From ea16ae60028a1e6e1820c3a99a66a74369259f8c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 3 Sep 2011 23:13:56 +0000 Subject: morehype update (1sep11) git-svn-id: svn://tug.org/texlive/trunk@23781 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/morehype/README.tex | 11 --- Master/texmf-dist/source/latex/morehype/blog.tex | 105 ++++++++++++++++----- .../texmf-dist/source/latex/morehype/makedoc.cfg | 40 -------- .../texmf-dist/source/latex/morehype/mdoccorr.cfg | 51 ---------- .../texmf-dist/source/latex/morehype/srcfiles.tex | 6 -- .../texmf-dist/source/latex/morehype/texlinks.tex | 16 ++-- 6 files changed, 91 insertions(+), 138 deletions(-) delete mode 100644 Master/texmf-dist/source/latex/morehype/README.tex delete mode 100644 Master/texmf-dist/source/latex/morehype/makedoc.cfg delete mode 100644 Master/texmf-dist/source/latex/morehype/mdoccorr.cfg delete mode 100644 Master/texmf-dist/source/latex/morehype/srcfiles.tex (limited to 'Master/texmf-dist/source/latex/morehype') 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{}| 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{}{}{}|: -\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{}|: -\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 -- cgit v1.2.3