From e09950f439263dd3649fc0d9bf357b0f124d247c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 21 Dec 2012 23:32:22 +0000 Subject: morehype (21dec12) git-svn-id: svn://tug.org/texlive/trunk@28610 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/morehype/blog.tex | 36 ++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) (limited to 'Master/texmf-dist/source/latex/morehype/blog.tex') diff --git a/Master/texmf-dist/source/latex/morehype/blog.tex b/Master/texmf-dist/source/latex/morehype/blog.tex index aacfd541094..71487ed57b4 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}[2012/11/30 documenting blog.sty] +\ProvidesFile{blog.tex}[2012/12/20 documenting blog.sty] \title{\textsf{blog.sty}\\---\\% Generating \HTML\ Quickly with \TeX\thanks{This document describes version @@ -26,6 +26,7 @@ \documentclass[fleqn]{article}%% TODO paper dimensions!? \sfcode`-=1001 %% 2011/10/15 \input{makedoc.cfg} %% shared formatting settings +\usepackage{filesdo} \MDfinaldatechecks %% 2012/12/20 \ReadPackageInfos{blog} %% \tagcode seems to be a quite recent pdfTeX primitive, %% cf. microtype.pdf ... %% 2010/11/06 @@ -33,6 +34,7 @@ \newcommand*{\HTML}{\acro{HTML}} %% 2011/09/08 \newcommand*{\CSS}{\acro{CSS}} %% 2011/11/09 \newcommand*{\secref}[1]{Sec.~\ref{sec:#1}} %% 2011/11/23 +\providecommand*{\LuaTeX}{Lua\TeX} %% 2012/12/20 \sloppy \begin{document} \maketitle @@ -232,6 +234,7 @@ See below for what is offered. \section{Wiki Markup by 'markblog.sty'} %% 2012/11/29 \label{sec:mark} +\subsection{Introduction} %% 2012/12/20 \AddQuotes This is the code and documentation of the package mentioned in Sec.~\ref{sec:ligs}, loadable by option |[mark]|. @@ -239,7 +242,35 @@ 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. +with `[[]]' is supported. %% <...> 2012/12/20 + +\subsection{Similar Packages} %% 2012/12/20 +'wiki.sty' from the \ctanpkgdref{nicetext} bundle has offered +some Wikipedia-like markup as a front-end for ordinary +typesetting with \LaTeX\ (for \acro{DVI}/\acro{PDF}), +implemented in a way very different from what is going on here, +rather converting markup sequences \emph{during} typesetting. + +More similar to the present approach is the way how +Wikipedia section titles in package documentation +is implemented by 'makedoc' from the 'nicetext' bundle, +based on \strong{preprocessing} by 'fifinddo'. + +In general, John MacFarlane's +\httpref{johnmacfarlane.net/pandoc}{\pkg{pandoc}} +(cf.~\wikideref{pandoc}{German Wikipedia}) +converts between wiki-like (simplified) markup and +\LaTeX\ markup. (It deals with rather fixed +markup rules, while we here process markup sequences +independently of an entire markup \emph{language}.) + +Another straightforward and well-documented way to +\emph{preprocess} source files for converting simplified +markup into \TeX\ markup is \ctanpkgauref{isambert}{Paul Isambert}'s +\ctanpkgref{interpreter}. It relies on \wikiref{LuaTeX}{\LuaTeX} +where Lua does the preprocessing. + +\subsection{Package File Header} %% 2012/12/20 \ResetCodeLineNumbers \input{markblog.doc} \DontAddQuotes @@ -442,3 +473,4 @@ with morehype RELEASE r0.4 2012/10/05 adjusted \HeaderLines (differ!) 2012/11/29 adding `blogligs' and `markblog' 2012/11/30 hello world, texblog sample removed, url foots +2012/12/20 filedate checks, doc. more about `markblog' -- cgit v1.2.3