diff options
author | Karl Berry <karl@freefriends.org> | 2011-10-23 22:25:02 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-10-23 22:25:02 +0000 |
commit | fb89be74d746b6e35b71f8b952d60171a94703d9 (patch) | |
tree | 82accd3660cb3c0b75dea67197efda283caad47d /Master/texmf-dist/tex/latex/morehype | |
parent | 6cbc7ea970ec21c86eccb8568e3845847ecaeb26 (diff) |
morehype (23oct11)
git-svn-id: svn://tug.org/texlive/trunk@24369 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype')
-rw-r--r-- | Master/texmf-dist/tex/latex/morehype/blog.sty | 53 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/morehype/blogdot.cfg | 7 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/morehype/blogdot.sty | 49 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/morehype/texlinks.sty | 212 |
4 files changed, 225 insertions, 96 deletions
diff --git a/Master/texmf-dist/tex/latex/morehype/blog.sty b/Master/texmf-dist/tex/latex/morehype/blog.sty index bcf0bc0d0ac..947ebabfe96 100644 --- a/Master/texmf-dist/tex/latex/morehype/blog.sty +++ b/Master/texmf-dist/tex/latex/morehype/blog.sty @@ -1,5 +1,5 @@ \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. -\ProvidesPackage{blog}[2011/10/15 v0.61 simple fast HTML (UL)] +\ProvidesPackage{blog}[2011/10/22 v0.62 simple fast HTML (UL)] %% copyright (C) 2010 2011 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. @@ -48,8 +48,10 @@ \ProcessOptions \MakeOther\< \MakeOther\> %% TODO ... \newcommand*{\BlogCopyFile}[2][]{% - \typeout{^^J\screenqtd{blog.sty} generating %% 2011/10/05 - \screenqtd{\htmljob\htmakeext}}% +% \typeout{^^J\screenqtd{blog.sty} generating %% 2011/10/05 +% \screenqtd{\htmljob\htmakeext}}% +%% <- 2011/10/22: such a message should be in driver file +%% when it is clear how many source files the target file has. \ProcessFileWith[\BlogCodes \let\ProvidesFile\BlogProvidesFile %% 2011/02/24 \let\protect\@empty %% 2011/03/24 @@ -301,13 +303,17 @@ %% etc. for |\textbf|, |\texttt| ...: \renewcommand*{\textbf}{\SimpleTagSurr b} \renewcommand*{\texttt}{\SimpleTagSurr{tt}} %% 2010/06/07 -%% |\textsf{<text>}| TODO (see some `makehtml.tex') %% 2011/05/11 -%% +%% |\textsf{<text>}| chooses some sans-serif: %% 2011/10/20 +\renewcommand*{\textsf}{% + \TagSurr{span}{\@style{font-family:sans-serif}}} %% |\textcolor| is from \LaTeX's 'color' package %% that we won't load for generating \HTML, %% so it is ``new" here, it is just natural to use it -%% for colored text (2010/05/15): -\newcommand*{\textcolor}[1]{\TagSurr{font}{color="#1"}} +%% for colored text. %% (2010/05/15): +%% \xmltagcode{font} is deprecated, use %% 2011/10/20 +%% \xmltagcode{span} instead: +% \newcommand*{\textcolor}[1]{\TagSurr{font}{color="#1"}} +\newcommand*{\textcolor}[1]{\TagSurr{span}{\@style{color:#1}}} %% %% == Logical Markup == %% |\code{<text>}| marks <text> as ``code," @@ -419,24 +425,32 @@ %% %% == Links == %% === Basic Link Macros === -%% |\hanc{<id>}{<text>}| makes <text> an anchor with -%% \HTML\ label <id> (like 'hyperref''s `\hypertarget'): +%% %% doc. fixes + hyperref 2011/10/16: +%% |\hanc{<name>}{<text>}| makes <text> an anchor with +%% \HTML\ label <name> like \ctanpkgref{hyperref}'s +%% |\hypertarget{<name>}{<text>}| +%% (that we actually provide as well, +%% towards printing from the same source): \newcommand*{\hanc}[1]{\TagSurr a{\@name{#1}}} -%% |\hancref{<id>}{<url>}{<text>}| makes <text> an anchor with -%% \HTML\ label <id> and at the same time a link to <url>: +\@ifdefinable\hypertarget{\let\hypertarget\hanc} +%% |\hancref{<name>}{<target>}{<text>}| makes <text> an anchor with +%% \HTML\ label <name> and at the same time a link to <target>: \newcommand*{\hancref}[2]{\TagSurr a{\@name{#1} \@href{#2}}} -%% |\href{<id>}{<text>}| makes <text> a link to <url>: +%% |\href{<name>}{<text>}| makes <text> a link to <name> +%% (as with 'hyperref'): \newcommand*{\href}[1]{\TagSurr a{\@href{#1}}} %% %% === Special cases of Basic Link Macros === %% |\autanc{<text>}| creates an anchor where <text> is %% the text and the internal label at the same time: \newcommand*{\autanc}[1]{\hanc{#1}{#1}} %% 2010/07/04 -%% |\ancref{<id>}{<text>}| makes <text> a link to -%% an anchor <id> on the same web page. +%% |\ancref{<name>}{<text>}| makes <text> a link to +%% an anchor <name> on the same web page. %% This is especially useful for a ``table of contents"---a %% list of links to sections of the page. +%% It is just like 'hyperref''s |\hyperlink{<name>}{<text>}|: \newcommand*{\ancref}[1]{\href{\##1}} +\@ifdefinable\hyperlink{\let\hyperlink\ancref} %% |\autref{<text>}| makes <text> a link to an anchor %% named <text> itself: \newcommand*{\autref}[1]{\ancref{#1}{#1}} %% 2010/07/04 @@ -493,6 +507,7 @@ %% or more generally with local non-\HTML\ files), %% so let us have a backbone %% |\hnewref{<prot>}{<host-path[#frag]>}{<text>}| +%% that %% 2011/10/21 %% makes <text> a link to <prot><host-path[#frag]>: \newcommand*{\hnewref}[2]{% \TagSurr a{\@href{#1#2" target="_blank}}} @@ -503,9 +518,7 @@ \RequirePackage[blog]{texlinks}[2011/02/10] %% Former |\urlref| appears as |\urlhttpref| there ... \newcommand \urlref {} \let\urlref\urlhttpref -%% ... and |\ctanref| has been replaced by `\tugctanref'. -%% Let's go on playing with the difference ... -\newcommand*{\ctanref}[1]{\httpref{ctan.org/tex-archive/#1}} +%% ... and `\ctanref' has changed its meaning there as of 2011/10/21. %% %% 2011/02/07: %% 'texlinks' sometimes uses a ``permanent alias" %% |\NormalHTTPref| of `\httpref': @@ -1065,3 +1078,9 @@ v0.61 2011/10/11 </li> in \item again, \Provides... v wrong 2011/10/12 \hnewref, `\ ' in allrulestable 2011/10/14 \CLBrk's 2011/10/15 doc. note on \HVspace/blogdot +part of MOREHYPE RELEASE r0.51 +v0.62 2011/10/16 \hyperlink, \hypertarget; doc. fixes there + 2011/10/20 \textcolor by <span>, \textsf + 2011/10/21 \ctanref now in texlinks.sty; + doc.: grammar with `that' + 2011/10/22 \BlogCopyFile message removed diff --git a/Master/texmf-dist/tex/latex/morehype/blogdot.cfg b/Master/texmf-dist/tex/latex/morehype/blogdot.cfg index 1970295d15a..c0ca5dfc68a 100644 --- a/Master/texmf-dist/tex/latex/morehype/blogdot.cfg +++ b/Master/texmf-dist/tex/latex/morehype/blogdot.cfg @@ -1,4 +1,4 @@ -\ProvidesFile{blogdot.cfg}[2011/10/14 local blogdot.sty config] +\ProvidesFile{blogdot.cfg}[2011/10/21 local blogdot.sty config] %% (U.L.:) For my 1024$\times$600 screen %% (with Mozilla Firefox~3.6.22 for Ubuntu canonical~-~1.0), %% the following choice of `\leftpagemargin' worked best @@ -27,4 +27,9 @@ %% ... `blogdot.cfg' may be a good idea for general settings; %% recompiling the presentation of a given document source %% `<job>.tex' may better be controlled in a file `<job>.cfg' ... +%% +%% Open CTAN files: %% 2011/10/21 +% \usemirrorctan +% \usecurrdirctan +%% Stop processing this file: \endinput diff --git a/Master/texmf-dist/tex/latex/morehype/blogdot.sty b/Master/texmf-dist/tex/latex/morehype/blogdot.sty index 699cb64805a..900025e9d35 100644 --- a/Master/texmf-dist/tex/latex/morehype/blogdot.sty +++ b/Master/texmf-dist/tex/latex/morehype/blogdot.sty @@ -1,5 +1,5 @@ \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. -\ProvidesPackage{blogdot}[2011/10/15 v0.3 HTML presentations (UL)] +\ProvidesPackage{blogdot}[2011/10/22 v0.4 HTML presentations (UL)] %% copyright (C) 2011 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. @@ -64,7 +64,8 @@ %% |\CommentBlogDotWholeWidth| procuces no \HTML\ code ... \global\let\BlogDotWholeWidth\@empty %% ... unless calculated with |\SumBlogDotWidth|: -\newcommand*{\SumBlogDotWidth}{{% +\newcommand*{\SumBlogDotWidth}{% + \relax{% %% \relax 2011/10/22 magic ... \count@\typeareawidth \advance\count@ \leftpagemargin \advance\count@\rightpagemargin @@ -122,7 +123,7 @@ %% |\BlogDotRestart| expands. \newcommand*{\screenbottom}[1]{% \ifFillBlogDotTypeArea - </p>\ancref{#1}{\BlogDotFillText}% + <p>\ancref{#1}{\BlogDotFillText}% %% not </p> 2011/10/22 \fi \endTd\emptycell \endtr @@ -232,7 +233,9 @@ %% the type area so that the text is centered on wider screens %% than the one the \HTML\ page was made for. The link may serve %% as an alternative to the bottom margin link -%% (which sometimes fails). It can be undone +%% (which sometimes fails). +%% `\FillBlogDotTypeArea' %% 2011/10/22 +%% can be undone %% by |\DontFillBlogDotTypeArea|: \newcommand*{\FillBlogDotTypeArea}{% \let\ifFillBlogDotTypeArea\iftrue @@ -241,8 +244,9 @@ \let\ifFillBlogDotTypeArea\iffalse} \DontFillBlogDotTypeArea %% |\FillBlogDotBottom| fills `\BlogDotFillText' into the -%% center bottom cell. I tried this before `\FillBlogDotTypeArea' -%% and I am not sure ... \ It can be undone by +%% center bottom cell. I tried it before `\FillBlogDotTypeArea' +%% and I am not sure ... +%% It can be undone by %% |\DontFillBlogDotBottom|: \newcommand*{\FillBlogDotBottom}{% \let\BlogDotBottomFill\BlogDotFillText} @@ -251,14 +255,37 @@ \newcommand*{\DontFillBlogDotBottom}{\let\BlogDotBottomFill\@empty} \DontFillBlogDotBottom %% |\DontShowBlogDotFillText| makes `\BlogDotFillText' invisible,\\ -%% |\ShowBlogDotFillText| makes it visible: +%% |\ShowBlogDotFillText| makes it visible. +%% Until 2011/10/22, `\textcolor' ('blog.sty') used the +%% \xmltagcode{font} element that is deprecated. +%% I still use it here because it seems to suppress the +%% `hover' \acro{CSS} indication for the link. +%% (I might offer a choice---TODO) \newcommand*{\DontShowBlogDotFillText}{% - \def\BlogDotFillTextColor{\textcolor{\bodybgcolor}}} +% \def\BlogDotFillTextColor{\textcolor{\bodybgcolor}}} + \def\BlogDotFillTextColor{% + \TagSurr{font}{color="\bodybgcolor"}}} \newcommand*{\ShowBlogDotFillText}{% \def\BlogDotFillTextColor{\textcolor{red}}} \DontShowBlogDotFillText +%% As of 2011/10/21, 'texlinks.sty' provides +%% `\ctanfileref{<path>}{<file-name>}' that uses an online +%% \TeX\ archive according to +%% \[|\usemirrorctan|\quad \mbox{or}\quad |\usetugctan|.\] +%% This is preferable for an online version of the presentation. +%% In `dantev45.htm', this is used for example files. +%% When, on the other hand, internet access during the presentation is +%% bad, such example files may instead be loaded from the +%% ``current directory." \ |\usecurrdirctan| \ modifies `\ctanfileref' +%% for this purpose (i.e., it will ignore <path>): +\newcommand*{\usecurrdirctan}{% + \renewcommand*{\ctanfileref}[2]{% + \hnewref{}{##2}{\filenamefmt{##2}}}} +%% (Using a local \acro{TDS} tree would be funny, but I don't +%% have good idea for this right now. ) +%% %% |\TryBlogDotCFG| looks for `blogdot.cfg', -%% |\TryBlogDotCFG[<file-name-base>]| +%% \[|\TryBlogDotCFG[<file-name-base>]|\] %% \[...\] 2011/10/21 %% looks for `<file-name-base>.cfg' %% (for recompiling a certain file): \newcommand*{\TryBlogDotCFG}[1][blogdot]{% @@ -290,3 +317,7 @@ v0.3 2011/10/11 \HVspace, \BlogDotFillText \ifFillBlogDotTypeArea, \tablerow, messages 2011/10/14 \maybe@blogdot@frame 2011/10/15 doc. note: \HVspace useless + part of morehype RELEASE r0.51 +v0.4 2011/10/21 \usecurrdirctan + 2011/10/22 FillText with <p> instead of </p>, its color + uses <font>; some more reworking of doc. diff --git a/Master/texmf-dist/tex/latex/morehype/texlinks.sty b/Master/texmf-dist/tex/latex/morehype/texlinks.sty index 9423dfef4df..ac546b89f67 100644 --- a/Master/texmf-dist/tex/latex/morehype/texlinks.sty +++ b/Master/texmf-dist/tex/latex/morehype/texlinks.sty @@ -1,5 +1,5 @@ \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. -\ProvidesPackage{texlinks}[2011/10/10 v0.41 TeX-related links (UL)] +\ProvidesPackage{texlinks}[2011/10/21 v0.5 TeX-related links (UL)] %% copyright (C) 2011 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. @@ -15,19 +15,19 @@ %% %% http://www.contact-ednotes.sty.de.vu %% -%% == Outline == +%% == Outline == %% % Almost %% 2011/07/23 %% % all the %% including https 2011/08/27 %% The link macros of 'texlinks' are based on macros %% |\httpref| and |\httpsref|. For use of 'texlinks' with 'blog.sty', %% the latter provides definitions of `\httpref' and `\httpsref' -%% suitable for \acro{HTML}, where a choice of opening a new +%% suitable for \HTML, where a choice of opening a new %% tab or window---or not---is relevant. %% %% For use with 'hyperref' (or ...?), 'texlinks' may %% provide definitions of `\httpref' and `\httpsref' %% based on `\href'. The decision to do so or not may happen at -%% `\begin{document}'. 'blog.sty' generates \acro{HTML} without +%% `\begin{document}'. 'blog.sty' generates \HTML\ without %% using the `{document}' environment, so we might assume %% that when `\begin{document}' is found, we are running %% 'hyperref', or just \emph{something} that provides a @@ -36,12 +36,12 @@ %% %% Moreover, a \acro{PDF} file with links may be \emph{printed}, %% and klicking the links on the paper may fail. -%% \acro{URL}s in main text, on the other hand, sometimes are +%% \URL s in main text, on the other hand, sometimes are %% troublesome. I consider it a good idea to present -%% links with their \acro{URL} as the displayed text in \emph{footnotes} -%% (or endnotes). It may even be useful with \acro{HTML} to present -%% the \acro{URL}s displayed in some -%% 2011/01/27: +%% links with their \URL\ as the displayed text in \emph{footnotes} +%% (or endnotes). It may even be useful with \HTML\ to present +%% the \URL s displayed in some +%% %% 2011/01/27: %% rm. 2011/10/20 %% ``appendix."---This idea has been resumed in v0.2 only, %% |\urlfoot|. %% % @@ -49,7 +49,7 @@ %% % package option forcing `\httpref' to use this style. %% % Well, better \emph{not today} ... [2011/01/24, TODO] %% -%% == Package Options == +%% == Package Options == %% Somebody may want to suppress a definition of `\httpref' %% at `\begin{document}' ... [2011/01/24, TODO] %% %% 2011/02/10: @@ -61,7 +61,49 @@ %% useful for different purposes than running 'blog.sty'. \ProcessOptions %% -%% \pagebreak +%% == Fonts for \URL s and File/Package Names == +%% %% ** Fonts for \URL s, File Names, and Package Names ** +%% %% new 2011/10/19, TODO: `meansltx'? vgl. `makedoc.cfg' +%% This section ``provides" markup for displaying \URL s (|\urlfmt|), +%% file names (|\filenamefmt|---thinking of single files +%% that may be found in the internet or on your computer---, +%% and ``packages" (|\pkgnamefmt|). +%% For the latter two, in certain files I use shorthands +%% |\file| and |\pkg|, resp., ... +%% (Not sure about `\providecommand' TODO ...) +%% %% TODO "fallback" with 'provlast' +%% +%% It is usual to use `\texttt' for formatting \TeX\ code +%% (``verbatim", `\verb' etc.). It may also be common to use +%% `\texttt' for file names, perhaps even for \URL s. +%% Therefore we provide |\urlfmt{<url>}| as follows: +\providecommand*{\urlfmt}{\texttt} +%% The file name format |\filenamefmt{<file-name>}| +%% may differ from the format for \URL s---if somebody +%% wants/adjusts it, \emph{here} it is the \emph{same:} +\providecommand*{\filenamefmt}{\texttt} +%% ... +%% I favour `\code' over `\texttt' as ``logical markup," +%% inspired by the \xmltagcode{code} element in \HTML, +%% but it is too difficult to provide this right now here ... +%% +%% %% Instead of |\pkgnamefmt{<pack-name>}|, +%% %% 'blog.sty' had `\pkg{<pack-name>}', %% was `prg' 2011/10/20 +%% %% without a proper implementation. +%% |\pkgnamefmt{<package-name>}| displays the name of a ``package". +%% Using `\textsf' for `\pkgnamefmt' +%% seems to conform to common practice today---implemented here. +%% The following code may later be suppressed at some package options, +%% as with the choice for `\httpref': %% TODO 2011/01/24 +% \@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone} +% \AtBeginDocument {\let\pkgnamefmt\textsf} +%% <- This was here until v0.61, makes a difference for \acro{PDF} +%% vs.\ 'blog' \HTML. Now we choose the same as with `\urlfmt': +\providecommand*{\pkgnamefmt}{\textsf} +%% Indeed, the same day we are providing `\textsf' in 'blog.sty'. +%% However, the rationale of the earlier solution was +%% that web pages use sans-serif as the \emph{normal} font ... +%% %% %% moving \httpsref 2011/08/27: %% == Providing &\httpref\ and &\httpsref == %% %% rm. \kern-\baselineskip 2011/10/10 @@ -69,7 +111,7 @@ %% should display <text> %% as a link to `http://<host-path[#frag]>'; %% \[|\httpsref{<host-path[#frag]>}{<text>}|\] -%% is the obvious analogue for `https:' \acro{URL}s. +%% is the obvious analogue for `https:' \URL s. %% In case `\begin{document}' is found with a definition of %% `\href' present, we provide definitions of `\httpref' %% and `\httpsref' in terms of `\href' there: @@ -86,14 +128,21 @@ \AtBeginDocument{%% TODO: options, guarded \let (mine, HO) \@ifdefinable\NormalHTTPref{\let\NormalHTTPref\httpref}} %% |\ithttpref{<url>}{<text>}| displays <text> in italics: -\newcommand*{\ithttpref}[2]{\NormalHTTPref{#1}{\textit{#2}}} -%% === \acro{URL}s as Links === -%% With |\urlhttpref{<url>}|, that \acro{URL} <url> is displayed: +% \newcommand*{\ithttpref}[2]{\NormalHTTPref{#1}{\textit{#2}}} +%% However, I seem never to have used it. And I would now +%% prefer |\metahttpref| TODO ... +%% +%% === \URL s as Links === +%% With |\urlhttpref{<url>}|, that \URL\ <url> is displayed: \newcommand*{\urlhttpref}[1]{% \NormalHTTPref{#1}{\urlfmt{\httpprefix#1}}} +%% %% moved up here 2011/10/20 +%% In 'blog.sty' (as of 2010/05/26), there was a command +%% `\urlref' instead of `\urlhttpref'. It did not provide `\urlfmt'. +%% %% |\httpprefix| is an idea that was missing in 'blog.sty' up to v0.3. %% It may be used to determine generally whether a display of an -%% \acro{URL} should include `http://'. I choose as default what was default +%% \URL\ should include `http://'. I choose as default what was default %% in 'blog.sty' %% (i.e., ``don't include"): %% add. 2011/01/27 \@ifdefinable\httpprefix{\let\httpprefix\@empty} %% TODO cf. above @@ -106,30 +155,24 @@ %% %% v0.2: %% ---or by `\let\httpprefix'|\theHTTPprefix|: \newcommand*{\theHTTPprefix}{http://} -%% |\urlfmt{<url>}| is chosen as `\texttt' here and may be -%% customized, e.g., with the 'breakurl' package. -\@ifdefinable\urlfmt{\let\urlfmt\texttt} -%% In 'blog.sty' (as of 2010/05/26), there was a command -%% `\urlref' instead of `\urlhttpref'. It did not provide `\urlfmt'. -%% %% With |\urlhttpsref{<url>}|, we \emph{force} displaying \qtd{`https://'}: \newcommand*{\urlhttpsref}[1]{\httpsref{#1}{\urlfmt{https://#1}}} %% -%% === Linking \acro{URL}s in Footnotes === %% 2011/08/27 +%% === Linking \URL s in Footnotes === %% 2011/08/27 %% \label{sec:urlfoot} %% |\foothttpurlref{<url>}| just is like %% `\footnote{\urlhttpref{<url>}}': \newcommand*{\foothttpurlref}[1]{\footnote{\urlhttpref{#1}}} %% |\urlfoot{<short>}{<id>}| %% redefines `\httpref' so that you can use all the shorthand -%% macros based on `\httpref' to get the according \acro{URL} +%% macros based on `\httpref' to get the according \URL\ %% display (as provided by `\urlhttpref') %% in a footnote without the need to include the -%% entire \acro{URL} in your source code. `\urlfoot' is available +%% entire \URL\ in your source code. `\urlfoot' is available %% with <short> and <id> %% when a shorthand |\<short>{<id>}{<text>}| has been defined %% where `\<short>' is the macro name and <id> is the target -%% identifier (usually part of the \acro{URL} generated from <id>) +%% identifier (usually part of the \URL\ generated from <id>) %% according to the syntax declaration of `\<short>'. \newcommand*{\urlfoot}[2]{{% \let\httpref\foothttpurlref @@ -220,7 +263,8 @@ \newcommand*{\Wikidedisambref}{\Wikidisambref{de}} \newcommand*{\Wikiendisambref}{\Wikidisambref{en}} %% -%% === Blanks and Umlauts in \acro{URL}s and Anchors === +%% \pagebreak %% 2011/10/21 +%% === Blanks and Umlauts in \URL s and Anchors === %% %% <- renamed 2011/05/17 reworked: %% |\underscorechar| seemed to be useful in macro %% definitions. The name was inspired by \LaTeX's @@ -277,17 +321,10 @@ % \@namedef{urluml:u}{\#C3\#BC} % \@namedef{urluml:s}{\#C3\#9F} %% 2010/08/09 %% -%% == \TeX-related == %% 2010/08/24 -%% === \acro{CTAN} === -%% |\bytopicref{<anchor>}{<text>}| -%% makes <text> a link to <anchor> of J\"urgen Fenn's -%% Topical Index of the \TeX\ Catalogue. You find the <anchor> -%% by clicking at the respective TOC entry on top of the page -%% and then read the \acro{URL} from the browser's navigation display. -\newcommand*{\bytopicref}[1]{% - \httpref{mirror.ctan.org/help/Catalogue/bytopic.html\##1}} -%% (Example:\quad `\bytopicref{html}{\acro{HTML}}' \ for \ \bytopicref{html}{\acro{HTML}}.) -%% +%% \pagebreak %% 2011/10/21 +%% == \TeX-related == %% 2010/08/24 +%% === \CTAN === +%% ==== Directories and Files in a \TeX\ Archive ==== %% % `\newcommand*{\ctanref}[1]{\httpref{ctan.org/#1}}' %% % once was replaced in 'blog.sty' by what will now be %% |\tugctanref{<path>}{<text>}| @@ -296,27 +333,64 @@ \newcommand*{\tugctanref}[1]{% \httpref{tug.ctan.org/tex-archive/#1}} %% Alternatively, you can refer to an (automatically chosen) -%% \acro{CTAN} \emph{mirror} +%% \CTAN\ \emph{mirror} %% using -%% \[|\mirrorctanref{<path>}{<text>}|:\] %% 2011/10/10 +%% \[|\mirrorctanref{<path>}{<text>}|.\] %% 2011/10/10 :->.2011/10/21: +%% (I prefer the \emph{appearance} of the +%% \tugctanref{}{\acro{TUG} archive}, designed by Jim Hefferon.) \newcommand*{\mirrorctanref}[1]{\httpref{mirror.ctan.org/#1}} %% You may actually want to ``open" a file <file-name> in <path> -%% on \acro{CTAN}, either by +%% on \CTAN, +%% <file-name> displayed as the link text, %% 2011/10/21 +%% either by %% \[|\tugctanfileref{<path>}{<file-name>}|\] %% 2011/10/10 %% or (for a mirror) by %% \[|\mirrorctanfileref{<path>}{<file-name>}|.\] %% 2011/10/10 -%% The file name format |\file{<file-name>}| -%% that is used in the definitions must be provided -%% elsewhere. %% 2011/10/06; TODO provlast \newcommand*{\tugctanfileref}[2]{% - \tugctanref{#1/#2}{\file{#2}}} + \tugctanref{#1/#2}{\filenamefmt{#2}}} \newcommand*{\mirrorctanfileref}[2]{% - \mirrorctanref{#1/#2}{\file{#2}}} -%% Typically, \LaTeX\ macro packages in \file{macros/latex/contrib/} + \mirrorctanref{#1/#2}{\filenamefmt{#2}}} +%% Typically, \LaTeX\ macro packages in `macros/latex/contrib/' %% are discussed, so here is |\ltxcontrib| saving a few characters: \newcommand*{\ltxcontrib}{macros/latex/contrib/} +%% |\ctanref| works like `\tugctanref' or like `\mirrorctanref', +%% depending on |\usetugctan| vs.\ |\usemirrorctan|. +%% So in any case its syntax is \[|\ctanref{<path>}{<text>}|.\] +%% Likewise, |\ctanfileref| works like +%% \[`\tugctanfileref'\quad \mbox{or}\quad `\mirrorctanfileref',\] +%% depending on the same `\usetugctan' vs.\ `\usemirrorctan', +%% so the syntax is +%% \[|\ctanfileref{<path>}{<file-name>}|\] +\newcommand*{\ctanref}{} \newcommand*{\ctanfileref}{} +\newcommand*{\usemirrorctan}{% + \let \ctanref \mirrorctanref + \let \ctanfileref \mirrorctanfileref} +\newcommand*{\usetugctan}{% + \let \ctanref \tugctanref + \let \ctanfileref \tugctanfileref} +%% |\usemirrorctan| is the \strong{default}, i.e., +%% |\ctanref| and |\ctanfileref| use +%% \urlhttpref{mirror.ctan.org}: +\usemirrorctan +%% \meta{Remark} (TODO): \ Another implementation I consider is +%% using some `\ctanurl'\-`prefix' that you can redefine for +%% accessing your favourite mirror. +%% +%% ==== J\"urgen Fenn's Topical \TeX\ Catalogue ==== +%% |\bytopicref{<anchor>}{<text>}| +%% \ %% 2011/10/21 +%% makes <text> a link to <anchor> of J\"urgen Fenn's +%% Topical Index of the \TeX\ Catalogue. You find the <anchor> +%% by clicking at the respective \acro{TOC} entry on top of the page +%% and then read the \URL\ from the browser's navigation display. +\newcommand*{\bytopicref}[1]{% + \httpref{mirror.ctan.org/help/Catalogue/bytopic.html\##1}} +%% (Example:\quad `\bytopicref{html}{\acro{HTML}}' \ for \ +%% \bytopicref{html}{\acro{HTML}}.) +%% +%% ==== Jim Hefferon's Package Descriptions ==== %% |\ctanpkgref{<pkg-name>}| -%% makes <text> a link to the \acro{CTAN} package info page for +%% makes <text> a link to the \CTAN\ package info page for %% the package <pkg-name>. %% |\CtanPkgRef{<name>}{<Name>}| %% is a variant for the cases where authors have a special idea @@ -327,25 +401,18 @@ %% Also, <Name> may be a package from a \emph{bundle} <name> %% where <name> has a description page while <Name> %% doesn't have its \emph{own} description page -%% (such as \CtanPkgRef{nicetext}{fifinddo}). +%% (such as \CtanPkgRef{nicetext}{makedoc}). +%% %% <- was `fifinddo' 2011/10/20, no with own id. \newcommand*{\CtanPkgRef}[2]{% \httpref{ctan.org/pkg/#1}{\pkgnamefmt{#2}}} \newcommand*{\ctanpkgref}[1]{\CtanPkgRef{#1}{#1}} -%% Instead of |\pkgnamefmt{<pack-name>}|, -%% 'blog.sty' had `\prg{<pack-name>}', without a proper -%% implementation. For typesetting, choosing `\pkgnamefmt' -%% as `\textsf' seems to conform to common practice today. -%% The following code may later be suppressed at some package options, -%% as with the choice for `\httpref': %% TODO 2011/01/24 -\@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone} -\AtBeginDocument {\let\pkgnamefmt\textsf} %% -%% === \acro{CTAN} Announcements === %% 2011/06/27 +%% === \CTAN\ Announcements === %% 2011/06/27 %% |\ctanannref{<id>}{<text>}| makes <text> a link -%% to the DANTE web page displaying a \acro{CTAN} +%% to the DANTE web page displaying a \CTAN\ %% announcement. You find <id> by searching %% \[\texttt{https://lists.dante.de/pipermail/ctan-ann/}\] -%% and then reading the \acro{URL}. +%% and then reading the \URL. %% <id> is composed as `<year>-<month>/<6-digits>.html'. \newcommand*{\ctanannref}[1]{% \httpsref{lists.dante.de/pipermail/ctan-ann/#1}} @@ -355,7 +422,7 @@ %% year, then a `-', then the (arabic) number of %% the month, then another `-', and then the actual %% internal identifier -%% (a number of six digits preceding `.html' of the \acro{URL}). +%% (a number of six digits preceding `.html' of the \URL). \newcommand*{\ctanannpref}[1]{% \ctanannref{\TL@piper@parse#1/.html}} \def\TL@piper@parse#1-#2-#3/{% @@ -367,7 +434,7 @@ \fi /#3} %% -%% === \acro{TUG} === +%% === \acro{TUG} === %% |\tugref{<path>}{<text>}| makes <text> a link %% to <path> on domain `tug.org': \newcommand*{\tugref}[1]{\httpref{tug.org/#1}} @@ -375,7 +442,7 @@ %% |\texhaxref{<id>}{<text>}| makes <text> a link %% to the \acro{TUG} web page displaying %% a texhax posting. You find <id> by searching -%% `tug.org/pipermail/texhax/' and then reading the \acro{URL}. +%% `tug.org/pipermail/texhax/' and then reading the \URL. %% <id> is composed as `<year>-<month>/<6-digits>.html'. \newcommand*{\texhaxref}[1]{\tugref{pipermail/texhax/#1}} %% |\THref{<id>}| saves you from choosing <text> @@ -390,9 +457,9 @@ %% year, then a `-', then the (arabic) number of %% the month, then another `-', and then the actual %% internal identifier -%% (a number of six digits preceding `.html' of the \acro{URL}). +%% (a number of six digits preceding `.html' of the \URL). %% I made this macro because I prefer typing to copying -%% from the \acro{URL}. +%% from the \URL. \newcommand*{\texhaxpref}[1]{% %% 2010/09/07 \texhaxref{20\TL@piper@parse#1/.html}} %% 2011/05/03 %% TODO: `\texhaxPref#1' searches list of offsets @@ -411,22 +478,22 @@ %% (e.g., \TUGIref{web}{\qtd{Web Projects}}): \newcommand*{\TUGIref}[1]{\tugref{interest.html\##1}} %% -%% === \acro{UK FAQ} === +%% === \acro{UK FAQ} === %% |\ukfaqref{<label>}{<text>}| makes <text> a link to %% the UK~\TeX~FAQ page with ``label"~= <label>: \newcommand*{\ukfaqref}[1]{\httpref{% www.tex.ac.uk/cgi-bin/texfaq2html?label=#1}} -%% === Wikibooks === +%% === Wikibooks === %% |\wikibooks{<language-code>}{<file>}{<text>}|: \newcommand*{\wikibooksref}[2]{\httpref{#1.wikibooks.org/wiki/#2}} -%% |\wikibooks{<file>}{<subject>}{<text>}| refers to the +%% |\latexwikibookref{<file>}{<subject>}{<text>}| refers to the %% (English) \LaTeX\ Wikibook: \newcommand*{\latexwikibookref}[1]{\wikibooksref{en}{LaTeX/#1}} %% The German %% \wikibooksref{de}{LaTeX-Kompendium}{\dqtd{\LaTeX-Kompendium}} %% is somewhat difficult, I leave it for now~... %% -%% == Leaving == %% 2011/01/24 +%% == Leaving == %% 2011/01/24 \endinput %% %% == VERSION HISTORY == @@ -451,3 +518,10 @@ v0.41 2011/09/03 doc.: more specific on \urluml/Wikipedia 2011/10/06 \mirrorctanref, \tugctanfileref, \mirrorctanfileref, \ltxcontrib 2011/10/10 doc. formatting of previous +uploaded with MOREHYPE r0.5(1) +v0.5 2011/10/19 doc. fix LaTeX Wikibook + 2011/10/20 \urlfmt, \filenamefmt and \pkgnamefmt + changed and moved, modified doc. on them, + doc. uses \URL + 2011/10/21 re-order CTAN, \pagebreak's, \ctanref and + choice for it, doc. modified; rm. \ithttpref |