summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/morehype
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-09-03 23:13:56 +0000
committerKarl Berry <karl@freefriends.org>2011-09-03 23:13:56 +0000
commitea16ae60028a1e6e1820c3a99a66a74369259f8c (patch)
treefde2a436c9b9a938da63173bdcee14495fe4172c /Master/texmf-dist/source/latex/morehype
parent320a834d2e64000bb5ba96aa67dfcc2435ad26f8 (diff)
morehype update (1sep11)
git-svn-id: svn://tug.org/texlive/trunk@23781 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/morehype')
-rw-r--r--Master/texmf-dist/source/latex/morehype/README.tex11
-rw-r--r--Master/texmf-dist/source/latex/morehype/blog.tex105
-rw-r--r--Master/texmf-dist/source/latex/morehype/makedoc.cfg40
-rw-r--r--Master/texmf-dist/source/latex/morehype/mdoccorr.cfg51
-rw-r--r--Master/texmf-dist/source/latex/morehype/srcfiles.tex6
-rw-r--r--Master/texmf-dist/source/latex/morehype/texlinks.tex16
6 files changed, 91 insertions, 138 deletions
diff --git a/Master/texmf-dist/source/latex/morehype/README.tex b/Master/texmf-dist/source/latex/morehype/README.tex
deleted file mode 100644
index ce26748edb5..00000000000
--- a/Master/texmf-dist/source/latex/morehype/README.tex
+++ /dev/null
@@ -1,11 +0,0 @@
-\ProvidesFile{README.tex}[2010/11/27 make README.pdf]
-\listfiles
-
-\documentclass[12pt]{article}
-\usepackage{verbatim}
-\pagestyle{empty}
-\begin{document}
-\vspace*{-2\baselineskip}
-\enlargethispage{1\baselineskip}
-\verbatiminput{README.txt}
-\end{document}
diff --git a/Master/texmf-dist/source/latex/morehype/blog.tex b/Master/texmf-dist/source/latex/morehype/blog.tex
index cf46597d225..b97f899fecf 100644
--- a/Master/texmf-dist/source/latex/morehype/blog.tex
+++ b/Master/texmf-dist/source/latex/morehype/blog.tex
@@ -1,6 +1,6 @@
-\ProvidesFile{blog.tex}[2011/01/27 documenting blog.sty]
+\ProvidesFile{blog.tex}[2011/09/01 documenting blog.sty]
\title{\textsf{blog.sty}\\---\\%
- Generating HTML Quickly with \TeX\thanks{This
+ Generating \acro{HTML} Quickly with \TeX\thanks{This
document describes version
\textcolor{blue}{\UseVersionOf{\jobname.sty}}
of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
@@ -12,7 +12,6 @@
\documentclass{article}%% TODO paper dimensions!?
\input{makedoc.cfg} %% shared formatting settings
\ReadPackageInfos{blog}
-\usepackage{color}
%% \tagcode seems to be a quite recent pdfTeX primitive,
%% cf. microtype.pdf ... %% 2010/11/06
\newcommand*{\xmltagcode}[1]{\texttt{<#1>}}
@@ -24,9 +23,9 @@
based on processing text files using the 'fifinddo' package.
Some \LaTeX\
commands %%% command names
-are redefined to access their HTML
+are redefined to access their \acro{HTML}
equivalents, other new macro names ``quote" the names of
-HTML elements. The package has evolved in several little steps
+\acro{HTML} elements. The package has evolved in several little steps
each aiming at getting pretty-looking ``hypertext" \textbf{notes}
with little effort,
where ``little effort" also has meant avoiding studying
@@ -35,13 +34,13 @@ documentation of similar packages already existing.
% Version v0.3 is the remainder of v0.2 after moving some stuff
% to 'fifinddo.sty' (especially `\CopyFile');
% moreover, the new `\BlogCopyFile' replaces empty source lines
-% by HTML's \xmltagcode{p} (starting a new paragraph).---Real
+% by \acro{HTML}'s \xmltagcode{p} (starting a new paragraph).---Real
% \emph{typesetting} from the same `.tex' source
% (pretty printable output) has not been tried yet.
%% <- 2011/01/24 ->
The package %%% rather
\emph{``misuses"} \TeX's macro language
-for generating HTML code and entirely \emph{ignores}
+for generating \acro{HTML} code and entirely \emph{ignores}
\TeX's typesetting capabilities.%%%---What about
% such a ``small" \TeX\ with macros only and
% \emph{no} typesetting capabilities ...!?
@@ -58,7 +57,7 @@ putting it somewhere where \TeX\ finds it
\strong{User commands} are described near their implementation below.
However, we must present an \strong{outline} of the procedure
-for generating HTML files:
+for generating \acro{HTML} files:
At least one \strong{driver} file and one \strong{source} file are
needed.
@@ -72,44 +71,100 @@ and uses file handling commands from 'blog.sty' and
\CtanPkgRef{nicetext}{fifinddo}
(cf. `mdoccheat.pdf' from the \ctanpkgref{nicetext} bundle).
It chooses \strong{source} files and the name(s) for the resulting
-HTML file(s). It may also need to load local settings, such as
+\acro{HTML} file(s). It may also need to load local settings, such as
for the language
%% modified 2011/01/25:
(`lang-de.fdf', `lang-en.fdf'),
and settings for converting the editor's text encoding
-into the encoding that the head of the resulting HTML file advertises
-(`atari.fdf').
+into the encoding that the head of the resulting \acro{HTML} file advertises
+(`atari.fdf' in the 'nicetext' bundle).
-The driver file can run a terminal dialogue in order to choose source
+The driver file could be run a terminal dialogue in order to choose source
and target files and settings. So far, I rather have programmed a
dialogue just for converting UTF-8 into an encoding that my
-Atari editor xEDIT can deal with
-[TODO: present in 'nicetext']. %% 2011/01/24
+Atari editor \textsc{xEDIT} can deal with.
+I do not present this now because it was conceptually mistaken,
+I must set up this conversion from scratch some time.
+% [TODO: present in 'nicetext']. %% 2011/01/24
The \strong{source} file(s) should contain user commands defined below
to generate the necessary \xmltagcode{head} section and the
\xmltagcode{body} tags.
-\section{Example}
+\section{Examples}
+\subsection{A Very Plain Style}
My ``\TeX-generated
-pages"{\footnote{\urlhttpref{www.webdesign-bu.de/uwe\underscorechar
- lueck/texmap.htm}}}
+pages"{\foothttpurlref{www.webdesign-bu.de/%
+ uwe\string_lueck/texmap.htm}}
use a \strong{driver} file `makehtml.tex'.
-To choose a page to generate, I ``uncomment" just one
+To choose a page to generate, I ``uncomment"ed just one
of several lines that set the ``current conversion job"
-from a list. I choose the example of a simple ``site map:"
-`texmap.htm' is generated from \strong{source} file `texmap.tex'.
+from a list (for some time).
+I choose the example of a simple ``site map:"
+`texmap.htm' is generated from \strong{source} file
+`texmap.tex'.---More recently however, I have started to
+read the job name and perhaps extra settings from a file
+`jobname.tex' that is created by a Bash script.
+
+In order to make it easier for the reader to see what is essential,
+I~have moved many `.cfg'-like extra definitions into a file
+`texblog.fdf'. Some of these definitions may later move into
+`blog.sty'. You should find `makehtml.tex', `texmap.tex', and
+`texblog.fdf' in a directory `demo/texblog', perhaps you can use them
+as templates.
\begingroup
\MakeOther\|\MakeOther\`\MakeOther\'\MakeOther\<
\MakeActive\ \def{\"u}
\hfuzz=\textwidth \advance \hfuzz by 28pt
-\subsection{Driver File \texttt{makehtml.tex}}
- \listinginput[5]{1}{makehtml.tex}
-\subsection{Source File \texttt{texmap.tex}}
- \listinginput[5]{1}{texmap.tex}
+\subsubsection{Driver File `makehtml.tex'}
+ \listinginput[5]{1}{CTAN/morehype/demo/texblog/makehtml.tex}
+\subsubsection{Source File `texmap.tex'}
+ \listinginput[5]{1}{CTAN/morehype/demo/texblog/texmap.tex}
+\endgroup
+
+\subsection{A Style with a Navigation Column}
+A style of web pages looking more professional than `texhax.hmt'
+(while perhaps becoming outdated) has a small navigation column
+on the left, side by side with a column for the main content.
+Both columns are spanned by a header section above and a footer
+section below. The package 'twocolpg.sty' provides commands
+`\PAGEHEAD', `\PAGENAVI', `\PAGEMAIN', `\PAGEFOOT', `\PAGEEND'
+(and some more) for structuring the source so that the code
+following `\PAGEHEAD' generates the header, the code following
+`\PAGENAVI' forms the content of the navigation column, etc.
+For real professionality, somebody must add some fine \acro{CSS},
+and the macros mentioned may need to be redefined to use the `@class'
+attribute. Also, I am not sure about the table macros in 'blog.sty',
+so much may change later.
+
+With things like these, can 'blog.sty' become a part of a
+``\Wikienref{content management system}" for \TeX\ addicts?
+This idea rather is based on the
+\wikideref{Content Management System}{\meta{German}}
+Wikipedia article.
+
+As an example, I present parts of the source for my
+``home page"{\foothttpurlref{www.webdesign-bu.de/%
+ uwe\string_lueck/schreibt.html}}.
+As the footer is the same on all pages of this style,
+it is added in the driver file `makehtml.tex'.
+`schreibt.tex' is the source file for generating `schreibt.html'.
+You should find \emph{this} `makehtml.tex', a cut down version of
+`schreibt.tex', and `writings.fdf' with my extra macros for these pages
+in a directory `demo/writings', hopefully useful as templates.
+
+\begingroup
+ \MakeOther\|\MakeOther\`\MakeOther\'\MakeOther\<
+ \MakeActive\ \def{\"u}
+ \hfuzz=\textwidth \advance \hfuzz by 10pt
+\subsubsection{Driver File `makehtml.tex'}
+ \listinginput[5]{1}{CTAN/morehype/demo/writings/makehtml.tex}
+\subsubsection{Source File `schreibt.tex'}
+ \listinginput[5]{1}{CTAN/morehype/demo/writings/schreibt.tex}
\endgroup
+
\section{The Package File}
\subsection{Package File Header (Legalize)}
\errorcontextlines=5
@@ -123,3 +178,5 @@ HISTORY
2010/11/11 for v0.3
2011/01/23 using readprov and color
2011/01/27 using \urlfoot
+2011/09/01 using new makedoc.cfg incl. \acro and \foothttp...;
+ extension for twocolpg.sty
diff --git a/Master/texmf-dist/source/latex/morehype/makedoc.cfg b/Master/texmf-dist/source/latex/morehype/makedoc.cfg
deleted file mode 100644
index 43d57ed87cc..00000000000
--- a/Master/texmf-dist/source/latex/morehype/makedoc.cfg
+++ /dev/null
@@ -1,40 +0,0 @@
-\ProvidesFile{makedoc.cfg}[2011/01/24 documentation settings]
-
-\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}}
-% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}}
-
-%% hyperref:
-\RequirePackage{ifpdf}
-\usepackage[%
- \ifpdf
-% bookmarks=false, %% 2010/12/22
-% bookmarksnumbered,
- bookmarksopen, %% 2011/01/24!?
- bookmarksopenlevel=2, %% 2011/01/23
-% pdfpagemode=UseNone,
-% pdfstartpage=10,
-% pdfstartview=FitH,
- citebordercolor={ .6 1 .6},
- filebordercolor={1 .6 1},
- linkbordercolor={1 .9 .7},
- urlbordercolor={ .7 1 1}, %% playing 2011/01/24
- \else
- draft
- \fi
-]{hyperref}
-
-\RequirePackage{niceverb}[2011/01/24]
-\RequirePackage{readprov} %% 2010/12/08
-\RequirePackage{hypertoc} %% 2011/01/23
-\RequirePackage{texlinks} %% 2011/01/24
-\makeatletter
- \@ifundefined{strong}
- {\let\strong\textbf} %% 2011/01/24
- {}
-\makeatother
-
-\errorcontextlines=4
-\pagestyle{headings}
-
-\endinput
-
diff --git a/Master/texmf-dist/source/latex/morehype/mdoccorr.cfg b/Master/texmf-dist/source/latex/morehype/mdoccorr.cfg
deleted file mode 100644
index bbcadd90e34..00000000000
--- a/Master/texmf-dist/source/latex/morehype/mdoccorr.cfg
+++ /dev/null
@@ -1,51 +0,0 @@
-\ProvidesFile{mdoccorr.cfg}[2011/01/27
- local typographical corrections
- with makedoc.sty]
-%% ... also demonstrates 'niceverb.sty'---see the typeset
-%% documentation of the present file in `makedoc.pdf'.
-%%
-%% |\SetPatternCodes{<commands>}| redefines
-%% `\PatternCodes' to be used in parsing and replacing
-%% (some ``sanitizing"). %% improved line breaks 2010/03/29
-\SetPatternCodes{\MakeOther\\\MakeOther\ }
-%% |\StartPrependingChain| initializes setup of a replacement
-%% chain:
-\StartPrependingChain
-%% |\PrependExpandableAllReplacer{<id>}{<find>}{<subst>}|:
-\PrependExpandableAllReplacer{etc}{etc. }{etc.\ }
-%% ... you can keep inter-sentence space after `etc.'
-%% by a code line break.
-\PrependExpandableAllReplacer{Cf}{Cf. }{Cf.\ } %% 2011/01/12
-\PrependExpandableAllReplacer{cf}{cf. }{cf.\ } %% corr. 2010/03/23
-%% ... but think of `cf.~'. Don't leave `cf.' at code line end!
-\PrependExpandableAllReplacer{rarr}{->}{$\to$} %% 2010/11/06
-\PrependExpandableAllReplacer{larr}{<-}{$\gets$} %% 2010/11/06
-% \PrependExpandableAllReplacer{dots}{...}{$\dots$}
-%% ... 2010/11/24 ``symmetric" variant of `\textellipsis':
-%% allow extra space at line end.
-\newcommand*{\PXAR}{\PrependExpandableAllReplacer}
-\PXAR{dots}{...}{.\kern\fontdimen3\font.\kern\fontdimen3\font.}
-\PXAR{dots }{... }{.\kern\fontdimen3\font.\kern\fontdimen3\font.\ }
-\PXAR{TODO}{TODO}{\textcolor{blue}{TODO}} %% 2011/01/27
-%% ... chain starts here, and here |\MakeDocCorrectHook| (silently)
-%% enters through a default variant |\SetCorrectHookJobLast|
-%% of |\SetCorrectHookJob{<id>}|:
-\SetCorrectHookJobLast
-%%
-%% |\ResetPatternCodes| resets `\PatternCodes' to their default
-%% value (which is `\fdPatternCodes'):
-\ResetPatternCodes
-%% ... restores 'fifinddo' default.
-\endinput
-
-HISTORY
-2009/04/05 with makedoc v0.2
-2010/03/11 broke some too long code lines
-2010/03/16 rendered `mdoccorr.cfg'
-2010/03/22 try \Prepend...
-2010/03/23 corrected `cf'
-2010/03/29 use \SetPatternCodes etc.
-2010/11/06 <- and ->
-2010/11/24 `...' ``symmetric variant" of `\textellipsis';
- \StartPrependingChain, no more \MakeExpandableAllreplacer
-2011/01/27 blue "TODO"
diff --git a/Master/texmf-dist/source/latex/morehype/srcfiles.tex b/Master/texmf-dist/source/latex/morehype/srcfiles.tex
deleted file mode 100644
index 8e7528b2bcf..00000000000
--- a/Master/texmf-dist/source/latex/morehype/srcfiles.tex
+++ /dev/null
@@ -1,6 +0,0 @@
-\RequirePackage{myfilist}
-\ProvidesFile{srcfiles.tex}[2011/02/10 collect file infos]
-\EmptyFileList %%% [readprov.sty,myfilist.sty]
-\ReadPackageInfos{blog,hypertoc,texlinks}
-\ReadFileInfos{blog,hypertoc,texlinks,atari.fdf,lang-de.fdf,lang-en.fdf,makedoc.cfg,mdoccorr.cfg,srcfiles}
-\ListInfos[SRCFILEs.txt]
diff --git a/Master/texmf-dist/source/latex/morehype/texlinks.tex b/Master/texmf-dist/source/latex/morehype/texlinks.tex
index 221c9471b60..e36bf0cc704 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/01/27 documenting texlinks.sty]
+\ProvidesFile{texlinks.tex}[2011/08/27 documenting texlinks.sty]
\title{\textsf{texlinks.sty}\\---\\\TeX-Related Links
for \textsf{hyperref}, \textsf{blog.sty}\\
(and maybe more)\thanks{This
@@ -24,16 +24,18 @@
'texlinks.sty' provides a couple of shorthands for making hyperlinks
with \ctanpkgref{hyperref}'s\urlpkgfoot{hyperref} `\href' command,
linking to URLs that one often refers to in discussing \TeX-related material.
-Especially, TUG material
+Especially, \acro{TUG} material
(including texhax postings and TUGboat articles) and
-CTAN pages (package descriptions, directories, Catalogue)
-are supported, also the UK~FAQ and Wikipedia
+\acro{CTAN} pages (package descriptions, directories, Catalogue)
+are supported, also the UK~FAQ,
+the \LaTeX\ Wikibook, %% 2011/08/27
+and Wikipedia
(where much \TeX-related software is described in a
visually appealing manner).
-However, up to now I have used them for \emph{HTML} overviews
+However, up to now I have used them for \emph{\acro{HTML}} overviews
generated with 'blog.sty'.
They may as well be useful with better known (and better developed)
-\TeX\,$\to$\,HTML software such as
+\TeX\,$\to$\,\acro{HTML} software such as
\ctanpkgref{tex4ht}\urlpkgfoot{tex4ht} or
\CtanPkgRef{latex2html}{LaTeX2HTML}\urlpkgfoot{latex2html}
(I don't know).
@@ -65,3 +67,5 @@ VERSION HISTORY
2011/01/24 for v0.1, very first
2011/01/27 for v0.2, use \urlfoot{ukfaq}
+2011/07/23 using \acro
+2011/08/27 mentioning LaTeX Wikibook in abstract