diff options
author | Karl Berry <karl@freefriends.org> | 2012-12-02 23:18:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-12-02 23:18:36 +0000 |
commit | 59e52a9aaf7ccb545c0e6c410f3859a7b79b43aa (patch) | |
tree | a9d353045009336295b169b1cd9f46a9f8f1e5ab /Master/texmf-dist/source/latex/morehype | |
parent | ecbf2241f32ef261ee58622856756a9e42211886 (diff) |
morehype (2dec12)
git-svn-id: svn://tug.org/texlive/trunk@28418 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/morehype')
-rw-r--r-- | Master/texmf-dist/source/latex/morehype/blog.tex | 96 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/morehype/blogexec.tex | 115 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/morehype/markblog.tex | 39 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/morehype/srcfiles.tex | 66 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/morehype/texlinks.tex | 14 | ||||
-rwxr-xr-x | Master/texmf-dist/source/latex/morehype/upsfl.sh | 6 |
6 files changed, 290 insertions, 46 deletions
diff --git a/Master/texmf-dist/source/latex/morehype/blog.tex b/Master/texmf-dist/source/latex/morehype/blog.tex index 9644a154183..aacfd541094 100644 --- a/Master/texmf-dist/source/latex/morehype/blog.tex +++ b/Master/texmf-dist/source/latex/morehype/blog.tex @@ -1,4 +1,4 @@ -\ProvidesFile{blog.tex}[2011/11/23 documenting blog.sty] +\ProvidesFile{blog.tex}[2012/11/30 documenting blog.sty] \title{\textsf{blog.sty}\\---\\% Generating \HTML\ Quickly with \TeX\thanks{This document describes version @@ -7,12 +7,20 @@ % \listfiles { \RequirePackage{makedoc} \ProcessLineMessage{} - \renewcommand\mdSectionLevelOne{\string\subsection} - \renewcommand\mdSectionLevelTwo{\string\subsubsection} - \MainDocParser{\SectionLevelTwoParseInput} - \HeaderLines{17} + %% three section levels 2012/08/07: + \renewcommand\mdSectionLevelOne {\string\subsection} + \renewcommand\mdSectionLevelTwo {\string\subsubsection} + \renewcommand\mdSectionLevelThree{\string\paragraph} + \MainDocParser{\SectionLevelThreeParseInput} + \HeaderLines{16} %% 2012/10/03 \MakeSingleDoc{blog.sty} + \HeaderLines{18} %% 2012/11/28 + \MakeSingleDoc{blogligs.sty} + \HeaderLines{18} %% 2012/11/28 + \MakeSingleDoc{markblog.sty} + \HeaderLines{18} %% 2012/10/05 \MakeSingleDoc{lnavicol.sty} + \HeaderLines{17} %% 2012/10/05 \MakeSingleDoc{blogdot.sty} } \documentclass[fleqn]{article}%% TODO paper dimensions!? @@ -81,16 +89,17 @@ It loads 'blog.sty' by \RequirePackage{blog} \end{verbatim} and uses file handling commands from 'blog.sty' and -\CtanPkgRef{nicetext}{fifinddo} -(cf. `mdoccheat.pdf' from the \ctanpkgref{nicetext} bundle). +\CtanPkgRef{nicetext}{fifinddo} +(cf. `mdoccheat.pdf' from the \ctanpkgref{nicetext} bundle).\urlfoot{CtanPkgRef}{nicetext} +%% <- \urlfoot 2012/11/30 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'), +%% 2012/11/29: +`\uselangcode' with the \ctanpkgdref{langcode} package %% dref 2012/11/30 and settings for converting the editor's text encoding -into the encoding that the head of the resulting \HTML\ file advertises -(`atari.fdf' in the 'nicetext' bundle). +into the encoding that the head of the resulting \HTML\ file +advertises---or into \HTML\ named entities +(for me, `atari_ht.fdf' has done this). 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 @@ -105,6 +114,16 @@ to generate the necessary \xmltagcode{head} section and the \xmltagcode{body} tags. \section{Examples} +\subsection{Hello World!} +This is the \strong{source} code for a ``Hello World" example, +in `hellowor.tex': +\MDsamplecodeinput{hellowor} +The \HTML\ file `hellowor.htm' is generated from `hellowor.tex' +by the following \strong{driver} file `mkhellow.tex': +\pagebreak[2] +\MDsamplecodeinput{mkhellow} + + \iffalse %% 2012/11/29 \subsection{A Very Plain Style} My ``\TeX-generated pages"{\foothttpurlref{www.webdesign-bu.de/% @@ -142,10 +161,12 @@ perhaps you can use them as templates. \listinginput[5]{1}{CTAN/morehype/demo/texblog/texmap.tex} \endgroup + \fi \subsection{A Style with a Navigation Column} \label{sec:example-lnavicol} -A style of web pages looking more professional than -`texmap.htm' %% was `texhax.hmt' 2011/09/02 +A style of web pages looking more professional +% than %% rm. 2012/11/29 +% `texmap.htm' %% was `texhax.hmt' 2011/09/02 (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 @@ -174,28 +195,57 @@ 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. +in a directory +`blogdemo/writings', %% blog 2012/11/30 +hopefully useful as templates. \begingroup \MakeActive\ \def{\"a} %% 2011/10/05 \MakeActive\ \def{\"u} \hfuzz=\textwidth \advance \hfuzz by 10pt + %% 2012/11/29 CTAN/morehype/demo -> blogdemo: \subsubsection{Driver File `makehtml.tex'} - \listinginput[5]{1}{CTAN/morehype/demo/writings/makehtml.tex} + \listinginput[5]{1}{blogdemo/writings/makehtml.tex} \subsubsection{Source File `schreibt.tex'} - \listinginput[5]{1}{CTAN/morehype/demo/writings/schreibt.tex} + \listinginput[5]{1}{blogdemo/writings/schreibt.tex} \endgroup \section{The File \file{blog.sty}} %% 2011/11/09 % \section{The File \texttt{blog.sty}} % \section{The File {\tt blog.sty}} %% <- strange 2011/11/08 -> -% \section{The File `blog.sty'} %% 2011/10/04 allow other files -\subsection{Package File Header (Legalize)} +% \section{The File `blog.sty'} %% 2011/10/04 allow other files +\subsection{Preliminaries} %% 2012/10/03 +\subsubsection{Package File Header (Legalese)} %% ize -> ese, subsub 2012/10/03 \ResetCodeLineNumbers \input{blog.doc} +\section{``Pervasive Ligatures" with 'blogligs.sty'} %% 2012/11/29 +\label{sec:moreligs} +% \AddQuotes +This is the code and documentation of the package mentioned in +Sec.~\ref{sec:ligs}, loadable by option |[ligs]|. +See below for what is offered. +\ResetCodeLineNumbers +\input{blogligs.doc} +% \DontAddQuotes + +\section{Wiki Markup by 'markblog.sty'} %% 2012/11/29 +\label{sec:mark} +\AddQuotes +This is the code and documentation of the package mentioned in +Sec.~\ref{sec:ligs}, loadable by option |[mark]|. +See below for what is offered. You should also find a file +`markblog.htm' that sketches it. Moreover, `texlinks.pdf' +describes in detail to what extent Wikipedia's +``\wikiref{Help:Links#Piped_links}{piped links}" +with `[[wikipedia-link]]' is supported. +\ResetCodeLineNumbers +\input{markblog.doc} +\DontAddQuotes + \pagebreak %% 2011/10/10 +%% <- keeping 2012/11/29 for \pagebreak within blogdot.sty \section{Real Web Pages with 'lnavicol.sty'} \label{sec:lnavicol} This is the code and documentation of the package mentioned in @@ -260,7 +310,7 @@ horizontically (cf.~Sec.~\ref{sec:dot-type}): ``printing" a heading centered horizontically---even on slides whose remaining content is aligned \emph{flush left} (I have only used <digit>=2 so far), - \cmdboxitem|\begin{<textblock>}{<width>}| \ + \cmdboxitem|\begin{textblock}{<width>}| \ %% not metavar 2012/07/19 ``printing" the content of a `{textblock}' environment with maximum line width <width> flush left, while that ``block" as a whole may be centered @@ -386,3 +436,9 @@ with morehype RELEASE r0.4 in page head 2011/11/09 so use \file with new makedoc.cfg for hyperref; \CSS 2011/11/23 \secref +2012/07/19 `textblock' not metavar +2012/08/07 three section levels +2012/10/03 ize -> ese, some restructuring, corr. \HeaderLines +2012/10/05 adjusted \HeaderLines (differ!) +2012/11/29 adding `blogligs' and `markblog' +2012/11/30 hello world, texblog sample removed, url foots diff --git a/Master/texmf-dist/source/latex/morehype/blogexec.tex b/Master/texmf-dist/source/latex/morehype/blogexec.tex new file mode 100644 index 00000000000..57830a9c125 --- /dev/null +++ b/Master/texmf-dist/source/latex/morehype/blogexec.tex @@ -0,0 +1,115 @@ +\ProvidesFile{blogexec.tex}[2011/11/20 documenting blogexec.sty] +\title{{\huge\pkg{blogexec.sty}}\\---\\Overcoming + \pkg{blog.sty}'s Pure Expansion\thanks{This + document describes version + \textcolor{blue}{\UseVersionOf{\jobname.sty}} + of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}} +% \listfiles +{ \RequirePackage{makedoc} + \ProcessLineMessage{} %%% {\message{.}} + \MakeJobDoc{17} + {\SectionLevelThreeParseInput} } +\documentclass[fleqn]{article}%% TODO paper dimensions!? +\input{makedoc.cfg} %% shared formatting settings +\providecommand*{\HTML}{\acro{HTML}} +\ReadPackageInfos{blogexec} +\sloppy +\begin{document} +\maketitle +\begin{abstract}\noindent +'blog.sty' before v0.7 generated \HTML\ by pure macro expansion +and could use \LaTeX\ macros (redefined) only to a very limited +extent. On adding 'blogexec.sty', some macros (configurable) are +``intercepted" before expansion in a 'blog' run for +``running" some code, basically `\begin', `\end', +and a new general `\EXECUTE'. +A table environment with active characters inside only is +provided---perhaps ``nicer than \LaTeX." +\end{abstract} +\tableofcontents + +% \newpage +\section{Features and Usage} + +% \subsection{Installing and Calling} +The file 'blogexec.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} %% corr. 2011/02/08 + +'blogexec.sty' may be loaded by +\begin{verbatim} + \RequirePackage{blogexec} +\end{verbatim} +in a driver file for 'blog.sty'. \strong{Alternatively}, +the following commands in a 'blog' driver file +(in a certain way even in a \emph{source} file) +load 'blogexec.sty' and then are carried out according to their +definitions in 'blogexec': +\begin{description} + \cmdboxitem|\BlogInterceptExecute| \ intercepts |\EXECUTE| only. + \cmdboxitem|\BlogInterceptEnvironments| \ intercepts |\EXECUTE|, + |\begin|, and |\end| only; the latter two then work much + as with \LaTeX. They expand to \HTML\ code as with 'blog'; + `\begin{<env>}' additionally executes commands according + to an (optional) + \[|\MakeBlogBeginRun{<env>}<arguments>{<begin-code>}|.\] + \cmdboxitem|\BlogInterceptExtra| \ intercepts all the commands + in certain lists (using the \ctanpkgref{dowith} package), + including `\EXECUTE', `\begin', `\end'. E.g., + \[|\MakeBlogOneArgInterception{<cmd>}{<run>}{<write>}|\] + adds <cmd> to such a list and tells that <run> should be + carried out and that <cmd><one-argument> should be replaced + by <write> in a line containing <cmd> + (not hidden in braces, and there better should not be much more + in the line). + \cmdboxitem|\BlogInterceptHash| \ does \emph{not} choose an + \strong{``interception level"} as the previous commands do, + but may be necessary for allowing parameters in macro + definitions to be run in the course of an interception. + It is automatically (``implicitly") envoked by the star forms + of the above commands, i.e., by either of + \begin{itemize} + \item |\BlogInterceptExecute*| + \item |\BlogInterceptEnvironments*| + \item |\BlogInterceptExtra*| + \end{itemize} +\end{description} +The reader may find additional details in the following sections +near the code implementing the commands. + +'blogexec.sty' also modifies 'blog.sty''s (v0.7) +|{stdallrulestable}| environment as follows: +\begin{itemize} + \item[\InlineCmdBox{\texttt{&|}}] + The vertical stroke becomes an active character + that closes a table cell and opens another one + (being an alias for 'blog.sty''s v0.7 `\endcell')---just + as |&| does it with \TeX/\LaTeX. + \cmdboxitem|&| The ampersand becomes an active character + that---\strong{differently to \TeX\slash\LaTeX}---as an alias for + 'blog.sty''s |\figurespace| produces the Unicode figure space + for alignment of figures. +\end{itemize} +\emph{Outside} the `{stdallrules}' environment, both characters +have their ``usual" meaning, i.e., |&| may be used for accessing +\HTML\ entities (as 'blog.sty' allows it). |\cr| (and |\endline|, +provided by 'blog.sty' v0.7) ends a table row and starts a new one. +|\\| is not touched---a \strong{difference to \LaTeX} and may still be +used for breaking a line within a table cell. + +% \section{Example} + +% \pagebreak +% \section{Implementation} +\section{Package File Header (Legalize)} +\input{blogexec.doc} +\end{document} + +VERSION HISTORY + +2011/11/04 for v0.1 very first +2011/11/09f. something more +2011/11/20 star forms + + diff --git a/Master/texmf-dist/source/latex/morehype/markblog.tex b/Master/texmf-dist/source/latex/morehype/markblog.tex new file mode 100644 index 00000000000..581ac15de40 --- /dev/null +++ b/Master/texmf-dist/source/latex/morehype/markblog.tex @@ -0,0 +1,39 @@ +\ProvidesFile{markblog.tex}[2012/11/29 extended blog markup] +\EXECUTE{\def\pkg{\code}\def\HTML{\abbr{HTML}} + \def\mystrong{\textcolor{\#aa0000}} + \def\myalert{\textcolor{red}}} +\head %%% \texmetadata 2012/09/23 + \metanamecontent{author}{Uwe L\"uck} + \metanamecontent{date}{\isotoday} + \robots{index,follow,noarchive} +\title{blog.sty \& wikis} %%% CMS} +\body +\begin{center} +\heading2{\CtanPkgRef{morehype}{markblog.sty} %%%{{blog[exec].sty}} + \& + [[Wiki]]s} %%% \wikiref{content management system}{\abbr{CMS}}} +\begin{stdallrulestable} + \EXECUTE{\let\blogcode\code \def\code#1{\textcolor{\#003300}{\blogcode{#1}}}} %% vs. CSS + %% ^^ war 66 2012/09/23 + \pkg{blog.sty} Syntax | Output | cf. \HTML | cf. \TeX | cf. ... \cr + \code{''italics''} | ''italics'' | \xmleltcode{i}{italics} + | \code{\{\cs{it} italics\}} | Wikipedia \cr + \code{'''boldface'''} | '''boldface''' | \xmleltcode{b}{boldface} + | \code{\{\cs{bf} boldface\}} | Wikipedia \cr + \code{[[Wikipedia]]} | [[Wikipedia]] | \xmleltattrcode{a}{href=...}{Wikipedia}} + | \code{\cs{href}\{...\}\{Wikipedia\}} + | Wikipedia \cr + \code{**mystrong**} | **mystrong** | \xmleltattrcode{span}{style=...}{mystrong}} + | \code{\cs{textcolor}\{...\}\{mystrong\}} + | [[Markdown]] \cr + \code{***myalert***} | ***myalert*** | \xmleltattrcode{span}{style=...}{myalert} + | \code{\cs{textcolor}{red}{myalert}} + | [[Markdown]] \cr + \code{...} | ... | \code{\…} | \cs{dots} | \cr + \code{--}, \code{---} | --, --- | \code{\–}, \code{\—} + | \code{--}, \code{---} -- "ligs" | \cr + \code{->}, \code{<-} | ->, <- | \code{\→}, \code{\←} + | \cs{to}, \cs{gets} | +\end{stdallrulestable} +\end{center} +\finish diff --git a/Master/texmf-dist/source/latex/morehype/srcfiles.tex b/Master/texmf-dist/source/latex/morehype/srcfiles.tex index 7c4310cc5b1..bb34ca68b11 100644 --- a/Master/texmf-dist/source/latex/morehype/srcfiles.tex +++ b/Master/texmf-dist/source/latex/morehype/srcfiles.tex @@ -1,22 +1,58 @@ -\ProvidesFile{srcfiles.tex}[2012/05/26 file infos -> SrcFILEs.txt] -\RequirePackage[r]{nicefilelist} +\ProvidesFile{srcfiles.tex}[2012/11/30 file infos -> SrcFILEs.txt] +\RequirePackage{filedate} +\RequirePackage[r,wrap]{nicefilelist}[2012/10/24] %\MFfieldtemplate{f-base}{nicefilelist} -\RequirePackage{myfilist} -\EmptyFileList[nicefilelist.sty] %%% [readprov.sty,myfilist.sty] +%\RequirePackage{myfilist}[2012/10/25] +%\EmptyFileList[nicefilelist.sty] %%% [readprov.sty,myfilist.sty] +\MaxBaseEmptyList* %% 2012/11/29 +%\FileDateAutoChecks +\FileListRemark[ ----]{-RELEASE.---} +\ReadFileInfos{morehype.RLS} +%\ReadFileInfos{USE....} +\FileListRemark[ ----]{-----USE.---} +\ReadPackageInfos{blog,blogdot} +\DatesDiffWarnings +\ReadFileInfos{blogdot.cfg} +\DatesDiffErrors +\ReadPackageInfos{blogexec,blogligs,hypertoc, + lnavicol,markblog,texlinks} +\ReadFileInfos{atari_ht.fdf,texblog.fdf} %% examples: %\ReadFileInfos{makehtml,texmap} %% documentation main sources: -\ReadFileInfos{DOCSRC....} -\ReadFileInfos{blog,blogexec,hypertoc,texlinks,srcfiles,README} +\FileListRemark[ ----]{-----DOC.SRC} +\ReadFileInfos{blog,blogexec,hellowor,hypertoc,markblog,texlinks} %% documentation settings and auxiliaries: -\ReadFileInfos{NICETEXT....} +%\ReadFileInfos{NICETEXT....} +\NoFileDateAutoChecks +\FileListRemark[ ----]{-----DOC.FMT} +\ReadFileInfos{README} +%\ReadPackageInfos{nicefilelist} +\ReadFileInfos{mkhellow,srcfiles} +\FileListRemark[ ----]{NICETEXT.---} \ReadPackageInfos{fifinddo,makedoc,niceverb} \ReadFileInfos{makedoc.cfg,mdoccorr.cfg} -\ReadPackageInfos{dowith} -\ReadPackageInfos{nicefilelist} -\ReadFileInfos{USE....} -\ReadPackageInfos{blog,blogdot,blogexec,lnavicol} -\ReadPackageInfos{hypertoc,texlinks} -\ReadFileInfos{atari_ht.fdf,texblog.fdf,blogdot.cfg} -\ReadFileInfos{morehype.RLS} -\ListInfos[SrcFILEs.txt] +\NoStopListInfos[SrcFILEs.txt] +%\ListInfos[SrcFILEs.txt] +%\EqualityMessages +\UseReferenceDate{\thepdfmoddate} +\ModDates +%\DatesDiffNotices +%\DatesDiffWarnings +%\CheckDateOfGiven{blogdot.cfg} +%\stop +\DatesDiffErrors +\RequirePackage{filesdo} +\DoWithBasesExts\CheckDateOfGiven{ + blog,blogexec,hypertoc,markblog,texlinks}{sty,tex} +%\DoWithBasesExts\CheckDateOfGiven{blogdot}{cfg,sty} +\DatesDiffWarnings +\CheckDateOfGiven{blogdot.cfg} +\DatesDiffErrors +\DoWithExtBases\CheckDateOfGiven{sty}{blogdot,blogligs} +\DoWithExtBases\CheckDateOfGiven{fdf}{atari_ht,texblog} +\DoWithExtBases\CheckDateOfGiven{tex}{mkhellow,hellowor,srcfiles} +\CheckDateOfGiven{morehype.RLS} +\DatesDiffWarnings +\CheckDateOfToday{morehype.RLS} +\stop diff --git a/Master/texmf-dist/source/latex/morehype/texlinks.tex b/Master/texmf-dist/source/latex/morehype/texlinks.tex index 68d98630fc2..6cfde6d985f 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/10/21 documenting texlinks.sty] +\ProvidesFile{texlinks.tex}[2012/11/28 documenting texlinks.sty] \title{{\Huge\textsf{texlinks.sty}}\\---\\\TeX-Related Links for \textsf{hyperref}, \textsf{blog.sty}\\ (and maybe more)\thanks{This @@ -17,9 +17,11 @@ \input{makedoc.cfg} %% shared formatting settings \usepackage{color} \newcommand*{\xmltagcode}[1]{\texttt{<#1>}} -\providecommand*{\CTAN}{\acro{CTAN}} -\providecommand*{\HTML}{\acro{HTML}} -\providecommand*{\URL} {\acro{URL}} +\providecommand{\CTAN}{\acro{CTAN}} +\providecommand{\HTML}{\acro{HTML}} +\providecommand{\URL} {\acro{URL}} +\providecommand{\ctanpkgdref}[1]{% + \ctanpkgref{#1}\,\urlfoot{CtanPkgRef}{#1}} \sloppy \begin{document} \maketitle @@ -61,7 +63,7 @@ you load 'texlinks.sty' (as usually) by Package options and user commands are described near their definitions below in the implementation section. -\section{Package File Header (Legalize)} +\section{Package File Header (Legalese)} %% ize -> ese 2012/11/09 \input{texlinks.doc} \end{document} @@ -75,3 +77,5 @@ VERSION HISTORY 2011/09/03 \Huge first line 2011/10/10 [fleqn] 2011/10/20 \HTML, \URL +2012/11/09 Legalize -> Legalese +2012/11/28 \ctanpkgdref diff --git a/Master/texmf-dist/source/latex/morehype/upsfl.sh b/Master/texmf-dist/source/latex/morehype/upsfl.sh deleted file mode 100755 index 6d9d57ce3b8..00000000000 --- a/Master/texmf-dist/source/latex/morehype/upsfl.sh +++ /dev/null @@ -1,6 +0,0 @@ -## dummy files: -echo \\ProvidesFile{USE....}[] > USE.... -echo \\ProvidesFile{DOCSRC....}[] > DOCSRC.... -echo \\ProvidesFile{NICETEXT....}[] > NICETEXT.... -latex srcfiles.tex -rm *.... |