From 5ab401f066bdbf32ae3ca4b1be2e9783f203054b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 4 Jan 2013 23:29:05 +0000 Subject: morehype (4jan13) git-svn-id: svn://tug.org/texlive/trunk@28730 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/tex/latex/morehype/blog.sty | 56 ++++-- Master/texmf-dist/tex/latex/morehype/blogdot.sty | 5 +- Master/texmf-dist/tex/latex/morehype/morehype.RLS | 5 +- Master/texmf-dist/tex/latex/morehype/texblog.fdf | 27 ++- Master/texmf-dist/tex/latex/morehype/texlinks.sty | 197 ++++++++++++++++------ 5 files changed, 208 insertions(+), 82 deletions(-) (limited to 'Master/texmf-dist/tex') diff --git a/Master/texmf-dist/tex/latex/morehype/blog.sty b/Master/texmf-dist/tex/latex/morehype/blog.sty index e6b4fc532c7..c2cd6ffd7d9 100644 --- a/Master/texmf-dist/tex/latex/morehype/blog.sty +++ b/Master/texmf-dist/tex/latex/morehype/blog.sty @@ -1,5 +1,5 @@ -\ProvidesPackage{blog}[2012/12/20 v0.81 simple fast HTML (UL)] -%% copyright (C) 2010 2011 2012 Uwe Lueck, +\ProvidesPackage{blog}[2013/01/04 v0.81 simple fast HTML (UL)] +%% copyright (C) 2010 2011 2012 2013 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. %% @@ -797,7 +797,7 @@ %% %% % \pagebreak %% 2012/07/30 rm. 2012/09/13 %% == Characters/Symbols == %% `Symbols' until 2011/09/25 -%% === Basic Preliminaries === +%% === Basic Preliminaries === %% |&| is made `other' for using it to call \HTML's %% ``character entities." %% dot inside 2011/02/25 \MakeOther\& @@ -823,7 +823,7 @@ \renderHTMLsymbol{\&}{amp} \let\%\PercentChar %% -%% === Diacritics === %% changed 2011/03/04 +%% === Diacritics === %% changed 2011/03/04 %% For the difference between \dqtd{diacritic} and %% \dqtd{accent,} see \wikienref{Diacritic}{\meta{Wikipedia.}} %% @@ -843,13 +843,35 @@ \renewcommand*{\`}[1]{grave;} \renewcommand*{\"}[1]{uml;} %% %% 2012/05/13: -%% former |\uml{}| is obsolete, use |\"| +%% ... former |\uml{}| is obsolete, use |\"| %% (or `\"') instead. %% % may have been overestimated: %% % (useful in macro definitions): %% 2010/11/13 %% % \newcommand* {\uml}[1] {uml;} %% 2010/08/24 %% -%% === Greek === %% 2011/02/26 +%% %% 2013/01/01: +%% |\v{}| just works with $=`s'$ and $=`S'$ +%% for \v{s} and \v{S}: +\renewcommand*{\v}[1]{#1caron;} +%% +%% === Ligatures and the Like === %% 2013/01/01 +%% |\lig{}| forms a ligature from and : +\newcommand*{\lig}[1]{lig;} +%% With v0.81, we use this to reimplement +%% |\ss| from Plain~\TeX\ and \LaTeX\ for the +%% putative %% 2013/01/01 +%% ``s-z ligature", the German ``\Wikienref{sharp s}" +%% (``\ss"): %% 2013/01/01 +% \renderHTMLsymbol{\ss}{szlig} +\renewcommand*{\ss}{\lig{sz}} +%% |\AE|, |\ae|, |\OE|, |\oe| (``\AE", ``\ae", ``\OE", ``\oe") +%% are reimplemented likewise: +\renewcommand*{\AE}{\lig{AE}} +\renewcommand*{\ae}{\lig{ae}} +\renewcommand*{\OE}{\lig{OE}} +\renewcommand*{\oe}{\lig{oe}} +%% +%% === Greek === %% 2011/02/26 \declareHTMLsymbols{{Alpha}{alpha} %% 2012/01/06 {Beta}{beta}{Gamma}{gamma}{Delta}{delta}{Epsilon}{epsilon} {Zeta}{zeta}{Eta}{eta}{Theta}{theta}{Iota}{iota}{Kappa}{kappa} @@ -859,7 +881,7 @@ {Omega}{omega} %% render -> declare 2011/02/26 {thetasym}{upsih}{piv} } %% -%% === Arrows === +%% === Arrows === %% ---somewhat completed 2012/07/25. %% %% |\downarrow|, |\leftarrow|, |\leftrightarrow|, |\rightarrow|, |\uparrow|: @@ -883,7 +905,7 @@ %% named ``downwards arrow with tip leftwards" in Unicode (U+21b2): \newcommand*{\crarrow}{↵} %% 2012/09/13 %% -%% === Dashes === +%% === Dashes === %% The ligatures `--' and `---' for en~dash and em~dash %% don't work in our expanding mode. Now, \HTML's policy %% for choosing names often prefers shorter names than @@ -896,7 +918,7 @@ \def \endash {–} %% \end... illegal \newcommand*{\emdash} {—} %% -%% === Spaces === +%% === Spaces === %% ``Math" (not only!)\ spaces |\,|, |\enspace|, |\quad|, |\qquad|: %% %% <- 2011/04/26 \renderHTMLsymbol{\enspace}{ensp} @@ -916,7 +938,7 @@ %% (U+2007, cf.~\wikienref{Figure space}{\meta{Wikipedia}}): \newcommand*{\figurespace}{&\#8199;} %% -%% === Quotes, Apostrophe === +%% === Quotes, Apostrophe === %% \label{sec:quotes} %% |\lq|, |\rq| \renderHTMLsymbol{\lq} {lsquo} @@ -980,7 +1002,7 @@ %% |\sfrac{1}{2}|, |\sfrac{1}{4}|, and |\sfrac{3}{4}| work so far: \newcommand*{\sfrac}[2]{&frac#1#2;} %% -%% === Math === +%% === Math === %% %% divided/reordered section 2012/08/07 %% ==== Symbols ==== %% (\TeX\ math type ``Ord")---|\aleph|: @@ -1066,12 +1088,12 @@ \declareHTMLsymbol{sum} %% %% -%% === Currencies === %% 2012/08/06 +%% === Currencies === %% 2012/08/06 %% |\cent|, |\currency|, |\euro|, |\pound|, |\yen|: %% ...symbols 2012/08/07: \declareHTMLsymbols{{cent}{currency}{euro}{pound}{yen}} %% You get the \$ symbol simply by |$|. %% -%% === Other === +%% === Other === %% The tilde |~| is used for its wonderful purpose, %% by analogy to \TeX (TODO overridden by `\FDpseudoTilde'): \renderHTMLsymbol{~}{nbsp} @@ -1085,10 +1107,6 @@ %% % \edef#2{\expandafter\@gobble\string#1}} %% Horizontal ellipsis: |\dots| ... \renderHTMLsymbol {\dots} {hellip} -%% %% 2012/05/13: -%% |\ss| from Plain~\TeX\ and \LaTeX\ is used for the ``s-z ligature", -%% the German ``\Wikienref{sharp s}": -\renderHTMLsymbol{\ss}{szlig} %% Plain~\TeX's and \LaTeX's |\-| becomes a soft hyphen: \renderHTMLsymbol{\-}{shy} %% |\copyright|: @@ -1585,4 +1603,6 @@ v0.8 2012/06/07 \underbar 2012/11/29 `blogligs.sty', `markblog.sty' ([ligs], [mark]) part of MOREHYPE RELEASE r0.7 v0.81 2012/12/20 \-, {enumtype} -part of MOREHYPE RELEASE r0.8 + 2013/01/02 caron, "Ligatures ..." (æ etc.) + 2013/01/04 updating copyright +part of MOREHYPE RELEASE r0.81 diff --git a/Master/texmf-dist/tex/latex/morehype/blogdot.sty b/Master/texmf-dist/tex/latex/morehype/blogdot.sty index a54c9d08603..104c791df07 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}[2012/11/21 v0.41 HTML presentations (UL)] +\ProvidesPackage{blogdot}[2013/01/04 v0.41a HTML presentations (UL)] %% copyright (C) 2011 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. @@ -300,7 +300,7 @@ } \TryBlogDotCFG %% -%% \pagebreak %% 2012/11/21 +%% %% rm. \pagebreak 2013/01/04 %% == The End and HISTORY == \endinput %% VERSION HISTORY @@ -329,3 +329,4 @@ v0.4 2011/10/21 \usecurrdirctan part of morehype RELEASE r0.6 v0.41 2012/11/19 \startscreenpage with \\; doc. \ 2012/11/21 updating version infos, doc. \pagebreak +v0.41a 2013/01/04 rm. \pagebreak diff --git a/Master/texmf-dist/tex/latex/morehype/morehype.RLS b/Master/texmf-dist/tex/latex/morehype/morehype.RLS index ac20a063628..4e57f6725ab 100644 --- a/Master/texmf-dist/tex/latex/morehype/morehype.RLS +++ b/Master/texmf-dist/tex/latex/morehype/morehype.RLS @@ -1,7 +1,10 @@ \ProvidesFile{morehype.RLS} %% RELEASE INFO - [2012/12/20 r0.8 texlinks v0.8 tug.ctan..., + [2013/01/04 r0.81 texlinks v0.81 www.ctan..., blog v0.81 enum..., blogexec v0.21 noblog] + [2012/12/20 r0.8 texlinks v0.8 tug.ctan..., + blog v0.81 enum..., + blogexec v0.21 noblog - NOT INSTALLED] [2012/12/08 r0.71 texlinks.sty v0.71 \string\ctanannpref\space corr.] [2012/12/07 r0.7b blog.sty wiki-like | texlinks documentation fix] diff --git a/Master/texmf-dist/tex/latex/morehype/texblog.fdf b/Master/texmf-dist/tex/latex/morehype/texblog.fdf index fc027745c17..58e8f9f64df 100644 --- a/Master/texmf-dist/tex/latex/morehype/texblog.fdf +++ b/Master/texmf-dist/tex/latex/morehype/texblog.fdf @@ -1,4 +1,4 @@ -\ProvidesFile{texblog.fdf}[2012/12/20 extra blog settings] +\ProvidesFile{texblog.fdf}[2013/01/04 extra blog settings] %% %% macros I use for my note pages %% -- Uwe Lueck, www.contact-ednotes.sty.de.vu @@ -334,11 +334,21 @@ % \newcommand*{\Wiktderef}[1]{\wiktionarylangref{de}{#1}{#1}} % \newcommand*{\Wiktref}[1]{% %% 2012/01/13 % \wiktionarylangref\langcode{#1}{#1}} -%% <- 2012/01/13 -> -\newcommand*{\Wiktionarylangref}[2]{% - \wiktionarylangref{#1}{#2}{#2}} -\newcommand*{\Wiktderef}{\Wiktionarylangref{de}} -\newcommand*{\Wiktenref}{\Wiktionarylangref{en}} +% %% <- 2012/01/13 -> +% \newcommand*{\Wiktionarylangref}[2]{% +% \wiktionarylangref{#1}{#2}{#2}} +%% 2012/12/25 +\newcommand*{\Wiktionarylangref}{% + \@double@first@arg\wiktionarylangref} +% \newcommand*{\Wiktderef}{\Wiktionarylangref{de}} +%% <- 2012/12/25 -> +\newcommand*{\wiktderef}{\wiktionarylangref{de}} +\newcommand*{\Wiktderef}{\@double@first@arg\wiktderef} +\newcommand*{\wiktref}{\wiktionarylangref\langcode} +% \newcommand*{\Wiktenref}{\Wiktionarylangref{en}} +%% <- 2012/12/25 -> +\newcommand*{\wiktenref}{\wiktionarylangref{en}} +\newcommand*{\Wiktenref}{\@double@first@arg\wiktenref} \newcommand*{\Wiktref}{\Wiktionarylangref\langcode} %% 2011/11/23, 2012/01/06, 2012/03/11: \newcommand*{\wikiquotelangref}[1]{% @@ -381,6 +391,8 @@ % \newcommand*{\todobytopic}[1]{% %% 2011/04/22, rm. 2011/11/08 % \myalert{\to\ \TOPref{#1}}} \newcommand*{\UKFAQref}[1]{\ukfaqref{#1}{UK~FAQ}} %% 2011/01/03 +\useTUGctanbases %% 2012/12/30 +% \renewcommand*{\ctanpkgauref}{\tugctanpkgauref} %% 2012/12/30 rm. 2013/01/04 %% SelfHTML: \newcommand*{\selfhtmlurl}{de.selfhtml.org} \newcommand*{\selfhtmlref}{\httpbaseref\selfhtmlurl} @@ -388,7 +400,6 @@ \selfhtmlref{/html/referenz/#1.htm}} \newcommand*{\selfhtmlcsseigref}{% %% 2012/09/23 \httpbaseref{\selfhtmlurl/css/eigenschaften}} - %% BlogLIGs moves to `markblog.sty' 2012/11/28 %% rm. HVspace etc. 2011/10/13 %% font switching (logical): @@ -442,7 +453,7 @@ {WP} %% 2012/10/06 \StopDoing %% 2012/02/07 -%% use \ParseLigs -- moves to `texblog.fdf' 2012/11/29 +%% use \ParseLigs -- moves to `blogligs.sty' 2012/11/29 %% corr. 2012/12/21 %% dashes: % \newcommand*{\enpardash}{\,\emdash\,} %% 2011/05/12 %% language-specific appear in `langcode.sty' diff --git a/Master/texmf-dist/tex/latex/morehype/texlinks.sty b/Master/texmf-dist/tex/latex/morehype/texlinks.sty index 2ba0585b1db..d14dd78dca7 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}[2012/12/20 v0.8 TeX-related links (UL)] +\ProvidesPackage{texlinks}[2012/12/31 v0.81 TeX-related links (UL)] %% copyright (C) 2011 2012 Uwe Lueck, %% http://www.contact-ednotes.sty.de.vu %% -- author-maintained in the sense of LPPL below. @@ -72,14 +72,23 @@ %% 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' +%% `\providecommand' will be used so that the user may choose %% 2012/12/28 +%% the style before loading 'texlinks'. +%% (Once I may provide a variant of `\providecommand' %% 2012/12/28 +%% that postpones the ``provision" to the ``beginning" of the +%% ``document", even with 'blog.sty' TODO) %% -%% It is usual to use `\texttt' for formatting \TeX\ code +%% It is usual to use +%% the same font as with %% 2012/12/28 +%% `\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{}| as follows: \providecommand*{\urlfmt}{\texttt} +%% The user may (later) choose a more advanced treatment by +%% loading \ctanpkgstyref{url} and +%% \[`\renewcommand{\urlfmt}{\url}'\] +%% %% The file name format |\filenamefmt{}| %% may differ from the format for \URL s---if somebody %% wants/adjusts it, \emph{here} it is the \emph{same:} @@ -88,6 +97,9 @@ %% 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 ... +%% +%% (TODO 2012/12/29: This section seems to be relevant for +%% \secref{url-text} only and might move there.) %% %% %% Instead of |\pkgnamefmt{}|, %% %% 'blog.sty' had `\pkg{}', %% was `prg' 2011/10/20 @@ -100,7 +112,8 @@ % \@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone} % \AtBeginDocument {\let\pkgnamefmt\textsf} %% <- This was here until v0.7, makes a difference for \acro{PDF} -%% vs.\ 'blog' \HTML. Now we choose the same as with `\urlfmt': +%% vs.\ 'blog'/\HTML. %% / 2012/12/28 +%% 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 @@ -153,7 +166,8 @@ %% With |\urlhttpsref{}|, we \emph{force} displaying \qtd{`https://'}: \newcommand*{\urlhttpsref}[1]{\httpsref{#1}{\urlfmt{https://#1}}} %% -%% ==== The \URL\ as the Link Text Phrase ==== +%% ==== The \URL\ (or a Part) as the Link Text Phrase ==== %% (...) 2012/12/28 +%% \label{sec:url-text} %% With |\urlhttpref{}|, that \URL\ is displayed: \newcommand*{\urlhttpref}[1]{% \NormalHTTPref{#1}{\urlfmt{\httpprefix#1}}} @@ -170,7 +184,7 @@ %% to say about the same matter, such as the web versions %% of newspapers or magazines. So you may compare how %% \domainref{www.ctan.org}{pkg/morehype} and -%% \domainref{tug.ctan.org}{pkg/morehype} inform about +%% \domainref {\tugctanorg}{pkg/morehype} inform about %% \tugc... 2012/12/29 %% the 'morehype' bundle (v0.8). %% The command is also used in \secref{wiki-stack} %% for `tex.stackexchange.com'. @@ -200,18 +214,28 @@ %% \begin{example}\leavevmode %% \[`\CtanPkgRef{morehype}{MoreHype}' %% \mbox{\quad and\quad } `\ctanpkgref{morehype}'\] -%% are provided below for linking to +%% are provided in \secref{sing-pkgs} for linking to %% `http://ctan.org/pkg/morehype'. %% \begin{itemize} -%% \item Try `CtanPkgRef' \emph{here}: -%% \CtanPkgRef{morehype}{MoreHype},\\ -%% for the \emph{footnote} try -%% `\urlfoot{CtanPkgRef}{morehype}';%%% -%% \urlfoot{CtanPkgRef}{morehype} -%% \item try `ctanpkgref' \emph{here}: \ctanpkgref{morehype},\\ -%% for the \emph{footnote} try -%% `\urlfoot{ctanpkgref}{morehype}'.%%% -%% \urlfoot{ctanpkgref}{morehype} +%% \item +%% % Try `CtanPkgRef' \emph{here}: +%% % \CtanPkgRef{morehype}{MoreHype},\\ +%% % for the \emph{footnote} try +%% % `\urlfoot{CtanPkgRef}{morehype}';%%% +%% % \urlfoot{CtanPkgRef}{morehype} +%% \simpleyields{\CtanPkgRef{morehype}{MoreHype}} %% etc. 2012/12/30 +%% \item +%% \simplecodefbox{\urlfoot{CtanPkgRef}{morehype}} +%% yields \urlfoot{CtanPkgRef}{morehype} +%% \item +%% % try `ctanpkgref' \emph{here}: \ctanpkgref{morehype},\\ +%% \simpleyields{\ctanpkgref{morehype}} +%% \item +%% % for the \emph{footnote} try +%% % `\urlfoot{ctanpkgref}{morehype}'.%%% +%% % \urlfoot{ctanpkgref}{morehype} +%% \simplecodefbox{\urlfoot{ctanpkgref}{morehype}} +%% yields \urlfoot{ctanpkgref}{morehype} %% \end{itemize} %% The lonely \qtd{\pkgnamefmt{morehype}} you see there above %% demonstrates that it doesn't work with `ctanpkgref' because @@ -293,6 +317,7 @@ %% \end{document} %% \end{verbatim} %% You may find it as `wiki_mwe.tex' with outcome `wiki_mwe.pdf'. +%% See \secref{langcode} for more examples. %% 2012/12/30 %% %% Apart from `\langcode', more advanced things are %% \emph{disambiguation} (\secref{wiki-back}), @@ -429,10 +454,15 @@ %% and adjusts a number of other settings. \newcommand*{\wikiref}{\wikilangref\langcode} %% %% adding args 2012/12/17: -%% |\Wikiref{}| and |Wikidisambref{}{}| +%% |\Wikiref{}| and |\Wikidisambref{}{}| %% second \ 2012/12/29 %% are the obvious analogues (cf. \secref{wiki-back}): \newcommand*{\Wikiref}{\Wikilangref\langcode} \newcommand*{\Wikidisambref}{\Wikilangdisambref\langcode} +%% \begin{simpleexamples} +%% \simpleexample{\Wikiref{LaTeX}} +%% \simpleexample{\wikiref{LaTeX}{&\LaTeX}} +%% \simpleexample{\Wikidisambref{Latex}{disambiguation}} +%% \end{simpleexamples} %% %% === Blanks and Umlauts in \URL s and Anchors === %% \label{sec:wiki-urls} @@ -501,22 +531,52 @@ \newcommand*{\html}{.html} %% %% === \CTAN === +%% ==== Former `tug.ctan.org' ==== %% 2012/12/29 +%% \label{sec:tug.ctan.org} +%% Apparently on 2012-12-21, `tug.ctan.org' ceased to refer +%% to the \CTAN\ interface that Jim Hef{}feron had developed, +%% and it has no longer provided a \TeX\ archive or package descriptions. +%% This killed many links generated by 'texlinks', and +%% `\tugctanref' and `\usetugctan' from v0.41 as well as +%% `\TugCtanPkgRef' and `\useTUGpkgpages' (among others) +%% from v0.8 that I uploaded 2012-12-20 became useless. +%% +%% I am now trying to make sense of these 'texlinks' macros +%% for a while, in order to avoid changing existing code +%% (in my package documentations and on my web pages). +%% For this purpose, |ctan.tug.org| and |alan.smcvt.edu| +%% seem to be good domains. I have been warned that this +%% may stop working soon again. So I do \strong{not recommend} +%% typing new code containing macros whose names contain `tugctan'. +%% +%% Also for later documentation +%% (\secref{search-pkg}, \secref{x.ctan.org}), +%% I introduce |\tugctanorg|, with a very counter-intuitive +%% definition due to what I have mentioned +%% (and to get intuitive interrelations instead): +\newcommand*{\tugctanorg}{ctan.tug.org} +%% (TODO: cf. \secref{tug}) +%% %% ==== 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{}{}|\] %% \[...\] 2012/12/19 +%% hopefully %% 2012/12/29 %% makes a link -%% to a \TeX~Archive directory or file . -%% |\ctanorg| saves a few tokens: %% 2012/12/18 -\newcommand*{\ctanorg}{.ctan.org} -\newcommand*{\tugctanref}{\httpbaseref{tug\ctanorg/tex-archive}} +%% to a \TeX~Archive directory or file +%% with Jim Hef{}feron's interface. %% 2012/12/29 +\newcommand*{\tugctanref}{\httpbaseref{\tugctanorg/tex-archive}} +%% \simpleexample{\tugctanref{}{Archive root}} %% Alternatively, you can refer to an (automatically chosen) %% \CTAN\ \emph{mirror} %% using %% \[|\mirrorctanref{}{}|.\] %% 2011/10/10 :->.2011/10/21: -%% (I prefer the \emph{appearance} of the -%% \tugctanref{}{\TUG\ archive}, designed by Jim Hefferon.) +%% % (I prefer the \emph{appearance} of the %% rm. 2012/12/29 +%% % \tugctanref{}{\TUG\ archive}, designed by Jim Hefferon.) +%% |\ctanorg| saves a few tokens: %% 2012/12/18, mv. down 2012/12/29 +\newcommand*{\ctanorg}{.ctan.org} \newcommand*{\mirrorctanref}{\httpbaseref{mirror\ctanorg}} +%% \simpleexample{\mirrorctanref{}{Archive root}} %% You may actually want to ``open" a file in %% on \CTAN, %% displayed as the link text, %% 2011/10/21 @@ -531,6 +591,13 @@ %% Typically, \LaTeX\ macro packages in `macros/latex/contrib/' %% are discussed, so here is |\ltxcontrib| saving a few characters: \newcommand*{\ltxcontrib}{macros/latex/contrib/} +%% So \[\simplecodefbox{% +%% \mirrorctanref{&\ltxcontrib morehype}{&\pkg{morehype}}}\] +%% yields \simplecodeoutfbox{% +%% \mirrorctanref {\ltxcontrib morehype}{&\pkg{morehype}}}. +%% %% <- & doesn't work in first arg. of \href 2012/12/30 +%% %% -> `replace.sty'? +%% %% |\ctanref| works like `\tugctanref' or like `\mirrorctanref', %% depending on |\usetugctan| vs.\ |\usemirrorctan|. %% So in any case its syntax is \[|\ctanref{}{}|.\] @@ -550,6 +617,10 @@ %% |\ctanref| and |\ctanfileref| use %% \urlhttpref{mirror.ctan.org}: \usemirrorctan +%% So +%% \simplecodefbox {\ctanref{&\ltxcontrib morehype}{&\pkg{morehype}}} +%% yields +%% \simplecodeoutfbox{\ctanref {\ltxcontrib morehype}{&\pkg{morehype}}}. %% \meta{Remark} (TODO): \ Another implementation I consider is %% using some `\ctanurl'\-`prefix' that you can redefine for %% accessing your favourite mirror. @@ -571,7 +642,7 @@ %% of \meta{The \TeX~Catalogue OnLine}: \newcommand*{\catalogueref}[1]{\mirrorctanref{help/Catalogue/#1}} %% Some mirrors seem to display the Catalogue's root directory -%% only this way, while others display ``Welcome" page. +%% only this way, while others display the ``Welcome" page. %% |\cataloguestartref{}| accesses the %% \cataloguestartref{\strong{Welcome} (\strong{start})} page surely: \newcommand*{\cataloguestartref}{\catalogueref{index\html}} @@ -638,40 +709,44 @@ %% pages under that domain have been changed in December %% and no longer call themselves ``Jim Hef{}feron's." %% The latter's pages seem to stay available under -%% `tug.ctan.org'. Major contentual differences at present +%% \urlfmt{\tugctanorg}. Major contentual differences at present %% (2012-12-18) seem to be: %% \begin{enumerate} %% \item `www.ctan.org' classifies packages by a new concept -%% of ``topics," while `tug.ctan.org' classifies them +%% of ``topics," while \urlfmt{\tugctanorg} classifies them %% by ``\strong{keywords}" as well as %% by ``\strong{char\-ac\-teri\-za\-tions}" out of which one is %% ``primary" and others are ``secondary." -%% \item `tug.ctan.org' like the Catalogue as in \secref{texcat} +%% \item \urlfmt{\tugctanorg} like the Catalogue as in \secref{texcat} %% provides links to single documentation files, %% unlike `www.ctan.org'. %% \end{enumerate} %% %% In order to keep as much as possible, I introduce new %% `\tugctan'\codedots\ and `\wwwctan'\codedots\ commands. -%% The first ones link to `tug.ctan.org', the others to +%% The first ones link to \urlfmt{\tugctanorg} +%% (see \secref{tug.ctan.org} for why), the others to %% `www.ctan.org'. The user may choose whether the -%% `\ctan'\codedots\ commands link to `tug.ctan.org' or to -%% `www.ctan.org'. +%% `\ctan'\codedots\ commands link to \urlfmt{\tugctanorg} +%% or to `www.ctan.org'. %% -%% |\tugctanorgbaseref{}{}| \ links to `tug.ctan.org' +%% |\tugctanorgbaseref{}{}| \ links to \urlfmt{\tugctanorg} %% independently of the choice for `\ctanorgbaseref': -\newcommand*{\tugctanorgbaseref}{\httpbaseref{tug\ctanorg}} +\newcommand*{\tugctanorgbaseref}{\httpbaseref\tugctanorg} %% |\wwwctanorgbaseref{}{}| \ links to `www.ctan.org' %% independently of the choice for `\ctanorgbaseref': \newcommand*{\wwwctanorgbaseref}{\httpbaseref{www\ctanorg}} %% |\useTUGctanbases| \ lets `\ctanorgbaseref' be `\tugctanorgbaseref': \newcommand*{\useTUGctanbases}{\let\ctanorgbaseref\tugctanorgbaseref} -%% |\ctanorgbaseref{}{}| \ aims to get Jim Hef{}feron's +%% `\ctanorgbaseref{}{}' before v0.81 aimed to get Jim Hef{}feron's %% pages via `\tugctanorgbaseref' by default: -\useTUGctanbases -%% To get the `www.ctan.org' interface instead, -%% issue |\useWWWctanbases|: +% \useTUGctanbases +%% ... but that is bad when the future of \urlfmt{\tugctanorg} is unclear. +%% Therefore, \ +%% |\useWWWctanbases| \ will choose `www.ctan.org' to look for package +%% descriptions as the default instead (as of v0.81): \newcommand*{\useWWWctanbases}{\let\ctanorgbaseref\wwwctanorgbaseref} +\useWWWctanbases %% %% ==== Single Packages without The \TeX~Catalogue ==== %% \label{sec:sing-pkgs} %% 2012/12/19 @@ -690,14 +765,14 @@ %% adds \qtdcode{.sty} to the package name: \newcommand*{\ctanpkgstyref}[1]{\CtanPkgRef{#1}{#1.sty}} %% The previous commands for package info pages choose between -%% `tug.ctan.org' and `www.ctan.org' according to +%% \urlfmt{\tugctanorg} and `www.ctan.org' according to %% `\useTUGctanbases' or `\useWWWctanbases' %% (i.e., `\ctanorgbaseref', \secref{x.ctan.org}). %% The next commands allow that choice independently of %% `\ctanorgbaseref', by contrast. %% |\useTUGpkgpages| may be issued to stick to the \TUG\ -%% package descriptions (from `CtanPkgRef') -%% even after `\useWWWctanorgbases' (useful? TODO): +%% package descriptions (from `CtanPkgRef'). +%% % even after `\useWWWctanorgbases' (useful? TODO): %% rm. 2012/12/29 \newcommand*{\TugCtanPkgRef}{\Ct@nPkgRef\tugctanorgbaseref} \newcommand*{\tugctanpkgref}{\@double@first@arg\TugCtanPkgRef} \newcommand*{\useTUGpkgpages}{\let\CtanPkgRef\TugCtanPkgRef} @@ -715,7 +790,7 @@ %% |\allpkgrefs{}|\] %% offering choice between the three interfaces for each package. %% \qtdcode{c} will stand for The \TeX~Catalogue, -%% \qtdcode{t} for `tun.ctan.org', and +%% \qtdcode{t} for \urlfmt{\tugctanorg}, and %% \qtdcode{w} for `www.ctan.org'. After |\useALLpkgpages|, %% this is what `\CtanPkgRef' and `\ctanpkgref' offer: \newcommand*{\AllPkgRefs}[2]{% @@ -737,37 +812,45 @@ %% With the advent of ``the new `www.ctan.org'" announced on %% \ctanannpref{12-12-006718}{2012-12-12,} links generated %% by this command stopped working altogether. -%% For v0.8, we ``repair" the definition so that the claim -%% becomes true again. But ``the new `www.ctan.org'" also +%% For v0.8, we repaired the definition so that the claim +%% became true again---for a few days. +%% v0.81 changes the default, see \secref{x.ctan.org}. +%% But ``the new `www.ctan.org'" also %% provides its own author pages, and we offer a choice %% between both interfaces for the author pages. %% A little problem has been that the paths to these pages -%% differ between `tug.ctan.org' and `www.ctan.org' now. -%% +%% differ between \urlfmt{\tugctanorg} and `www.ctan.org' now. \newcommand*{\ctanpkgauref}[1]{\ctanorgbaseref{author/% -%% Only `tug.ctan.org' uses \qtdcode{id/}: +%% Only \urlfmt{\tugctanorg} uses \qtdcode{id/}: \ifx\ctanorgbaseref\tugctanorgbaseref id/\fi #1}} %% % \simpleexample{\ctanpkgauref{lueck}{&\emph{My} packages}} %% \simpleexample{\ctanpkgauref{lueck}{mine}} +%% %---On 2012-12-30, however, I see that with `ctan.org/author/id', +%% %\qtdcode{/id} is automatically removed. (TODO) +%% %% |\tugctanpkgauref{}{}| chooses Jim Hef{}feron's %% author pages even if `www.ctan.org' has been chosen to be %% the main interface for package descriptions (\secref{x.ctan.org}): \newcommand*{\tugctanpkgauref}[1]{\tugctanorgbaseref{author/id/#1}} %% \simpleexample{\tugctanpkgauref{lueck}{mine}} %% |\wwwctanpkgauref{}{}| chooses the new `www.ctan.org''s -%% author pages even if `tug.ctan.org' has been chosen to be +%% author pages even if \urlfmt{\tugctanorg} has been chosen to be %% the main interface for package descriptions (\secref{x.ctan.org}): \newcommand*{\wwwctanpkgauref}[1]{\wwwctanorgbaseref{author/#1}} %% \simpleexample{\wwwctanpkgauref{lueck}{mine}} +%% By the default settings as of v0.81, `\wwwctanpkgauref' %% 2012/12/30 +%% is equivalent to `\ctanpkgauref'. To change this, issue +%% \[`\renewcommand{\ctanpkgauref}{\tugctanpkgauref}'\] %% %% ==== Other Ways to Search for Packages ==== +%% \label{sec:search-pkg} %% 2012/12/29 %% |\ctanpkgtopicref{}{}| accesses a list of %% packages belonging to the ``topic" with identifier . \newcommand*{\ctanpkgtopicref}[1]{\wwwctanorgbaseref{topic/#1}} %% \simpleexample{\ctanpkgtopicref{cvt-html}{make HTML}} %% -%% `tug.ctan.org' and `www.ctan.org' offer more pages for which +%% \urlfmt{\tugctanorg} and `www.ctan.org' offer more pages for which %% I don't create own macros, while I use some of them on a %% \httpref{www.webdesign-bu.de/uwe_lueck/taeglich.htm} %% {page collecting my favourite links.} @@ -778,18 +861,18 @@ %% \begin{itemize} %% \item On \urlhttpref{www.ctan.org/author}, you can browse %% package authors. I could not find an equivalent -%% page under `tug.ctan.org'. -%% \item \urlhttpref{tug.ctan.org/search} and +%% page under \urlfmt{\tugctanorg}. +%% \item \urlhttpref{\tugctanorg/search} and %% \urlhttpref{www.ctan.org/search} offer different %% criteria for searches. %% \item On \urlhttpref{www.ctan.org/topic}, you can browse topics. %% This page in fact is accessed by `\ctanpkgtopicref{}' %% ( empty). Jim Hef{}feron's keywords %% %%% and characterizations -%% can be browsed on \urlhttpref{tug.ctan.org/keywords}. +%% can be browsed on \urlhttpref{\tugctanorg/keywords}. %% His characterizations can be browsed from -%% \urlhttpref{tug.ctan.org/characterization/choose\string_dimen}. -%% \item \urlhttpref{tug.ctan.org/pkg} is a single page listing +%% \urlhttpref{\tugctanorg/characterization/choose\string_dimen}. +%% \item \urlhttpref{\tugctanorg/pkg} is a single page listing %% all package identifiers %% (for `\ctanpkgref{}', as links). %% %%% The corresponding @@ -887,6 +970,7 @@ \newcommand*{\stackoverref}{\stackquestionref{stackoverflow}} %% %% === \TUG === %% \TUG 2012/12/15 +%% \label{sec:tug} %% 2012/12/29 %% |\tugref{}{}| makes a link %% to on domain `tug.org': \newcommand*{\tugref}{\httpbaseref{tug.org}} @@ -1045,3 +1129,10 @@ v0.8 2012/12/15 \domainref from `texblog.fdf' 2012/12/19 \cat@ctan@pkg@ref, \@double@first@arg; doc. uses {example}, \fbox, etc. 2012/12/20 \ctanpkgtopicref +v0.81 2012/12/28 doc.: "fonts" \provide, corr. \pkgnamefmt, + reworked \urlfoot + 2012/12/29 \tugctanorg; doc.: TODO on "fonts", + more on Jim ... \tugctanorg + 2012/12/30 ... in sec:search-pkg; mod. doc. \ctanpkgauref, + more doc. wiki "overview", \simplecodefbox etc., + 2012/12/31 doc. "the" Welcome ... -- cgit v1.2.3