summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/morehype/blog.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-12-21 23:32:22 +0000
committerKarl Berry <karl@freefriends.org>2012-12-21 23:32:22 +0000
commite09950f439263dd3649fc0d9bf357b0f124d247c (patch)
tree1cb95afbfec7c2e1362c7d6afcc4df7ebb36d596 /Master/texmf-dist/source/latex/morehype/blog.tex
parent0dbb0a9f652efcecaf1d844cf8177d3b7a29fd03 (diff)
morehype (21dec12)
git-svn-id: svn://tug.org/texlive/trunk@28610 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/morehype/blog.tex')
-rw-r--r--Master/texmf-dist/source/latex/morehype/blog.tex36
1 files changed, 34 insertions, 2 deletions
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 `[[<wikipedia-link>]]' 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'