summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/morehype/blog.sty
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype/blog.sty')
-rw-r--r--Master/texmf-dist/tex/latex/morehype/blog.sty526
1 files changed, 386 insertions, 140 deletions
diff --git a/Master/texmf-dist/tex/latex/morehype/blog.sty b/Master/texmf-dist/tex/latex/morehype/blog.sty
index 83fcf4dca4c..6ff50a8ab58 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/02/10 v0.41 simple fast HTML (UL)]
+\ProvidesPackage{blog}[2011/08/31 v0.5 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.
@@ -18,12 +18,15 @@
%% == Processing ==
%% We are building on the 'fifinddo' package:
\RequirePackage{fifinddo}
+%% |\CLBrk| is a \emph{code line break}
+%% (also saving subsequent comment mark):
+\newcommand*{\CLBrk}{^^J}
%% |\BlogCopyFile[<changes>]{<src-file>}|
%% ``copies" the \TeX\ source file <src-file>
%% into the file specified by `\ResultFile'.
%% As in \TeX\ an empty line starts a new paragraph,
%% we ``interpret" an empty source line as
-%% HTML tag \xmltagcode{p} for starting a new paragraph.
+%% \acro{HTML} tag \xmltagcode{p} for starting a new paragraph.
%% Empty source lines following some first empty source
%% line immediately are ignored
%% (``compression" of empty lines).---However,
@@ -40,7 +43,10 @@
\ProcessOptions
\MakeOther\< \MakeOther\> %% TODO ...
\newcommand*{\BlogCopyFile}[2][]{%
- \ProcessFileWith[\BlogCodes #1]{#2}{%
+ \ProcessFileWith[\BlogCodes
+ \let\ProvidesFile\BlogProvidesFile %% 2011/02/24
+ \let\protect\@empty %% 2011/03/24
+ #1]{#2}{%
\IfFDinputEmpty
{\IfFDpreviousInputEmpty
\relax
@@ -55,9 +61,34 @@
\newcommand*{\BlogCodes}{% %% 2010/09/07
\endlinechar`\ \catcode`\~\active \BasicNormalCatCodes}
%% The tilde is active as in Plain~TeX too, it is so natural to
-%% use it for abbreviating HTML's `&nbsp;'!
-%%
-%% == General HTML Matters ==
+%% use it for abbreviating \acro{HTML}'s `&nbsp;'!
+%%
+%% %% v0.42:
+%% |\ProvidesFile{<file-name>.tex}[<file-info>]| \ is supported
+%% for use with the \CtanPkgRef{morehype}{myfilist}
+%% package %% TODO \urlpkgfoot!? 2011/02/22
+%% to get a list of source file infos.
+%% In generating the \acro{HTML} file, the file infos are transformed
+%% into an \acro{HTML} comment. Actually it is
+%% |\BlogProvidesFile| (for the time being, 2011/02/22):
+\@ifdefinable\BlogProvidesFile{%
+ \def\BlogProvidesFile#1[#2]{%
+ \comment{ generated from\CLBrk\CLBrk
+ \ \ \ \ \ \ \ \ \ #1, #2,\CLBrk\CLBrk
+ \ \ \ \ \ with blog.sty,
+ \GenDate\ }}} %% TODO predefine?
+%% %% changes 2011/02/24:
+%% (TODO: customizable style.)---Due to the limitations
+%% of the approach reading the source file
+%% line by line, the ``optional argument" `[<file-info>]'
+%% of `\ProvidesFile' must appear in the same line as
+%% the closing brace of its mandatory argument.
+%% The feature may require inserting
+%% \[`\let\ProvidesFile\BlogProvidesFile'\]
+%% somewhere, e.g., in `\BlogCopyFile'.
+%%
+%% \pagebreak[3] %% 2011/05/11
+%% == General \acro{HTML} Matters ==
%% The following stuff is required for any web page
%% (or hardly evitable).
%% === General Tagging ===
@@ -68,7 +99,7 @@
%% are used to avoid repeating element names <el-name> in
%% definitions of \TeX\ macros that refer to ``entire"
%% elements---as opposed to elements whose content often
-%% spans lines (as readable HTML code).
+%% spans lines (as readable \acro{HTML} code).
%% We will handle the latter kind of elements
%% using \LaTeX's idea of ``environments."
%% `\TagSurr' also inserts specifications of element
@@ -82,13 +113,13 @@
\newcommand*{\STS}{} \let\STS\SimpleTagSurr %% 2010/05/23
\newcommand*{\TagSurr}[3]{<#1 #2>#3</#1>}
%%
-%% === Attributes ===
+%% === Attributes === %%% (General) %%%
%% Inspired by the common way to use `@' for referring
%% to element attributes---i.e., `@<attr>' refers to attribute
-%% `<attr>'---in HTML/XML documentation, we often use
+%% `<attr>'---in \acro{HTML}/\acro{XML} documentation, we often use
%% $$`\@<attr>{<value>}' \qquad
%% \mbox{to ``abbreviate"}\qquad `<attr>="<value>"'$$
-%% within the starting tag of an HTML element.
+%% within the starting tag of an \acro{HTML} element.
%% This does not really
%% make typing easier or improve readability,
%% it rather saves \TeX's memory by using a single token
@@ -109,12 +140,19 @@
%% |@href| is most important for that ``hyper-text:"
\declareHTMLattrib{href}
%% ... and |@name| (among other uses) is needed for
+%% |@name| for %% 2011/04/26
%% hyper-text anchors:
-\declareHTMLattrib{name} %% 2010/11/06
-% \expandafter\show\csname @href\endcsname
-%% |@bgcolor| and other attributes following are especially used
-%% in formatting \textbf{tables}:
+\declareHTMLattrib{name} %% 2010/11/06
+%% Many elements have the |@type| attribute: %% 2011/08/01
+\declareHTMLattrib{type}
+%% |@title| for tooltips: %% 2011/04/26
+\let\@title\relax
+\declareHTMLattrib{title} %% 2011/04/26
+%% |@bgcolor| is used in tables as well as
+%% for the appearance of the entire page:
\declareHTMLattrib{bgcolor}
+%%
+%% %%% Attributes (Tables) %%%
%% Of course, conflicts may occur, as the form
%% `\@<ASCII-chars>' of macro names is used for internal
%% (La)\TeX\ macros.
@@ -132,13 +170,17 @@
\let\@height\relax
\declareHTMLattrib{height} %% 2010/07/24
%% We can enumerate the specifications allowed for
-%% |@align| ... actually it isn't used/introduced here ...
-%% we just abbreviate (indeed!) entire attribute specifications:
-\newcommand*{\@align@c}{align="center"} %% 2010/08/03
-\newcommand*{\@align@l}{align="left"} %% 2010/07/17
-\newcommand*{\@align@r}{align="right"}
+%% |@align|: %% reimpl. 2011/04/24
+\newcommand*{\@align@c}{\@align{center}}
+\newcommand*{\@align@l}{\@align{left}}
+\newcommand*{\@align@r}{\@align{right}}
+\newcommand*{\@align}[1]{align="#1"}
+%% |@valign@t|:
+\newcommand*{\@valign@t}{v\@align{top}} %% 2011/04/24
%% Some other uses of `\declareHTMLattrib' essential for
-%% tables:
+%% \emph{tables:} %% emph 2011/04/24
+\declareHTMLattrib{border} %% 2011/04/24
+\declareHTMLattrib{class} %% 2011/04/24
\declareHTMLattrib{cellpadding} %% 2010/07/18
\declareHTMLattrib{cellspacing} %% 2010/07/18
\declareHTMLattrib{colspan} %% 2010/07/17
@@ -151,30 +193,28 @@
%% well, not so bad, as the main purpose of this namespace
%% is saving tokens \emph{in macros.}
%%
-%% === HTML's Special Symbols ===
-%% |#| is needed for numerical specifications in HTML,
+%% === \acro{HTML}'s Special Symbols ===
+%% |#| is needed for numerical specifications in \acro{HTML},
%% especially colors and Unicode symbols,
%% while it plays a different (essential) role in our
%% definitions of \TeX\ macros here.
%% We redefine \LaTeX's |\#|
%% for a kind of ``quoting" `#' in macro definitions
-%% in order to refer to their HTML meaning.---I \textbf{wonder}
+%% in order to refer to their \acro{HTML} meaning.---I \textbf{wonder}
%% what I had in mind with the |&| things here.
%% I cannot find any use of |\AmpMark| in my code
%% (including my web pages). There is no real problem
-%% with calling special HTML symbols, `&' is simply
+%% with calling special \acro{HTML} symbols, `&' is simply
%% made `other' already here for macros calling those symbols
%% (below), and in processing source files, it is as well
%% `other' by default. The symbols section, however, redefines |\&|
-%% for calling HTML's ampersand symbol.
+%% for calling \acro{HTML}'s ampersand symbol.
{\catcode`\&=12 \catcode`\#=12
\gdef\AmpMark{&} \gdef\#{#}}
%% ... `\CompWordMark' etc.?
%%
%% === Head ===
-%% |\head| produces the first two tags that an HTML file must start
-%% with (we sometimes use `^^J' for line breaks in the HTML file
-%% to get some readibility of the generated code):
+%% |\head| produces the first two tags that an \acro{HTML} file must start:
\newcommand*{\head}{<html><head>} %% ^^J rm 2010/10/10
%% |\MetaTag{<inside>}| and |\ContentAtt{<value>}|
%% are internal shortcuts:
@@ -186,8 +226,9 @@
%% |\description{<text>}| for web searches (I think):
\newcommand*{\description}[1]{%
\MetaTag{\@name{description} \ContentAtt{#1}}}
-%% ... an outright \textbf{mistake!} The definition is overridden
-%% to get the HTML equivalent to \LaTeX's `description' environment.
+%% ... an outright \textbf{mistake!} TODO %% todo 2011/07/25
+%% The definition is overridden
+%% to get the \acro{HTML} equivalent to \LaTeX's `description' environment.
%% `\newcommand' did not warn here because we don't load any \LaTeX\
%% class for text-processing macros and code generation.---And so
%% some |\MetaDescr| should be defined---and used finally!
@@ -195,7 +236,10 @@
%% |\robots{<instructions>}|:
\newcommand*{\robots}[1]{%% juergenf: index, follow, noarchive
\MetaTag{\@name{robots} \ContentAtt{#1}}}
-%% |\stylesheet{<media>}{<css>}| !?
+%% |\norobots| for privacy: %% 2011/03/16
+\newcommand*{\norobots}{\robots{noarchive,nofollow,noindex}}
+%% |\stylesheet{<media>}{<css>}| uses <css>`.css' for
+%% `media="<media>"':
\newcommand*{\stylesheet}[2]{%
\space\space %% 2010/09/10
<link rel="stylesheet" media="#1" type="text/css" \@href{#2.css}>}
@@ -216,12 +260,13 @@
%%
%% == Fonts ==
%% |\heading{<level>}{<text>}| prints <text> with size dependent
-%% on <level>. The latter may be one out of `1', `2', `3', `4'
-%% (I think).
+%% on <level>. The latter may be one out of
+%% `1', `2', `3', `4', `5', `6'. %% 2011/05/12
\newcommand*{\heading}[1]{\SimpleTagSurr{h#1}}
%% ... I might use `\section' etc. one day, I made `\heading'
%% when I could not control the sizes of the section titles
%% properly and decided first to experiment with the level numbers.
+%% %% <- TODO re-order alltogether, cf. SelfHTML 2011/05/12
%%
%% We ``re-use" some \LaTeX\ commands for specifying font attributes,
%% rather than (re)defining macros `\i', `\b', `\tt', ...
@@ -231,17 +276,19 @@
\renewcommand*{\textit}{\SimpleTagSurr i}
%% etc. for |\textbf|, |\texttt| ...:
\renewcommand*{\textbf}{\SimpleTagSurr b}
-\renewcommand*{\texttt}{\SimpleTagSurr{tt}} %% 2010/06/07
+\renewcommand*{\texttt}{\SimpleTagSurr{tt}} %% 2010/06/07
+%% |\textsf{<text>}| TODO (see some `makehtml.tex') %% 2011/05/11
+%%
%% |\textcolor| is from \LaTeX's 'color' package
-%% that we won't load for generating HTML,
+%% that we won't load for generating \acro{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"}}
-%% |\code{<text>}| is different than the former font commands,
-%% it is \emph{not} a standard \LaTeX\ macro.
-%% It is similar to `\verb', which however doesn't work with
-%% a pair of curly braces. The macro name rather is derived
-%% from the HTML element name `code':
+%%
+%% == Logical Markup ==
+%% |\code{<text>}| marks <text> as ``code,"
+%% just accessing te \xmltagcode{code} element,
+%% while standard \LaTeX\ does not provide a `\code' command:
\newcommand*{\code} {\SimpleTagSurr{code}} %% 2010/04/27
%% |\emph{<text>}| is \LaTeX's command again, but somewhat abused,
%% expanding to \lq\xmltagcode{em}<text>\xmltagcode{/em}\rq:
@@ -249,9 +296,12 @@
%% ... Note that \LaTeX's `\emph' feature of switching to `up'
%% when `\emph' appears in an italic context doesn't work here ...
%%
-%% |\strong{<text>}| again just calls an HTML element.
+%% |\strong{<text>}| again just calls an \acro{HTML} element.
%% It may behave like `\textbf{<text>}', or ... I don't know ...
\newcommand*{\strong} {\SimpleTagSurr{strong}}
+%% %% 2011/03/09:
+%% |\var{<symbol(s)>}| accesses the \xmltagcode{var} element:
+\newcommand*{\var}{\SimpleTagSurr{var}}
%%
%% == Environments ==
%% We reduce \LaTeX's |\begin| and |\end| to their most primitive
@@ -267,7 +317,7 @@
%% does not allow any assignments while ``copying"
%% the \TeX\ source into the `.htm'.
%% There even is no check for proper nesting.
-%% `\begin' and `\end' just represent HTML elements
+%% `\begin' and `\end' just represent \acro{HTML} elements
%% (their starting/ending tags)
%% that typically have ``long" content.
%% (We might ``intercept" `\begin' and `\end' before
@@ -281,16 +331,16 @@
%%
%% As formerly with ``fonts," we have \emph{two} policies for
%% \textbf{choosing macro names}:
-%% (i)~using an \emph{existing} HTML element name,
+%% (i)~using an \emph{existing} \acro{HTML} element name,
%% (ii)~using a \LaTeX\ command name for accessing a somewhat
-%% similar HTML element having a \emph{different} name.
+%% similar \acro{HTML} element having a \emph{different} name.
%%
%% |\declareHTMLelement{<el-name>}| creates a \emph{new}
%% <el-name> ``environment" according to policy~(i):
\newcommand*{\declareHTMLelement}[1]{%
\newenvironment*{#1}{<#1>}{</#1>}}
%% |\renderHTMLelement{<ltx-env>}{<el-name>}| \emph{redefines}
-%% \LaTeX's <ltx-env> environment to use HTML's <el-name> element
+%% \LaTeX's <ltx-env> environment to use \acro{HTML}'s <el-name> element
%% according to policy~(ii):
\newcommand*{\renderHTMLelement}[2]{%
\renewenvironment*{#1}{<#2>}{</#2>}}
@@ -316,8 +366,8 @@
%% To use it for policy~(ii), we give it a dummy definition
%% so `\render'... won't complain:
\let\quote\empty
-\renderHTMLelement{quote} {blockquote}
-%% For list |\item|s, I tried to get readable HTML code
+\renderHTMLelement{quote}{blockquote}
+%% For list |\item|s, I tried to get readable \acro{HTML} code
%% using `\indenti'. This fails with nested lists.
%% The indent could be increased for nested lists
%% if we supported assignments with `\begin' and `\end'.
@@ -338,10 +388,10 @@
%% == Links ==
%% === Basic Link Macros ===
%% |\hanc{<id>}{<text>}| makes <text> an anchor with
-%% HTML label <id> (like 'hyperref''s `\hypertarget'):
+%% \acro{HTML} label <id> (like 'hyperref''s `\hypertarget'):
\newcommand*{\hanc}[1]{\TagSurr a{\@name{#1}}}
%% |\hancref{<id>}{<url>}{<text>}| makes <text> an anchor with
-%% HTML label <id> and at the same time a link to <url>:
+%% \acro{HTML} label <id> and at the same time a link to <url>:
\newcommand*{\hancref}[2]{\TagSurr a{\@name{#1} \@href{#2}}}
%% |\href{<id>}{<text>}| makes <text> a link to <url>:
\newcommand*{\href}[1]{\TagSurr a{\@href{#1}}}
@@ -379,20 +429,21 @@
%% using $$|\fileref{<filename-base>}|.$$ I have used
%% extension `.htm' to avoid disturbing my Atari
%% editor 'xEDIT' or the the Atari emulator (Hatari).
-%% I could switch to `.html' some time using symbolic links.
+%% %% rm. 2011/08/18:
+%% % I could switch to `.html' some time using symbolic links.
%% The extension I actually use is stored as macro
%% |\htext| in a more local file (e.g., `.cfg').---Later
%% I realized that I may want to refer to local files
%% other than web pages, and therefore I introduced a more
-%% general |\FileRef{<filename>}|.
-%% \textbf{Only now (v0.2) I realize}
-%% it's just the same as |\href|!
-\newcommand*{\FileRef}[1]{\TagSurr a{\@href{#1}}}
-%% <- 2010/09/11 ->
-\newcommand*{\fileref}[1]{\FileRef{#1\htext}}
+%% %% mod. 2011/08/18:
+%% general `\FileRef{<filename>}|', overlooking
+%% that it was the same as |\href|.
+% \newcommand*{\FileRef}[1]{\TagSurr a{\@href{#1}}}
+\newcommand*{\fileref}[1]{\href{#1\htext}}
% \newcommand*{\emfileref}[2]{\fileref{#1}{\emph{#2}}}
\newcommand*{\itfileref}[2]{\fileref{#1}{\textit{#2}}}
-%% |\fileancref{<file>}{<anchor>}| links to
+%% |\fileancref{<file>}{<anchor>}{<text>}| links to
+%% %% <- `text' added 2011/03/19
%% anchor <anchor> on web page <file>:
\newcommand*{\fileancref}[2]{%
\TagSurr a{\@href{#1\htext\##2}}}
@@ -421,46 +472,116 @@
%% 'texlinks' sometimes uses a ``permanent alias"
%% |\NormalHTTPref| of `\httpref':
\@ifdefinable \NormalHTTPref {\let\NormalHTTPref\httpref}
+%% |\httpsref| is the analogue of `\httpref' for `https://':
+\newcommand*{\httpsref}[1]{% %% 2011/06/27
+ \TagSurr a{\@href{https://#1" target="_blank}}}
%%
%%
-%% == Symbols ==
-%% |&| is made `other' for using it to call HTML's ``character
-%% entities".
+%% == Symbols == %% ordering 2011/02/25
+%% === Basic Preliminaries ===
+%% |&| is made `other' for using it to call \acro{HTML}'s
+%% ``character entities." %% dot inside 2011/02/25
\@makeother\&
%% Again we have the two policies about choosing macro names
%% and respectively two new definition commands.
%% |\declareHTMLsymbol{<name>}| defines a macro `\<name>'
%% expanding to `&<name>;'. Checking for prior definedness
-%% hasn't been implemented yet. (TODO)
+%% hasn't been implemented yet.
+%% (TODO; but sometimes redefining ...) %% 2011/02/26
\newcommand*{\declareHTMLsymbol}[1]{\@namedef{#1}{&#1;}}
%% |\renderHTMLsymbol{<macro>}{<name>}| \emph{redefines}
%% macro <macro> to expand to `&<name>;':
\newcommand*{\renderHTMLsymbol} [2]{\renewcommand*{#1}{&#2;}}
-%% These auxilaries applied: |\ccedil| (TODO re-order) ...
-\declareHTMLsymbol{ccedil} %% 2010/08/17
+%% Redefinitions of |\&| and |\%|
+%% (well, `\PercentChar' is 'fifinddo''s %% add. apostroph 2011/07/22
+%% version of \LaTeX's `\@percentchar'):
+\renderHTMLsymbol{\&}{amp}
+\let\%\PercentChar
+%%
+%% === Diacritics === %% changed 2011/03/04
+%% For the difference between \dqtd{diacritic} and
+%% \dqtd{accent,} see \wikienref{Diacritic}{Wikipedia}.
+%%
+%% |\ccedil|: %%%, |\eacute|, |\ocirc| (``r\^ole")
+\declareHTMLsymbol{ccedil}
+%% %% 2011/03/04:
+%% \acro{HTML} entities |&eacute;|, |&ocirc;| etc. can be accessed
+%% by \TeX's accent commands |\'|, |\^|, |\`|, |\"|:
+% \declareHTMLsymbol{eacute}
+% \declareHTMLsymbol{ocirc}
+\renewcommand*{\'}[1]{&#1acute;}
+\renewcommand*{\^}[1]{&#1circ;}
+\renewcommand*{\`}[1]{&#1grave;}
+\renewcommand*{\"}[1]{&#1uml;}
+%% |\uml{<char>}| % yields the umlaut for <char>
+%% may have been overestimated:
+%% % (useful in macro definitions): %% 2010/11/13
+% \newcommand* {\uml}[1] {&#1uml;} %% 2010/08/24
+%%
+%% === Greek === %% 2011/02/26
+\declareHTMLsymbol{Alpha}
+\declareHTMLsymbol{alpha}
+\declareHTMLsymbol{Beta}
+\declareHTMLsymbol{beta}
+\declareHTMLsymbol{Gamma}
+\declareHTMLsymbol{gamma}
+\declareHTMLsymbol{Delta}
+\declareHTMLsymbol{delta}
+\declareHTMLsymbol{Epsilon}
+\declareHTMLsymbol{epsilon}
+\declareHTMLsymbol{Zeta}
+\declareHTMLsymbol{zeta}
+\declareHTMLsymbol{Eta}
+\declareHTMLsymbol{eta}
+\declareHTMLsymbol{Theta}
+\declareHTMLsymbol{theta}
+\declareHTMLsymbol{Iota}
+\declareHTMLsymbol{iota}
+\declareHTMLsymbol{Kappa}
+\declareHTMLsymbol{kappa}
+\declareHTMLsymbol{Lambda}
+\declareHTMLsymbol{lambda}
+\declareHTMLsymbol{My}
+\declareHTMLsymbol{my}
+\declareHTMLsymbol{Ny}
+\declareHTMLsymbol{ny}
+\declareHTMLsymbol{Xi}
+\declareHTMLsymbol{xi}
+\declareHTMLsymbol{Omikron}
+\declareHTMLsymbol{omikron}
+\declareHTMLsymbol{Pi}
+\declareHTMLsymbol{pi}
+\declareHTMLsymbol{Rho}
+\declareHTMLsymbol{rho}
+\declareHTMLsymbol{Sigma}
+\declareHTMLsymbol{sigma}
+\declareHTMLsymbol{sigmaf}
+\declareHTMLsymbol{Tau}
+\declareHTMLsymbol{tau}
+\declareHTMLsymbol{Upsilon}
+\declareHTMLsymbol{upsilon}
+\declareHTMLsymbol{Phi}
+\declareHTMLsymbol{phi}
+\declareHTMLsymbol{Chi}
+\declareHTMLsymbol{chi}
+\declareHTMLsymbol{Psi}
+\declareHTMLsymbol{psi}
+\declareHTMLsymbol{Omega} %% render -> declare 2011/02/26
+\declareHTMLsymbol{omega}
+\declareHTMLsymbol{thetasym}
+\declareHTMLsymbol{upsih}
+\declareHTMLsymbol{piv}
+%%
+%% === Arrows ===
%% Arrows: |\gets|, |\to|, |\uparrow|, |\downarrow| ...
\renderHTMLsymbol {\gets} {larr}
\renderHTMLsymbol {\to} {rarr}
\renderHTMLsymbol {\uparrow} {uarr} %% 2010/09/15
\renderHTMLsymbol {\downarrow}{darr} %% 2010/09/15
-%% \verb+>+ and \verb+<+: |\gt|, |\lt| ...
-\declareHTMLsymbol{gt} %% greater than 2010/06/13
-\declareHTMLsymbol{lt} %% less than 2010/06/13
-%% Redefinitions of |\&| and |\%|
-%% (well, `\PercentChar' is 'fifinddo's version of
-%% \LaTeX's `\@percentchar'):
-\renderHTMLsymbol {\&} {amp}
-\let\%\PercentChar %% 2010/07/01
-%% Horizontal ellipsis: |\dots| ...
-\renderHTMLsymbol {\dots} {hellip}
-%% The tilde |~| is used for its wonderful purpose,
-%% by analogy to \TeX:
-\renderHTMLsymbol {~} {nbsp}
-%% But now we need a replacement |\tilde| for URLs involving
-%% home directories of institution members:
-{\@makeother\~ \gdef\tilde{~}}
+%%
+%% === Dashes ===
%% The ligatures `--' and `---' for en~dash and em~dash
-%% don't work in our expanding mode. Now, HTML's policy
+%% don't work in our expanding mode. Now, \acro{HTML}'s policy
%% for choosing names often prefers shorter names than
%% are recommended for (La)\TeX, so here I adopt a \emph{third}
%% police besides (i) and (ii) earlier; cf. \LaTeX's
@@ -469,21 +590,36 @@
%% |\endash|, |\emdash| ...
\def \endash {&ndash;} %% \end... illegal
\newcommand*{\emdash} {&mdash;}
-%% ``Math" spaces |\enspace|, |\quad|, |\qquad|:
-\renderHTMLsymbol{\enspace} {ensp}
-\renderHTMLsymbol{\quad} {emsp}
-\renewcommand* {\qquad} {\quad\quad}
-%% Quotes: |\lq|, |\rq| ... (TODO own subsection)
+%%
+%% === Spaces ===
+%% ``Math" (not only!)\ spaces |\,|, |\enspace|, |\quad|, |\qquad|:
+%% %% <- 2011/04/26
+\renderHTMLsymbol{\enspace}{ensp}
+\renderHTMLsymbol{\quad} {emsp}
+\renewcommand* {\qquad} {\quad\quad}
+%% 2011/07/22: `&thinsp;' allows line breaks,
+%% so we introduce |\thinsp| to access `&thinsp;',
+%% while |\thinspace| and |\,| use Unicode "Narrow No-Break Space"
+%% (`U+202F', see \meta{Wikipedia \Wikienref{Space (punctuation)}};
+%% browser support?):
+% \renderHTMLsymbol{\thinspace}{thinsp}
+% \renderHTMLsymbol{\,} {thinsp}
+\declareHTMLsymbol{thinsp}
+\renderHTMLsymbol{\thinspace}{\#8239}
+\renderHTMLsymbol{\,} {\#8239}
+%%
+%% === Quotes, Apostrophe, Prime ===
+%% |\lq|, |\rq|
\renderHTMLsymbol{\lq} {lsquo}
% \newcommand* {\rsquo} {&rsquo;} %% removed 2010/04/26
\renderHTMLsymbol{\rq} {rsquo}
-%% In order to use the right single quote for the HTML apostrophe,
+%% In order to use the right single quote for the \acro{HTML} apostrophe,
%% we must save other uses before.
%% |\screentqtd{<text>}| is used for screen messages,
%% and |\urlapostr| is the version of the right single quote
-%% for URLs (TODO which? Wikipedia?):
+%% for \acro{URL}s of Wikipedia articles: %% 2011/08/31
\newcommand*{\screenqtd}[1]{`#1'}
-\newcommand*{\urlapostr} {'} %% 2010/09/10
+\newcommand*{\urlapostr} {'} %% 2010/09/10
%% Here finally is the change of |'|:
\MakeActiveDef\'{&rsquo;}
%% ... TODO \verb+\MakeActiveLet\'\rq+!
@@ -494,7 +630,7 @@
%% |\ldquo|, |\rdquo|, |\sbquo|, |\prime|, |\Prime| ...
\declareHTMLsymbol{ldquo}
\declareHTMLsymbol{rdquo}
-\declareHTMLsymbol{sbquo} %% 2010/07/01
+\declareHTMLsymbol{sbquo} %% 2010/07/01
\renewcommand*{\prime}{&prime;}
\declareHTMLsymbol{Prime}
% \newcommand*{\Prime}{&Prime;}
@@ -504,30 +640,95 @@
\def\endqtd#1{\ldquo#1\rdquo} %% \newcommand: "\end"
\newcommand*\enqtd[1]{\lq#1\rq} %% 2010/09/08, \new... 2010/11/08
\newcommand*{\dedqtd}[1]{&bdquo;#1\ldquo}
-%% ... TODO `\bdquo'!? %% 2010/11/08
-%%
-%% Some more letters: |\eacute|, |\ocirc| (``r\^ole"),
-%% |\Omega| ...
-\declareHTMLsymbol{eacute}
-\declareHTMLsymbol{ocirc}
-\renderHTMLsymbol{\Omega} {Omega} %% 2010/08/24
-%% |\uml{<char>}| yields the umlaut for <char>
-%% (useful in macro definitions): %% 2010/11/13
-\newcommand* {\uml}[1] {&#1uml;} %% 2010/08/24
-%% |\copyright|:
-\renderHTMLsymbol{\copyright}{copy} %% 2010/08/24
-%% Curly braces |\{| and |\}|: %% 2010/09/10
+\newcommand*{\deqtd}[1]{&sbquo;#1&lsquo;} %% corr. 2011/05/14
+%% ... TODO `\bdquo'!? %% 2010/11/08
+%%
+%% === Math ===
+%% %% doc. extended 2011/05/08:
+%% Because \verb+<+ and \verb+>+ are used for \acro{HTML}'s
+%% element notation, we provide aliases |\gt|, |\lt|
+%% for mathematical $\lt$ and $\gt$:
+\declareHTMLsymbol{gt}
+\declareHTMLsymbol{lt}
+%% |\ge|, |\le|, and |\ne| for $\geq$, $\leq$, and $\neq$ resp.:
+\declareHTMLsymbol{ge}
+\declareHTMLsymbol{le}
+\declareHTMLsymbol{ne}
+%% We also provide their \TeX\ aliases
+%% |\geq|, |\leq|, |\neq|: %% 2011/05/11
+\let\geq\ge
+\let\leq\le
+\let\neq\ne
+%% Angle braces |\langle| and |\rangle|:
+\renderHTMLsymbol{\langle}{lang}
+\renderHTMLsymbol{\rangle}{rang}
+%% The one-argument macro |\angled{<angled>}|
+%% allows better readable code %% TODO:
+%% (\textcolor{red}{should be in a more general package}):
+\newcommand*{\angled}[1]{\langle#1\rangle}
+%% Curly braces |\{| and |\}| \textcolor{red}{\dots}:
\begingroup
\Delimiters\[\] \gdef\{[{] \gdef\}[}]
\endgroup
+%% \TeX's |\ast| corresponds to the ``lower" version
+%% of the asterisk:
+\renderHTMLsymbol{\ast}{lowast} %% 2011/03/29
+%% Besides \TeX's |\subset| and |\subseteq|,
+%% we provide short versions |\sub| and |\sube| %% 2011/05/08
+%% inspired by \acro{HTML}:
+\declareHTMLsymbol{sub} %% 2011/04/04
+\let\subset\sub %% 2011/05/08
+\declareHTMLsymbol{sube} %% 2011/03/29
+\let\subseteq\sube %% 2011/05/08
+%% \TeX\ and \acro{HTML} agree on |\cap|, |\cup|, %% 2011/05/08
+%% and |\times|:
+\declareHTMLsymbol{cap} %% 2011/04/04
+\declareHTMLsymbol{cup} %% 2011/04/04
+\declareHTMLsymbol{times} %% 2011/04/04
+%% We stick to \TeX's |\emptyset| %% 2011/05/08
+\renderHTMLsymbol{\emptyset}{empty} %% 2011/04/14
+%% We need |\minus| since math mode switching is
+%% not supported by 'blog': %% 2011/05/08
+\declareHTMLsymbol{minus} %% 2011/03/31
+%% We override \acro{HTML}'s `&circ;' to get \TeX's \cs{circ}
+%% (i.e., $\circ$; %% 2011/05/08:
+%% \textcolor{red}{but I cannot see it
+%% on my own pages!?}):
+\renderHTMLsymbol{\circ}{\#x2218} %% 2011/04/28
+\renderHTMLsymbol{\cdot}{middot} %% 2011/05/07
+%% |\sdot| generates `&sdot,', a variant of of `&middot;'
+%% reserved for the \Wikienref{dot product} according to
+%% the \wikideref{Malzeichen\#Skalarprodukt}:
+\declareHTMLsymbol{sdot} %% 2011/05/08
%%
-%% %% Problem: line-wise approach requires that all macro arguments
-%% %% are in the same line. Otherwise the lines must be enclosed
-%% %% in curly braces. Or split single arguments. %% 2010/04/11
-%% % <- rm 2010/11/08
+%% === Other ===
+%% The tilde |~| is used for its wonderful purpose,
+%% by analogy to \TeX:
+\renderHTMLsymbol{~}{nbsp}
+%% But now we need a replacement |\tilde| for URLs involving
+%% home directories of institution members
+%% (should better be |\tildechar| or `\TildeChar',
+%% cf.~'fifinddo'): %% 2011/04/29
+{\@makeother\~ \gdef\tilde{~} \gdef\tildechar{~}}
+%% % <- more elegant macro %% 2011/05/18
+%% % \newcommand*{\StoreOtherCharAs}[2]{%
+%% % \edef#2{\expandafter\@gobble\string#1}}
+%% Horizontal ellipsis: |\dots| ...
+\renderHTMLsymbol {\dots} {hellip}
+%%
+%% |\copyright|:
+\renderHTMLsymbol{\copyright}{copy}
+%% |\bullet| %% 2011/03/29
+\renderHTMLsymbol{\bullet}{bull}
+%% |\euro|: %% 2011/05/09
+\declareHTMLsymbol{euro}
+%% \LaTeX's |\S| prints the \dqtd{\Wikienref{section sign}}
+%% \qtd{\S}. In \acro{HTML}, the latter accessed by `&sect;',
+%% we \dqtd{redirect} `\S' to this: %% 2011/05/18
+\renderHTMLsymbol{\S}{sect}
%%
-%% \pagebreak[3]
-%% == \TeX-related == %% 2010/08/24
+%%
+%% == \TeX-related == %% 2010/08/24
%% Somebody actually using 'blog.sty' must have a need to put down
%% notes about \TeX\ for her own private purposes at least---I expect.
%% === Logos ===
@@ -555,54 +756,54 @@
%% |\texcs{\<tex-cmd-name>}| or `\texcs\<tex-cmd-name>'
%% (care for spacing yourself):
\newcommand*{\texcs}[1]{\code{\string#1}} %% 2010/11/13
+%% Good old |\cs{<tex-cmd-name>}| may be preferable:
+\def\cs#1{\code{\BackslashChar#1}} %% 2011/03/06
%%
%% == Tables ==
-%% These macros have proved somewhat bad. It may be better to
-%% re-implement tables support alltogether.
-%%
+%% %% 2011/04/24: rm. remark on doubtful stability, ordered
+%% === Indenting ===
%% There are three levels of indenting:
%% $$|\indenti|, \quad
%% |\indentii|,\quad \mbox{and}\quad
%% |\indentiii|.$$
-%% The intention for these was to get readable HTML code. Not sure ...
+%% The intention for these was to get readable \acro{HTML} code. Not sure ...
{\catcode`\ =12%% 2010/05/19
\gdef\indenti{ }\gdef\indentii{ }\gdef\indentiii{ }}
+%%
+%% === Starting/Ending Tables ===
%% 2010/07/17:
\newcommand*{\startTable}[1]{<table #1>}
\def\endTable{</table>}
-%% 2010/07/18:
-\newcommand*{\starttr}{<tr>}
-\def\endtr{</tr>}
-\newcommand*{\startTd}[1]{<td #1>}
-\def\endTd{</td>}
-\newcommand*{\simplecell}{\SimpleTagSurr{td}}
\newcommand*{\@frame@box}{\@frame{box}}
\newcommand*{\@frame@groups}{\@frame{groups}}
\newenvironment{allrulestable}[2]
{\startTable{\@cellpadding{#1} \@width{#2}
- \@frame@box rules="all"}^^J%
+ \@frame@box rules="all"}\CLBrk
\indenti<tbody>}
- {\indenti</tbody>^^J\endTable}
+ {\indenti</tbody>\CLBrk\endTable}
+%% === Rows ===
%% I first thought it would be good for readability if
-%% some HTML comments explain nesting or briefly describe
+%% some \acro{HTML} comments explain nesting or briefly describe
%% the content of some column, row, or cell.
%% But this is troublesome when you want to comment out
%% an entire table ...
-\newenvironment*{TableRow}[2]{%% weniger ^^J 2010/05/18
-% \indenti\ \comment{ #1 }^^J%
-%% <- 2010/05/23 ->
-% \ \comment{ #1 }^^J%
-%% <- 2010/07/18 ->
- \indenti \comment{ #1 }^^J%
- \indentii<tr #2>%
+\newenvironment*{TableRow}[2]{%% lesser indentation 2011/04/25
+ \ \comment{ #1 }\CLBrk
+ \indenti<tr #2>%
}{%
- \indentii</tr>}
+ \indenti</tr>}
\newenvironment{tablecoloredrow}[2]
{\TableRow{#1}{\@bgcolor{#2}}}
{\endTableRow}
%% "top" 2010/05/18:
-\newenvironment{tablerow}[1]{\TableRow{#1}{valign="top"}}
+\newenvironment{tablerow}[1]{\TableRow{#1}{\@valign@t}}
{\endTableRow}
+%% 2010/07/18:
+\newcommand*{\starttr}{<tr>}
+\def\endtr{</tr>}
+%%
+%% === Cells ===
+\newcommand*{\simplecell}{\SimpleTagSurr{td}} %% 2010/07/18
% \newcommand*{\TableCell}[2]{\indentiii<td #1>#2</td>}
% \newcommand*{\TableCell}[2]{\indentiii\TagSurr{td}{#1}{#2}}
%% <- 2010/07/18 ->
@@ -617,10 +818,20 @@
\newenvironment{bigtablecell}[1]{\BigTableCell{#1}{}}
{\endBigTableCell}
% {\ifx\\#1\\% %% 2010/05/30
-% \indentii\ \comment{#1}^^J%
+% \indentii\ \comment{#1}\CLBrk
% \fi
% \indentiii<td>}
% {\indentii</td>} %% !? 2010/05/23
+%% 2010/06/05:
+\newenvironment{BigTableCell}[2]
+ {\ifx\\#1\\\indentii\ \comment{#1}\CLBrk\fi
+ \indentiii\startTd{#2}}
+ {\indentii\endTd} %% TODO indent? 2010/07/18
+%% 2010/07/18:
+\newcommand*{\startTd}[1]{<td #1>}
+\def\endTd{</td>}
+%%
+%% === Filling a Row with Dummy Cells ===
%% Generalization 2010/06/28:
% \newcommand*{\FillRow}[2]{% %% broke line 2011/01/24
% \indentiii\TagSurr{td}{\@colspan{#1} #2}{}}
@@ -628,18 +839,13 @@
\newcommand*{\FillRow}[2]{\indentiii\startTd{\@colspan{#1} #2}\endTd}
\newcommand*{\fillrow}[1]{\FillRow{#1}{}}
\newcommand*{\fillrowcolor}[2]{\FillRow{#1}{\@bgcolor{#2}}}
-%% 2010/06/05:
-\newenvironment{BigTableCell}[2]
- {\ifx\\#1\\\indentii\ \comment{#1}^^J\fi
- \indentiii\startTd{#2}}
- {\indentii\endTd} %% TODO indent? 2010/07/18
%%
%% == Misc ==
-%% |\comment{<comment>}| produces a one-line HTML comment.
+%% |\comment{<comment>}| produces a one-line \acro{HTML} comment.
%% By contrast, there is an environment
%% |{commentlines}{<comment>}|
%% for mult-line comments. It is convenient for ``commenting out"
-%% code (unless the latter contains other HTML comments ...)
+%% code (unless the latter contains other \acro{HTML} comments ...)
%% where <comment> is a \emph{comment} for explaining what is
%% commented out. %% 2010/11/14
\newcommand*{\comment}[1]{<!--#1-->}
@@ -649,10 +855,10 @@
{<!--#1}
{-->}
%% \TeX's |\hrule| (rather deprecated in \LaTeX) is redefined
-%% to produce an HTML horizontal line:
+%% to produce an \acro{HTML} horizontal line:
\renewcommand*{\hrule}{<hr>}
%% Redefining |\ | to be the same as `\space' may be helpful
-%% for manual indenting or spacing of HTML code.
+%% for manual indenting or spacing of \acro{HTML} code.
%% Or better (just now remembering): I used it for making
%% ``ASCII trees" with the \xmltagcode{pre} element
%% (redefined `verbatim').
@@ -674,6 +880,10 @@
%% I have used this for \qtd{Last revised \dots} and for placing
%% navigation marks.
\newcommand*{\rightpar}{\TagSurr p\@align@r} %% 2010/06/17
+%% %% 2011/04/29:
+%% Often I use `\rightpar' with \textit{italics},
+%% now there is |\rightitpar{<text>}| for this purpose:
+\newcommand*{\rightitpar}[1]{\rightpar{\textit{#1}}}
%% For references, there were
% \catcode`\^=\active
% \def^#1{\SimpleTagSurr{sup}{#1}}
@@ -710,3 +920,39 @@ v0.3 2010/11/10 removed ^^J from \head
v0.4 2011/01/24 moving links to texlinks.sty
v0.41 2011/02/07 \NormalHTTPref
2011/02/10 refined call of `texlinks'
+ PART OF CTAN RELEASE r0.3
+v0.5 2011/02/22 \BlogProvidesFile
+ 2011/02/24 ... in \BlogCopyFile
+ 2011/02/25 ordering symbols
+ 2011/02/26 subsection Greek; note on \declareHTMLsymbol
+ 2011/03/04 diacritics
+ 2011/03/06 \cs
+ 2011/03/09 \var
+ 2011/03/16 \robots
+ 2011/03/19 doc. \fileancref arg.s corr.
+ 2011/03/29 \Sigma, ...
+ 2011/03/31 \minus
+ 2011/04/04 \times, \sub, \delta
+ 2011/04/11 Greek completed
+ 2011/04/14 \emptyset
+ 2011/04/22 \deqtd
+ 2011/04/24 doc.: folding, \stylesheet, ordered "tables";
+ @border, @align, @valign
+ 2011/04/25 lesser indentation with TableRow
+ 2011/04/26 \,, \thinspace, \@title; doc. \@name
+ 2011/04/28 [\circ] PROBLEM still
+ 2011/04/29 \rightitpar
+ 2011/05/07 \cdot
+ 2011/05/08 extended doc. on math symbols; \sdot;
+ \ast replaces \lowast; \subset, \subseteq;
+ \angled
+ 2011/05/09 \euro
+ 2011/05/11 |\geq| etc.; new section "logical markup"
+ 2011/05/12 corr. doc. \heading
+ 2011/05/14 right mark of \deqtd was rsquo instead of lsquo!
+ 2011/05/18 \S and note on \StoreOtherCharAs
+ 2011/06/27 \httpsref; doc: \acro
+ 2011/07/22 \thinspace vs. \thinsp; 'fifinddo''s
+ 2011/07/25 "todo" on \description
+ 2011/08/18f.removing \FileRef, 0.42-> 0.5
+ 2011/08/31 clarified use of \urlapostr