\ProvidesFile{dantev45.tex}[2011/10/25 DANTE Herbst \string'11]
\ifFillBlogDotTypeArea \comment{ \string"Kompromiss\string" mit 
                                 \string\FillBlogDotTypeArea\ }\fi
\CommentBlogDotWholeWidth
\head \charset{ISO-8859-1} %%% {utf-8} 
  \texrobots 
%   \stylesheet{all}{blogdot}
  \begin{style}{all}
    h1 { font-size: 42px; margin-bottom: 21px }
    h2 { font-size: 30px; margin-bottom: 21px }
    % h3 { font-size: 24px; }
    % h4 { font-size: 21px; }

    td { 
%     font-family:Arial,Verdana,"Lucida Sans",sans-serif; 
    font-family:Arial,Verdana,\LucidaSans,sans-serif;  %% 2011/10/05
    color:#000000; 
    font-size: 21px 
    }

    p { margin-bottom:0px }
    dl, ol, ul { 
    padding-left: 1em;
    margin-left: 1em; margin-top: 18px; margin-bottom: 18px;
    vertical-align: middle; 
    }
    dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px }
    li { margin: 0px; margin-top:  9px; margin-bottom: 9px; padding: 0px }
    blockquote { margin-left: 2em }
    pre { margin-left:2em; margin-top:0px }

    a:link { color:#0000d0; text-decoration:none; }
    a:visited { color:purple; text-decoration:none; }
    a:hover { color:blue; text-decoration:underline; }
    a:active { color:blue; text-decoration:underline; }
  \end{style}
  \title{Dokumentation und HTML mit fifinddo}
\body 
%   \topofpage
%   \deTeXtopofpage{| \Fileref{heyctan}~| \Fileref{texhax}} 
  \deTeXtopofpage{} 
\endgraf
   [\,\STS{big}{\strong{\autref{START}}}%%%\\~| %% big 2011/10/08
      \myalert{<<< zuerst klicken}, 
      \mystrong{dann auf Bildunterrand klicken}
        \begin{small}
          bzw. knapp unter Text (\wikideref{Internet Explorer}{MSIE})
        \end{small}
      und rechts unten f�r \ancref{inhalt}{"R�ckkehr"}\\
        \begin{small}                           %% 2011/10/21
          \quad\pardash\myalert{more} about the present file on:
          \CtanPkgRef{fifinddo-info}{CTAN}
        \end{small}
      \hrule
\quad \autref{teil-0}~|
      \autref{titelerlaeut1}~| 
      \autref{titelerlaeut2}~| 
      \autref{titelerlaeut3}~| 
      \autref{interessant}~|
      \autref{motive-t}~| 
      \autref{motive-p}~| 
      \autref{status}~|
\strong{\autref{inhalt}}\\%%%~|
\quad \autref{teil-1}~|
      \autref{txt2tex}~| 
      \autref{txt2tex-trad}\\%%%~|
\quad \autref{teil-2}~|
      \autref{typoz-latex}~|        %% 2011/10/05 umgestellt
      \autref{minimal-mehr}~|
      \autref{typoz-bewert}~| 
      \autref{typoz-auto}~| 
      \autref{typoz-ctan}\\%%%~| 
\quad \autref{teil-3}~|
      \autref{wiki-markup}~| 
      \autref{wiki-listen}\\%%%~|
\quad \autref{teil-4}~|
      \autref{implement}~| 
      \autref{implement-ms}~| 
      \autref{implement-ms2}~| 
      \autref{implement-ma}~| 
      \autref{implement-ma+}~| 
      \autref{implement-mas}\\%%%~| 
\quad \autref{teil-5}~|
      \autref{nicetext}~|
      \autref{wiki}\\%%%~| %%% \autref{min-markup-doku}~| \autref{doku-format}~|
\quad \autref{teil-6}~| 
      \autref{niceverb}~|
      \autref{syntax}~|
      \autref{vert}~|
      \autref{niceverb-noch}~|
      \autref{niceverb-sim}\\%%%~|
\quad \autref{teil-7}~| %%% \autref{txt2tex-doku}~|
      \autref{kommentar}~| 
      \autref{kommentarzw}~| 
      \autref{kommentarzwa}\\%%%~| 
\quad \autref{teil-8}~| 
      \autref{kommentar-ignor}~|
      \autref{kommentar-ignor-mehr}~| 
      \autref{docstrip}~| 
      \autref{kommentarzch}~| 
      \autref{ohne-docstrip}\\%%%~| 
\quad \autref{teil-9}~| 
      \autref{doku-vor}~| 
      \autref{doku-doc}~| 
      \autref{docinput}~| 
      \autref{docinput2}~| 
      \autref{docinput-min}~| 
      \autref{makedoc-input}~| %% neu statt \autref{mdoccorr} 2011/10/05
      \autref{makedoc-lauf}~|       %% neu 2011/10/06
      \autref{erfolg}~|             %% ausgebaut 2011/10/05f.
      \autref{catcodes}\\%%%~| \\   %% ausgebaut 2011/10/06
\quad \autref{teil-10}~| 
      \autref{html-alt}~| 
      \autref{html-statt-pdf}~|
      \autref{html-und-pdf}~|       %% 2011/10/06 ausgebaut
      \autref{blog-probleme}~|
      \autref{schluss}\,]           %% gek�rzt 2011/10/05
  \hrule
\titlescreenpage
\heading1{\mystrong{Paketdokumentation}\\und 
          \mystrong{Webseitenpflege} mit\\
          (\pkg{\mystrong{niceverb}.sty} 
          und)\\\pkg{\mystrong{fifinddo}.sty}}
Uwe L�ck
\vspace{18} 
šberarbeitete Fassung des auf der\\
\httpref{www.dante.de/events/mv45/Programm.html}{%
         \acronym{DANTE}-Herbsttagung 2011}\\
gehaltenen Vortrags
\vspace{18} 
\Isodate\GenDate

\teilpage{0}{šber den Vortrag}
\labelsection{titelerlaeut1}{%
  \mystrong{Vortragstitel} bedeutet (I):}
\begin{description}
  \ditem{"Paketdokumentation"}
    \Endash Beschreibung von \LaTeX-Makro-Paketen, \dh
%     bzw. der \mystrong{Syntax} einzelner \mystrong{Makros}, 
%     ihrer \mystrong{Argumente}, der \mystrong{Wirkung}~\dots%%%\\ 
    \begin{enumerate}
      \item in "Schreibmaschinenschrift" (\mystrong{"verbatim"}) gesetzter 
        \mystrong{Paketcode} wechselt mit in \LaTeX-Qualit„t gesetztem 
        \mystrong{Kommentar} ab ("zeilenweise")
      \item der \mystrong{Kommentar}text \mystrong{enth„lt} 
        "verbatim" gesetzten \TeX-\mystrong{Code} ("inline") 
        zur Bezugnahme\pardash insbesondere:
      \item \mystrong{Gebrauchsanleitung}/Syntaxbeschreibung f�r Nutzer:
          \\\meta{\bdquo Tippt man}
        \begin{quote}
          \mystrong{%
            \cs{foo\ast[\metavar{opt-arg}]{\metavar{mand-arg}}}}, 
        \end{quote}
          \meta{so erh„lt man~\dots\ldquo}
    \end{itemize}
\end{description}

\labelcentersection{titelerlaeut2}{%
  \mystrong{\ancref{START}{Vortragstitel}} bedeutet (II):}
\begin{textblock}{560}
  \begin{description}
    \ditem{"Webseitenpflege"}
      \Endash "hochtrabend", zun„chst blož: \mystrong{\HTML}-Erzeugung
      \Endash
      \begin{itemize}
        \item \mystrong{Internet}auftritt~(?
              \wikideref{Content-Management-System}{CMS}?
              \Endash \webdesignref{schreibt.html}{ja~\dots})
        \item bequeme \mystrong{Textformat}-Alternative zu \PDF~\dots 
              \\
              (Notizen zu \webdesignref{heyctan.htm}{Links}, 
              Beamer-Pr„sentation~\dots)
      \end{itemize}
  \end{description}
\end{textblock}

\nextcenterscreenpage{titelerlaeut3}
\section{\mystrong{\ancref{START}{Vortragstitel}} bedeutet (III):}
\dots\ was haben \mystrong{Paketdokumentation} und 
\mystrong{\HTML-Erzeugung} miteinander zu tun\mystrong{??}
\\\\
(\Endash Zu \mystrong{\HTML-Paketdokumentationen} 
       \\habe ich es noch \mystrong{nicht} gebracht~\dots)

\labelcentersection{interessant}{%
  Vortrag \mystrong{interessant}~\dots}
\begin{textblock}{600}
  \begin{enumerate}
    \item wenn man als Makroprogrammierer 
      \pkg{\mystrong{doc}.sty} und \file{\mystrong{docstrip}.tex} 
      ("\file{\mystrong{.dtx}}~\dots")
      zu aufw„ndig findet~\dots
    \item wenn man \mystrong{\HTML} sch„tzt und \mystrong{\PDF} 
      vermeiden m”chte~\dots
    \item wenn man \mystrong{Makro-\Wikideref{Denksport}} mag
  \end{enumerate}
\end{textblock}

\labelcentersection{motive-t}{Inhaltliche Motive}
\begin{textblock}{560}
  \begin{enumerate}
    \item \strong{"minimales Markup"}, 
          "\Wikideref{syntaktischer Zucker}"
          (\LaTeX-\mystrong{Qualit„t} 
           \emph{m”glichst ohne} \LaTeX-\mystrong{Befehle})
    \item \strong{"Missbrauch"} von \mystrong{\TeX} 
          als "\mystrong{Skript}sprache"
          \\
          (\dqtd{mit \TeX\ muss und will ich 
                 \mystrong{keine andere} Sprache lernen}; 
                 \mystrong{statt} \PDF-\mystrong{Schriftsatz}
                 \Endash wie \ctanpkgref{docstrip})
    \item \mystrong{kleine}(?), einfache(?), experimentelle(!), 
          ("schrullige",) gerade eigenen (U.\,L.) Bed�rfnissen 
          entsprechende \strong{Alternativen} zu existierenden 
          "professionelleren" Paketen
          (\mystrong{Erfolge}\pardash Scheitern~\dots) 
%            \Endash gespannt auf \mystrong{Kommentare}.)
  \end{enumerate}
\end{textblock}
% \begin{description}
%   \ditem{"minimales Markup", "syntaktischer Zucker"}
%     \begin{itemize}
%       \item m”glichst wenig 
%     \end{itemize}
% \end{description}

