From fb89be74d746b6e35b71f8b952d60171a94703d9 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 23 Oct 2011 22:25:02 +0000 Subject: morehype (23oct11) git-svn-id: svn://tug.org/texlive/trunk@24369 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/morehype/RELEASEs.txt | 25 +++ Master/texmf-dist/doc/latex/morehype/SrcFILEs.txt | 28 +-- Master/texmf-dist/doc/latex/morehype/blog.pdf | Bin 537349 -> 540612 bytes .../doc/latex/morehype/demo/texblog/makehtml.tex | 6 +- Master/texmf-dist/doc/latex/morehype/texlinks.pdf | Bin 369402 -> 397107 bytes Master/texmf-dist/source/latex/morehype/blog.tex | 8 +- .../texmf-dist/source/latex/morehype/srcfiles.tex | 21 +- .../texmf-dist/source/latex/morehype/texlinks.tex | 8 +- Master/texmf-dist/tex/latex/morehype/blog.sty | 53 ++++-- Master/texmf-dist/tex/latex/morehype/blogdot.cfg | 7 +- Master/texmf-dist/tex/latex/morehype/blogdot.sty | 49 ++++- Master/texmf-dist/tex/latex/morehype/texlinks.sty | 212 ++++++++++++++------- 12 files changed, 291 insertions(+), 126 deletions(-) diff --git a/Master/texmf-dist/doc/latex/morehype/RELEASEs.txt b/Master/texmf-dist/doc/latex/morehype/RELEASEs.txt index 1b2a40cfb05..113d138d2ce 100644 --- a/Master/texmf-dist/doc/latex/morehype/RELEASEs.txt +++ b/Master/texmf-dist/doc/latex/morehype/RELEASEs.txt @@ -1,3 +1,28 @@ + + BUNDLE `morehype' RELEASES: + +r0.52 2011/10/23 choosing CTAN URLs, HTML towards hyperref +============================================================ +- `blogdot.sty' ("HTML beamer presentations") v0.4 + provides \usecurrdirctan for opening CTAN example files + from current directory (in case of bad internet access + during *presentation*, while *online* version uses CTAN) +- `texlinks.sty' v0.5: + - new \ctanref and \ctanfileref choose web source + according to new \usetugctan vs. \usemirrorctan + - changes treatment of fonts for URLs, file names, + and package names + - re-structures code and documentation +- `blog.sty' v0.62 + - provides \hyperlink and \hypertarget as aliases of + earlier blog.sty commands - towards + "HTML and PDF from same source" + - provides \textsf + - "updates" \textcolor +- `blog.pdf' links to fifinddo-info/dantev45.htm +- and a few documentation fixes + + r0.51 2011/10/15 blogdot.sty: HTML beamer presentations + more morehype changes ============================================================ diff --git a/Master/texmf-dist/doc/latex/morehype/SrcFILEs.txt b/Master/texmf-dist/doc/latex/morehype/SrcFILEs.txt index c203cd6fc6b..25334290cc8 100644 --- a/Master/texmf-dist/doc/latex/morehype/SrcFILEs.txt +++ b/Master/texmf-dist/doc/latex/morehype/SrcFILEs.txt @@ -1,25 +1,29 @@ *File List* + DOCSRC. + blog.tex 2011/10/21 documenting blog.sty +hypertoc.tex 2011/01/27 documenting hypertoc.sty +texlinks.tex 2011/10/21 documenting texlinks.sty +srcfiles.tex 2011/10/23 file infos -> SrcFILEs.txt + README.tex 2011/02/14 make README.pdf +NICETEXT. +fifinddo.sty 2011/10/23 v0.44 filtering TeX(t) files by TeX (UL) makedoc.sty 2011/10/12 v0.41b TeX input from *.sty (UL) niceverb.sty 2011/09/09 v0.44 minimize doc markup (UL) makedoc.cfg 2011/08/22 documentation settings mdoccorr.cfg 2011/10/13 local typographical corrections with makedoc.sty -srcfiles.tex 2011/10/10 file infos -> SrcFILEs.txt - blog.tex 2011/10/15 documenting blog.sty -hypertoc.tex 2011/01/27 documenting hypertoc.sty -texlinks.tex 2011/10/10 documenting texlinks.sty - README.tex 2011/02/14 make README.pdf - lang-de.fdf 2011/09/24 German settings for blog.sty - lang-en.fdf 2011/01/25 English settings for blog.sty - blog.sty 2011/10/15 v0.61 simple fast HTML (UL) + USE. hypertoc.sty 2011/01/23 v0.1 pretty TOC links (UL) -texlinks.sty 2011/10/10 v0.41 TeX-related links (UL) +texlinks.sty 2011/10/21 v0.5 TeX-related links (UL) + blog.sty 2011/10/22 v0.62 simple fast HTML (UL) lnavicol.sty 2011/10/13 left navigation column with blog.sty - blogdot.sty 2011/10/15 v0.3 HTML presentations (UL) - blogdot.cfg 2011/10/14 local blogdot.sty config + blogdot.sty 2011/10/22 v0.4 HTML presentations (UL) + lang-de.fdf 2011/09/24 German settings for blog.sty + lang-en.fdf 2011/01/25 English settings for blog.sty texblog.fdf 2011/10/13 extra blog settings + blogdot.cfg 2011/10/21 local blogdot.sty config *********** - List made at 2011/10/15, 20:00 + List made at 2011/10/23, 17:58 from script file srcfiles.tex diff --git a/Master/texmf-dist/doc/latex/morehype/blog.pdf b/Master/texmf-dist/doc/latex/morehype/blog.pdf index 67d9a1cddc1..c6608a4dfef 100644 Binary files a/Master/texmf-dist/doc/latex/morehype/blog.pdf and b/Master/texmf-dist/doc/latex/morehype/blog.pdf differ diff --git a/Master/texmf-dist/doc/latex/morehype/demo/texblog/makehtml.tex b/Master/texmf-dist/doc/latex/morehype/demo/texblog/makehtml.tex index 74ed9b39a03..d5823035f63 100644 --- a/Master/texmf-dist/doc/latex/morehype/demo/texblog/makehtml.tex +++ b/Master/texmf-dist/doc/latex/morehype/demo/texblog/makehtml.tex @@ -1,10 +1,10 @@ -\def \GenDate {2011/10/15} +\def \GenDate {2011/10/23} \ProvidesFile{makehtml.tex}[\GenDate\space HTML driver] \RequirePackage{blog,texlinks} \input{atari.fdf}\input{lang-en.fdf} -\input{texblog.fdf} %% 2011/09/24 +\input{texblog.fdf} %% 2011/09/24 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\input{jobname} %% write with "echo" +\input{jobname} %% write with "echo" % \def \htmljob %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % {texmap} diff --git a/Master/texmf-dist/doc/latex/morehype/texlinks.pdf b/Master/texmf-dist/doc/latex/morehype/texlinks.pdf index 40bef87256d..a1044d8505b 100644 Binary files a/Master/texmf-dist/doc/latex/morehype/texlinks.pdf and b/Master/texmf-dist/doc/latex/morehype/texlinks.pdf differ diff --git a/Master/texmf-dist/source/latex/morehype/blog.tex b/Master/texmf-dist/source/latex/morehype/blog.tex index 4e2663dda0e..9544e7c3a26 100644 --- a/Master/texmf-dist/source/latex/morehype/blog.tex +++ b/Master/texmf-dist/source/latex/morehype/blog.tex @@ -1,4 +1,4 @@ -\ProvidesFile{blog.tex}[2011/10/15 documenting blog.sty] +\ProvidesFile{blog.tex}[2011/10/21 documenting blog.sty] \title{\textsf{blog.sty}\\---\\% Generating \HTML\ Quickly with \TeX\thanks{This document describes version @@ -266,7 +266,10 @@ horizontically (cf.~Sec.~\ref{sec:dot-type}): \end{description} The so far single \strong{example} of a presentation prepared using 'blogdot' -is |dantev45.htm|, a sketch of applying 'fifinddo' to package +is \ctanfileref{info/fifinddo-info}{dantev45.htm} +%% <- 2011/10/21 -> +(\ctanpkgref{fifinddo-info} bundle), +a sketch of applying 'fifinddo' to package documentation and \HTML\ generation. A ``driver" file is needed for generating the \HTML\ code for the presentation from a `.tex' source by analogy to generating any \HTML\ file using 'blog.sty'. @@ -371,3 +374,4 @@ with morehype RELEASE r0.4 2011/10/11 limitations of blogdot, corrected makedoc code 2011/10/15 more on limitations of blogdot; abstract on lnavicol and blogdot +2011/10/21 links to fifinddo-info/dantev45.htm diff --git a/Master/texmf-dist/source/latex/morehype/srcfiles.tex b/Master/texmf-dist/source/latex/morehype/srcfiles.tex index 5e43b015635..e0b470663e7 100644 --- a/Master/texmf-dist/source/latex/morehype/srcfiles.tex +++ b/Master/texmf-dist/source/latex/morehype/srcfiles.tex @@ -1,16 +1,15 @@ \RequirePackage{myfilist} -\ProvidesFile{srcfiles.tex}[2011/10/10 file infos -> SrcFILEs.txt] +\ProvidesFile{srcfiles.tex}[2011/10/23 file infos -> SrcFILEs.txt] \EmptyFileList %%% [readprov.sty,myfilist.sty] -%% documentation settings and auxiliaries: -\ReadPackageInfos{makedoc,niceverb} -\ReadFileInfos{makedoc.cfg,mdoccorr.cfg,srcfiles} -%% documentation main sources: -\ReadFileInfos{blog,hypertoc,texlinks,README} %% examples: % \ReadFileInfos{makehtml,texmap} -%% blog.sty settings (TODO: documented?): -\ReadFileInfos{lang-de.fdf,lang-en.fdf} -%% packages: -\ReadPackageInfos{blog,hypertoc,texlinks,lnavicol,blogdot} -\ReadFileInfos{blogdot.cfg,texblog.fdf} +%% documentation settings and auxiliaries: +%% documentation main sources: +\ReadFileInfos{DOCSRC.,blog,hypertoc,texlinks,srcfiles,README} +\ReadFileInfos{NICETEXT.} +\ReadPackageInfos{fifinddo,makedoc,niceverb} +\ReadFileInfos{makedoc.cfg,mdoccorr.cfg} +\ReadFileInfos{USE.} +\ReadPackageInfos{hypertoc,texlinks,blog,lnavicol,blogdot} +\ReadFileInfos{lang-de.fdf,lang-en.fdf,texblog.fdf,blogdot.cfg} \ListInfos[SrcFILEs.txt] diff --git a/Master/texmf-dist/source/latex/morehype/texlinks.tex b/Master/texmf-dist/source/latex/morehype/texlinks.tex index a212013fd87..68d98630fc2 100644 --- a/Master/texmf-dist/source/latex/morehype/texlinks.tex +++ b/Master/texmf-dist/source/latex/morehype/texlinks.tex @@ -1,4 +1,4 @@ -\ProvidesFile{texlinks.tex}[2011/10/10 documenting texlinks.sty] +\ProvidesFile{texlinks.tex}[2011/10/21 documenting texlinks.sty] \title{{\Huge\textsf{texlinks.sty}}\\---\\\TeX-Related Links for \textsf{hyperref}, \textsf{blog.sty}\\ (and maybe more)\thanks{This @@ -17,6 +17,9 @@ \input{makedoc.cfg} %% shared formatting settings \usepackage{color} \newcommand*{\xmltagcode}[1]{\texttt{<#1>}} +\providecommand*{\CTAN}{\acro{CTAN}} +\providecommand*{\HTML}{\acro{HTML}} +\providecommand*{\URL} {\acro{URL}} \sloppy \begin{document} \maketitle @@ -26,7 +29,7 @@ with \ctanpkgref{hyperref}'s\urlpkgfoot{hyperref} `\href' command, linking to URLs that one often refers to in discussing \TeX-related material. Especially, \acro{TUG} material (including texhax postings and TUGboat articles) and -\acro{CTAN} pages (package descriptions, directories, Catalogue) +\CTAN\ pages (package descriptions, directories, Catalogue) are supported, also the UK~FAQ, the \LaTeX\ Wikibook, %% 2011/08/27 and Wikipedia @@ -71,3 +74,4 @@ VERSION HISTORY 2011/08/27 mentioning LaTeX Wikibook in abstract 2011/09/03 \Huge first line 2011/10/10 [fleqn] +2011/10/20 \HTML, \URL 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{}| TODO (see some `makehtml.tex') %% 2011/05/11 -%% +%% |\textsf{}| 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{}| marks as ``code," @@ -419,24 +425,32 @@ %% %% == Links == %% === Basic Link Macros === -%% |\hanc{}{}| makes an anchor with -%% \HTML\ label (like 'hyperref''s `\hypertarget'): +%% %% doc. fixes + hyperref 2011/10/16: +%% |\hanc{}{}| makes an anchor with +%% \HTML\ label like \ctanpkgref{hyperref}'s +%% |\hypertarget{}{}| +%% (that we actually provide as well, +%% towards printing from the same source): \newcommand*{\hanc}[1]{\TagSurr a{\@name{#1}}} -%% |\hancref{}{}{}| makes an anchor with -%% \HTML\ label and at the same time a link to : +\@ifdefinable\hypertarget{\let\hypertarget\hanc} +%% |\hancref{}{}{}| makes an anchor with +%% \HTML\ label and at the same time a link to : \newcommand*{\hancref}[2]{\TagSurr a{\@name{#1} \@href{#2}}} -%% |\href{}{}| makes a link to : +%% |\href{}{}| makes a link to +%% (as with 'hyperref'): \newcommand*{\href}[1]{\TagSurr a{\@href{#1}}} %% %% === Special cases of Basic Link Macros === %% |\autanc{}| creates an anchor where is %% the text and the internal label at the same time: \newcommand*{\autanc}[1]{\hanc{#1}{#1}} %% 2010/07/04 -%% |\ancref{}{}| makes a link to -%% an anchor on the same web page. +%% |\ancref{}{}| makes a link to +%% an anchor 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{}{}|: \newcommand*{\ancref}[1]{\href{\##1}} +\@ifdefinable\hyperlink{\let\hyperlink\ancref} %% |\autref{}| makes a link to an anchor %% named 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{}{}{}| +%% that %% 2011/10/21 %% makes a link to : \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 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 , \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 %% `.tex' may better be controlled in a file `.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 -

