summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/morehype
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-02-02 01:06:44 +0000
committerKarl Berry <karl@freefriends.org>2011-02-02 01:06:44 +0000
commitf9cdf6d0869e9672668bf7e5f523c80aa7ea44b1 (patch)
tree054fbf8d266e0b01bb808debd6134aa754a0eede /Master/texmf-dist/doc/latex/morehype
parent5575cc4b3dc1b6c24a4f1b3f693118591a04bba7 (diff)
morehype (1feb11)
git-svn-id: svn://tug.org/texlive/trunk@21256 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/morehype')
-rw-r--r--Master/texmf-dist/doc/latex/morehype/RELEASE.txt4
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/README.tex11
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/blog.tex125
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/gather.tex6
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/hypertoc.tex79
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/makedoc.cfg40
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/mdoccorr.cfg51
-rw-r--r--Master/texmf-dist/doc/latex/morehype/docsrc/texlinks.tex66
-rw-r--r--Master/texmf-dist/doc/latex/morehype/makehtml.tex (renamed from Master/texmf-dist/doc/latex/morehype/docsrc/makehtml.tex)0
-rw-r--r--Master/texmf-dist/doc/latex/morehype/texmap.tex (renamed from Master/texmf-dist/doc/latex/morehype/docsrc/texmap.tex)0
10 files changed, 3 insertions, 379 deletions
diff --git a/Master/texmf-dist/doc/latex/morehype/RELEASE.txt b/Master/texmf-dist/doc/latex/morehype/RELEASE.txt
index 3721f420937..f8ef768d33b 100644
--- a/Master/texmf-dist/doc/latex/morehype/RELEASE.txt
+++ b/Master/texmf-dist/doc/latex/morehype/RELEASE.txt
@@ -1,4 +1,6 @@
r0.2 2011/01/27 texlinks v0.2 \urlfoot
\urlfoot displays the URL that some shorthand generates
in a footnote. E.g., \ukfaqref{LABEL}{TEXT} generates
-an URL that \urlfoot{ukfaqref}{LABEL} displays. \ No newline at end of file
+an URL that \urlfoot{ukfaqref}{LABEL} displays.
+
+r0.2a 2011/01/30 makehtml.tex+texmap.tex to `doc', TDS with `source' \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/README.tex b/Master/texmf-dist/doc/latex/morehype/docsrc/README.tex
deleted file mode 100644
index ce26748edb5..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/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/doc/latex/morehype/docsrc/blog.tex b/Master/texmf-dist/doc/latex/morehype/docsrc/blog.tex
deleted file mode 100644
index cf46597d225..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/blog.tex
+++ /dev/null
@@ -1,125 +0,0 @@
-\ProvidesFile{blog.tex}[2011/01/27 documenting blog.sty]
-\title{\textsf{blog.sty}\\---\\%
- Generating HTML Quickly with \TeX\thanks{This
- document describes version
- \textcolor{blue}{\UseVersionOf{\jobname.sty}}
- of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
-% \listfiles
-{ \RequirePackage{makedoc} \ProcessLineMessage{}
- \renewcommand\mdSectionLevelOne{\string\subsection}
- \renewcommand\mdSectionLevelTwo{\string\subsubsection}
- \MakeJobDoc{17}{\SectionLevelTwoParseInput} }
-\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>}}
-\sloppy
-\begin{document}
-\maketitle
-\begin{abstract}\noindent
-'blog.sty' provides \TeX\ macros for generating web pages,
-based on processing text files using the 'fifinddo' package.
-Some \LaTeX\
-commands %%% command names
-are redefined to access their HTML
-equivalents, other new macro names ``quote" the names of
-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
-documentation of similar packages already existing.
-[TODO: list them!]
-% 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
-% \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}
-\TeX's typesetting capabilities.%%%---What about
-% such a ``small" \TeX\ with macros only and
-% \emph{no} typesetting capabilities ...!?
-\end{abstract}
-\tableofcontents
-
-\section{Installing and Usage}
-The file 'blog.sty' is provided ready,
-\strong{installation} only requires
-putting it somewhere where \TeX\ finds it
-(which may need updating the filename data
- base).\urlfoot{ukfaqref}{inst-wlcf}
-
-\strong{User commands} are described near their implementation below.
-
-However, we must present an \strong{outline} of the procedure
-for generating HTML files:
-
-At least one \strong{driver} file and one \strong{source} file are
-needed.
-
-The \strong{driver} file's name is stored in `\jobname'.
-It loads 'blog.sty' by
-\begin{verbatim}
- \RequirePackage{blog}
-\end{verbatim}
-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
-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').
-
-The driver file can 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
-
-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}
-My ``\TeX-generated
-pages"{\footnote{\urlhttpref{www.webdesign-bu.de/uwe\underscorechar
- lueck/texmap.htm}}}
-use a \strong{driver} file `makehtml.tex'.
-To choose a page to generate, I ``uncomment" 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'.
-
-\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}
-\endgroup
-
-\section{The Package File}
-\subsection{Package File Header (Legalize)}
- \errorcontextlines=5
- \ResetCodeLineNumbers
-\input{blog.doc}
-\end{document}
-
-HISTORY
-
-2010/11/05 for v0.2
-2010/11/11 for v0.3
-2011/01/23 using readprov and color
-2011/01/27 using \urlfoot
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/gather.tex b/Master/texmf-dist/doc/latex/morehype/docsrc/gather.tex
deleted file mode 100644
index 41f508b6335..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/gather.tex
+++ /dev/null
@@ -1,6 +0,0 @@
-\RequirePackage{myfilist}
-\ProvidesFile{gather.tex}[2011/01/25 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,gather}
-\ListInfos[FileList.txt]
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/hypertoc.tex b/Master/texmf-dist/doc/latex/morehype/docsrc/hypertoc.tex
deleted file mode 100644
index bd5091f3f5c..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/hypertoc.tex
+++ /dev/null
@@ -1,79 +0,0 @@
-\ProvidesFile{hypertoc.tex}[2011/01/27 documenting hypertoc.sty]
-\title{\textsf{hypertoc.sty}\\---\\Decent Links
- in Tables of Contents\thanks{This
- document describes version
- \textcolor{blue}{\UseVersionOf{\jobname.sty}}
- of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
-% \listfiles
-{ \RequirePackage{makedoc} \ProcessLineMessage{}
- \MakeJobDoc{18}% %% 2011/01/23
- {\SectionLevelOneParseInput} }
-\documentclass{article}%% TODO paper dimensions!?
-\input{makedoc.cfg} %% shared formatting settings
-\usepackage{color} %% readprov in makedoc.cfg 2011/01/23
-\sloppy
-\begin{document}
-\maketitle
-\begin{abstract}\noindent
-'hypertoc.sty' changes macros for the table of contents
-so that colored frames to indicate links look acceptable.
-In the present version, this is achieved by inserting struts
-and only addresses \LaTeX's standard 'article.cls'.
-\end{abstract}
-
-\tableofcontents
-
-\section{Why}
-By default, the 'hyperref' package highlights sectioning titles
-as printed in the table of contents (TOC) by red-framed boxes.
-It looks horrible, because of
-(\textit{i})~the aggressive color and
-(\textit{ii})~the irregular, ``random" shapes of the boxes.
-
-To avoid this, it seems to be standard to use 'hyperref''s
-package option `[colorlinks]'. I don't like this either.
-It is confusing as to how the printed output will look like,
-the chosen color doesn't create a much more pleasant look;
-indeed, the publisher's graphical designer may have chosen
-colors for printing the table of contents---this design
-then is spoiled.
-
-Therefore I prefer (\textit{a})~choosing a more decent color
-and (\textit{b})~using struts so that the boxes have a more
-regular shape.
-
-In a publisher's package I even have found the idea
-to make a box for the entire TOC entry, including the page number.
-Then the frames look regular indeed, and you need less precision
-in moving the mouse for clicking at an entry.
-It would be nice if this could be integrated here later.
-
-\section{Usage}
-The file 'hypertoc.sty' is provided ready, installation only requires
-putting it somewhere where \TeX\ finds it
-(which may need updating the filename data
- base).\urlfoot{ukfaqref}{inst-wlcf} %% 2011/01/27
-
-Below the `\documentclass' line(s) and above `\begin{document}',
-you load 'hypertoc.sty' (as usually) by
-\begin{verbatim}
- \usepackage{hypertoc}
-\end{verbatim}
-
-This controls the \emph{shapes} of the frames.
-The \emph{color} must be chosen by the 'hyperref' package option
-`[linkbordercolor]', I have used
-\[`linkbordercolor={1 .9 .7},'\]
----cf.~`makedoc.cfg'.
-
-\section{The Package File}
-The package essentially has just \emph{six} code lines at present.
-
-\input{hypertoc.doc}
-\end{document}
-
-VERSION HISTORY
-
-2011/01/23 for v0.1, very first
-2011/01/24 \ProvidesFile date corrected
-2011/01/27 uses \urlfoot
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/makedoc.cfg b/Master/texmf-dist/doc/latex/morehype/docsrc/makedoc.cfg
deleted file mode 100644
index 43d57ed87cc..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/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/doc/latex/morehype/docsrc/mdoccorr.cfg b/Master/texmf-dist/doc/latex/morehype/docsrc/mdoccorr.cfg
deleted file mode 100644
index bbcadd90e34..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/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/doc/latex/morehype/docsrc/texlinks.tex b/Master/texmf-dist/doc/latex/morehype/docsrc/texlinks.tex
deleted file mode 100644
index 5ea979d5de0..00000000000
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/texlinks.tex
+++ /dev/null
@@ -1,66 +0,0 @@
-\ProvidesFile{texlinks.tex}[2011/01/27 documenting texlinks.sty]
-\title{\textsf{texlinks.sty}\\---\\\TeX-Related Links
- for \textsf{hyperref}, \textsf{blog.sty}\\
- (and maybe more)\thanks{This
- document describes version
- \textcolor{blue}{\UseVersionOf{\jobname.sty}}
- of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
-% \listfiles
-{ \RequirePackage{makedoc} \ProcessLineMessage{}
-% %% 2011/01/24:
-% \renewcommand*{\mdSectionLevelOne}{\string\subsection}
-% \renewcommand*{\mdSectionLevelTwo}{\string\subsubsection}
-% \renewcommand*{\mdSectionLevelThree}{\string\paragraph}
- \MakeJobDoc{17}% %% 2011/01/24
- {\SectionLevelThreeParseInput} }
-\documentclass{article} %% TODO paper dimensions!?
-\input{makedoc.cfg} %% shared formatting settings
-\usepackage{color}
-\newcommand*{\xmltagcode}[1]{\texttt{<#1>}}
-\sloppy
-\begin{document}
-\maketitle
-\begin{abstract}\noindent
-'texlinks.sty' provides a couple of shorthands for making hyperlinks
-with \ctanpkgref{hyperref}'s `\href' command, linking to URLs that one
-often refers to in discussing \TeX-related material.
-Especially, TUG material
-(including texhax postings and TUGboat articles) and
-CTAN pages (package descriptions, directories, Catalogue)
-are supported, also the UK~FAQ 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
-generated with 'blog.sty'.
-They may as well be useful with better known (and better developed)
-\TeX\,$\to$\,HTML software such as
-\ctanpkgref{tex4ht} or \CtanPkgRef{latex2html}{LaTeX2HTML}
-(I don't know).
-\end{abstract}
-
-\tableofcontents
-
-\section{Usage}
-The file 'texlinks.sty' is provided ready, installation only requires
-putting it somewhere where \TeX\ finds it
-(which may need updating the filename data
- base).\urlfoot{ukfaqref}{inst-wlcf}
- % \footnote{\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf}}
-
-Below the `\documentclass' line(s) and above `\begin{document}',
-you load 'texlinks.sty' (as usually) by
-\begin{verbatim}
- \usepackage{texlinks}
-\end{verbatim}
-Package options and user commands are described near their definitions
-below in the implementation section.
-
-\section{Package File Header (Legalize)}
-
-\input{texlinks.doc}
-\end{document}
-
-VERSION HISTORY
-
-2011/01/24 for v0.1, very first
-2011/01/27 for v0.2, use \urlfoot{ukfaq}
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/makehtml.tex b/Master/texmf-dist/doc/latex/morehype/makehtml.tex
index 8c19929f374..8c19929f374 100644
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/makehtml.tex
+++ b/Master/texmf-dist/doc/latex/morehype/makehtml.tex
diff --git a/Master/texmf-dist/doc/latex/morehype/docsrc/texmap.tex b/Master/texmf-dist/doc/latex/morehype/texmap.tex
index 11776953cf2..11776953cf2 100644
--- a/Master/texmf-dist/doc/latex/morehype/docsrc/texmap.tex
+++ b/Master/texmf-dist/doc/latex/morehype/texmap.tex