diff options
author | Karl Berry <karl@freefriends.org> | 2011-09-03 23:13:56 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-09-03 23:13:56 +0000 |
commit | ea16ae60028a1e6e1820c3a99a66a74369259f8c (patch) | |
tree | fde2a436c9b9a938da63173bdcee14495fe4172c /Master/texmf-dist/tex/latex/morehype/texlinks.sty | |
parent | 320a834d2e64000bb5ba96aa67dfcc2435ad26f8 (diff) |
morehype update (1sep11)
git-svn-id: svn://tug.org/texlive/trunk@23781 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype/texlinks.sty')
-rw-r--r-- | Master/texmf-dist/tex/latex/morehype/texlinks.sty | 330 |
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 |