summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/morehype/blog.sty
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-10-11 22:54:02 +0000
committerKarl Berry <karl@freefriends.org>2011-10-11 22:54:02 +0000
commitf5d5dc04a3a9336da726ed2dcf9bcb741f8dad4b (patch)
tree7e40e516d0eaf09e1ae5e6474326a08ea152be78 /Master/texmf-dist/tex/latex/morehype/blog.sty
parent662cda48313c1615e5b117f827f245bd4a4fc22a (diff)
morehype (11oct11)
git-svn-id: svn://tug.org/texlive/trunk@24269 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype/blog.sty')
-rw-r--r--Master/texmf-dist/tex/latex/morehype/blog.sty287
1 files changed, 176 insertions, 111 deletions
diff --git a/Master/texmf-dist/tex/latex/morehype/blog.sty b/Master/texmf-dist/tex/latex/morehype/blog.sty
index 6ff50a8ab58..5ff71be95e2 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/08/31 v0.5 simple fast HTML (UL)]
+\ProvidesPackage{blog}[2011/10/10 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.
@@ -21,12 +21,17 @@
%% |\CLBrk| is a \emph{code line break}
%% (also saving subsequent comment mark):
\newcommand*{\CLBrk}{^^J}
+%% |\htmakeext| is the extension of the generated file.
+%% Typically it should be `.html', as set here,
+%% but my Atari emulator needs `.htm'
+%% (see `texblog.fdf'):
+\newcommand*{\htmakeext}{.html}
%% |\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
-%% \acro{HTML} tag \xmltagcode{p} for starting a new paragraph.
+%% \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,
@@ -43,6 +48,8 @@
\ProcessOptions
\MakeOther\< \MakeOther\> %% TODO ...
\newcommand*{\BlogCopyFile}[2][]{%
+ \typeout{^^J\screenqtd{blog.sty} generating %% 2011/10/05
+ \screenqtd{\htmljob\htmakeext}}%
\ProcessFileWith[\BlogCodes
\let\ProvidesFile\BlogProvidesFile %% 2011/02/24
\let\protect\@empty %% 2011/03/24
@@ -61,15 +68,15 @@
\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 \acro{HTML}'s `&nbsp;'!
+%% use it for abbreviating \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
+%% In generating the \HTML\ file, the file infos are transformed
+%% into an \HTML\ comment. Actually it is
%% |\BlogProvidesFile| (for the time being, 2011/02/22):
\@ifdefinable\BlogProvidesFile{%
\def\BlogProvidesFile#1[#2]{%
@@ -87,19 +94,20 @@
%% \[`\let\ProvidesFile\BlogProvidesFile'\]
%% somewhere, e.g., in `\BlogCopyFile'.
%%
-%% \pagebreak[3] %% 2011/05/11
-%% == General \acro{HTML} Matters ==
+%% \pagebreak %% 2011/10/10
+%% == General \HTML\ Matters ==
%% The following stuff is required for any web page
%% (or hardly evitable).
%% === General Tagging ===
-%% $$|\TagSurr{<el-name>}{<attr>}{<content>}|$$
+%% %% $$ -> \[ ... 2011/10/10:
+%% \[|\TagSurr{<el-name>}{<attr>}{<content>}|\]
%% (I hoped this way code would be more readable
%% than with `\TagSurround' ...)
-%% and $$|\SimpleTagSurr{<el-name>}{<content>}|$$
+%% and \[|\SimpleTagSurr{<el-name>}{<content>}|\]
%% 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 \acro{HTML} code).
+%% spans lines (as readable \HTML\ code).
%% We will handle the latter kind of elements
%% using \LaTeX's idea of ``environments."
%% `\TagSurr' also inserts specifications of element
@@ -116,10 +124,10 @@
%% === Attributes === %%% (General) %%%
%% Inspired by the common way to use `@' for referring
%% to element attributes---i.e., `@<attr>' refers to attribute
-%% `<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 \acro{HTML} element.
+%% `<attr>'---in \HTML/\acro{XML} documentation, we often use
+%% \[`\@<attr>{<value>}' \qquad
+%% \mbox{to ``abbreviate"}\qquad `<attr>="<value>"'\]
+%% within the starting tag of an \HTML\ element.
%% This does not really
%% make typing easier or improve readability,
%% it rather saves \TeX's memory by using a single token
@@ -130,24 +138,32 @@
\newcommand*{\declareHTMLattrib}[1]{%
\def\reserved@a{@#1}%
\@ifundefined{@#1}%
-% {\@namedef{@#1}##1{ #1="##1"}}%
{\@namedef{@#1}##1{#1="##1"}}%
\@notdefinable}
%% So after `\declareHTMLattrib{<attr>}', `\@<attr>' is a
%% \TeX\ macro expecting one parameter for the specification.
%%
%% A few frequent attributes are declared this way here.
+%% %% 2011/09/27:
+%% |@class|, |@id|, |@style|, |@title|, |@lang|, and |@dir|
+%% are the ones named on
+%% \wikienref{HTML\#Attributes}{\meta{Wikipedia}}:
+\let\@class\relax %% for tab/arr in latex.ltx
+\declareHTMLattrib{class}
+\declareHTMLattrib{id}
+\declareHTMLattrib{style}
+\let\@title\relax %% for \title in latex.ltx
+\declareHTMLattrib{title} %% 2011/04/26
+\declareHTMLattrib{lang}
+\declareHTMLattrib{dir}
+%% |@type| is quite frequent too: %% doc. 2011/09/27
+\declareHTMLattrib{type}
%% |@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
-%% 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}
@@ -180,7 +196,6 @@
%% Some other uses of `\declareHTMLattrib' essential for
%% \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
@@ -193,28 +208,28 @@
%% well, not so bad, as the main purpose of this namespace
%% is saving tokens \emph{in macros.}
%%
-%% === \acro{HTML}'s Special Symbols ===
-%% |#| is needed for numerical specifications in \acro{HTML},
+%% === \HTML's Special Symbols ===
+%% |#| is needed for numerical specifications in \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 \acro{HTML} meaning.---I \textbf{wonder}
+%% in order to refer to their \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 \acro{HTML} symbols, `&' is simply
+%% with calling special \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 \acro{HTML}'s ampersand symbol.
+%% for calling \HTML's ampersand symbol.
{\catcode`\&=12 \catcode`\#=12
\gdef\AmpMark{&} \gdef\#{#}}
%% ... `\CompWordMark' etc.?
%%
%% === Head ===
-%% |\head| produces the first two tags that an \acro{HTML} file must start:
+%% |\head| produces the first two tags that an \HTML\ file must start:
\newcommand*{\head}{<html><head>} %% ^^J rm 2010/10/10
%% |\MetaTag{<inside>}| and |\ContentAtt{<value>}|
%% are internal shortcuts:
@@ -224,14 +239,14 @@
\newcommand*{\charset}[1]{%
\MetaTag{http-equiv="Content-Type" \ContentAtt{text/html; #1}}}
%% |\description{<text>}| for web searches (I think):
-\newcommand*{\description}[1]{%
- \MetaTag{\@name{description} \ContentAtt{#1}}}
-%% ... an outright \textbf{mistake!} TODO %% todo 2011/07/25
+% \newcommand*{\description}[1]{%
+% \MetaTag{\@name{description} \ContentAtt{#1}}}
+%% ... an outright \textbf{mistake!} %% commented out 2011/10/05
%% The definition is overridden
-%% to get the \acro{HTML} equivalent to \LaTeX's `description' environment.
+%% to get the \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!
+%% some |\MetaDescr| should be defined---and used finally! TODO
%%
%% |\robots{<instructions>}|:
\newcommand*{\robots}[1]{%% juergenf: index, follow, noarchive
@@ -242,7 +257,16 @@
%% `media="<media>"':
\newcommand*{\stylesheet}[2]{%
\space\space %% 2010/09/10
- <link rel="stylesheet" media="#1" type="text/css" \@href{#2.css}>}
+ <link rel="stylesheet" media="#1"
+ \@type{text/css} %% \@type 2011/10/05
+ \@href{#2.css}>}
+%% %% 2011/10/05:
+%% Alternatively, style declarations may occur in the
+%% \xmltagcode{style} element. It can be accessed by the
+%% |{style}| environment (cf. Sec.~\ref{sec:env}):
+\newenvironment*{style}[1]
+ {<style \@type{text/css} media="#1">}
+ {</style>}
%% With |\title{<text>}|, <text> heads %% grammar? TODO 2010/04/08
%% the browser window:
\renewcommand*{\title}[1]{\space\space<title>#1</title>}
@@ -270,9 +294,9 @@
%%
%% We ``re-use" some \LaTeX\ commands for specifying font attributes,
%% rather than (re)defining macros `\i', `\b', `\tt', ...
-%% $$|\textit{<text>}| \qquad
+%% \[|\textit{<text>}| \qquad
%% \mbox{just expands to}\qquad
-%% \xmltagcode{i}<text>\xmltagcode{/i}$$
+%% \xmltagcode{i}<text>\xmltagcode{/i}\]
\renewcommand*{\textit}{\SimpleTagSurr i}
%% etc. for |\textbf|, |\texttt| ...:
\renewcommand*{\textbf}{\SimpleTagSurr b}
@@ -280,7 +304,7 @@
%% |\textsf{<text>}| TODO (see some `makehtml.tex') %% 2011/05/11
%%
%% |\textcolor| is from \LaTeX's 'color' package
-%% that we won't load for generating \acro{HTML},
+%% 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"}}
@@ -289,21 +313,26 @@
%% |\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
+\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:
\renewcommand*{\emph} {\SimpleTagSurr{em}}
%% ... 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 \acro{HTML} element.
+%% |\strong{<text>}| again just calls an \HTML\ element.
%% It may behave like `\textbf{<text>}', or ... I don't know ...
-\newcommand*{\strong} {\SimpleTagSurr{strong}}
+\newcommand*{\strong}{\SimpleTagSurr{strong}}
%% %% 2011/03/09:
%% |\var{<symbol(s)>}| accesses the \xmltagcode{var} element:
\newcommand*{\var}{\SimpleTagSurr{var}}
+%% |\acronym{<chars>}| ... there is `\acro' in the TUGboat
+%% macros, while \HTML\ provides an \xmltagcode{acronym}
+%% environment ... %% 2011/09/21
+\newcommand*{\acronym}{\SimpleTagSurr{acronym}}
%%
%% == Environments ==
+%% \label{sec:env}
%% We reduce \LaTeX's |\begin| and |\end| to their most primitive
%% core.
%% \begin{description}
@@ -317,81 +346,81 @@
%% 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 \acro{HTML} elements
+%% `\begin' and `\end' just represent \HTML\ elements
%% (their starting/ending tags)
%% that typically have ``long" content.
%% (We might ``intercept" `\begin' and `\end' before
%% copying for executing some assignments in a future version.)
\let\begin\@nameuse
\def\end#1{\csname end#1\endcsname}
-%% |{center}|---TODO cf. \xmltagcode{center} 2010/07/18:
-\renewenvironment*{center}{<p align="center">}{</p>}
%% ... moving |{english}| to `xmlprint.cfg'
%% 2010/05/22 ...%% doc 2010/11/06
%%
%% As formerly with ``fonts," we have \emph{two} policies for
%% \textbf{choosing macro names}:
-%% (i)~using an \emph{existing} \acro{HTML} element name,
+%% (i)~using an \emph{existing} \HTML\ element name,
%% (ii)~using a \LaTeX\ command name for accessing a somewhat
-%% 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 \acro{HTML}'s <el-name> element
-%% according to policy~(ii):
-\newcommand*{\renderHTMLelement}[2]{%
- \renewenvironment*{#1}{<#2>}{</#2>}}
-%% Applying former auxiliaries:
-%%
-%% `\small' is a \LaTeX\ command from a \emph{class}---that
-%% we won't load, therefore we can create a \emph{new}
-%% |{small}| environment using \xmltagcode{small} according to
-%% policy~(i):
-\declareHTMLelement{small}
+%% similar \HTML\ element having a \emph{different} name.
+%% [\,2011/10/05: so what? TODO\,]
+%%
+%% New 2011/10/05:
+%% With |\useHTMLelement{<ltx-env>}{<html-el>}|,
+%% you can access the \xmltagcode{<html-el>} element
+%% by the `<ltx-env>' environment.
+%% The ``starred" form is for ``list" environments
+%% where I observed around 2011/10/01 that certain links
+%% (with Mozilla Firefox) need \xmltagcode{/li}:
+\newcommand*{\useHTMLelement}{%
+ \@ifstar{\@useHTMLelement[</li>]}{\@useHTMLelement}}
+\newcommand*{\@useHTMLelement}[3][]{%
+ \@namedef{#2}{<#3>}%
+ \@namedef{end#2}{#1</#3>}}
+%% Applications:
+%%
+%% \acro{CARE:} |{small}| is an environment here,
+%% it is not in \LaTeX:
+\useHTMLelement{small}{small}
+%% |{center}|: %% TODO von 2010/07/18, weiter oben
+% \renewenvironment*{center}{<p align="center">}{</p>}
+% \renewenvironment*{center}{<p \@align@c>}{</p>}
+\useHTMLelement{center}{center}
%% The next definitions for |{enumerate}|, |{itemize}|,
%% `{verbatim}' follow policy~(ii):
-\renderHTMLelement{enumerate}{ol}
-\renderHTMLelement{itemize} {ul}
+\useHTMLelement*{enumerate}{ol}
+\useHTMLelement*{itemize} {ul}
%% %% 2010/11/16:
%% With 'blog.sty', |{verbatim}| really doesn't work much
%% like its original \LaTeX\ variant. \TeX\ macros inside
%% still are expanded, and you must care yourself for
%% wanted \dqtd{quoting}:
-\renderHTMLelement{verbatim} {pre} %% 2010/09/10
-%%
-%% |{quote}| is defined in \LaTeX\ classes only again.
-%% 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 \acro{HTML} code
+\useHTMLelement{verbatim} {pre}
+%% |{quote}|:
+\useHTMLelement{quote}{blockquote}
+%% For list |\item|s, I tried to get readable \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'.
+%% 2011/10/04 including \xmltagcode{</li>},
+%% repairs more links in \acro{DANTE} talk:
\renewcommand*{\item}{\indenti<li>}
-%% <- 2010/05/23, 2010/06/10 ->
-% \renewcommand*{\item}{<li>}
%% \LaTeX's |{description}| environment redefines the
%% label format for the optional argument of `\item'.
%% Again, \emph{we} cannot do this here
%% (we even cannot use optional arguments,
%% at least not easily).
%% Instead we define a different |\ditem{<term>}|
-%% having a \emph{mandatory} argument.
-%% %% 2010/07/05:
-\renderHTMLelement{description}{dl}
+%% having a \emph{mandatory} argument
+%% (TODO star?). %% 2011/10/05
+\useHTMLelement{description}{dl}
\newcommand*{\ditem}[1]{\indenti<dt>\strong{#1}<dd>}
%%
%% == Links ==
%% === Basic Link Macros ===
%% |\hanc{<id>}{<text>}| makes <text> an anchor with
-%% \acro{HTML} label <id> (like 'hyperref''s `\hypertarget'):
+%% \HTML\ label <id> (like 'hyperref''s `\hypertarget'):
\newcommand*{\hanc}[1]{\TagSurr a{\@name{#1}}}
%% |\hancref{<id>}{<url>}{<text>}| makes <text> an anchor with
-%% \acro{HTML} label <id> and at the same time a link to <url>:
+%% \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}}}
@@ -426,7 +455,7 @@
%%
%% === Built Macros for Links to Local Files ===
%% Originally, I wanted to refer to my web pages only,
-%% using $$|\fileref{<filename-base>}|.$$ I have used
+%% using \[|\fileref{<filename-base>}|.\] I have used
%% extension `.htm' to avoid disturbing my Atari
%% editor 'xEDIT' or the the Atari emulator (Hatari).
%% %% rm. 2011/08/18:
@@ -439,6 +468,7 @@
%% general `\FileRef{<filename>}|', overlooking
%% that it was the same as |\href|.
% \newcommand*{\FileRef}[1]{\TagSurr a{\@href{#1}}}
+\newcommand*{\htext}{.htm} %% 2011/10/05
\newcommand*{\fileref}[1]{\href{#1\htext}}
% \newcommand*{\emfileref}[2]{\fileref{#1}{\emph{#2}}}
\newcommand*{\itfileref}[2]{\fileref{#1}{\textit{#2}}}
@@ -477,9 +507,9 @@
\TagSurr a{\@href{https://#1" target="_blank}}}
%%
%%
-%% == Symbols == %% ordering 2011/02/25
+%% == Characters/Symbols == %% `Symbols' until 2011/09/25
%% === Basic Preliminaries ===
-%% |&| is made `other' for using it to call \acro{HTML}'s
+%% |&| is made `other' for using it to call \HTML's
%% ``character entities." %% dot inside 2011/02/25
\@makeother\&
%% Again we have the two policies about choosing macro names
@@ -498,6 +528,7 @@
\renderHTMLsymbol{\&}{amp}
\let\%\PercentChar
%%
+%% \pagebreak %% output routine problem 2011/10/05
%% === Diacritics === %% changed 2011/03/04
%% For the difference between \dqtd{diacritic} and
%% \dqtd{accent,} see \wikienref{Diacritic}{Wikipedia}.
@@ -505,7 +536,7 @@
%% |\ccedil|: %%%, |\eacute|, |\ocirc| (``r\^ole")
\declareHTMLsymbol{ccedil}
%% %% 2011/03/04:
-%% \acro{HTML} entities |&eacute;|, |&ocirc;| etc. can be accessed
+%% \HTML\ entities |&eacute;|, |&ocirc;| etc. can be accessed
%% by \TeX's accent commands |\'|, |\^|, |\`|, |\"|:
% \declareHTMLsymbol{eacute}
% \declareHTMLsymbol{ocirc}
@@ -581,7 +612,7 @@
%%
%% === Dashes ===
%% The ligatures `--' and `---' for en~dash and em~dash
-%% don't work in our expanding mode. Now, \acro{HTML}'s policy
+%% don't work in our expanding mode. Now, \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
@@ -599,7 +630,7 @@
\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"
+%% while |\thinspace| and |\,| use Unicode ``Narrow No-Break Space"
%% (`U+202F', see \meta{Wikipedia \Wikienref{Space (punctuation)}};
%% browser support?):
% \renderHTMLsymbol{\thinspace}{thinsp}
@@ -607,13 +638,15 @@
\declareHTMLsymbol{thinsp}
\renderHTMLsymbol{\thinspace}{\#8239}
\renderHTMLsymbol{\,} {\#8239}
+%% |\figurespace| %% 2011/09/25
+%% (U+2007, cf.~\wikienref{Figure space}{\meta{Wikipedia}}):
+\newcommand*{\figurespace}{&\#8199;}
%%
%% === 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 \acro{HTML} apostrophe,
+%% In order to use the right single quote for the \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
@@ -627,7 +660,8 @@
%% save `\screenqtd'! Tilde likwise!?
%% ... TODO change `\catcode`\`'!? 2010/04/26
%%
-%% |\ldquo|, |\rdquo|, |\sbquo|, |\prime|, |\Prime| ...
+%% |\bdquo|, |\ldquo|, |\rdquo|, |\sbquo|, |\prime|, |\Prime| ...
+\declareHTMLsymbol{bdquo} %% 2011/09/23
\declareHTMLsymbol{ldquo}
\declareHTMLsymbol{rdquo}
\declareHTMLsymbol{sbquo} %% 2010/07/01
@@ -637,15 +671,15 @@
%% |\endqtd{<text>}| quotes in the English style using double quote
%% marks, |\enqtd{<text>}| uses single quote marks instead, and
%% |\dedqtd{<text>}| quotes in German style:
-\def\endqtd#1{\ldquo#1\rdquo} %% \newcommand: "\end"
+\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}
+\newcommand*{\dedqtd}[1]{\bdquo#1\ldquo}
\newcommand*{\deqtd}[1]{&sbquo;#1&lsquo;} %% corr. 2011/05/14
-%% ... TODO `\bdquo'!? %% 2010/11/08
+%% TODO `\glqq' from 'german.sty' etc. %% 2011/09/22
%%
%% === Math ===
%% %% doc. extended 2011/05/08:
-%% Because \verb+<+ and \verb+>+ are used for \acro{HTML}'s
+%% Because \verb+<+ and \verb+>+ are used for \HTML's
%% element notation, we provide aliases |\gt|, |\lt|
%% for mathematical $\lt$ and $\gt$:
\declareHTMLsymbol{gt}
@@ -675,12 +709,12 @@
\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}:
+%% inspired by \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
+%% \TeX\ and \HTML\ agree on |\cap|, |\cup|, %% 2011/05/08
%% and |\times|:
\declareHTMLsymbol{cap} %% 2011/04/04
\declareHTMLsymbol{cup} %% 2011/04/04
@@ -690,7 +724,8 @@
%% 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}
+%% We override \HTML's \lq`&circ;'\rq\ %% \lq\rq 2011/09/08
+%% to get \TeX's \cs{circ}
%% (i.e., $\circ$; %% 2011/05/08:
%% \textcolor{red}{but I cannot see it
%% on my own pages!?}):
@@ -698,8 +733,14 @@
\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}:
+%% the \wikideref{Malzeichen\#Skalarprodukt}
+%% {German \meta{Wikipedia}} %% 2011/09/08!
\declareHTMLsymbol{sdot} %% 2011/05/08
+%% I provide |\degrees| for the degree symbol.
+%% \LaTeX\ already has `\deg' as an operator,
+%% therefore I do not want to use `\declareHTMLsymbol'
+%% here.
+\newcommand*{\degrees}{&deg;}
%%
%% === Other ===
%% The tilde |~| is used for its wonderful purpose,
@@ -723,12 +764,15 @@
%% |\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;',
+%% \qtd{\S}. In \HTML, the latter accessed by `&sect;',
%% we \dqtd{redirect} `\S' to this: %% 2011/05/18
\renderHTMLsymbol{\S}{sect}
+%% |\dagger|, |\ddagger|: %% 2011/10/01
+\renderHTMLsymbol{\dagger}{dagger}
+\renderHTMLsymbol{\ddagger}{Dagger}
%%
%%
-%% == \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 ===
@@ -750,23 +794,25 @@
\newcommand*{\XeTeX}{\prg{XeTeX}} %% 2010/10/09
\newcommand*{\TeXbook}{TeXbook} %% 2010/09/13
%%
-%% === Else ===
+%% === Describing Macros ===
%% With v0.4, \TeX-related \emph{links} are moved to 'texlinks.sty'.
%%
%% |\texcs{\<tex-cmd-name>}| or `\texcs\<tex-cmd-name>'
%% (care for spacing yourself):
-\newcommand*{\texcs}[1]{\code{\string#1}} %% 2010/11/13
+\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
+\def\cs#1{\code{\BackslashChar#1}} %% 2011/03/06
+%% |\metavar{<name>}|: %% 2011/09/22
+\newcommand*{\metavar}[1]{\angled{\meta{#1}}}
%%
%% == Tables ==
%% %% 2011/04/24: rm. remark on doubtful stability, ordered
%% === Indenting ===
%% There are three levels of indenting:
-%% $$|\indenti|, \quad
+%% \[|\indenti|, \quad
%% |\indentii|,\quad \mbox{and}\quad
-%% |\indentiii|.$$
-%% The intention for these was to get readable \acro{HTML} code. Not sure ...
+%% |\indentiii|.\]
+%% The intention for these was to get readable \HTML\ code. Not sure ...
{\catcode`\ =12%% 2010/05/19
\gdef\indenti{ }\gdef\indentii{ }\gdef\indentiii{ }}
%%
@@ -783,7 +829,7 @@
{\indenti</tbody>\CLBrk\endTable}
%% === Rows ===
%% I first thought it would be good for readability if
-%% some \acro{HTML} comments explain nesting or briefly describe
+%% some \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 ...
@@ -795,7 +841,7 @@
\newenvironment{tablecoloredrow}[2]
{\TableRow{#1}{\@bgcolor{#2}}}
{\endTableRow}
-%% "top" 2010/05/18:
+%% ``top" 2010/05/18:
\newenvironment{tablerow}[1]{\TableRow{#1}{\@valign@t}}
{\endTableRow}
%% 2010/07/18:
@@ -830,6 +876,7 @@
%% 2010/07/18:
\newcommand*{\startTd}[1]{<td #1>}
\def\endTd{</td>}
+\newcommand*{\emptycell}{<td />} %% 2011/10/07
%%
%% === Filling a Row with Dummy Cells ===
%% Generalization 2010/06/28:
@@ -841,11 +888,12 @@
\newcommand*{\fillrowcolor}[2]{\FillRow{#1}{\@bgcolor{#2}}}
%%
%% == Misc ==
-%% |\comment{<comment>}| produces a one-line \acro{HTML} comment.
+%% |\comment{<comment>}| produces a one-line \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 \acro{HTML} comments ...)
+%% for multi-line comments. %% was mult-l... 2011/09/08
+%% It is convenient for ``commenting out"
+%% code (unless the latter contains other \HTML\ comments ...)
%% where <comment> is a \emph{comment} for explaining what is
%% commented out. %% 2010/11/14
\newcommand*{\comment}[1]{<!--#1-->}
@@ -855,10 +903,10 @@
{<!--#1}
{-->}
%% \TeX's |\hrule| (rather deprecated in \LaTeX) is redefined
-%% to produce an \acro{HTML} horizontal line:
+%% to produce an \HTML\ horizontal line:
\renewcommand*{\hrule}{<hr>}
%% Redefining |\ | to be the same as `\space' may be helpful
-%% for manual indenting or spacing of \acro{HTML} code.
+%% for manual indenting or spacing of \HTML\ code.
%% Or better (just now remembering): I used it for making
%% ``ASCII trees" with the \xmltagcode{pre} element
%% (redefined `verbatim').
@@ -920,7 +968,7 @@ 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
+part of MOREHYPE RELEASE r0.3
v0.5 2011/02/22 \BlogProvidesFile
2011/02/24 ... in \BlogCopyFile
2011/02/25 ordering symbols
@@ -956,3 +1004,20 @@ v0.5 2011/02/22 \BlogProvidesFile
2011/07/25 "todo" on \description
2011/08/18f.removing \FileRef, 0.42-> 0.5
2011/08/31 clarified use of \urlapostr
+part of MOREHYPE RELEASE r0.4
+v0.6 2011/09/08 doc. uses \HTML, \lq/\rq with &circ;,
+ doc. fix `mult-'; \degrees
+ 2011/09/21 \acronym
+ 2011/09/22 \metavar; TODO \glqq...
+ 2011/09/23 \bdquo
+ 2011/09/25 doc. `Characters/Symbols'; \figurespace
+ 2011/09/27 "universal" attributes completed, reworked doc.
+ 2011/09/30 end lists with </li>
+ 2011/10/01 \dagger, \ddagger
+ 2011/10/04 \item includes </li>
+ 2011/10/05 {style}; doc. \acronym -> \acro, \pagebreak,
+ rm. \description; {center} accesses <center>,
+ \useHTMLenvironment replaces \declareHTMLelement
+ and \renderHTMLelement, message "generating"
+ 2011/10/07 \emptycell
+ 2011/10/10 doc.: page breaks, $$->\[/\]