summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/morehype/texlinks.sty
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype/texlinks.sty')
-rw-r--r--Master/texmf-dist/tex/latex/morehype/texlinks.sty330
1 files changed, 213 insertions, 117 deletions
diff --git a/Master/texmf-dist/tex/latex/morehype/texlinks.sty b/Master/texmf-dist/tex/latex/morehype/texlinks.sty
index 04659d34509..32f3b9c2cab 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/02/10 v0.3 TeX-related links (UL)]
+\ProvidesPackage{texlinks}[2011/08/27 v0.4 TeX-related links (UL)]
%% copyright (C) 2011 Uwe Lueck,
%% http://www.contact-ednotes.sty.de.vu
%% -- author-maintained in the sense of LPPL below.
@@ -16,29 +16,31 @@
%% http://www.contact-ednotes.sty.de.vu
%%
%% == Outline ==
-%% All the link macros of 'texlinks' are based on a macro
-%% |\httpref|. For use of 'texlinks' with 'blog.sty',
-%% the latter provides a definition of `\httpref'
-%% suitable for HTML, where a choice of opening a new
+%% % 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
%% tab or window---or not---is relevant.
%%
%% For use with 'hyperref' (or ...?), 'texlinks' may
-%% provide a definition of `\httpref' based on `\href'.
-%% The decision to do so or not may happen at
-%% `\begin{document}'. 'blog.sty' generates HTML without
+%% 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
%% 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
%% useful `\href'. We might then execute a definition of
%% `\httpref' in terms of `\href'. Well, not sure ...
%%
-%% Moreover, a PDF file with links may be \emph{printed},
+%% Moreover, a \acro{PDF} file with links may be \emph{printed},
%% and klicking the links on the paper may fail.
-%% URLs in main text, on the other hand, sometimes are
+%% \acro{URL}s in main text, on the other hand, sometimes are
%% troublesome. I consider it a good idea to present
-%% links with their URL as the displayed text in \emph{footnotes}
-%% (or endnotes). It may even be useful with HTML to present
-%% the URLs displayed in some
+%% 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:
%% ``appendix."---This idea has been resumed in v0.2 only,
%% |\urlfoot|.
@@ -59,33 +61,39 @@
%% useful for different purposes than running 'blog.sty'.
\ProcessOptions
%%
-%% == Providing &\httpref ==
+%% \pagebreak
+%% %% moving \httpsref 2011/08/27:
+%% == Providing &\httpref\ and &\httpsref ==
%% \kern-\baselineskip
%% \[|\httpref{<host-path[#frag]>}{<text>}|\]
%% should display <text>
-%% as a link to `http://<host-path[#frag]>'.
-%% \
+%% as a link to `http://<host-path[#frag]>';
+%% \[|\httpsref{<host-path[#frag]>}{<text>}|\]
+%% is the obvious analogue for `https:' \acro{URL}s.
%% In case `\begin{document}' is found with a definition of
-%% `\href' present, we provide a definition of `\httpref'
-%% in terms of `\href' there:
+%% `\href' present, we provide definitions of `\httpref'
+%% and `\httpsref' in terms of `\href' there:
\AtBeginDocument{%
\@ifundefined{href}{%
% \PackageError ... TODO!? 2011/01/24
- }{\newcommand*{\httpref}[1]{\href{http://#1}}}}
+ }{\newcommand*{\httpref} [1]{\href {http://#1}}%
+ \newcommand*{\httpsref}[1]{\href{https://#1}}}}
%%
-%% == Variants of &\httpref ==
+%% == Variants of &\httpref\ and &\httpsref ==
%% |\NormalHTTPref| may be used as an alias for `\httpref'
-%% in situations where the latter has been redefined: %% v0.2
+%% in situations where the latter has been redefined %% v0.2
+%% (as in Section~\ref{sec:urlfoot}):
\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}}}
-%% With |\urlhttpref{<url>}|, that URL is displayed:
+%% === \acro{URL}s as Links ===
+%% With |\urlhttpref{<url>}|, that \acro{URL} <url> is displayed:
\newcommand*{\urlhttpref}[1]{%
\NormalHTTPref{#1}{\urlfmt{\httpprefix#1}}}
%% |\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
-%% URL should include `http://'. I choose as default what was default
+%% \acro{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
@@ -104,19 +112,24 @@
%% 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
+%% \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 URL
+%% macros based on `\httpref' to get the according \acro{URL}
%% display (as provided by `\urlhttpref')
%% in a footnote without the need to include the
-%% entire URL in your source code. `\urlfoot' is available
+%% entire \acro{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 URL generated from <id>)
+%% identifier (usually part of the \acro{URL} generated from <id>)
%% according to the syntax declaration of `\<short>'.
\newcommand*{\urlfoot}[2]{{%
\let\httpref\foothttpurlref
@@ -136,10 +149,10 @@
%% \item try `ctanpkgref' \emph{here}: \ctanpkgref{morehype},\\
%% for the \emph{footnote} try
%% `\urlfoot{ctanpkgref}{morehype}'.%%%
-%% \urlfoot{ctanpkgref}{morehype}
+%% \urlfoot{ctanpkgref}{morehype}
%% \end{itemize}
-%% The lonely \qtd{\pkgnamefmt{morehype}} demonstrates that
-%% it doesn't work with `ctanpkgref' because
+%% The lonely \qtd{\pkgnamefmt{morehype}} you see there above
+%% demonstrates that it doesn't work with `ctanpkgref' because
%% `\ctanpkgref' doesn't have separate arguments for
%% <id> and <text>, it actually doubles <id>.
%% A local `\let\ctanpkgref\CtanPkgRef' could help,
@@ -153,87 +166,126 @@
\newcommand* {\urlpkgfoot} {\urlfoot{CtanPkgRef}}
%%
%% == Wikipedia ==
+%% %% TODO separate wikilink.sty? https:!?
+%% === Backbones ===
+%% As of v0.4, we have a \dqtd{backbone} macro
+%% \[|\wikiref{<language-code>}{<lemma>}{<text>}|\]
+%% for links to Wikipedia. <language-code> consists of
+%% two characters like \lq`de'\rq\ for German Wikipedia articles
+%% or \lq`en'\rq\ for English ones. <lemma> is the identifier of
+%% the article, and <text> is displayed as the link:
+\newcommand*{\wikiref}[2]{\httpref{#1.wikipedia.org/wiki/#2}}
+%% There is |\Wikiref{<language-code>}{<lemma>}|
+%% for the case that <lemma> and <text> are the same:
+\newcommand*{\Wikiref}[2]{\wikiref{#1}{#2}{#2}}
+%% We could have `\wikiref{<lang>}[<id>]{<text>}' instead, then
+%% `\Wikiref' would not be needed; however, the present code is to
+%% work with 'blog.sty', where optional arguments fail.%%%---
+%%
+%% Quite often, programs share their names with movies,
+%% biological species, etc., then lemma disambiguation is required.
+%% Usually, we don't want to display the disambiguation.
+%% \[|\Wikidisambref{<language-code>}{<term>}{<suffix>}|\]
+%% will link to
+%% \[`http://en.wikipedia.org/wiki/<term>_(<suffix>)'\]
+\newcommand*{\Wikidisambref}[3]{\wikiref{#1}{#2 (#3)}{#2}}
+%% There %% was `Their' 2011/07/23
+%% was something like a more general variant |\wikidisambref|,
+%% now I doubt its usefulness and \textcolor{blue}{omit} it
+%% in order to see where it occurs (2011/05/13).
+%%
+%% For \strong{anchors}, \qtd{&#} can be used with 'blog.sty'---and
+%% even with 'hyperref'.
+%% \par\smallskip\noindent
+%% \strong{Example:}\quad
+%% `\wikienref{TeX#History}{\TeX}'
+%% \ for \
+%% \wikienref{TeX#History}{\TeX}.
+%%
+%% === English and German ===
+%% The next macros just save you from typing braces around
+%% the language codes for English and German:
+%% |\wikienref{<lemma>}{<text>}| refers to the English Wikipedia,
+%% |\wikideref{<lemma>}{<text>}| refers to the German one.
+\newcommand*{\wikideref}{\wikiref{de}}
+\newcommand*{\wikienref}{\wikiref{en}}
%% |\Wikideref{<lemma>}| refers to article <lemma> in the German
-%% Wikipedia. (The next considerations apply to English
-%% etc. as well!) With umlauts etc.,
-%% |\wikideref{<wiki-id>}{<lemma>}| may be needed.
-%% For this form, sometimes using \qtd{&_} seemed to be needed.
-%% In 'blog.sty', there was `\catcode`\_=12'.
-%% This was no problem there, as the underscore was not needed
-%% for math there. (For some time I thought of making it `\active'
-%% for a shorthand for \xmltagcode{sub} elements ...)
-%% But I could not find out whether it was needed or avoidable.
-%% I leave this matter open here (for 'hyperref') ...
-%% [2011/01/24, TODO, maybe solved there]
-\newcommand*{\wikideref}[1]{\httpref{de.wikipedia.org/wiki/#1}}
-\newcommand*{\Wikideref}[1]{\wikideref{#1}{#1}}
-%% Anyway, |\underscorechar| seems to be useful in our macro
-%% definitions. The name is inspired by \LaTeX's
-%% `\@backslashchar' and `\@percentchar':
-\newcommand \underscorechar {}
-{\@makeother\_ \gdef\underscorechar{_}}
-%% \strong{Note:} It would be natural to replace `\Wikideref'
-%% by equipping `\wikideref' with an optional argument---with
-%% \LaTeX. With 'blog.sty' however, where this code is now
-%% taken from, optional arguments didn't work.
-%% Later we might indeed in a similar manner to dealing
-%% with 'hyperref' at `\begin{document}' introduce optional
-%% arguments for the case of typesetting.---Analogues apply
-%% in the sequel again. [2011/01/24, TODO]
+%% Wikipedia and displays <lemma> as <text>:
+\newcommand*{\Wikideref}{\Wikiref{de}}
+%% |\Wikienref{<lemma>}| is `\Wikideref''s analogue for English:
+\newcommand*{\Wikienref}{\Wikiref{en}}
+%% |\Wikidedisambref{<lemma>}{<suffix>}| chooses a disambiguation
+%% according to <suffix> for the German Wikipedia,
+%% |\Wikiendisambref{<lemma>}{<suffix>}| for the English one:
+\newcommand*{\Wikidedisambref}{\Wikidisambref{de}}
+\newcommand*{\Wikiendisambref}{\Wikidisambref{en}}
+%%
+%% === Blanks and Umlauts in \acro{URL}s and Anchors ===
+%% %% <- renamed 2011/05/17 reworked:
+%% |\underscorechar| seemed to be useful in macro
+%% definitions. The name was inspired by \LaTeX's
+%% `\@backslashchar' and `\@percentchar'.
+%% However, I am now trying what happens without it.
+%% It occurred in `blog.tex' for the documentation of
+%% the 'blog' package, but `\string_' seems to be a good
+%% replacement.
+% \newcommand \underscorechar {}
+% {\@makeother\_ \gdef\underscorechar{_}}
+%% Anyway, in my notes I have a more elegant macro for
+%% providing ``other" versions of special characters.
%%
+%% Guessing what `\underscorechar' was good for (2011-05-17):
+%% Wikipedia lemmas and anchors often or even \emph{typically}
+%% contain \emph{blank spaces}.
+%% The Wikipedia software usually converts them into
+%% underscore characters. Blank spaces in \emph{lemmas}
+%% seem \emph{not} to need treatment here in 'texlinks'.
+%% However, Wikipedia also creates \emph{anchors} from
+%% \emph{section headings}, which typically contain blank spaces.
+%% This has been more difficult ...
+%%
+%% Likewise with umlauts: text encoding suffices for \emph{lemmas.}
+%% I made `\urluml' for lemmas. But umlauts in \emph{anchors}
+%% generated from \emph{section headings} are different.
+%% While umlauts in \emph{lemmas} are represented by sequences
+%% starting with a \emph{percent} character, the anchors
+%% use a \emph{dot} instead of the percent character.
+%% Therefore now |\ancuml{<char>}| is provided:
+\newcommand*{\ancuml}[1]{\csname ancuml:#1\endcsname}
+\@namedef{ancuml:a}{.C3.A4}
+\@namedef{ancuml:o}{.C3.B6}
+\@namedef{ancuml:u}{.C3.BC}
+\@namedef{ancuml:s}{.C3.9F}
+%% What you read in the rest of the section is
+%% \textcolor{blue}{wrong}, the commands are
+%% \textcolor{blue}{dropped} for testing as of 2011/05/13.
%% |\itwikideref| is an italic variant of `\wikideref':
-\newcommand*{\itwikideref}[2]{\wikideref{#1}{\textit{#2}}}
-%% |\wikienref{<wiki-id>}{<lemma>}| refers to the English Wikipedia:
-\newcommand*{\wikienref}[1]{\httpref{en.wikipedia.org/wiki/#1}}
+% \newcommand*{\itwikideref}[2]{\wikideref{#1}{\textit{#2}}}
%% By analogy to `\Wikideref',
-%% |\Wikienref{<lemma>}| saves you from repeating <lemma>:
-%% %% abbreviates `\wikienref{<lemma>}{<lemma>}':
-\newcommand*{\Wikienref}[1]{\wikienref{#1}{#1}}
-%% Quite often, programs share their names with movies,
-%% biological species, etc.,
-%% then disambiguation is required. Usually, the movie is irrelevant
-%% and we don't want to display the disambiguation.
%% The following macros save you from typing the underscore
%% (didn't spaces suffice sometimes?) %% TODO 2011/01/24
%% and the round parantheses.
-%% |\wikiendisambref{<term>}{<suffix>}{<text>}|
-%% links to
-%% \[`http://en.wikipedia.org/wiki/<term>_(<suffix>)'\]
-%% while displaying <text> as link text only:
-\newcommand*{\wikiendisambref}[2]{%
- \wikienref{#1\underscorechar (#2)}}
-%% |\Wikiendisambref{<term>}{<suffix>}|
-%% does the same when <text> is the same as <term>:
-\newcommand*{\Wikiendisambref}[2]{%
- \wikienref{#1\underscorechar (#2)}{#1}}
%% Italic variant |\itwikienref| of `\wikienref'
%% ('blog.sty' had `\emwikienref' instead):
-\newcommand*{\itwikienref}[2]{\wikienref{#1}{\textit{#2}}}
+% \newcommand*{\itwikienref}[2]{\wikienref{#1}{\textit{#2}}}
%% |\urluml{<ascii-char>}| as of 2010/05/25
%% (not sure if it ever worked or was actually needed):
-\newcommand*{\urluml}[1]{\csname urluml:#1\endcsname}
-\@namedef{urluml:a}{\#C3\#A4}
-\@namedef{urluml:o}{\#C3\#B6}
-\@namedef{urluml:u}{\#C3\#BC}
-\@namedef{urluml:s}{\#C3\#9F} %% 2010/08/09
-%% For \strong{anchors}, \qtd{&#} can be used with 'blog.sty'---and
-%% even with 'hyperref'.
-%% \par\smallskip\noindent
-%% \strong{Example:}\quad
-%% `\wikienref{TeX#History}{\TeX}'
-%% \ for \
-%% \wikienref{TeX#History}{\TeX}.
+% \newcommand*{\urluml}[1]{\csname urluml:#1\endcsname}
+% \@namedef{urluml:a}{\#C3\#A4}
+% \@namedef{urluml:o}{\#C3\#B6}
+% \@namedef{urluml:u}{\#C3\#BC}
+% \@namedef{urluml:s}{\#C3\#9F} %% 2010/08/09
%%
-%% == \TeX-related == %% 2010/08/24
-%% === CTAN ===
+%% == \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 URL from the browser's navigation display.
+%% 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}{HTML}' \ for \ \bytopicref{html}{HTML}.)
+%% (Example:\quad `\bytopicref{html}{\acro{HTML}}' \ for \ \bytopicref{html}{\acro{HTML}}.)
%%
%% % `\newcommand*{\ctanref}[1]{\httpref{ctan.org/#1}}'
%% % once was replaced in 'blog.sty' by what will now be
@@ -244,8 +296,9 @@
\httpref{tug.ctan.org/tex-archive/#1}}
%% %% corr. 2010/11/23:
%% $|\ctanpkgref{<pkg-name>}|$
-%% makes <text> a link to the CTAN package info page for
-%% the package <pkg-name>. $|\CtanPkgRef{<name>}{<Name>}|$
+%% makes <text> a link to the \acro{CTAN} package info page for
+%% the package <pkg-name>.
+%% $|\CtanPkgRef{<name>}{<Name>}|$
%% is a variant for the cases where authors have a special idea
%% <Name> using some capital letters when they describe their packages
%% (ASCII versions of ``Logos" such as `BibTeX')
@@ -267,18 +320,46 @@
\@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone}
\AtBeginDocument {\let\pkgnamefmt\textsf}
%%
-%% === TUG ===
+%% === \acro{CTAN} Announcements === %% 2011/06/27
+%% |\ctanannref{<id>}{<text>}| makes <text> a link
+%% to the DANTE web page displaying a \acro{CTAN}
+%% announcement. You find <id> by searching
+%% \[\texttt{https://lists.dante.de/pipermail/ctan-ann/}\]
+%% and then reading the \acro{URL}.
+%% <id> is composed as `<year>-<month>/<6-digits>.html'.
+\newcommand*{\ctanannref}[1]{%
+ \httpsref{lists.dante.de/pipermail/ctan-ann/#1}}
+%% |\ctanannpref{<id-code>}{<text>}| is a variant
+%% of `\ctanannref' where in place of <id>
+%% you only type the third and fourth digit of the
+%% 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}).
+\newcommand*{\ctanannpref}[1]{%
+ \ctanannref{\TL@piper@parse#1/.html}}
+\def\TL@piper@parse#1-#2-#3/{%
+ #1-%
+ \ifcase #2\or
+ January\or February\or March\or April\or
+ May\or June\or July\or August\or
+ September\or October\or November\or December% 2010/12/23
+ \fi
+ /#3}
+%%
+%% === \acro{TUG} ===
%% |\tugref{<path>}{<text>}| makes <text> a link
%% to <path> on domain `tug.org':
\newcommand*{\tugref}[1]{\httpref{tug.org/#1}}
%% ==== texhax ====
%% |\texhaxref{<id>}{<text>}| makes <text> a link
-%% to the TUG web page displaying
+%% to the \acro{TUG} web page displaying
%% a texhax posting. You find <id> by searching
-%% `tug.org/pipermail/texhax/' and then reading the URL.
+%% `tug.org/pipermail/texhax/' and then reading the \acro{URL}.
+%% <id> is composed as `<year>-<month>/<6-digits>.html'.
+\newcommand*{\texhaxref}[1]{\tugref{pipermail/texhax/#1}}
%% |\THref{<id>}| saves you from choosing <text>
%% and uses `texhax' instead.
-\newcommand*{\texhaxref}[1]{\tugref{pipermail/texhax/#1}}
\newcommand*{\THref}[1]{\texhaxref{#1}{texhax}}
%% (It was `\prg{texhax}' in 'blog.sty', to have something
%% logo-like, without a good idea how to implement it.)
@@ -287,38 +368,43 @@
%% of `\texhaxref' where in place of <id>
%% you only type the third and fourth digit of the
%% year, then a `-', then the (arabic) number of
-%% the month, then another `-', and then actual
+%% the month, then another `-', and then the actual
%% internal identifier
-%% (a number of six digits preceding `.html' of the URL).
+%% (a number of six digits preceding `.html' of the \acro{URL}).
%% I made this macro because I prefer typing to copying
-%% from the URL.
-\newcommand*{\texhaxpref}[1]{% %% 2010/09/07
- \texhaxref{20\@texhax@parse#1/.html}}
-\def\@texhax@parse#1-#2-#3/{%
- #1-%
- \ifcase #2\or
- January\or February\or March\or April\or
- May\or June\or July\or August\or
- September\or October\or November\or December% 2010/12/23
- \fi
- /#3}
+%% from the \acro{URL}.
+\newcommand*{\texhaxpref}[1]{% %% 2010/09/07
+ \texhaxref{20\TL@piper@parse#1/.html}} %% 2011/05/03
%% TODO: `\texhaxPref#1' searches list of offsets
%% to determine year/month from id
%%
-%% ==== Other ====
-%% |\tugbartref{<filename-base>}{<text>}| makes <text>
-%% a link to the TUGboat article `<filename-base>.pdf':
-\newcommand*{\tugbartref}[1]{\tugref{TUGboat/Articles/#1.pdf}}
+%% ==== Other ====
+%% %% 2011/04/27 corr. doc. vol/issue
+%% |\tugbartref{tb<vol>-<issue>/<filename-base>}{<text>}|
+%% makes <text> a link to the TUGboat article
+%% `<filename-base>.pdf' in vol.~<vol> and issue~<issue>:
+% \newcommand*{\tugbartref}[1]{\tugref{TUGboat/Articles/#1.pdf}}
+\newcommand*{\tugbartref}[1]{\tugref{TUGboat/#1.pdf}}
+%% %% <- 2011/04/30
%% |\TUGIref{<anchor>}{<text>}| makes text a link to an <anchor>
-%% on the TUG web page entitled \qtd{TeX Resources on the Web}
+%% on the \acro{TUG} web page entitled \qtd{TeX Resources on the Web}
%% (e.g., \TUGIref{web}{\qtd{Web Projects}}):
\newcommand*{\TUGIref}[1]{\tugref{interest.html\##1}}
%%
-%% === 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{<language-code>}{<file>}{<text>}|:
+\newcommand*{\wikibooksref}[2]{\httpref{#1.wikibooks.org/wiki/#2}}
+%% |\wikibooks{<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
\endinput
@@ -330,3 +416,13 @@ v0.2 2011/01/27 \urlfoot, \NormalHTTPref, \foothttpurlref,
more consistent use of \newcommand and
\@ifdefinable (TODO: guarded \let)
v0.3 2011/02/10 [blog]; \urlpkgfoot
+v0.4 2011/04/27 doc. \tugbartref\ corrected
+ 2011/04/30 shortened link in \tugbartref
+ 2011/05/03 \TL@piper@parse, tried \ctanannref
+ 2011/05/13 reworking Wikipedia, arbitrary languages
+ 2011/06/27 doc.: \acro; \httpsref, \ctanannref
+ 2011/07/23 doc.: typo \acro{TUG}, `Almost all', page breaks;
+ \Wikidisambref: different order of arg.s
+ 2011/08/18 doc.: \acro with UK; wikibooks
+ 2011/08/27 doc. \acro with URL and PDF;
+ more doc and code changes for https