\labelcentersection{motive-p}{Pers”nliche Motive}
\begin{textblock}{424}                      %% aus 440 2011/10/15
(bemerkenswerte \mystrong{Mischung} aus:)
  \begin{enumerate}
    \item gespannt auf \mystrong{Kommentare}\\zu \mystrong{meinen} Paketen, 
    \item Vortrag soll aber auch �ber \mystrong{"Konkurrenzprodukte" informieren} 
    \item \mystrong{Irrt�mer? Hinweise?} 
          \Endash \mystrong{Terminologie} erst in letzten zwei Wochen 
          "erarbeitet" 
    \item Vorstellung von \pkg{\mystrong{blogdot}.sty}
          (\ctanpkgref{morehype}-B�ndel)                %% 2011/10/06
%     \item \wikideref{Worms}{Wormser} \wikideref{Nibelungenlied}{Rache}
  \end{enumerate}
(und wohl auch ein wenig der beklagenswerten 
\wikideref{Verfassung und Verfassungsvertrag\#Entstehung}{Eitelkeit}~\dots)
\end{textblock}
\labelcentersection{status}{\mystrong{Status}}
% mein erster Tagungsvortrag seit langem\vspace{9}
% Johannes K�ster\vspace{9} %% Anregung "keine Zeit" ... 2011/10/03
nicht richtig fertig, zu umfangreich, hasten, �berspringen
\vspace{9}
kein Experte in Typografie, \HTML, \acronym{CSS}

\labelcentersection{inhalt}{Vortragsteile}
\begin{textblock}{420}
  \begin{enumerate}
    \item \ancref{teil-1}{\mystrong{"Markup"?}}\pardash Terminologie
    \item \ancref{teil-2}{\mystrong{"typografische Zeichen"}}
          mit \TeX/\LaTeX
    \item \ancref{teil-3}{\mystrong{"Formatierung"}}
    \item \ancref{teil-4}{\mystrong{Implementierung}}
          "minimalen Markups" "\mystrong{mit \TeX\ allein}"
    \item \ancref{teil-5}{Paket\mystrong{dokumentation}}
    \item \ancref{teil-6}{\pkg{\mystrong{niceverb}.sty}}
    \item \ancref{teil-7}{"Kommentar"} 
    \item \ancref{teil-8}{Kommentar \mystrong{ausblenden}} 
    \item \ancref{teil-9}{%
%                           \mystrong{Vorverarbeitung}} 
%                           von Code+Kommentar-Dateien
                          "Darstellung"} des Kommentars
    \item \ancref{teil-10}{\mystrong{HTML}} erzeugen
  \end{enumerate}
\end{textblock}

\teilpage{1}{\mystrong{"Markup"} oder so
             \vspace{18}
             \small(Begriffskl„rung\pardash oder so)\endsmall}
\labelsection{txt2tex}{%
  Von \file{.txt} zu \file{.tex}}
% \section{Typografische Erg„nzungen reinen Texts}
% \answer{worum man reinen Text erweitern muss, um typografische 
%  Qualit„t zu erhalten\pardash "minimal" sp„ter!}
Um \mystrong{reinen Text} in \mystrong{\LaTeX-Input} 
(f�r \LaTeX-Qualit„t) umzuwandeln, muss man normalerweise 
Folgendes erg„nzen/„ndern: 
% (Versuch~einer 
% Unterscheidung und \mystrong{Terminologie}): 
\begin{enumerate}
  \item %%% \answer{automatische}
        %%% \strong{"typografische Anreicherung"}, 
        %%% \file{.txt}\to\file{.tex}; 
        \strong{"\wikideref{Typografische Zeichen in HTML}{%
                 typografische Zeichen}"}
        \Endash "typografische" Varianten von
        \wikideref{Auslassungspunkte}{%
                  \mystrong{Auslassungspunkten}},
        \mystrong{Anf�hrung}szeichen,
        \mystrong{Leerzeichen}, 
        und \mystrong{Strichen}.
        %%% \myalert{Beispiele} 
        %%% [space factor, Ellipse, gesch�tzte Leerzeichen, Festabst„nde, 
        %%%  Gedankenstriche, Anf�hrungszeichen]
        %%% \answer{\pkg{easylatex} etc. 
        %%%         (\webdesignref{heyctan.htm\#mine-related}{%
        %%%                        mine-related})
        %%% bzw. zu \autref{implement}}
  \item \strong{"\wikideref{Textformatierung}{%
                 Formatierung}"}\pardash Umschalten zwischen 
        \mystrong{Zeichens„tzen}, Einr�cken, 
        \mystrong{Listen}, Verweise,\Dots
% \answer{\Endash durch spezielle einzelne Zeichen (statt 
%         Backslash~\dots)
%         \Endash Wikipedia, Hervorhebungen nicht so wichtig?}
\end{enumerate}
% Begr�ndung: 
\Endash \mystrong{Unterscheidung} nur \mystrong{HTML}-Terminologie?
\\
\HTML\ verwendet f�r \mystrong{ersten} Fall 
spezielle \mystrong{Zeichen} wie 
\code{\&nbsp;} (anders als \cs{dots}), 
\\
f�r \mystrong{zweiten} Einrahmung mit "Tags" wie
\code{\lt i\gt...\lt/i\gt}
(„hnlich~\LaTeX~\dots); oder~\dots
\vspace{9}
\begin{small}
  \answer{dachte zun„chst, Wortsch”pfung sei meine eigene}
\end{small}

% \answer{\dots\ vgl. 
%         \wikideref{Auszeichnungssprache\#Beispiele}{Wikipedia}}

\labelcentersection{txt2tex-trad}{"Auszeichnung"}
  \begin{textblock}{540}
"Traditionell"
\begin{itemize}
  \item bezieht sich \mystrong{"Auszeichnung"}
        \\
        (im "\Wikideref{Manuskript}"/\Wikideref{Typoskript}, 
         "Markup", 
         "\Wikideref{Schriftauszeichnung}"/\Wikideref{%
                     Auszeichnungssprache}) 
        \\
        anscheinend nur auf \strong{"Formatieren"}
        \\
        (vielleicht weil der \mystrong{Setzer} das nicht "ahnen" 
         konnte),
  \item w„hrend \strong{typografische Zeichen}varianten
        \\
        f�r den \mystrong{Setzer} eher "selbstverst„ndlich" waren 
        \\
        und im "Manuskript" \mystrong{nicht} besonders \mystrong{angezeigt} wurden.
\end{itemize}
  \end{textblock}

\teilpage{2}{\mystrong{Typografische Zeichen} mit \TeX/\LaTeX}
\labelcentersection{typoz-latex}{%
  Typografische Zeichen mit \mystrong{\TeX/\LaTeX}}
% \begin{small}
%   \answer{\Endash zur Erinnerung~\dots}
% \end{small}
%   <p>
\begin{allrulestable}{8}{}%%%{612}
  \begin{tablecoloredrow}{ typoz-latex }{\#eeefff}
    \simplecell{\strong{Zeichen}}
    \simplecell{\strong{realisiert durch}}
  \end{tablecoloredrow}
  \rowoftwocells{\mystrong{Auslassung}szeichen}{\cs{dots}}
%   \starttr
%     \tablewidthcell{200}{Auslassungspunkte}
%     \tablewidthcell{412}{\cs{dots}}
%     \simplecell{\cs{dots}}
%   \endtr
  \rowoftwocells{%
    Gedanken-/"bis"-\mystrong{Strich}}{%
      \dqtd{\code{---}} (englisch), 
      \dqtd{\code{--}}\pardash\mystrong{Ligaturen}}
  \rowoftwocells{%
    (Doppelte) \mystrong{Anf�hrung}szeichen}{%
%     \starttr
%      \tablewidthcell{200}{(Doppelte) Anf�hrungszeichen}
%      \tablewidthcell{412}{%
      Englisch: \mystrong{Ligaturen} \code{``...\texcs'\texcs'}; 
      \\
      Deutsch mit \code{(n)german.sty} oder \code{babel.sty}
      \code{\texcs"`...\texcs"\texcs'}
      \Endash \mystrong{aktive Zeichen}}
%      \endtr
  \rowoftwocells{%                          %% tiefer 2011/10/05
    Gesch�tztes~\mystrong{Leer}zeichen, Festabstand}{%
      \dqtd{\texcs~}
      \Endash\mystrong{aktives Zeichen}, \dqtd{\cs{,}}}
  \rowoftwocells{%
    Englisch: \mystrong{Leer}raum nach Satzzeichen}{%
      \dqtd{\cs{ }} ("Steuerungsleerzeichen"), 
      \dqtd{\cs{@}}, \cs{sfcode`...}}
\end{allrulestable}
  <p>
\begin{small}
  \answer{"Aktive Zeichen" verhalten sich wie Makros, 
%           werden mit 
%           \cs{catcode...13} 
%           \cs{catcode`\texcs\~=13}} 
%           eingestellt.
          \TeX book S.\,37
          }
\end{small}

\labelcentersection{minimal-mehr}{Bewertung~\endash\\%%%Vertiefung 
                                  %%% von 
                                  \mystrong{"minimales Markup"}
                                  genauer
                                  }
\begin{textblock}{560}
  \itqtd{\LaTeX-\mystrong{Qualit„t} 
        \emph{m”glichst ohne} \LaTeX-\mystrong{Befehle}}\\
  \Endash \file{README} des \ctanpkgref{nicetext}-B�ndels:
%   \begin{itquote}
    \\\itqtd{m”glichst keine \mystrong{Zeichen} im Dokument\mystrong{quell}code,
             \\die nicht auch \mystrong{gedruckt} werden!%

%   \end{itquote}
             }\\
  \Endash schliežt \mystrong{"typografische Zeichen"} ein 
  \Endash Schw„che meiner (damaligen) Terminologie~\endash
  \begin{enumerate}
    \item \mystrong{weg} mit \mystrong{Backslash}s, 
          englischen \mystrong{Befehlen} und 
          geschwungenen \mystrong{Klammern!}    %% ngneng 2011/10/03
    \item �berhaupt m”glichst wenig Code-\mystrong{Zeichen}
    \item Zeichen m”glichst \mystrong{intuitiv}
    \item \dots\ am besten so \mystrong{aussehen wie Ergebnis}
    \item \Endash \mystrong{"\acronym{ASCII-WYSIWYG}"}
          \Endash vs.~\ctanpkgref{unisugar} mit Unicode~\dots
  \end{enumerate}
\end{textblock}

\labelcentersection{typoz-bewert}{%% center/textblock 2011/10/14
  Typografische Zeichen\pardash Bewertung}
\begin{textblock}{640}
  \Endash von \ancref{typoz-latex}{\TeX/\LaTeX:}
  \begin{enumerate}
    \item \mystrong{\TeX-Ligaturen} schon ganz gut!
    \item \mystrong{aktive Zeichen}\Dots na ja\Dots
          \dqtd{\texcs~} besser als \dqtd{\code{\&nbsp;}}, 
          aber~\dots
    \item \mystrong{\cs{dots}} schon �bel~\dots
          (warum nicht \mystrong{Ligatur} \dqtd{\code{...}}?)
  \end{enumerate}
\end{textblock}

\labelsection{typoz-auto}{%
  Typografische Zeichen \mystrong{automatisch?}}
\begin{enumerate}
  \item \mystrong{automatische} Umwandlung "reiner" Zeichen 
        in "typografische"?\\ 
  \item \mystrong{\cs{sfcode`A=999}} schon in diese Richtung
        (\TeX book~S.\,76)
  \item so ja optional \mystrong{Anf�hrungszeichen} in 
        \mystrong{\meta{Word}} 
  \item \dots\ \emph{\mystrong{und hier}} \comment{ texblog.fdf }
        \Endash simpel, solange nicht \pkg{german}/\pkg{babel}~\dots: 
        \\\code{\texcs"...\texcs"} expandiert zu 
        \cs{glqq...}\cs{grqq} oder so
  \item eigentlich \emph{nur dies} 
        (automatisches Einf�gen typografischer Zeichen)
        \mystrong{"\code{.txt\to.tex}"}
        in \ctanpkgref{nicetext}-Beschreibung
        (Schw„che der Terminologie)
  \item \emph{WARNUNG!} \mystrong{fehlerhafte} Automatisierung
        typografischer \mystrong{Anf�hrungszeichen} kann zum Verlust 
        des \ancref{motive-p}{\mystrong{Doktortitels}} 
        und politischer Žmter f�hren!
        (\pkg{gutten.sty})
        \vspace{9}
        \begin{small}
          \answer{\,\zB\ \pkg{german.sty} nicht geladen, 
                  \cs{glqq}, \cs{grqq} nicht definiert, 
                  Fehlermeldungen ignoriert\,}
        \end{small}
\end{enumerate}

\labelsection{typoz-ctan}{%
  \mystrong{\file{.txt}\to\file{.tex}} \emph{vor} \pkg{nicetext}}
\Endash auf CTAN:
\begin{enumerate}
  \item \ctanpkgref{txt2latex} kleines 
        \Wikidedisambref{Perl}{Programmiersprache}-Skript,
        wandelt gerade \mystrong{\TeX s spezielle Zeichen}
        ("\code{\&}" etc.), \mystrong{\dqtd{\code{...}}} 
        und doppelte/einzelne \mystrong{Anf�hrungszeichen} um
        (s.~Datei 
         \ctanfileref{support/txt2latex}{txt2latex})
  \item \ctanpkgref{txt2tex}\pardash Perl, erzeugt tats„chlich 
        \LaTeX-\mystrong{Formatierung} (Paketnamen "verkehrt"!)
  \item \CtanPkgRef{easylatex}{EasyLaTeX} „hnlich oder mehr,
        \mystrong{GUI}(?), Ideen aus \mystrong{Wiki\dots-Markup}; 
        zuletzt 2004 (\file{README} 2009 eher CTAN-Hand)
  \item \CtanPkgRef{smiletex}{SmileTeX} Windows \file{.exe}?
        +~Werkzeuge f�r Grafikeinbindung etc.,
        zuletzt 2004
\end{enumerate}
\Endash f�r \mystrong{Paketdokumentation} ist mir das zuviel~\dots


\teilpage{3}{\mystrong{"Formatierung"}
             \vspace{18pt}
             \small(Auszeichnung, Wikipedia)\endsmall}
\labelcentersection{wiki-markup}{%
  \mystrong{Wikipedia}: Schriftauszeichnung}
\Endash Anregungen wie f�r \ancref{typoz-auto}{\pkg{EasyLaTeX}}?
  <p>
\begin{allrulestable}{8}{}%%%{610} 
%     \rowoftwocells{\strong{\mystrong{Wiki}-Code}}{%
%                           \strong{wie \mystrong{\LaTeX}-Code}}
  \begin{tablecoloredrow}{ wiki-markup 1 }{\#eeefff}
    \simplecell{\strong{\mystrong{Wiki}-Code}}
    \simplecell{\strong{wie \mystrong{LaTeX}-Code}}
  \end{tablecoloredrow}
  \rowoftwocells{\code{ == šber ==}}  {\cs{section{šber}}}
  \rowoftwocells{\code{===~Unter~===}}{\cs{subsection{Unter}}}
  \rowoftwocells{\code{%
    \urlapostr\urlapostr\urlapostr 
      fett\urlapostr\urlapostr\urlapostr}}{%
                        \cs{textbf{fett}}}
  \rowoftwocells{\code{%
    \urlapostr\urlapostr kursiv\urlapostr\urlapostr}}{%
                        \cs{textit{kursiv}}}
  \rowoftwocells{\code{%
    \urlapostr\urlapostr\urlapostr\urlapostr\urlapostr
      Fett-\urlapostr\urlapostr\urlapostr
        Kur\urlapostr\urlapostr}}{%
                        \cs{textit{\cs{textbf{Fett-}}Kur}}}
\end{allrulestable}
  <p>
\Endash \mystrong{Intuition} dahinter vielleicht:
Bedeutungen von \emph{kursiv} und\\ 
\emph{doppelten Anf�hrungszeichen} verwandt, 
\zB\ Buchtitel

\labelcentersection{wiki-listen}{%
  \mystrong{Wikipedia}: Listen und Zitate}
\begin{allrulestable}{8}{}%%%{640} 
  \begin{tablecoloredrow}{ wiki-markup 2 }{\#eeefff}
    \simplecell{\strong{\mystrong{Wiki}-}}
    \simplecell{\strong{wie \mystrong{LaTeX}-Code}}
%     \simplecell{}
    \simplecell{\strong{\mystrong{Wiki}-}}
    \simplecell{\strong{wie \mystrong{LaTeX}-Code}}
  \end{tablecoloredrow}
  \starttr
    \simplecell{\code{\ast~Eins\\\ast~Zwei}}
    \simplecell{\cs{begin{itemize}}\\
                \cs{item Eins}\\\cs{item Zwei}\\
                \cs{end{itemize}}}
%     \simplecell{}
%     \simplecell{\code{Er~nur:\\:Ja,~...}}
    \simplecell{\code{Er~nur:\\:Ja,~\dots}}
    \simplecell{\code{Er~nur:\\\cs{begin{quote}}\\
%                       Ja,~...\\\cs{end{quote}}}}
%                       Ja,~\dots\\\cs{end{quote}}}}
                      Ja,~\cs{dots}\\\cs{end{quote}}}}
  \endtr
  \starttr
    \simplecell{\code{# Eins\\# Zwei}}
    \simplecell{\cs{begin{enumerate}}\\
                \cs{item Eins}\\\cs{item Zwei}\\
                \cs{end{enumerate}}}
%     \simplecell{}
    \simplecell{\code{Code:\\\enspace\cs{relax}}}
    \simplecell{\code{Code:\\\cs{begin{verbatim}}\\
                      \cs{relax}\\\cs{end{verbatim}}}}}
  \endtr
\end{allrulestable}
\\
\Endash immerhin recht \mystrong{"minimal"}, 
auch halbwegs \mystrong{intuitiv.}
\vspace{9}
(vgl.~\ctanfileref{\ltxcontrib nicetext/doc}{%
                         wikicheat.pdf})

\teilpage{4}{\mystrong{Implementierung}\\"minimalen Markups" 
             \\"mit \mystrong{\TeX\ allein}"}
\labelsection{implement}{%
  \mystrong{Implementierung}smethoden f�r\\"minimales Markup" 
            mit \mystrong{\TeX}}
\begin{theses}
  \thesis{(ML)}{\strong{Ligaturen}\pardash\dots
                \\(nicht mein Ding, Zukunft ohne \acronym{METAFONT}?)}
  \thesis{(MS)}{\strong{"Substitution"} bzw. \strong{"Skript"}, 
                genauer: \mystrong{Vorverarbeitung} der 
                \file{.tex}-Datei, 
                \mystrong{Zeichenkettenersetzung} 
                (und mehr)
                %%% \\                              %% rm. 2011/10/15
                per \wikideref{Skriptsprache}{Skript} 
                wie mit Perl~/ \wikideref{awk}{awk}~/~etc.
                bzw. mit den \ancref{typoz-auto}{beschriebenen} 
                Paketen}
  \thesis{(MA)}{\strong{("forschende") aktive Zeichen}
                \Endash im \mystrong{"Schriftsatz-Modus"} 
                (w„hrend \TeX\ den Dokumentquelltext 
                 st�ckweise in Glyphen und K„stchen umwandelt)
                 \mystrong{expandieren} aktive Zeichen mehr oder weniger 
                 direkt zu \mystrong{"normalen"} \LaTeX-Befehlen, 
                 \mystrong{"forschende"} aktive Zeichen 
                 "\mystrong{erkunden} dabei ihre \mystrong{Umgebung}"}
\end{theses}

\labelsection{implement-ms}{Methode (MS)\pardash Anmerkungen~I}
  \TeX s                            %% apostrophe rm. 2011/10/03
  Mechanismus, sog. \mystrong{"begrenzte Parameter"}
  von Makros zu erkennen 
  (\TeX book S.\,203),              %% moved komma 2011/10/03
  bietet eine bequeme, aber auch "begrenzte" Methode, 
  \wikideref{Zeichenkette}{"Zeichenketten"} ("Strings")
  zu erkennen\\(und zu \mystrong{ersetzen}). 
  \begin{enumerate}
    \item Vor- und Nachteile entstehen daraus, dass 
          ein "String" aus "reinem Text" von \TeX\ intern
          durch unterschiedliche \mystrong{"Token-Ketten"} "dargestellt"
          werden kann. Auch von \mystrong{Grož-/Kleinschreibung} abzusehen 
          ist nicht ganz einfach. 
    \item Diese Methode wurde seit l„ngerem von \LaTeX's internem 
          \mystrong{\cs{@in}}-Makro 
          [haupts„chlich zur Erkennung von Paket-Optionen]
          und vom Paket \mystrong{\ctanpkgref{substr}} 
          (Harald Harders bzw. Heiko Oberdiek) 
          angewandt. %%% angewendet.            %% 2011/10/03
    \item Gegenw„rtig fužen auch \mystrong{\file{fifinddo.sty}} und 
          \mystrong{\file{makedoc.sty}} (\ctanpkgref{nicetext}) 
          auf dieser Methode\pardash gen�gte bisher \emph{praktisch}.
  \end{enumerate}

\labelsection{implement-ms2}{Anmerkungen zu (MS)~II
              \\(\mystrong{String}s und \mystrong{Scripting} mit 
              \mystrong{\TeX})}
\begin{enumerate}
  \item Die Pakete \ctanpkgref{stringstrings} (Steven Segletes), 
        \ctanpkgref{xstring} (Christian Tellechea, \CtanPkgRef{etex}{e-\TeX})
        und \ctanpkgref{ted} (Manuel P\'egouri\'e-Gonnard) liefern String-Funktionen 
        "auf h”chstem Niveau".
  \item String-Funktionen finden sich auch in 
        \ctanpkgref{datatool} (Nicola Talbot), 
        \ctanpkgref{coolstr} (Nick Setzer) und 
        \ctanpkgref{texapi} (Paul Isambert).
  \item Eine "ernsthafte \mystrong{Skriptsprache}" 
        bietet neben Zeichenersetzung 
        allgemeiner \mystrong{"Sortierung"} und \mystrong{"Filter".} 
        Beispielsweise bietet \ctanpkgref{docstrip}
        eine \TeX-basierte Skriptsprache, 
        die aus einer \mystrong{\file{.dtx}-Quelldatei}
        die \mystrong{"Kommentare" entfernt} 
        und den Rest in verschiedene
        \mystrong{"kompakte" \TeX-Eingabedateien} "sortiert".
\end{enumerate}

\labelsection{implement-ma}{"Minimales Markup"\\
              mit \mystrong{"forschenden" aktiven Zeichen} (MA)}
\mystrong{\pkg{wiki.sty}} aus dem \mystrong{\pkg{nicetext}}-B�ndel
implementiert die \ancref{wiki-markup}{zuvor} beschriebene 
\mystrong{Wikipedia}-Syntax f�r \TeX, \dh\ mit \pkg{wiki.sty} 
kann man in der \code{{document}}-Umgebung von \LaTeX
\begin{enumerate}
  \item statt \mystrong{\cs{...section{...}}} einrahmende 
        \mystrong{Gleichheitszeichen}-Folgen verwenden,
  \item \mystrong{Kursiv}- und \mystrong{Fett}schrift
        mit Folgen von 
        \wikideref{Apostroph}{%
                   "\mystrong{Apostroph}-Ersatzzeichen"}
        (ASCII-Code~39) ein- und abschalten,
  \item \mystrong{Listen} und \mystrong{Blockzitate} 
        aus Menschen- oder Programmiersprache durch 
        spezielle \mystrong{Zeilenanf„nge} anzeigen.
\end{enumerate}

\labelsection{implement-ma+}{\pkg{\mystrong{wiki}.sty}s 
                             \mystrong{"forschende"} Zeichen}
\begin{enumerate}
  \item \mystrong{Gleichheitszeichen} werden \emph{aktive} Zeichen, 
        die feststellen, wieviele Gleichheitszeichen unmittelbar 
        aufeinander folgen.
  \item Ebenso funktionieren die \mystrong{Apostroph}-Ersatzzeichen. 
        Dabei werden \cs{textit} und \cs{textbf} nicht direkt 
        verwendet, das \mystrong{Umschalten} und die 
        \mystrong{Kursivkorrektur} 
        finden \mystrong{ohne} \mystrong{"Gruppenbildung"} statt.
  \item Um \mystrong{Listen} und \mystrong{Zitate} am Zeilenanfang 
        zu erkennen, wird das \mystrong{Zeilenende}-Zeichen 
        (\code{^^M}) \mystrong{aktiv} und „ndert auch f�r kurze Zeit 
        die Kategorie des Leerzeichens. 
        So analysiert \code{^^M} den Anfang der n„chsten Zeile 
        und kann feststellen, ob eine Liste bzw. ein Blockzitat 
        \mystrong{beginnt}, \mystrong{fortgesetzt} wird, oder 
        \mystrong{endet}, oder ob der Liste ein 
        \mystrong{weiterer Punkt} (\cs{item}) hinzugef�gt wird. 
        Entsprechend wird automatisch eine 
        \cs{begin{...}}- bzw. \cs{end{...}}-Zeile oder das Makro 
        \mystrong{\cs{item}} eingef�gt
\end{enumerate}

\labelcentersection{implement-mas}{(MA) vs. (MS)}
\begin{textblock}{600}
  Die Methoden \mystrong{(MA)} (aktive Zeichen) 
  und \mystrong{(MS)}\\(Substitution/Skript)
  \mystrong{schliežen sich \emph{nicht} gegenseitig aus.}
  \\Welche Methode man anwendet,
  ist vielleicht "Geschmackssache".
  Die \ancref{wiki-markup}{\mystrong{Wikipedia-Abschnitts�berschrift}}
  (Gleichheitszeichen) wird in 
  \file{\mystrong{wiki}.sty} nach Methode (MA),\\
  in \file{\mystrong{makedoc}.sty} nach Methode (MS) implementiert.
\end{textblock}

\teilpage{5}{\mystrong{Dokumentation} von \LaTeX-Paketen
             \vspace{18}
             \small(mit \mystrong{\pkg{nicetext}})\endsmall}

% \labelsection{min-markup-doku}{%
%   \mystrong{"Minimales Markup"} in der Paket\mystrong{dokumentation}
%   mit \pkg{nicetext}}
% 
\labelcentersection{nicetext}{Die \mystrong{Pakete} %% center 2011/10/14
                              des \mystrong{\pkg{nicetext}}-B�ndels}
\begin{textblock}{600}  %% aus 640 2011/10/15
  \begin{description}
    \ditem{\pkg{wiki.sty}}
  %     Implementierung von 
      \mystrong{Wikipedia-Markup} gem„ž (MA) 
      (\ancref{implement-ma}{\so})
    \ditem{\pkg{niceverb.sty}}
      \mystrong{"minimales Markup"}(?) speziell f�r \mystrong{Beschreibung} 
      \\                %% 2011/10/15
      von \mystrong{\LaTeX-Makros} und \LaTeX-\mystrong{Paketen} 
  %     in gewisser Weise auch "typografische Varianten" 
  %     von ASCII-Zeichen, alles gem„ž 
      (MA)
    \ditem{\pkg{makedoc.sty}}
  %     \mystrong{Skript}sprache f�r die 
      \mystrong{Vorverarbeitung} von 
  %     Dateien, die \mystrong{Code und Kommentar} ("gemischt") enthalten, 
        \mystrong{Code+Kommentar}-Dateien
  %     implementiert insbesondere 
  %     \mystrong{Wikipedia-šberschriften}, alles
      (MS)
    \ditem{\pkg{mdoccorr.cfg}}
      \mystrong{Regeln} zum Einf�gen \mystrong{typografischer Zeichen} (MS)
    \ditem{\pkg{fifinddo.sty}}
  %     allgemeine \mystrong{Skript}sprache, um \mystrong{aus Text}dateien 
  %     andere \mystrong{Text}dateien zu \mystrong{erzeugen}, 
  %     Grundlage f�r \mystrong{\pkg{makedoc.sty}}
      \mystrong{\pkg{makedoc.sty}} zugrundeliegende 
      \mystrong{Skript}sprache
  \end{description}
\end{textblock}

% \labelsection{doku-format}{%
%   Paketdokumentation: \mystrong{Formatierung}}
% 
\labelsection{wiki}{%
  \pkg{\mystrong{wiki}.sty}}
% \begin{textblock}{480}
  \begin{enumerate}
    \item \ancref{implement-ma}{\mystrong{Schrift}kodierung} 
          durch \emph{Folgen} von \mystrong{Apostrophen} finde ich 
          \mystrong{nicht intuitiv genug}, 
          um andere Paketbearbeiter damit konfrontieren zu wollen,
          \small\answer{Publikum (U.\,Z.): \Wikideref{Markdown}!}\endsmall
    \item \dots\ sie ist gegenw„rtig auch \mystrong{inkompatibel} mit der 
          Verwendung "aktiver Apostrophe" in 
          \pkg{\mystrong{niceverb}.sty}.
    \item \ancref{implement-ma}{\mystrong{šberschriften}kodierung} durch 
          \mystrong{Gleichheitszeichen} verwende ich bisher in der 
          (MA)-Implementierung von \pkg{\mystrong{makedoc}.sty}. 
    \item Dass \ancref{implement-ma+}{\mystrong{Einr�cken}} eine 
          \mystrong{verbatim}-Umgebung ausl”st, finde ich 
          \mystrong{unpraktisch.}
    \item Im Quelltext sehe ich lieber \mystrong{"1."}, \mystrong{"2."}, 
          \dots als "\code{\#}". 
          \\
          \small\answer{Publikum: \Wikideref{Markdown}!}\endsmall
    \item \mystrong{Unnummerierte Listen} mit \texcs* sind 
          \mystrong{OK}, 
          habe ich mal f�r \mystrong{"Fremddokumentation"} eingesetzt.
  \end{enumerate}
% \end{textblock}


\teilpage{6}{\pkg{\mystrong{niceverb}.sty}}
\labelsection{niceverb}{%
  \pkg{\mystrong{niceverb}.sty}\pardash "Schrift\mystrong{auszeichnung}"}
  \wikideref{Definitionsmenge}{"Fortsetzung"} der 
  \ancref{wiki-markup}{\mystrong{Wikipedia}-Schriftauszeichnung:} 
\begin{enumerate}
  \item Umrahmung mit \mystrong{einfachen Apostroph}-Ersatzzeichen 
        (\code{'nicetext'})                 %% verb->text 2011/10/08
        wirkt wie \mystrong{\cs{textsf}}
        \Endash f�r \mystrong{Paketnamen}.
  \item \mystrong{einfache Anf�hrung}szeichen
        wirken wie \mystrong{\cs{texttt}}
        \Endash f�r \mystrong{Code}
        \Endash tats„chlich wirkt \code{\lq\cs{foo}'} 
        (solange nicht in Makro-Argument) wie 
        \mystrong{\cs{verb}\code{+\cs{foo}+}} 
        (\mystrong{Inline-verbatim}).
%   \item \mystrong{Vertikalstriche} (\code{|\cs{foo}|}) 
%         sollen \mystrong{Code} beim \mystrong{šberfliegen} der 
%         Dokumentation \mystrong{herausstechen} lassen 
%         ("hier Erl„uterung von \cs{foo}!")
%         \Endash \mystrong{Farbhinterlegung}? derzeit
%         \mystrong{"K„sten"} wie mit \cs{fbox}:
%         \begin{quote}
%             \allrulestable{2}{}\starttr
%               \simplecell{\cs{foo}}
%             \endtr\endallrulestable
%         \end{quote}
% %         Allerdings achte ich darauf, dass alle dieselbe 
% %         H”he haben und die Zeilenh”he und -tiefe nicht „ndern 
% %         (\cs{InlineCmdBox}).
%         "Intern" wird zwischen \mystrong{\cs{VerticalCmdBox}} und 
%         \mystrong{\cs{InlineCmdBox}} 
%         (erm”glicht zusammenfassende Aufz„hlung von Makros 
%          in \emph{einem} Absatz) gew„hlt.
\end{enumerate}
  \vspace{0}
  <p \@align@c>
\begin{allrulestable}{8}{}
  \begin{tablecoloredrow}{ wiki-markup 1 }{\#eeefff}
      \simplecell{\strong{Code mit \mystrong{niceverb}.sty}}
      \simplecell{\strong{wie Code \mystrong{sonst}}}
  \end{tablecoloredrow}
  \rowoftwocells{\code{'nicetext'}}{\cs{textsf{nicetext}}}
  \rowoftwocells{\code{\lq\cs{foo}'}}{\cs{verb+}\cs{foo+}}
  \rowoftwocells{\code{\lq README.txt'}}{\cs{texttt{README.txt}}}
\end{allrulestable}
  </p>

\labelcentersection{syntax}{\mystrong{Beschreibung} von \LaTeX-Makros}
\begin{textblock}{640}          %% 2011/10/15
  \meta{\bdquo Tippt man}
  \begin{verbatim}
    \mystrong{%
      \texcs\foo\ast[\metavar{opt-arg}]{\metavar{mand-arg}}}
  \end{verbatim}
    \meta{so erh„lt man~\dots\ldquo}
  \Endash so soll die Beschreibung der \mystrong{Syntax} von 
  \mystrong{\cs{foo}} im \mystrong{\file{.pdf}} aussehen. 
  \endash %%%  <p>
  \mystrong{Code} daf�r mit \pkg{\mystrong{niceverb}.sty}:
  \begin{verbatim}
    \mystrong{%
      \lq\texcs\foo\ast[\lt opt-arg\gt]{\lt mand-arg\gt}\rq}
  \end{verbatim}
  % (mittlerweile auch mit \mystrong{Martin Scharrer}s \ctanpkgref{ydoc}, 
  %  abgesehen von den \mystrong{Anf�hrung}szeichen}).
  \Endash \mystrong{"\acronym{ASCII-WYSIWYG}"} 
  %% <- mod. 2011/10/03 ->
  \\\endash
  \cs{langle} \mystrong{"typografisches"} "\code{\lt}",
  \\\endash
  \cs{rangle} "typografisches" "\code{\gt}".
  % Im \mystrong{"Auto-Modus"} kann man die umrahmenden 
  % \mystrong{Anf�hrung}szeichen 
  % \mystrong{weglassen! (Backslash aktiv)}
  \\
  \endash %%%  <p>
  \mystrong{Code} daf�r mit \pkg{\mystrong{doc}.sty} 
  (aus der \LaTeX-"base"-Distribution):
  \begin{verbatim}
    \mystrong{%
      \texcs|\texcs\foo\ast[|%
             \texcs\meta{opt-arg}|]{|%
             \texcs\meta{mand-arg}|}|}
  \end{verbatim}
\end{textblock}

\labelsection{vert}{\mystrong{Hervorhebung} von 
  Makro\mystrong{beschreibungen}}
%% TODO Link weiter fkt. nicht mit Firefox im Internetshop 2011/10/12
\mystrong{Vertikalstriche} (\code{|\cs{foo}|}) 
\begin{itemize}
  \item schalten im vorigen Beispiel (\pkg{\mystrong{doc}.sty})
        \endashed{wie es sehr \mystrong{�blich} ist}
        \mystrong{verbatim}-Modus an/aus, 
        \dh\ \mystrong{\code{|\cs{foo}|}} k�rzt 
        \mystrong{\cs{verb|}\cs{foo|}} ab~\endash
  \item sollen mit \pkg{\mystrong{niceverb}.sty}
        \mystrong{Code hervorheben} und 
        beim \mystrong{šberfliegen} der 
        Dokumentation \mystrong{herausstechen} lassen 
        (\itqtd{hier~Erl„uterung~von~\cs{foo}!})
\end{itemize}
\Endash \mystrong{Farbhinterlegung}? derzeit
\mystrong{"K„sten"} wie mit \cs{fbox},
% \begin{quote}
%     \allrulestable{2}{}\starttr
%       \simplecell{\cs{foo}}
%     \endtr\endallrulestable
% \end{quote}
%         Allerdings achte ich darauf, dass alle dieselbe 
%         H”he haben und die Zeilenh”he und -tiefe nicht „ndern 
%         (\cs{InlineCmdBox}).
% "Intern" wird zwischen \mystrong{\cs{VerticalCmdBox}} und 
% \mystrong{\cs{InlineCmdBox}} 
% (erm”glicht zusammenfassende Aufz„hlung von Makros 
%  in \emph{einem} Absatz) gew„hlt.
intern soll \cs{InlineCmdBox} zusammenfassende Aufz„hlungen von Makros 
\emph{in einem Absatz} erm”glichen. \strong{Beispiel}~Code/Ergebnis:
\begin{verbatim}
    |\texcs\foo\ast[\lt opt-arg\gt]{\lt mand-arg\gt}|
\end{verbatim}
\begin{quote}
    \allrulestable{2}{}\starttr
         \simplecell{%
            \,\cs{foo\ast[\metavar{opt-arg}]%
                         {\metavar{mand-arg}}}\,}
    \endtr\endallrulestable
\end{quote}

\labelsection{niceverb-noch}{%
  \pkg{\mystrong{niceverb}.sty} \mystrong{noch:}}
\begin{enumerate} 
  \item \mystrong{"\code{\lt meta\gt}"} erzeugt "\metavar{meta}" 
        \mystrong{sowohl} innerhalb \mystrong{als auch} 
        aužerhalb von einfachen Anf�hrungszeichen.
  \item Im \strong{"Auto-Modus"} werden \LaTeX-Befehle nicht 
        ausgef�hrt, sondern als \mystrong{verbatim}-Text 
        interpretiert, etwa folgende Sterne und Klammern 
        als \mystrong{Syntaxbeschreibung} dazu.     %% . 2011/10/03
  \item \Endash dient besonders 
        der \mystrong{"Fremddokumentation"} 
        (vorhandene \acronym{ASCII}-Paketdokumentation 
         anderer Autoren ohne Eingriff in \LaTeX-Qualit„t setzen).
  \item "\code{\mystrong{\&}}"              %% \mystrong 2011/10/08
        ist \mystrong{aktives Zeichen}, welches in
        \mystrong{Makroargumenten} Befehlen und 
        Syntaxbeschreibungen vorangestellt werden kann, 
        um \mystrong{"nachzuhelfen"}:
    \begin{verbatim}
      \mystrong{%
        \cs{footnote{\texcs&\texcs\foo\ast
                     [\lt opt-arg\gt]%
                     {\lt mand-arg\gt}}}}
    \end{verbatim}
  \item % Nat�rlich gibt es mit all diesen \mystrong{aktiven Zeichen} 
        % auch \mystrong{Probleme}, und \mystrong{Auswege} dazu~\dots 
        \mystrong{aktive Zeichen}~\to\ \mystrong{Probleme}~\dots 
        \mystrong{Auswege}~\dots
\end{enumerate}

\labelsection{niceverb-sim}{\mystrong{Žhnliche} Pakete 
                            \mystrong{anderer} Autoren}
% \\\answer{\pkg{ltxdoc.cls}
\begin{enumerate}
  \item \pkg{\mystrong{niceverb}.sty} ist wesentlich inspiriert
        durch die Dokumentationsmethode \mystrong{Stephan B”ttcher}s 
        in \CtanPkgRef{lineno}{\mystrong{lineno}.sty}. 
  \item Žhnliche Funktionalit„t liefert auch 
        \mystrong{\pkg{ltxguide.cls}} f�r die "\LaTeX-Guides".
  \item Die \ancref{syntax}{bequeme \mystrong{Syntaxbeschreibung}} 
        gibt es 
        ("mittlerweile") auch in \mystrong{Martin Scharrers} 
        \ctanpkgref{ydoc}. 
  \item \pkg{\mystrong{niceverb}.sty} ist ebenso wie
        \pkg{\mystrong{ydoc}} als \strong{Alternative}
        zu \pkg{\mystrong{doc}.sty} konzipiert. 
        \pkg{\mystrong{ydoc}} liefert dabei einen „hnlichen 
        \mystrong{Funktionsumfang} wie \pkg{\mystrong{doc}.sty}, 
        w„hrend \emph{ich} (f�r meine Zwecke) 
        einen solchen Funktionsumfang �berhaupt 
        \mystrong{nicht haben will.}
        \Endash \mystrong{Allerdings} habe ich einzelne 
        \pkg{\mystrong{doc}.sty}-Funktionen in 
        \pkg{\mystrong{makedoc}.sty} und in 
        \pkg{\mystrong{readprov}.sty} 
        (\ctanpkgref{fileinfo}-B�ndel).     %% "B�ndel" 2011/10/03
\end{enumerate}
 

\teilpage{7}{"Kommentar"}
\labelsection{kommentar}{%
  \mystrong{Code} und \mystrong{"Kommentar"}}
%   "Perversion der \mystrong{Kommentarzeichen}"}
\small\answer{vgl. \Wikideref{Schuld und S�hne}, 
                   \Wikideref{Pride and Prejudice}, 
                   \Wikideref{Gesetzeskommentar} zum 
                   \Wikideref{Code civil}}\endsmall
  <p>
\TeX\ bietet wie alle "normalen" Programmiersprachen die M”glichkeit, 
\mystrong{in Quelldateien Text} einzuf�gen, der \mystrong{nicht} 
vom Compiler bzw. Interpreter (als \mystrong{Befehle/Daten}) 
verarbeitet werden soll, sondern an (menschliche) \mystrong{Leser} 
gerichtet ist\pardash hier \mystrong{"Kommentar"}. 
\\                                                  %% 2011/10/15
Einzelne \mystrong{Zwecke}
(der \wikideref{Kommentar (Programmierung)}{Wikipedia-Artikel} 
 weiž noch mehr~\dots):

\labelcentersection{kommentarzw}{\mystrong{Zwecke} des Kommentars}
\begin{textblock}{576}              %% 2011/10/15
  \begin{enumerate}
    \item \strong{Erl„uterungen} f�r \strong{Programmierer}, 
          um die \strong{Wartung} des Codes zu erleichtern~\endash
    \item gerade im Falle von \mystrong{\TeX}- und \LaTeX-Paketen 
          (alter~Zeiten) %%% enth„lt/enthielt der "Kommentar"
          an \strong{Nutzer} gerichtete \mystrong{"Erl„uterungen"}
          im~Sinne einer \strong{Gebrauchsanleitung}\\
          (manchmal der einzig verf�gbaren).        %% Genitiv 2011/10/15
    \item In etwa gleichrangig %%% ist die 
          Bedeutung des \strong{"Auskommentierens"} von Code, 
          \dh %%% der
          \mystrong{"Kommentar"}~enth„lt %%% in diesem Fall 
          eigentlich \mystrong{Befehle/Daten} f�r %%% den 
          Compiler/Interpreter, die der \mystrong{Programmierer}
          (oder~auch~Dokument\mystrong{autor}) %%% m”chte diesen 
          \mystrong{"aufbewahren"} m”chte statt v”llig zu 
          \mystrong{l”schen}                %% <- 2011/10/15 ->
%           \mystrong{Code nicht} ganz und gar \mystrong{l”schen},
%           sondern ihn \mystrong{"aufbewahren"~\dots}
  \end{enumerate}
\end{textblock}

\labelsection{kommentarzwa}{Zwecke des \mystrong{"Auskommentierens"}}
\begin{enumerate-a}
  \item als eine Art \strong{"Versionskontrolle"}: 
        man \mystrong{beh„lt sich vor}, den~Code~sp„ter wieder 
        "an den Compiler/Interpreter zu richten"
        (durch einfache Entfernung der 
         \Wikideref{Kommentarzeichen} bzw. 
         \mystrong{"Kommentarbegrenzern"}), 
        \zB\ zum "\Wikideref{Debugging}"
        oder~f�r~bestimmte Adressaten~\endash
  \item als "Erinnerung" and fr�here \mystrong{"Fehlversuche"},
        die auf fr�here "šberlegungen" hinweist und so wieder 
        der \strong{Wartung} durch den Programmierer/Autor dient.
\end{enumerate-a}
Ich nehme an, bei vielen ist in der t„glichen Praxis mit \TeX/\LaTeX 
das "Auskommentieren" die \strong{haupts„chliche} Funktion des 
\mystrong{"Kommentars"}~\dots


\teilpage{8}{Methoden Kommentar \mystrong{"auszublenden"}}
\labelsection{kommentar-ignor}{%
  \mystrong{Feinheiten} des \mystrong{"Ausblendens"}\\von Kommentar}
\begin{enumerate}
  \item Enth„lt eine \mystrong{\TeX/\LaTeX-Paketdatei} 
        die \TeX-Anweisungen und gleichzeitig die \strong{Gebrauchsanweisung}, 
        so umfasst sie typischerweise wesentlich mehr 
        \mystrong{Kommentarzeilen} als \mystrong{Anweisungszeilen}. 
  \item Auch \strong{"Programmierertext"}, der die Implementierung 
        sorgf„ltig diskutiert, kann im Verh„ltnis zum Code sehr 
        umfangreich sein (\zB\ \pkg{\file{lineno}.sty}).
  \item \mystrong{"Vor langer Zeit"} forderte das \strong{Einlesen} 
        von \TeX-Makrodateien aufgrund der "\mystrong{Hardware}-Umst„nde"
        bereits so viel Zeit, dass es \mystrong{sinnvoll} war,
        das Einlesen von Kommentarzeilen v”llig zu \strong{vermeiden}~\dots 
\end{enumerate}

\labelsection{kommentar-ignor-mehr}{%
  \mystrong{"Ausblenden"} von Kommentar\pardash\mystrong{Forts.}~\dots}
\begin{enumerate}
  \item Ein \mystrong{"primitiver" Ansatz} dazu war, 
        die \strong{"Gebrauchsanleitung"}\\ 
        "am Ende der Datei" \mystrong{nach} dem 
        \mystrong{\cs{endinput}}-Befehl der Datei
        anzubringen. Die Datei enthielt dann gerne am 
        \mystrong{Anfang} den Hinweis auf die Gebrauchsanleitung 
        der Datei an ihrem \mystrong{Ende}.\\
        Der \cs{endinput}-Befehl bricht die Verarbeitung der Datei ab, 
        so dass die Zeilen darunter tats„chlich 
        keine Verarbeitungszeit mehr beanspruchen.
  \item \mystrong{Andererseits} sollte f�r die \strong{Wartung} 
        der Kommentar eben doch in der \mystrong{N„he} der 
        betreffenden Code-Zeilen angebracht werden~\dots
\end{enumerate}

\labelsection{docstrip}{%
  \pkg{docstrip} \mystrong{blendet} noch \mystrong{effizienter} aus:} 

\begin{enumerate}
  \item Mit \mystrong{\LaTeX2} hatten \mystrong{Paket-Dateien} 
        die Endung \mystrong{"\file{.sty}".}\\
        Sie \mystrong{enthielten} noch \mystrong{"Kommentar"} wie oben. 
  \item Mit \mystrong{\LaTeX2e} wurden \pkg{\mystrong{doc}.sty} und 
        \pkg{\mystrong{docstrip}.tex} eingef�hrt. 
        Dateien, die \mystrong{Code} und \mystrong{Kommentar 
        "gemischt"} enthielten, bekamen nun die Endung 
        \mystrong{"\file{.doc}"} oder \mystrong{"\file{.dtx}".} 
        \pkg{docstrip} wandelt solche Dateien in Dateien mit Endungen 
        haupts„chlich wie \mystrong{"\code{.sty}"} oder 
        \mystrong{"\code{.cls}"} um; 
        diese sollen \mystrong{keinen Kommentar} mehr enthalten
        (bis auf \mystrong{Lizenz}-Hinweise) und sind diejenigen,
        die~im~\TeX-Lauf tats„chlich \mystrong{eingelesen} werden, 
        \mystrong{aužer\Dots}
\end{enumerate}

\labelsection{kommentarzch}{Kommentar\mystrong{zeichen}}
\begin{enumerate}
  \item Kommentar\mystrong{zeilen} sind mit \TeX/\LaTeX\ gew”hnlich 
        durch das Kommentar\mystrong{zeichen} ("\code{\%}") 
        am Anfang gekennzeichnet.
  \item (Nach \mystrong{\cs{endinput}} wird Code auch 
        \mystrong{ohne} Kommentarzeichen ignoriert; 
        ebenso kann man im Prinzip "Kommentar" \metavar{kommentar} mit 
        \mystrong{"\cs{iffalse}\metavar{kommentar}\cs{fi}"}
        einrahmen.)
  \item Diese (ganz oben) \mystrong{Zeilen mit Kommentarzeichen}
        werden dann von \mystrong{\pkg{docstrip}} entfernt~\dots
        \dh, diese Kommentarzeichen dienen gar \mystrong{nicht} 
        mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei 
        als "zu ignorieren" zu kennzeichnen, vielmehr sind sie gar 
        nicht mehr da. \mystrong{Wieso dann noch Kommentarzeichen?}
  \item \dots\ tats„chlich: Mit \mystrong{Paul Isambert}s 
        \CtanPkgRef{codedoc}{CodeDoc} ist der "Kommentar"
        normaler, von \mystrong{Listing-Umgebungen}
        unterbrochener Text (ohne "\code{\%}" links). 
        Letztere schreiben den Code in die \mystrong{kompakte Paketdatei}.
\end{enumerate}

\labelsection{ohne-docstrip}{%
  \emph{Ohne} \pkg{docstrip} \mystrong{heute}}
(\autref{docstrip} fortsetzend:)\Dots 
\emph{aber}                                 %% emph 2011/10/08 
es gibt die \mystrong{\file{.sty}-Pakete}, 
die \mystrong{\emph{mit} Kommentarzeilen} 
(ohne \pkg{docstrip} einzuschalten) eingelesen werden, \mystrong{noch 
heute!}
\begin{itemize}
  \item verschiedene in \acronym{TDS}-\file{ltxmisc/}, darunter 
        einige geniale, f�r manche unverzichtbare Pakete von 
        \httpref{ctan.org/author/id/arseneau}{\mystrong{%
            Donald Arseneau}} (ich sehe gerade \ctanpkgref{framed}~\dots)
  \item \mystrong{Stephan B”ttcher}s \CtanPkgRef{lineno}{lineno.sty}
        (Zeilennummerierung besonders f�r 
         \mystrong{kritische Editionen} und \mystrong{Einreichungen})
        enth„lt gewaltig viel Kommentar\pardash von mir �bernommen, 
        nie geh”rt, dass das Laden zu lange dauere~\dots
  \item alle (? \cs{endinput}) meine 
        \httpref{ctan.org/author/id/lueck}{\mystrong{eigenen}} 
        Pakete (was nat�rlich einfach eine Frechheit sein kann~\dots)
\end{itemize}


\teilpage{9}{\mystrong{"Darstellung"} des Kommentars}
%   \mystrong{Vorverarbeitung}\\von Code+Kommentar-Dateien}
% Verarbeitung als Dokumentation
\labelsection{doku-vor}{"Darstellung" des Kommentars
                        \Endash \mystrong{"Vorzeit"}}
\begin{enumerate}
  \item \emph{Vor} \pkg{\mystrong{doc}.sty} 
        war der \mystrong{Kommentar} in \mystrong{Paketdateien} 
        dazu da, mit einem \mystrong{Texteditor} gelesen oder 
        im \mystrong{"Text"}-Modus 
        (als "Listing", im Gegensatz zum f�r \TeX\ 
         erforderlichen \mystrong{"Grafik"}-Modus) 
        ausge\mystrong{druckt} zu werden.
  \item Kommentar entsprechend 
        "reiner \mystrong{\acronym{ASCII}}-Text",
        weder "typografische Zeichen" noch Auszeichnung.
\end{enumerate}

\labelsection{doku-doc}{%
  Darstellung des Kommentars mit \pkg{\mystrong{doc}.sty}}
\begin{enumerate}
  \item Erst mit \pkg{\mystrong{doc}.sty} wurde 
        die heute von \mystrong{\LaTeX-Paketen} auf dem 
        \mystrong{CTAN} gewohnte \LaTeX-Druck\mystrong{qualit„t} 
        des \mystrong{Kommentars} m”glich, 
        wobei man den \mystrong{Code} als Imitation 
        der Texteditor- und Listing-Druckqualit„t auszeichnet. 
        \mystrong{Entscheidend} ist dabei der 
        \mystrong{"\Wikideref{Don't repeat yourself}"}-Grundsatz
        \Endash die \mystrong{Code} und 
        \mystrong{Kommentar mischende} Quelldatei wird f�r 
        den Qualit„tsausdruck nicht von Hand �berarbeitet, 
        sondern "automatisch" mit dem \mystrong{\cs{DocInput}}-Befehl 
        verarbeitet.
  \item (Wie war das eigentlich mit \mystrong{\acronym{WEB}?})
  \item Dazu kann man allerdings (oder konnte bisher) 
        \mystrong{nicht} (den fr�heren) 
        \mystrong{"\acronym{ASCII}"-Kommentar} verwenden,
        der Kommentar muss vielmehr als "\LaTeX-Input"
        mit \mystrong{typografischen Zeichen} und 
        \LaTeX-\mystrong{Markup}
        in der \mystrong{Code+Kommentar}-Quelldatei stehen
        (vgl. \pkg{ltxdoc}-Dokumentation zu \code{{oldcomments}}).
\end{enumerate}

\labelsection{docinput}{%
  \mystrong{\cs{DocInput}}\cb{\metavar{c+k}}}}
\dots~(\mystrong{\pkg{doc}}, \ctanpkgref{gmdoc},~\dots)
verarbeitet die \mystrong{Code/Kommentar mischende} Datei 
\mystrong{\metavar{c+k}} so\pardash sie enthalte als Beispiel
% dass die nette \cs{rmfamily}/\cs{ttfamily}-Mischung f�rs \file{.pdf} 
% entsteht 
\begin{verbatim}
  \% \cs{textit{dolce far niente:}}
  \% \ \ \ \cs{begin{macrocode}}
  \  \ \cs{relax} 
  \% \ \ \ \cs{end{macrocode}}
  \% -- genug, 
\end{verbatim}
\cs{DocInput{\metavar{c+k}}} f�hrt \mystrong{\cs{MakePercentIgnore}} 
vor \cs{input{\metavar{c+k}}} aus, Effekt wie 
\begin{verbatim}                %% 2011/10/03 exakt "%" weggelassen
  \ \cs{textit{dolce far niente:}}
  \ \ \ \ \cs{begin{macrocode}}
  \ \ \cs{relax} 
  \ \ \ \ \cs{end{macrocode}}
  \ -- genug, 
\end{verbatim}

\labelsection{docinput2}{(\cs{DocInput})}
(šbertrag:)
\begin{verbatim}
  \ \cs{textit{dolce far niente:}}
  \ \ \ \ \cs{begin{macrocode}}
  \ \ \cs{relax} 
  \ \ \ \ \cs{end{macrocode}}
  \ -- genug, 
\end{verbatim}
\dots~so kommt der \mystrong{Code} in eine 
\mystrong{Listing}-Umgebung, der \mystrong{Rest} wird 
\mystrong{"normal"} in \LaTeX-Qualit„t gesetzt.
  <p>
\mystrong{"Minimales Markup"} w�rde bedeuten, 
dass man \mystrong{dasselbe} Ergebnis~\dots

\labelcentersection{docinput-min}{%%                center 2011/10/14
  \mystrong{"Minimale" Kennzeichnung} des Codes}}
\begin{textblock}{420}
  \dots~statt mit 
  \begin{verbatim}
    \% \cs{textit{dolce far niente:}}
    \% \ \ \ \cs{begin{macrocode}}
    \  \ \cs{relax} 
    \% \ \ \ \cs{end{macrocode}}
    \% -- genug, 
  \end{verbatim}
  schon mit 
  \begin{verbatim}
    \% \cs{textit{dolce far niente:}}
    \  \ \cs{relax} 
    \% -- genug, 
  \end{verbatim}
  erh„lt. %%% bekommt. %% 2011/10/14
  Dies erreichen~\dots
\end{textblock}

\labelsection{docinput-alt}{%
  \mystrong{"smartes"} \cs{DocInput}}
%% Zeilenumbr�che/\Endash 2011/10/08: 
\Endash \mystrong{Algorithmus} klar:\\
\quad \Endash nach Zeile 
\emph{mit} "\code{\%}" vor \emph{"ohne"} %% war verkehrtrum 2011/10/03
"\cs{begin{macrocode}}",\\
\quad \Endash im umgekehrten Fall "\cs{end{macrocode}}"
einf�gen~\endash
\begin{enumerate}
  \item \ctanpkgref{gmdoc} 
        (\mystrong{Grzegorz Murzynowski};       %% y 2011/10/25
        \myalert{ich meine mich zu erinnern:}\\
        wie bei \pkg{wiki.sty} sind die 
        \mystrong{Zeilenendzeichen aktiv}\\ 
        und schauen sich den n„chsten Zeilenanfang an)
  \item \ctanpkgref{lineno} (\mystrong{Stephan B”ttcher})
        \Endash eine \acronym{UNIX}-Shell wendet ein 
        in der Datei \pkg{lineno.sty} enthaltenes 
        \Wikideref{awk}-Skript auf \file{lineno.sty} 
        an, erzeugt Dokumentationsdatei \file{lineno.tex}~\dots
  \item \pkg{\mystrong{makedoc}.sty} (selbst) bietet statt awk 
%         zusammen mit \pkg{\mystrong{fifinddo}.sty} 
        eine Art \TeX-basierte Skriptsprache und unterschiedliche 
        \mystrong{Zeilenparser},\\
        um jeweils eine Dokumentationsdatei zu erzeugen. 
%         Auf Kommentarzeilen werden in 
%         \mystrong{\file{mdoccorr.cfg}} festgelegte 
%         Zeichenkettenersetzungen angewendet, um 
%         \mystrong{typografische Zeichen} einzuf�gen 
%         ("\file{.txt}\to\file{.tex}").
\end{enumerate}

\labelcentersection{kommentarz-kombi}{% 
  \mystrong{"Interpretationen"} von Kommentarzeichen} 

\begin{textblock}{560}
\mystrong{echter} Kommentar vs. \mystrong{"Auskommentieren"},
ich: %%% "\code{\%\%}" vs. "\code{\%}")
  \begin{verbatim}
    \cs{typeout{ok}} \%\% Code
    \%\ \cs{typeout{ko}} \%\% auskommentierter Code
    \%\% \lt- falls ko \%\% Kommentar
    \%\% \% \lt- falls KO \%\% auskommentierter Kommentar
    \%\% \%\% \lt- 2011/10/01 \%\% Kommentar zum Kommentar
  \end{verbatim}
  \mystrong{ergibt} mit \pkg{makedoc} und von mir bevorzugten 
  Einstellungen:
  \begin{quote}
    \ \ \cs{typeout{ok} \%\% Code}\\
    \%\ \cs{typeout{ko} \%\% auskommentierter Code}\\
    \gets falls ko 
  \end{quote}
  \Endash Parsermakros                          %% c -> k 2011/10/14
          f�r verschiedene \mystrong{"Stile"}, 
          etwa Pakete \mystrong{anderer} Autoren, die 
          \mystrong{keine "\code{\%\%}"} verwenden
\end{textblock}

% \labelcentersection{mdoccorr}{\pkg{mdoccorr.cfg}}
% Textersetzungen nur in Kommentarzeilen
% \vspace{9}
% (s.~Datei 
%  \ctanfileref{\ltxcontrib nicetext/use}{mdoccorr.cfg})

\labelcentersection{makedoc-input}{%
  \mystrong{\pkg{makedoc}}s             %% \mystrong 2011/10/08
  \cs{DocInput{\metavar{job}}}}
\begin{textblock}{600} 
  %% <- 2011/10/07 ->
  Genaue Entsprechung zu \cs{DocInput} fehlt derzeit.\\
  "\metavar{job}" ergibt sich von selbst, oder~\dots\\
  Verschiedene \mystrong{Skriptbefehle} 
  unterst�tzen unterschiedliche \mystrong{Dokumentationsstile} 
  (šbersicht:                                           %% 2011/10/07
     \ctanfileref{\ltxcontrib nicetext/doc}{%
                        mdoccheat.pdf}).\\
    <p>
  c+k-Dateien werden mit \pkg{makedoc} \emph{nicht direkt} eingelesen.
  \\Die Hauptdatei 
  \begin{enumerate}
    \item \mystrong{erzeugt} aus (je)der c+k-Datei eine 
      \mystrong{Dokumentationsversion} 
      (\mystrong{"\file{.txt}\to\file{.tex}"}, 
       Einf�gen von "\mystrong{Listing}-Wrappern", 
       \mystrong{Zeichenkettenersetzungen} 
       f�r \mystrong{Gliederung} und \mystrong{typografische Zeichen}, 
       dazu Datei 
       \ctanfileref{\ltxcontrib nicetext/use}{%
            mdoccorr.cfg%
       }/\ctanfileref{info/fifinddo-info}{%
            mdoccorr.pdf}, 
    \item liest und \mystrong{setzt} die erzeugte Datei dann als 
      \mystrong{\file{.tex}.} 
  \end{enumerate}
  %% 2011/10/06:
  \mystrong{Genauer}~\dots
\end{textblock}

\labelsection{makedoc-lauf}{Dokumentationslauf}     %% 2011/10/06
[Genauer]~\dots~\mystrong{kompiliere}               %% 2011/10/07
ich typischerweise die Dokumentation 
\begin{enumerate}
  \item \file{\metavar{job}.\mystrong{pdf}}  von 
        \file{\metavar{job}.\mystrong{sty}}  aus 
        \file{\metavar{job}.\mystrong{tex}}. 
  \item \file{\metavar{job}.\mystrong{tex}} 
                   enth„lt \pkg{makedoc}-Befehle 
                   zur Erzeugung von 
        \file{\metavar{job}.\mystrong{doc}}  aus 
        \file{\metavar{job}.\mystrong{sty}}  und zum Einlesen von 
        \file{\metavar{job}.\mystrong{doc}}, 
  \item                               kann noch Dokumentation von 
                                     \mystrong{Erg„nzungspaketen} 
                                     \metavar{add} via 
        \file{\metavar{add}.\mystrong{doc}}             einbinden.
  \item \file{\metavar{job}\mystrong{.doc}}/\file{\metavar{add}\mystrong{.doc}} 
        k”nnen\\(nach \cs{RequirePackage{makedoc}})\\
        ganz zu Anfang des \TeX-Laufs innerhalb einer Gruppe erzeugt 
        und dann in der \code{{document}}-Umgebung mit 
        \mystrong{\cs{input}} eingelesen werden.
\end{enumerate}

% \labelsection{txt2tex-doku}{%
%   Paketdokumentation~\dots}
% % \section{Markup in der \mystrong{Paketdokumentation}}
% \dots\ betrifft Dateien, die gleichzeitig Makrocode und 
%  dessen Kommentierung enthalten:
%  \TODO: sp„ter oder anders?
% \begin{enumerate}
%   \item verbatim im Kommentar
%   \item Hervorhebung beschriebener Makros
%   \item "Metavariablen" im Kommentar
%   \item Listing\pardash Kennzeichnung von Code/Kommentar
%   \item \cs{textsf} f�r Paketnamen
%   \item "minimal": Pakete anderer Autoren
%   \item \cs{DoNotIndex}
% \end{enumerate}
% \\
% [\ctanpkgref{xdoc}, \ctanpkgref{ydoc}, 
%  \ctanpkgref{DoX},  \ctanpkgref{pauldoc}]

\labelsection{erfolg}{Erfolge/Scheitern}
% \begin{textblock}{360} 
  \begin{enumerate}
    \item Ich kann damit \mystrong{flott} 
          Pakete schreiben/dokumentieren\\ 
          (auch mit \mystrong{Dokumentation} als 
           \mystrong{"\Wikideref{Roadmap}"} beginnen). 
          \\ %%% \item %% 2011/10/06
          \emph{Nach} Einrichten des 
          Dokumentations-\mystrong{Workflows}\\ 
          l„uft mittlerweile meist alles \mystrong{"wie am Schn�rchen".}
    \item %% 2011/10/06
          \mystrong{Einrichten} eines solchen Workflows 
          war aufw„ndig,\\daf�r jetzt \mystrong{Vorlagen} 
          sowie \mystrong{Bash}- und 
          \mystrong{\pkg{fifinddo}-Skripts}. 
    \item \mystrong{Fehler} wegen Umwegs �ber 
          \mystrong{erzeugte} Dateien\\
          (mehr Zeilen als in Quelldatei)
          manchmal \mystrong{schwer verst„ndlich}~\dots
    \item %% 2011/10/06
          In der \mystrong{Praxis} kann ich (derzeit) 
          doch \mystrong{\LaTeX-Befehle}\\ 
          (Backslashs, \dots, vgl.~\ancref{minimal-mehr}{Vorgabe})
          \mystrong{nicht} ganz \mystrong{vermeiden},\\ 
          wohl vor allem bei \mystrong{Verweisen}~\dots
    \item Dennoch gelungene \mystrong{"Fremddokumentationen":}\\
          \ctanfileref{\ltxcontrib nicetext/demo}{arseneau.pdf}, 
          \ctanfileref{\ltxcontrib nicetext/demo}{substr.pdf}.
  \end{enumerate}
% \end{textblock}

\labelcentersection{catcodes}{%
  Vorteile und Problematik der 
           \mystrong{Zeichenkategorien} (\cs{catcode...})%
}
\begin{textblock}{560}
  \begin{enumerate}
    \item f�r \mystrong{Dokumentation}svorverarbeitung 
          Einlesen als \mystrong{"reinen Text"}
          (\cs{dospecials} \mystrong{"\code{other}"})
    \item \mystrong{\cs{PatternCodes}} f�r Ersetzungsregeln 
          anzupassen
    \item \pkg{\mystrong{blog}.sty} (\ctanpkgref{morehype}-B�ndel)
          nutzt dagegen "minimale" \mystrong{\TeX-Syntax}, 
          \mystrong{expandiert} Makros zu \mystrong{\HTML}-Code
          (Hauptdatei "\file{makehtml.tex}" \oae\
          wandelt \metavar{job}\mystrong{\file{.tex}}
          zeilenweise
          in \metavar{job}\mystrong{\file{.html}} um).
  \end{enumerate}
\end{textblock}

\teilpage{10}{\mystrong{HTML} erzeugen}
\labelcentersection{html-statt-pdf}{%
%   Notizen in reinem Text~/ \HTML~/ \PDF}
  \mystrong{Nutzen} von \HTML\ (vs.~\PDF)}
\begin{textblock}{520}                      %% 560 -> 520 2011/10/14
  \begin{enumerate}
    \item \mystrong{Internetauftritt/CMS}
    \item "Elektronischer \mystrong{Zettelkasten}"
      \begin{enumerate-a}
        \item Querverweise 
        \item gegliederte/kommentierte \mystrong{Link-Sammlungen}
        \item Hervorhebung von \mystrong{Stichw”rtern} 
              in Texten aus anderen Formaten 
%               (Xpad/Tomboy)
  %% <- unterer Link funktioniert nicht mehr 2011/10/03; 
  %%    OK mit </li> in allen \item ->
              (\httpref{mterry.name/xpad}{Xpad}/\Wikidedisambref{Tomboy}{Software})
  %% <- Software 2011/10/04
      \end{enumerate-a}
    \item besserer \mystrong{Lesefluss ohne Seiten}umbr�che,\\
          ohne problematische \mystrong{Zeilen}umbr�che
    \item \mystrong{keine Arbeit mit Umbr�chen}\\(aužer gedankliche Gliederung)
    \item \mystrong{Bildschirmfl„che} voll nutzen
  \end{enumerate}
\end{textblock}
\labelsection{html-alt}{%
  \mystrong{HTML}-Erzeugung\pardash \mystrong{Alternativen}}
\begin{itemize}
  \item HTML-Editoren, CMSe?; Formeln? keine Ahnung, \myalert{egal}
  \item \strong{\CtanPkgRef{tex4ht}{TeX4th}} 
        (Eitan Gurari\dagger; 
         \meta{\wikideref{TeX4ht}{Wikipedia}} sehr informativ)
        \Endash \wikideref{TeX4ht}{\mystrong{verarbeitet 
        \file{.dvi}}}, kommt insofern (wohl) mit allen Paketen/Makros 
        zurecht, ohne sie einzeln zu behandeln
        \Endash damit \mystrong{Webseiten} pflegen\myalert{?}
  \item diverse \strong{Syntax-Wandler} wie 
        \Wikideref{LaTeX2html} (Perl), \urlref{hevea.inria.fr}, 
        \httpref{evalwhen.com/tex2page}{\TeX2page}, 
        %% <- \ctanpkgref{tex2page}: not on CTAN
        \CtanPkgRef{tth}{TtH} 
        (\Wikidedisambref{C}{Programmiersprache};
         \httpref{hutchinson.belmont.ma.us/tth/}{Home:} Formeln!);
        vgl.~\urlref{tug.org/interest.html\#web}%%%~\TODO
  \item \pkg{\strong{blog}.sty} 
        (\ctanpkgref{morehype}-B�ndel)      %% "B�ndel" 2011/10/03
        \Endash expandiert Makros zu HTML; 
        \mystrong{\LaTeX}-Makros \mystrong{umdefiniert}, 
        \mystrong{neue} Makros f�r bestimmte 
        \mystrong{\HTML-Strukturen}, \zB \pkg{\mystrong{lnavicol}.sty} 
\end{itemize}

\labelcentersection{html-und-pdf}{%
  \HTML\ und \PDF\ aus \mystrong{selber Quelle}?}
%% ausgebaut 2011/10/06:
\begin{textblock}{540}
  \begin{enumerate}
    \item \cs{labelsection} etc.\pardash \mystrong{"\pkg{html\TeX}"}\\
          (\mystrong{\HTML} regt zu Makros an, die \mystrong{auch} f�r 
           \mystrong{\PDF}-Erzeugung interessant w„ren,\\ 
           angefangen mit logischer Auszeichnung wie 
           \code{\lt code\gt}/\cs{code}, 
           \code{\lt strong\gt}/\cs{strong}.)
  % \vspace{9}
    \item \pkg{\mystrong{texlinks}.sty} 
          (\ctanpkgref{morehype}-B�ndel)\\
          bietet \mystrong{Beispiele} f�r \mystrong{Makros}, 
          die \mystrong{gleichermažen} 
          \begin{itemize}
            \item f�r \mystrong{\pkg{hyperref}/\PDF}
            \item wie f�r \mystrong{\HTML}-Erzeugung mit 
                  \pkg{\mystrong{blog}.sty} 
          \end{itemize}
          geeignet sind
          (fužen auf wenigen 
          "\Wikideref{Pivot}/\Wikideref{Angelpunkt}"-Makros 
           wie etwa \cs{href},\\nur ein solches f�r 
           \pkg{hyperref} vs. \pkg{blog} unterschiedlich zu definieren).
  \end{enumerate}
\end{textblock}

\labelcentersection{blog-probleme}{%
    Was (zur Zeit) \emph{nicht} geht}               %% emph 2011/10/08
\begin{textblock}{560}
  (weil Makros \mystrong{nur expandiert} werden,    %% 2011/10/06
  vgl.~\Wikideref{Funktionale Programmierung}):
  Z„hler, optionale Argumente, \ast-Varianten, \cs{unskip}, \cs{verb}; 
  \cs{begin} ”ffnet keine Gruppe f�r lokale Einstellungen, 
  solche k”nnen ohnehin nicht vorgenommen werden.
  ("Was man an \TeX\ hat.")
  \Endash Mathe: Br�che/Wurzeln? vgl. dazu
          \httpref{hutchinson.belmont.ma.us/tth/}{TtH}.
    \vspace{9}
  \mystrong{Ausweg} irgendwann: besondere Behandlung 
  von Zeilen, die bestimmte einzelne Makros enthalten, 
  wie etwa 
  \cs{EXECUTE{\metavar{einstellungen}}}, 
  \cs{begin}, \cs{end}.
    \vspace{9}
  Wandlung \mystrong{zeilenweise} erschwert auch Verteilen 
  von \mystrong{Makroargumenten �ber mehrere Zeilen}
  ("Klammer rechtzeitig ”ffnen"). 
  K�nftige Alternativen w„ren \ctanpkgref{catchfile}
  oder "bis zur n„chsten leeren Zeile am St�ck" einlesen.
\end{textblock}


\labelcentersection{schluss}{Dank}      %% schwarz 2011/10/14
%% gek�rzt 2011/10/05:
% \labelcentersection{schluss}{Schluss}
% Dieser Vortrag war f�r mich eine \mystrong{Pr�fung}, 
% \\die ich hoffentlich mit \mystrong{"Auszeichnung"} bestanden habe!
% \\("Markup")
% \vspace{42}
% \cheading2{Dank}
\begin{textblock}{600}
  \begin{itemize}
    \item \pkg{\mystrong{blog}.sty} wurde (2010) 
          mittelbar/teilweise durch die 
          \wikideref{Deutsche Forschungsgemeinschaft}{DFG}
          unterst�tzt
    \item den \mystrong{Einstieg} in \mystrong{\HTML} 
          verdanke ich in erster Linie meinem Bruder, 
          Rainer L�ck (\urlref{www.webdesign-bu.de}) 
    \item f�rs \mystrong{Zuh”ren} \answer{Zuschauen}
   \end{itemize}
und \strong{nachtr„glich:}
   \begin{itemize}
    \item an \mystrong{Uwe Ziegenhagen} (\ua) f�r Hinweis auf\\ 
          \Wikideref{Markdown} und 
          \httpref{johnmacfarlane.net/pandoc}{pandoc},
    \item an \mystrong{Bernd Raichle} f�r Hinweis auf 
          \mystrong{Kees van der Laan}s (NTG) Arbeiten �ber 
          "minimales Markup",
    \item "\mystrong{technischen} Helfern" %% <- 2011/10/08 ->
          (Kabel/\httpref{%                %% line break 2011/10/21
            www.x.org/wiki/Projects/XRandR}{\code{xrandr}})!
   \end{itemize}
\end{textblock}

% \nextcenterscreenpage{}
% \labelsection{}{%
% \section{}
\screenbottom{START}
\finish