\ancref{#1}{\BlogDotFillText}% +

\ancref{#1}{\BlogDotFillText}% %% not

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{}{}' 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 ): +\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[]| +%% \[|\TryBlogDotCFG[]|\] %% \[...\] 2011/10/21 %% looks for `.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

instead of

, its color + uses ; 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{}| as follows: +\providecommand*{\urlfmt}{\texttt} +%% 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:} +\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{}|, +%% %% 'blog.sty' had `\pkg{}', %% was `prg' 2011/10/20 +%% %% without a proper implementation. +%% |\pkgnamefmt{}| 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 %% as a link to `http://'; %% \[|\httpsref{}{}|\] -%% 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{}{}| displays in italics: -\newcommand*{\ithttpref}[2]{\NormalHTTPref{#1}{\textit{#2}}} -%% === \acro{URL}s as Links === -%% With |\urlhttpref{}|, that \acro{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{}|, that \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{}| 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{}|, 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{}| just is like %% `\footnote{\urlhttpref{}}': \newcommand*{\foothttpurlref}[1]{\footnote{\urlhttpref{#1}}} %% |\urlfoot{}{}| %% 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 and %% when a shorthand |\{}{}| has been defined %% where `\' is the macro name and is the target -%% identifier (usually part of the \acro{URL} generated from ) +%% identifier (usually part of the \URL\ generated from ) %% according to the syntax declaration of `\'. \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{}{}| -%% makes a link to of J\"urgen Fenn's -%% Topical Index of the \TeX\ Catalogue. You find the -%% 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{}{}| @@ -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{}{}|:\] %% 2011/10/10 +%% \[|\mirrorctanref{}{}|.\] %% 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 in -%% on \acro{CTAN}, either by +%% on \CTAN, +%% displayed as the link text, %% 2011/10/21 +%% either by %% \[|\tugctanfileref{}{}|\] %% 2011/10/10 %% or (for a mirror) by %% \[|\mirrorctanfileref{}{}|.\] %% 2011/10/10 -%% The file name format |\file{}| -%% 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{}{}|.\] +%% Likewise, |\ctanfileref| works like +%% \[`\tugctanfileref'\quad \mbox{or}\quad `\mirrorctanfileref',\] +%% depending on the same `\usetugctan' vs.\ `\usemirrorctan', +%% so the syntax is +%% \[|\ctanfileref{}{}|\] +\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{}{}| +%% \ %% 2011/10/21 +%% makes a link to of J\"urgen Fenn's +%% Topical Index of the \TeX\ Catalogue. You find the +%% 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{}| -%% makes a link to the \acro{CTAN} package info page for +%% makes a link to the \CTAN\ package info page for %% the package . %% |\CtanPkgRef{}{}| %% is a variant for the cases where authors have a special idea @@ -327,25 +401,18 @@ %% Also, may be a package from a \emph{bundle} %% where has a description page while %% 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{}|, -%% 'blog.sty' had `\prg{}', 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{}{}| makes a link -%% to the DANTE web page displaying a \acro{CTAN} +%% to the DANTE web page displaying a \CTAN\ %% announcement. You find by searching %% \[\texttt{https://lists.dante.de/pipermail/ctan-ann/}\] -%% and then reading the \acro{URL}. +%% and then reading the \URL. %% is composed as `-/<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{}{}| makes a link %% to on domain `tug.org': \newcommand*{\tugref}[1]{\httpref{tug.org/#1}} @@ -375,7 +442,7 @@ %% |\texhaxref{}{}| makes a link %% to the \acro{TUG} web page displaying %% a texhax posting. You find by searching -%% `tug.org/pipermail/texhax/' and then reading the \acro{URL}. +%% `tug.org/pipermail/texhax/' and then reading the \URL. %% is composed as `-/<6-digits>.html'. \newcommand*{\texhaxref}[1]{\tugref{pipermail/texhax/#1}} %% |\THref{}| saves you from choosing @@ -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{