diff options
23 files changed, 34716 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/LIESMICH.txt b/Master/texmf-dist/doc/latex/fifinddo-info/LIESMICH.txt new file mode 100644 index 00000000000..e1553e28166 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/LIESMICH.txt @@ -0,0 +1,48 @@ + + LIESMICH.txt fuer `fifinddo-info' + (C) Uwe Lueck 2011/10/16 + + +Die Datei `dantev45.htm' ist eine "HTML-Beamer-Praesentation" ueber + + "Paketdokumentation und Webseitenpflege (HTML-Erzeugung) + mit (`niceverb.sty' und) `fifinddo.sty'" + +- ueberarbeitete Fassung meines Vortrags auf der +DANTE-Herbsttagung 2011, zu oeffnen mit einem Webbrowser. +In der zweiten Zeile mit "START" sollte die Gebrauchsanleitung +zu finden sein. + +`dante-mv45-lueck.pdf' ist ausserdem eine Zusammenfassung. + +`dantev45.htm' und die uebrigen Dateien dienen auch als Beispiel +fuer das im `morehype'-Buendel (http://ctan.org/pkg/morehype) +enthaltene und dort in `blog.pdf' beschriebene Paket `blogdot.sty' +fuer "HTML-Beamer-Praesentationen". + +Im Verzeichnis `variants' finden sich Versionen der Datei fuer +unterschiedliche Bildschirme und Browser. Die Zahl im Dateinamen +ist die Breite der "Folien" in Pixeln ("geraten" fuer +Bildschirmbreiten 800 und ca. 1200). "exact" bedeutet genaue +Abstimmung fuer die angegebene Breite und einen Schirm der Hoehe +600 fuer die Browser Firefox, Google Chrome und Opera. "com" +sollte auch mit Internet Explorer und breiteren Schirmen gut +aussehen und (halbwegs) funktionieren. "frame" sollte auf einem +groesseren Schirm die Abmessungen fuer einen kleineren durch einen +Rahmen sichtbar machen. "show" zeigt die Randgrenzen und (evtl.) +den sonst unsichtbaren Fuelltext (fuer "filltype" und "com", +siehe `\FillBlogDotTypeArea' in der Dokumentation von `blogdot'). +"clean" bedeutet, dass kein Fuelltext verwendet wird. + +Die Dateien unterliegen der LaTeX Project Public License ab v1.3c: + + http://www.latex-project.org/lppl.txt + +Eine TDS-Version ist + + http://mirror.ctan.org/install/info/fifinddo.tds.zip + +Bemerkungen erbitte ich unter + + http://www.contact-ednotes.sty.de.vu + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/README b/Master/texmf-dist/doc/latex/fifinddo-info/README new file mode 100644 index 00000000000..732a80890c4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/README @@ -0,0 +1,51 @@ + + README for `fifinddo-info' + (C) Uwe Lueck 2011/10/16 + +Here you find (i) files (in `source/') that demonstrate making +an "HTML beamer presentation" with `blogdot.sty' from the +`morehype' bundle (described in `blog.pdf'), (ii) a German +sketch of package documentation and HTML generation based on +`fifinddo.sty' (`nicetext' bundle): `dantev45.htm' +(cf. `LIESMICH.txt'). + +TRYING the presentation: open `dantev45.htm' with a browser, +click on "START", later click on screen bottom for next view +or on lower right corner of screen for the overview. With MSIE +however, this does not work, find something to click at right +below the text. + +VARIANTS: dantev45.htm is a "compromise" version of the +presentation. Directory `variants' contains versions for different +screens and browsers, exemplifying "recompilation" according to +the `blogdot' documentation. + +KEYWORDs: beamer presentations, literate macro programming, HTML; +font selection, lists, punctuation, quotation, spacing, +text decoration computer text/verbatim text, font selection, +lists, punctuation, quotation, spacing, text decoration, +verbatim text + +The files can be redistributed and/or modified under the terms +of the LaTeX Project Public License; either version 1.3c of the +License, or any later version, see + + http://www.latex-project.org/lppl.txt + +We did our best to help you, but there is NO WARRANTY. + +The CTAN directory `/info/fifinddo/' is author-maintained in the +sense of this license. + +The latest public version of the package is available at + + http://mirror.ctan.org/info/fifinddo/ + +A TDS version of the package is available as + + http://mirror.ctan.org/install/info/fifinddo.tds.zip + +Please report bugs, problems, and suggestions via + + http://www.contact-ednotes.sty.de.vu + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/dante-mv45-lueck.pdf b/Master/texmf-dist/doc/latex/fifinddo-info/dante-mv45-lueck.pdf Binary files differnew file mode 100644 index 00000000000..7f4710a8a06 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/dante-mv45-lueck.pdf diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm b/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm new file mode 100644 index 00000000000..e7a589dbbc5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 768 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf b/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf Binary files differnew file mode 100644 index 00000000000..e6e2ac95828 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html new file mode 100644 index 00000000000..e14faae57cf --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> + +<!-- slide width = 1180 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html new file mode 100644 index 00000000000..2acb15f837e --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 1180 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html new file mode 100644 index 00000000000..e7a589dbbc5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 768 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html new file mode 100644 index 00000000000..f5b3e2c0a77 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> + +<!-- slide width = 768 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html new file mode 100644 index 00000000000..7a2281e3806 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> + +<!-- slide width = 768 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html new file mode 100644 index 00000000000..0894946b75d --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 768 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</p><a href="#teil-0"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</p><a href="#titelerlaeut1"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</p><a href="#titelerlaeut2"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</p><a href="#titelerlaeut3"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</p><a href="#interessant"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</p><a href="#motive-t"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</p><a href="#motive-p"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</p><a href="#status"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</p><a href="#inhalt"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</p><a href="#teil-1"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</p><a href="#txt2tex"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</p><a href="#txt2tex-trad"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</p><a href="#teil-2"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</p><a href="#typoz-latex"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</p><a href="#minimal-mehr"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</p><a href="#typoz-bewert"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</p><a href="#typoz-auto"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</p><a href="#typoz-ctan"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</p><a href="#teil-3"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</p><a href="#wiki-markup"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</p><a href="#wiki-listen"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</p><a href="#teil-4"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</p><a href="#implement"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</p><a href="#implement-ms"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</p><a href="#implement-ms2"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</p><a href="#implement-ma"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</p><a href="#implement-ma+"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</p><a href="#implement-mas"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</p><a href="#teil-5"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</p><a href="#nicetext"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</p><a href="#wiki"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</p><a href="#teil-6"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</p><a href="#niceverb"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</p><a href="#syntax"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</p><a href="#vert"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</p><a href="#niceverb-noch"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</p><a href="#niceverb-sim"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</p><a href="#teil-7"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</p><a href="#kommentar"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</p><a href="#kommentarzw"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</p><a href="#kommentarzwa"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</p><a href="#teil-8"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</p><a href="#kommentar-ignor"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</p><a href="#kommentar-ignor-mehr"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</p><a href="#docstrip"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</p><a href="#kommentarzch"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</p><a href="#ohne-docstrip"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</p><a href="#teil-9"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</p><a href="#doku-vor"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</p><a href="#doku-doc"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</p><a href="#docinput"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</p><a href="#docinput2"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</p><a href="#docinput-min"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</p><a href="#docinput-alt"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</p><a href="#kommentarz-kombi"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</p><a href="#makedoc-input"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</p><a href="#makedoc-lauf"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</p><a href="#erfolg"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</p><a href="#catcodes"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</p><a href="#teil-10"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</p><a href="#html-statt-pdf"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</p><a href="#html-alt"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</p><a href="#html-und-pdf"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</p><a href="#blog-probleme"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</p><a href="#schluss"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</p><a href="#START"><center><font color="red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html new file mode 100644 index 00000000000..d021eeb03a3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html new file mode 100644 index 00000000000..3628a857586 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> + +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html new file mode 100644 index 00000000000..bc22e8a2f5d --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html @@ -0,0 +1,3283 @@ +<!-- generated from + + dantev45.tex, 2011/10/14 DANTE Herbst '11, + + with blog.sty, 2011/10/15 --> + +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; 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; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45</code> – <a href="dantev45.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<font color="red"><<< zuerst klicken</font>, +<font color="#aa0000">dann auf Bildunterrand klicken</font> +<small> +bzw. knapp unter Text +(<a href="http://de.wikipedia.org/wiki/Internet Explorer" target="_blank">MSIE</a>) +</small> +und rechts unten für <a href="#inhalt">„Rückkehr“</a><br> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><font color="#aa0000">Paketdokumentation</font><br>und <font color="#aa0000">Webseitenpflege</font> mit<br> (<code><font color="#aa0000">niceverb</font>.sty</code> und)<br><code><font color="#aa0000">fifinddo</font>.sty</code></h1> +Uwe Lück + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Überarbeitete Fassung des auf der<br> +<a href="http://www.dante.de/events/mv45/Programm.html" target="_blank"><acronym>DANTE</acronym>-Herbsttagung 2011</a><br> +gehaltenen Vortrags + +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +2011-10-15 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 0:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Vortragstitel</font> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<font color="#aa0000">„verbatim“</font>) gesetzter +<font color="#aa0000">Paketcode</font> wechselt mit in LaTeX-Qualität gesetztem +<font color="#aa0000">Kommentar</font> ab („zeilenweise“) + </li> + <li>der <font color="#aa0000">Kommentar</font>text <font color="#aa0000">enthält</font> +„verbatim“ gesetzten TeX-<font color="#aa0000">Code</font> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><font color="#aa0000">Gebrauchsanleitung</font>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<font color="#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></font>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung +– +<ul> + </li> + <li><font color="#aa0000">Internet</font>auftritt (? +<a href="http://de.wikipedia.org/wiki/Content-Management-System" target="_blank">CMS</a>? +– <a href="http://www.webdesign-bu.de/uwe_lueck/schreibt.html" target="_blank">ja …</a>) + </li> + <li>bequeme <font color="#aa0000">Textformat</font>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><font color="#aa0000"><a href="#START">Vortragstitel</a></font> bedeutet (III):</h2> +… was haben <font color="#aa0000">Paketdokumentation</font> und +<font color="#aa0000"><acronym>HTML</acronym>-Erzeugung</font> miteinander zu tun<font color="#aa0000">??</font> +<br><br> +(– Zu <font color="#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</font> +<br>habe ich es noch <font color="#aa0000">nicht</font> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <font color="#aa0000">interessant</font> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><font color="#aa0000">doc</font>.sty</code> und <code><font color="#aa0000">docstrip</font>.tex</code> +(„<code><font color="#aa0000">.dtx</font></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <font color="#aa0000"><acronym>HTML</acronym></font> schätzt und <font color="#aa0000"><acronym>PDF</acronym></font> +vermeiden möchte … + </li> + <li>wenn man <font color="#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></font> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<font color="#aa0000">Qualität</font> +<em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>) + </li> + <li><strong>„Missbrauch“</strong> von <font color="#aa0000">TeX</font> +als „<font color="#aa0000">Skript</font>sprache“ +<br> +(„mit TeX muss und will ich <font color="#aa0000">keine andere</font> Sprache lernen“; +<font color="#aa0000">statt</font> <acronym>PDF</acronym>-<font color="#aa0000">Schriftsatz</font> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><font color="#aa0000">kleine</font>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<font color="#aa0000">Erfolge</font> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <font color="#aa0000">Mischung</font> aus:) +<ol> + </li> + <li>gespannt auf <font color="#aa0000">Kommentare</font><br>zu <font color="#aa0000">meinen</font> Paketen, + </li> + <li>Vortrag soll aber auch über <font color="#aa0000">„Konkurrenzprodukte“ informieren</font> + </li> + <li><font color="#aa0000">Irrtümer? Hinweise?</font> +– <font color="#aa0000">Terminologie</font> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><font color="#aa0000">blogdot</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Status</font></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><font color="#aa0000">„Markup“?</font></a> – Terminologie + </li> + <li><a href="#teil-2"><font color="#aa0000">„typografische Zeichen“</font></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><font color="#aa0000">„Formatierung“</font></a> + </li> + <li><a href="#teil-4"><font color="#aa0000">Implementierung</font></a> +„minimalen Markups“ „<font color="#aa0000">mit TeX allein</font>“ + </li> + <li><a href="#teil-5">Paket<font color="#aa0000">dokumentation</font></a> + </li> + <li><a href="#teil-6"><code><font color="#aa0000">niceverb</font>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <font color="#aa0000">ausblenden</font></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><font color="#aa0000">HTML</font></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 1:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Markup“</font> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <font color="#aa0000">reinen Text</font> in <font color="#aa0000">LaTeX-Input</font> +(für LaTeX-Qualität) umzuwandeln, muss man normalerweise +Folgendes ergänzen/ändern: + +<ol> + </li> + <li> + +<strong>„<a href="http://de.wikipedia.org/wiki/Typografische Zeichen in HTML" target="_blank">typografische Zeichen</a>“</strong> +– „typografische“ Varianten von +<a href="http://de.wikipedia.org/wiki/Auslassungspunkte" target="_blank"><font color="#aa0000">Auslassungspunkten</font></a>, +<font color="#aa0000">Anführung</font>szeichen, +<font color="#aa0000">Leerzeichen</font>, +und <font color="#aa0000">Strichen</font>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<font color="#aa0000">Zeichensätzen</font>, Einrücken, +<font color="#aa0000">Listen</font>, Verweise, … + +</li></ol> + +– <font color="#aa0000">Unterscheidung</font> nur <font color="#aa0000">HTML</font>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <font color="#aa0000">ersten</font> Fall +spezielle <font color="#aa0000">Zeichen</font> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <font color="#aa0000">zweiten</font> Einrahmung mit „Tags“ wie +<code><i>...</i></code> +(ähnlich LaTeX …); oder … + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <font color="#aa0000">„Auszeichnung“</font> +<br> +(im „<a href="http://de.wikipedia.org/wiki/Manuskript" target="_blank">Manuskript</a>“/<a href="http://de.wikipedia.org/wiki/Typoskript" target="_blank">Typoskript</a>, +„Markup“, +„<a href="http://de.wikipedia.org/wiki/Schriftauszeichnung" target="_blank">Schriftauszeichnung</a>“/<a href="http://de.wikipedia.org/wiki/Auszeichnungssprache" target="_blank">Auszeichnungssprache</a>) +<br> +anscheinend nur auf <strong>„Formatieren“</strong> +<br> +(vielleicht weil der <font color="#aa0000">Setzer</font> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <font color="#aa0000">Setzer</font> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <font color="#aa0000">nicht</font> besonders <font color="#aa0000">angezeigt</font> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 2:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Typografische Zeichen</font> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <font color="#aa0000">TeX/LaTeX</font></h2> + +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- typoz-latex --> + <tr bgcolor="#eeefff"> +<td><strong>Zeichen</strong></td> +<td><strong>realisiert durch</strong></td> + </tr> +<tr><td><font color="#aa0000">Auslassung</font>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<font color="#aa0000">Strich</font></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <font color="#aa0000">Ligaturen</font></td></tr> +<tr><td>(Doppelte) <font color="#aa0000">Anführung</font>szeichen</td><td>Englisch: <font color="#aa0000">Ligaturen</font> <code>``...<code>'</code><code>'</code></code>; <br> Deutsch mit <code>(n)german.sty</code> oder <code>babel.sty</code> <code><code>"</code>`...<code>"</code><code>'</code></code> – <font color="#aa0000">aktive Zeichen</font></td></tr> + +<tr><td>Geschütztes <font color="#aa0000">Leer</font>zeichen, Festabstand</td><td>„<code>~</code>“ – <font color="#aa0000">aktives Zeichen</font>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <font color="#aa0000">Leer</font>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<font color="#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</font> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><font color="#aa0000">„minimales Markup“</font> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<font color="#aa0000">Qualität</font> <em>möglichst ohne</em> LaTeX-<font color="#aa0000">Befehle</font>“</i><br> +– <code>README</code> des <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Bündels: + +<br><i>„möglichst keine <font color="#aa0000">Zeichen</font> im Dokument<font color="#aa0000">quell</font>code, <br>die nicht auch <font color="#aa0000">gedruckt</font> werden!“</i><br> +– schließt <font color="#aa0000">„typografische Zeichen“</font> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><font color="#aa0000">weg</font> mit <font color="#aa0000">Backslash</font>s, +englischen <font color="#aa0000">Befehlen</font> und +geschwungenen <font color="#aa0000">Klammern!</font> + </li> + <li>überhaupt möglichst wenig Code-<font color="#aa0000">Zeichen</font> + </li> + <li>Zeichen möglichst <font color="#aa0000">intuitiv</font> + </li> + <li>… am besten so <font color="#aa0000">aussehen wie Ergebnis</font> + </li> + <li>– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><font color="#aa0000">TeX-Ligaturen</font> schon ganz gut! + </li> + <li><font color="#aa0000">aktive Zeichen</font> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><font color="#aa0000"><code>\dots</code></font> schon übel … +(warum nicht <font color="#aa0000">Ligatur</font> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <font color="#aa0000">automatisch?</font></h2> +<ol> + </li> + <li><font color="#aa0000">automatische</font> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><font color="#aa0000"><code>\sfcode`A=999</code></font> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <font color="#aa0000">Anführungszeichen</font> in +<font color="#aa0000"><i>Word</i></font> + </li> + <li>… <em><font color="#aa0000">und hier</font></em> <!-- texblog.fdf --> +– simpel, solange nicht <code>german</code>/<code>babel</code> …: +<br><code><code>"</code>...<code>"</code></code> expandiert zu +<code>\glqq...</code><code>\grqq</code> oder so + </li> + <li>eigentlich <em>nur dies</em> +(automatisches Einfügen typografischer Zeichen) +<font color="#aa0000">„<code>.txt→.tex</code>“</font> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <font color="#aa0000">fehlerhafte</font> Automatisierung +typografischer <font color="#aa0000">Anführungszeichen</font> kann zum Verlust +des <a href="#motive-p"><font color="#aa0000">Doktortitels</font></a> +und politischer Ämter führen! +(<code>gutten.sty</code>) + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<small> +<font color="#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</font> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>.txt</code>→<code>.tex</code></font> <em>vor</em> <code>nicetext</code></h2> +– auf CTAN: +<ol> + </li> + <li><a href="http://ctan.org/pkg/txt2latex" target="_blank"><code>txt2latex</code></a> kleines +<a href="http://de.wikipedia.org/wiki/Perl (Programmiersprache)" target="_blank">Perl</a>-Skript, +wandelt gerade <font color="#aa0000">TeXs spezielle Zeichen</font> +(„<code>&</code>“ etc.), <font color="#aa0000">„<code>...</code>“</font> +und doppelte/einzelne <font color="#aa0000">Anführungszeichen</font> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><code>txt2latex</code></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<font color="#aa0000">Formatierung</font> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<font color="#aa0000">GUI</font>(?), Ideen aus <font color="#aa0000">Wiki…-Markup</font>; +zuletzt 2004 (<code>README</code> 2009 eher CTAN-Hand) + </li> + <li><a href="http://ctan.org/pkg/smiletex" target="_blank"><code>SmileTeX</code></a> Windows <code>.exe</code>? ++ Werkzeuge für Grafikeinbindung etc., +zuletzt 2004 +</li></ol> +– für <font color="#aa0000">Paketdokumentation</font> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 3:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Formatierung“</font> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Schriftauszeichnung</h2> +– Anregungen wie für <a href="#typoz-auto"><code>EasyLaTeX</code></a>? +<p> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-Code</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr><td><code> == Über ==</code></td><td><code>\section{Über}</code></td></tr> +<tr><td><code>=== Unter ===</code></td><td><code>\subsection{Unter}</code></td></tr> +<tr><td><code>'''fett'''</code></td><td><code>\textbf{fett}</code></td></tr> +<tr><td><code>''kursiv''</code></td><td><code>\textit{kursiv}</code></td></tr> +<tr><td><code>'''''Fett-'''Kur''</code></td><td><code>\textit{<code>\textbf{Fett-}</code>Kur}</code></td></tr> + </tbody> +</table> +<p> +– <font color="#aa0000">Intuition</font> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Wikipedia</font>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + +<td><strong><font color="#aa0000">Wiki</font>-</strong></td> +<td><strong>wie <font color="#aa0000">LaTeX</font>-Code</strong></td> + </tr> +<tr> +<td><code>∗ Eins<br>∗ Zwei</code></td> +<td><code>\begin{itemize}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{itemize}</code></td> + +<td><code>Er nur:<br>:Ja, …</code></td> +<td><code>Er nur:<br><code>\begin{quote}</code><br> Ja, <code>\dots</code><br><code>\end{quote}</code></code></td> +</tr> +<tr> +<td><code># Eins<br># Zwei</code></td> +<td><code>\begin{enumerate}</code><br> <code>\item Eins</code><br><code>\item Zwei</code><br> <code>\end{enumerate}</code></td> + +<td><code>Code:<br> <code>\relax</code></code></td> +<td><code>Code:<br><code>\begin{verbatim}</code><br> <code>\relax</code><br><code>\end{verbatim}</code></code></td> +</tr> + </tbody> +</table> +<br> +– immerhin recht <font color="#aa0000">„minimal“</font>, +auch halbwegs <font color="#aa0000">intuitiv.</font> + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +(vgl. <a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/wikicheat.pdf" target="_blank"><code>wikicheat.pdf</code></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 4:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Implementierung</font><br>„minimalen Markups“ <br>„mit <font color="#aa0000">TeX allein</font>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Implementierung</font>smethoden für<br>„minimales Markup“ mit <font color="#aa0000">TeX</font></h2> +<table cellpadding="9" cellspacing="0"> + <!-- thesis --> + <tr valign="top"> <td width="42px">(ML)</td><td><strong>Ligaturen</strong> – …<br>(nicht mein Ding, Zukunft ohne <acronym>METAFONT</acronym>?)</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MS)</td><td><strong>„Substitution“</strong> bzw. <strong>„Skript“</strong>, genauer: <font color="#aa0000">Vorverarbeitung</font> der <code>.tex</code>-Datei, <font color="#aa0000">Zeichenkettenersetzung</font> (und mehr) per <a href="http://de.wikipedia.org/wiki/Skriptsprache" target="_blank">Skript</a> wie mit Perl / <a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a> / etc. bzw. mit den <a href="#typoz-auto">beschriebenen</a> Paketen</td> </tr> + <!-- thesis --> + <tr valign="top"> <td width="42px">(MA)</td><td><strong>(„forschende“) aktive Zeichen</strong> – im <font color="#aa0000">„Schriftsatz-Modus“</font> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <font color="#aa0000">expandieren</font> aktive Zeichen mehr oder weniger direkt zu <font color="#aa0000">„normalen“</font> LaTeX-Befehlen, <font color="#aa0000">„forschende“</font> aktive Zeichen „<font color="#aa0000">erkunden</font> dabei ihre <font color="#aa0000">Umgebung</font>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <font color="#aa0000">„begrenzte Parameter“</font> +von Makros zu erkennen +(TeXbook S. 203), +bietet eine bequeme, aber auch „begrenzte“ Methode, +<a href="http://de.wikipedia.org/wiki/Zeichenkette" target="_blank">„Zeichenketten“</a> („Strings“) +zu erkennen<br>(und zu <font color="#aa0000">ersetzen</font>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <font color="#aa0000">„Token-Ketten“</font> „dargestellt“ +werden kann. Auch von <font color="#aa0000">Groß-/Kleinschreibung</font> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<font color="#aa0000"><code>\@in</code></font>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <font color="#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></font> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <font color="#aa0000"><code>fifinddo.sty</code></font> und +<font color="#aa0000"><code>makedoc.sty</code></font> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<font color="#aa0000">String</font>s und <font color="#aa0000">Scripting</font> mit <font color="#aa0000">TeX</font>)</h2> +<ol> + </li> + <li>Die Pakete <a href="http://ctan.org/pkg/stringstrings" target="_blank"><code>stringstrings</code></a> (Steven Segletes), +<a href="http://ctan.org/pkg/xstring" target="_blank"><code>xstring</code></a> (Christian Tellechea, <a href="http://ctan.org/pkg/etex" target="_blank"><code>e-TeX</code></a>) +und <a href="http://ctan.org/pkg/ted" target="_blank"><code>ted</code></a> (Manuel Pégourié-Gonnard) liefern String-Funktionen +„auf höchstem Niveau“. + </li> + <li>String-Funktionen finden sich auch in +<a href="http://ctan.org/pkg/datatool" target="_blank"><code>datatool</code></a> (Nicola Talbot), +<a href="http://ctan.org/pkg/coolstr" target="_blank"><code>coolstr</code></a> (Nick Setzer) und +<a href="http://ctan.org/pkg/texapi" target="_blank"><code>texapi</code></a> (Paul Isambert). + </li> + <li>Eine „ernsthafte <font color="#aa0000">Skriptsprache</font>“ +bietet neben Zeichenersetzung +allgemeiner <font color="#aa0000">„Sortierung“</font> und <font color="#aa0000">„Filter“.</font> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <font color="#aa0000"><code>.dtx</code>-Quelldatei</font> +die <font color="#aa0000">„Kommentare“ entfernt</font> +und den Rest in verschiedene +<font color="#aa0000">„kompakte“ TeX-Eingabedateien</font> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <font color="#aa0000">„forschenden“ aktiven Zeichen</font> (MA)</h2> +<font color="#aa0000"><code>wiki.sty</code></font> aus dem <font color="#aa0000"><code>nicetext</code></font>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<font color="#aa0000">Wikipedia</font>-Syntax für TeX, d. h. mit <code>wiki.sty</code> +kann man in der <code>{document}</code>-Umgebung von LaTeX +<ol> + </li> + <li>statt <font color="#aa0000"><code>\...section{...}</code></font> einrahmende +<font color="#aa0000">Gleichheitszeichen</font>-Folgen verwenden, + </li> + <li><font color="#aa0000">Kursiv</font>- und <font color="#aa0000">Fett</font>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<font color="#aa0000">Apostroph</font>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><font color="#aa0000">Listen</font> und <font color="#aa0000">Blockzitate</font> +aus Menschen- oder Programmiersprache durch +spezielle <font color="#aa0000">Zeilenanfänge</font> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code>s <font color="#aa0000">„forschende“</font> Zeichen</h2> +<ol> + </li> + <li><font color="#aa0000">Gleichheitszeichen</font> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <font color="#aa0000">Apostroph</font>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <font color="#aa0000">Umschalten</font> und die +<font color="#aa0000">Kursivkorrektur</font> +finden <font color="#aa0000">ohne</font> <font color="#aa0000">„Gruppenbildung“</font> statt. + </li> + <li>Um <font color="#aa0000">Listen</font> und <font color="#aa0000">Zitate</font> am Zeilenanfang +zu erkennen, wird das <font color="#aa0000">Zeilenende</font>-Zeichen +(<code>^^M</code>) <font color="#aa0000">aktiv</font> und ändert auch für kurze Zeit +die Kategorie des Leerzeichens. +So analysiert <code>^^M</code> den Anfang der nächsten Zeile +und kann feststellen, ob eine Liste bzw. ein Blockzitat +<font color="#aa0000">beginnt</font>, <font color="#aa0000">fortgesetzt</font> wird, oder +<font color="#aa0000">endet</font>, oder ob der Liste ein +<font color="#aa0000">weiterer Punkt</font> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<font color="#aa0000"><code>\item</code></font> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <font color="#aa0000">(MA)</font> (aktive Zeichen) +und <font color="#aa0000">(MS)</font><br>(Substitution/Skript) +<font color="#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</font> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><font color="#aa0000">Wikipedia-Abschnittsüberschrift</font></a> +(Gleichheitszeichen) wird in +<code><font color="#aa0000">wiki</font>.sty</code> nach Methode (MA),<br> +in <code><font color="#aa0000">makedoc</font>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 5:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">Dokumentation</font> von LaTeX-Paketen +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(mit <font color="#aa0000"><code>nicetext</code></font>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <font color="#aa0000">Pakete</font> des <font color="#aa0000"><code>nicetext</code></font>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<font color="#aa0000">Wikipedia-Markup</font> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<font color="#aa0000">„minimales Markup“</font>(?) speziell für <font color="#aa0000">Beschreibung</font> +<br> +von <font color="#aa0000">LaTeX-Makros</font> und LaTeX-<font color="#aa0000">Paketen</font> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<font color="#aa0000">Vorverarbeitung</font> von + +<font color="#aa0000">Code+Kommentar</font>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<font color="#aa0000">Regeln</font> zum Einfügen <font color="#aa0000">typografischer Zeichen</font> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<font color="#aa0000"><code>makedoc.sty</code></font> zugrundeliegende +<font color="#aa0000">Skript</font>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">wiki</font>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><font color="#aa0000">Schrift</font>kodierung</a> +durch <em>Folgen</em> von <font color="#aa0000">Apostrophen</font> finde ich +<font color="#aa0000">nicht intuitiv genug</font>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><font color="#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li>… sie ist gegenwärtig auch <font color="#aa0000">inkompatibel</font> mit der +Verwendung „aktiver Apostrophe“ in +<code><font color="#aa0000">niceverb</font>.sty</code>. + </li> + <li><a href="#implement-ma"><font color="#aa0000">Überschriften</font>kodierung</a> durch +<font color="#aa0000">Gleichheitszeichen</font> verwende ich bisher in der +(MA)-Implementierung von <code><font color="#aa0000">makedoc</font>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><font color="#aa0000">Einrücken</font></a> eine +<font color="#aa0000">verbatim</font>-Umgebung auslöst, finde ich +<font color="#aa0000">unpraktisch.</font> + </li> + <li>Im Quelltext sehe ich lieber <font color="#aa0000">„1.“</font>, <font color="#aa0000">„2.“</font>, +…als „<code>#</code>“. +<br> +<small><font color="#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</font></small> + </li> + <li><font color="#aa0000">Unnummerierte Listen</font> mit <code>*</code> sind +<font color="#aa0000">OK</font>, +habe ich mal für <font color="#aa0000">„Fremddokumentation“</font> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 6:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><font color="#aa0000">niceverb</font>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> – „Schrift<font color="#aa0000">auszeichnung</font>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><font color="#aa0000">Wikipedia</font>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <font color="#aa0000">einfachen Apostroph</font>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <font color="#aa0000"><code>\textsf</code></font> +– für <font color="#aa0000">Paketnamen</font>. + </li> + <li><font color="#aa0000">einfache Anführung</font>szeichen +wirken wie <font color="#aa0000"><code>\texttt</code></font> +– für <font color="#aa0000">Code</font> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<font color="#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></font> +(<font color="#aa0000">Inline-verbatim</font>). + +</li></ol> + +<table width="" height="0" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<p align="center"> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 1 --> + <tr bgcolor="#eeefff"> +<td><strong>Code mit <font color="#aa0000">niceverb</font>.sty</strong></td> +<td><strong>wie Code <font color="#aa0000">sonst</font></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Beschreibung</font> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<font color="#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</font> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <font color="#aa0000">Syntax</font> von +<font color="#aa0000"><code>\foo</code></font> im <font color="#aa0000"><code>.pdf</code></font> aussehen. +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">niceverb</font>.sty</code>: +<pre> +<font color="#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</font> +</pre> + +– <font color="#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</font> + +<br>– +<code>\langle</code> <font color="#aa0000">„typografisches“</font> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<font color="#aa0000">Code</font> dafür mit <code><font color="#aa0000">doc</font>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<font color="#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</font> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Hervorhebung</font> von Makro<font color="#aa0000">beschreibungen</font></h2> + +<font color="#aa0000">Vertikalstriche</font> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><font color="#aa0000">doc</font>.sty</code>) +– wie es sehr <font color="#aa0000">üblich</font> ist – +<font color="#aa0000">verbatim</font>-Modus an/aus, +d. h. <font color="#aa0000"><code>|<code>\foo</code>|</code></font> kürzt +<font color="#aa0000"><code>\verb|</code><code>\foo|</code></font> ab – + </li> + <li>sollen mit <code><font color="#aa0000">niceverb</font>.sty</code> +<font color="#aa0000">Code hervorheben</font> und +beim <font color="#aa0000">Überfliegen</font> der +Dokumentation <font color="#aa0000">herausstechen</font> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <font color="#aa0000">Farbhinterlegung</font>? derzeit +<font color="#aa0000">„Kästen“</font> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><font color="#aa0000">niceverb</font>.sty</code> <font color="#aa0000">noch:</font></h2> +<ol> + </li> + <li><font color="#aa0000">„<code><meta></code>“</font> erzeugt „⟨<i>meta</i>⟩“ +<font color="#aa0000">sowohl</font> innerhalb <font color="#aa0000">als auch</font> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <font color="#aa0000">verbatim</font>-Text +interpretiert, etwa folgende Sterne und Klammern +als <font color="#aa0000">Syntaxbeschreibung</font> dazu. + </li> + <li>– dient besonders +der <font color="#aa0000">„Fremddokumentation“</font> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><font color="#aa0000">&</font></code>“ +ist <font color="#aa0000">aktives Zeichen</font>, welches in +<font color="#aa0000">Makroargumenten</font> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <font color="#aa0000">„nachzuhelfen“</font>: +<pre> +<font color="#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></font> +</pre> + </li> + <li> + +<font color="#aa0000">aktive Zeichen</font> → <font color="#aa0000">Probleme</font> … +<font color="#aa0000">Auswege</font> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Ähnliche</font> Pakete <font color="#aa0000">anderer</font> Autoren</h2> + +<ol> + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <font color="#aa0000">Stephan Böttcher</font>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><font color="#aa0000">lineno</font>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<font color="#aa0000"><code>ltxguide.cls</code></font> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <font color="#aa0000">Syntaxbeschreibung</font></a> +gibt es +(„mittlerweile“) auch in <font color="#aa0000">Martin Scharrers</font> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><font color="#aa0000">niceverb</font>.sty</code> ist ebenso wie +<code><font color="#aa0000">ydoc</font></code> als <strong>Alternative</strong> +zu <code><font color="#aa0000">doc</font>.sty</code> konzipiert. +<code><font color="#aa0000">ydoc</font></code> liefert dabei einen ähnlichen +<font color="#aa0000">Funktionsumfang</font> wie <code><font color="#aa0000">doc</font>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<font color="#aa0000">nicht haben will.</font> +– <font color="#aa0000">Allerdings</font> habe ich einzelne +<code><font color="#aa0000">doc</font>.sty</code>-Funktionen in +<code><font color="#aa0000">makedoc</font>.sty</code> und in +<code><font color="#aa0000">readprov</font>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 7:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Code</font> und <font color="#aa0000">„Kommentar“</font></h2> + +<small><font color="#006600">[vgl. <a href="http://de.wikipedia.org/wiki/Schuld und Sühne" target="_blank">Schuld und Sühne</a>, <a href="http://de.wikipedia.org/wiki/Pride and Prejudice" target="_blank">Pride and Prejudice</a>, <a href="http://de.wikipedia.org/wiki/Gesetzeskommentar" target="_blank">Gesetzeskommentar</a> zum <a href="http://de.wikipedia.org/wiki/Code civil" target="_blank">Code civil</a>]</font></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<font color="#aa0000">in Quelldateien Text</font> einzufügen, der <font color="#aa0000">nicht</font> +vom Compiler bzw. Interpreter (als <font color="#aa0000">Befehle/Daten</font>) +verarbeitet werden soll, sondern an (menschliche) <font color="#aa0000">Leser</font> +gerichtet ist – hier <font color="#aa0000">„Kommentar“</font>. +<br> +Einzelne <font color="#aa0000">Zwecke</font> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Zwecke</font> des Kommentars</h2> +<table width="576"><tr><td > +<ol> + </li> + <li><strong>Erläuterungen</strong> für <strong>Programmierer</strong>, +um die <strong>Wartung</strong> des Codes zu erleichtern – + </li> + <li>gerade im Falle von <font color="#aa0000">TeX</font>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <font color="#aa0000">„Erläuterungen“</font> +im Sinne einer <strong>Gebrauchsanleitung</strong><br> +(manchmal der einzig verfügbaren). + </li> + <li>In etwa gleichrangig +Bedeutung des <strong>„Auskommentierens“</strong> von Code, +d. h. +<font color="#aa0000">„Kommentar“</font> enthält +eigentlich <font color="#aa0000">Befehle/Daten</font> für +Compiler/Interpreter, die der <font color="#aa0000">Programmierer</font> +(oder auch Dokument<font color="#aa0000">autor</font>) +<font color="#aa0000">„aufbewahren“</font> möchte statt völlig zu +<font color="#aa0000">löschen</font> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <font color="#aa0000">„Auskommentierens“</font></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <font color="#aa0000">behält sich vor</font>, den Code später wieder +„an den Compiler/Interpreter zu richten“ +(durch einfache Entfernung der +<a href="http://de.wikipedia.org/wiki/Kommentarzeichen" target="_blank">Kommentarzeichen</a> bzw. +<font color="#aa0000">„Kommentarbegrenzern“</font>), +z. B. zum „<a href="http://de.wikipedia.org/wiki/Debugging" target="_blank">Debugging</a>“ +oder für bestimmte Adressaten – + </li> + <li>als „Erinnerung“ and frühere <font color="#aa0000">„Fehlversuche“</font>, +die auf frühere „Überlegungen“ hinweist und so wieder +der <strong>Wartung</strong> durch den Programmierer/Autor dient. +</ol> +Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX +das „Auskommentieren“ die <strong>hauptsächliche</strong> Funktion des +<font color="#aa0000">„Kommentars“</font> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 8:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <font color="#aa0000">„auszublenden“</font></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">Feinheiten</font> des <font color="#aa0000">„Ausblendens“</font><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <font color="#aa0000">TeX/LaTeX-Paketdatei</font> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<font color="#aa0000">Kommentarzeilen</font> als <font color="#aa0000">Anweisungszeilen</font>. + </li> + <li>Auch <strong>„Programmierertext“</strong>, der die Implementierung +sorgfältig diskutiert, kann im Verhältnis zum Code sehr +umfangreich sein (z. B. <code><code>lineno</code>.sty</code>). + </li> + <li><font color="#aa0000">„Vor langer Zeit“</font> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<font color="#aa0000">Hardware</font>-Umstände“ +bereits so viel Zeit, dass es <font color="#aa0000">sinnvoll</font> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„Ausblenden“</font> von Kommentar – <font color="#aa0000">Forts.</font> …</h2> +<ol> + </li> + <li>Ein <font color="#aa0000">„primitiver“ Ansatz</font> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <font color="#aa0000">nach</font> dem +<font color="#aa0000"><code>\endinput</code></font>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<font color="#aa0000">Anfang</font> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <font color="#aa0000">Ende</font>.<br> +Der <code>\endinput</code>-Befehl bricht die Verarbeitung der Datei ab, +so dass die Zeilen darunter tatsächlich +keine Verarbeitungszeit mehr beanspruchen. + </li> + <li><font color="#aa0000">Andererseits</font> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <font color="#aa0000">Nähe</font> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <font color="#aa0000">blendet</font> noch <font color="#aa0000">effizienter</font> aus:</h2> + +<ol> + </li> + <li>Mit <font color="#aa0000">LaTeX2</font> hatten <font color="#aa0000">Paket-Dateien</font> +die Endung <font color="#aa0000">„<code>.sty</code>“.</font><br> +Sie <font color="#aa0000">enthielten</font> noch <font color="#aa0000">„Kommentar“</font> wie oben. + </li> + <li>Mit <font color="#aa0000">LaTeX2e</font> wurden <code><font color="#aa0000">doc</font>.sty</code> und +<code><font color="#aa0000">docstrip</font>.tex</code> eingeführt. +Dateien, die <font color="#aa0000">Code</font> und <font color="#aa0000">Kommentar „gemischt“</font> enthielten, bekamen nun die Endung +<font color="#aa0000">„<code>.doc</code>“</font> oder <font color="#aa0000">„<code>.dtx</code>“.</font> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <font color="#aa0000">„<code>.sty</code>“</font> oder +<font color="#aa0000">„<code>.cls</code>“</font> um; +diese sollen <font color="#aa0000">keinen Kommentar</font> mehr enthalten +(bis auf <font color="#aa0000">Lizenz</font>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <font color="#aa0000">eingelesen</font> werden, +<font color="#aa0000">außer … </font> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<font color="#aa0000">zeichen</font></h2> +<ol> + </li> + <li>Kommentar<font color="#aa0000">zeilen</font> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<font color="#aa0000">zeichen</font> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <font color="#aa0000"><code>\endinput</code></font> wird Code auch +<font color="#aa0000">ohne</font> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<font color="#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</font> +einrahmen.) + </li> + <li>Diese (ganz oben) <font color="#aa0000">Zeilen mit Kommentarzeichen</font> +werden dann von <font color="#aa0000"><code>docstrip</code></font> entfernt … +d. h., diese Kommentarzeichen dienen gar <font color="#aa0000">nicht</font> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <font color="#aa0000">Wieso dann noch Kommentarzeichen?</font> + </li> + <li>… tatsächlich: Mit <font color="#aa0000">Paul Isambert</font>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <font color="#aa0000">Listing-Umgebungen</font> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <font color="#aa0000">kompakte Paketdatei</font>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <font color="#aa0000">heute</font></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <font color="#aa0000"><code>.sty</code>-Pakete</font>, +die <font color="#aa0000"><em>mit</em> Kommentarzeilen</font> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <font color="#aa0000">noch heute!</font> +<ul> + </li> + <li>verschiedene in <acronym>TDS</acronym>-<code>ltxmisc/</code>, darunter +einige geniale, für manche unverzichtbare Pakete von +<a href="http://ctan.org/author/id/arseneau" target="_blank"><font color="#aa0000">Donald Arseneau</font></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><font color="#aa0000">Stephan Böttcher</font>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<font color="#aa0000">kritische Editionen</font> und <font color="#aa0000">Einreichungen</font>) +enthält gewaltig viel Kommentar – von mir übernommen, +nie gehört, dass das Laden zu lange dauere … + </li> + <li>alle (? <code>\endinput</code>) meine +<a href="http://ctan.org/author/id/lueck" target="_blank"><font color="#aa0000">eigenen</font></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 9:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">„Darstellung“</font> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <font color="#aa0000">„Vorzeit“</font></h2> +<ol> + </li> + <li><em>Vor</em> <code><font color="#aa0000">doc</font>.sty</code> +war der <font color="#aa0000">Kommentar</font> in <font color="#aa0000">Paketdateien</font> +dazu da, mit einem <font color="#aa0000">Texteditor</font> gelesen oder +im <font color="#aa0000">„Text“</font>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <font color="#aa0000">„Grafik“</font>-Modus) +ausge<font color="#aa0000">druckt</font> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <font color="#aa0000"><acronym>ASCII</acronym></font>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><font color="#aa0000">doc</font>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><font color="#aa0000">doc</font>.sty</code> wurde +die heute von <font color="#aa0000">LaTeX-Paketen</font> auf dem +<font color="#aa0000">CTAN</font> gewohnte LaTeX-Druck<font color="#aa0000">qualität</font> +des <font color="#aa0000">Kommentars</font> möglich, +wobei man den <font color="#aa0000">Code</font> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<font color="#aa0000">Entscheidend</font> ist dabei der +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</font>-Grundsatz +– die <font color="#aa0000">Code</font> und +<font color="#aa0000">Kommentar mischende</font> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <font color="#aa0000"><code>\DocInput</code></font>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <font color="#aa0000"><acronym>WEB</acronym>?</font>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<font color="#aa0000">nicht</font> (den früheren) +<font color="#aa0000">„<acronym>ASCII</acronym>“-Kommentar</font> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <font color="#aa0000">typografischen Zeichen</font> und +LaTeX-<font color="#aa0000">Markup</font> +in der <font color="#aa0000">Code+Kommentar</font>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000"><code>\DocInput</code></font><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<font color="#aa0000"><code>doc</code></font>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <font color="#aa0000">Code/Kommentar mischende</font> Datei +<font color="#aa0000">⟨<i>c+k</i>⟩</font> so – sie enthalte als Beispiel + +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +<code>\DocInput{⟨<i>c+k</i>⟩}</code> führt <font color="#aa0000"><code>\MakePercentIgnore</code></font> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <font color="#aa0000">Code</font> in eine +<font color="#aa0000">Listing</font>-Umgebung, der <font color="#aa0000">Rest</font> wird +<font color="#aa0000">„normal“</font> in LaTeX-Qualität gesetzt. +<p> +<font color="#aa0000">„Minimales Markup“</font> würde bedeuten, +dass man <font color="#aa0000">dasselbe</font> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Minimale“ Kennzeichnung</font> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">„smartes“</font> <code>\DocInput</code></h2> + +– <font color="#aa0000">Algorithmus</font> klar:<br> + – nach Zeile +<em>mit</em> „<code>%</code>“ vor <em>„ohne“</em> +„<code>\begin{macrocode}</code>“,<br> + – im umgekehrten Fall „<code>\end{macrocode}</code>“ +einfügen – +<ol> + </li> + <li><a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a> (<font color="#aa0000">Grzegorz Murzinowski</font>; +<font color="red">ich meine mich zu erinnern:</font><br> +wie bei <code>wiki.sty</code> sind die +<font color="#aa0000">Zeilenendzeichen aktiv</font><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<font color="#aa0000">Stephan Böttcher</font>) +– eine <acronym>UNIX</acronym>-Shell wendet ein +in der Datei <code>lineno.sty</code> enthaltenes +<a href="http://de.wikipedia.org/wiki/awk" target="_blank">awk</a>-Skript auf <code>lineno.sty</code> +an, erzeugt Dokumentationsdatei <code>lineno.tex</code> … + </li> + <li><code><font color="#aa0000">makedoc</font>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<font color="#aa0000">Zeilenparser</font>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">„Interpretationen“</font> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<font color="#aa0000">echter</font> Kommentar vs. <font color="#aa0000">„Auskommentieren“</font>, +ich: +<pre> +<code>\typeout{ok}</code> %% Code +% <code>\typeout{ko}</code> %% auskommentierter Code +%% <- falls ko %% Kommentar +%% % <- falls KO %% auskommentierter Kommentar +%% %% <- 2011/10/01 %% Kommentar zum Kommentar +</pre> +<font color="#aa0000">ergibt</font> mit <code>makedoc</code> und von mir bevorzugten +Einstellungen: +<blockquote> + <code>\typeout{ok} %% Code</code><br> +% <code>\typeout{ko} %% auskommentierter Code</code><br> +←falls ko +</blockquote> +– Parsermakros +für verschiedene <font color="#aa0000">„Stile“</font>, +etwa Pakete <font color="#aa0000">anderer</font> Autoren, die +<font color="#aa0000">keine „<code>%%</code>“</font> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000"><code>makedoc</code></font>s <code>\DocInput{⟨<i>job</i>⟩}</code></h2> +<table width="600"><tr><td > + +Genaue Entsprechung zu <code>\DocInput</code> fehlt derzeit.<br> +„⟨<i>job</i>⟩“ ergibt sich von selbst, oder …<br> +Verschiedene <font color="#aa0000">Skriptbefehle</font> +unterstützen unterschiedliche <font color="#aa0000">Dokumentationsstile</font> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><code>mdoccheat.pdf</code></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><font color="#aa0000">erzeugt</font> aus (je)der c+k-Datei eine +<font color="#aa0000">Dokumentationsversion</font> +(<font color="#aa0000">„<code>.txt</code>→<code>.tex</code>“</font>, +Einfügen von „<font color="#aa0000">Listing</font>-Wrappern“, +<font color="#aa0000">Zeichenkettenersetzungen</font> +für <font color="#aa0000">Gliederung</font> und <font color="#aa0000">typografische Zeichen</font>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><code>mdoccorr.cfg</code></a>/<a href="mdoccorr.pdf" target="_blank"><code>pdf</code></a>, + </li> + <li>liest und <font color="#aa0000">setzt</font> die erzeugte Datei dann als +<font color="#aa0000"><code>.tex</code>.</font> +</li></ol> + +<font color="#aa0000">Genauer</font> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <font color="#aa0000">kompiliere</font> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">pdf</font></code> von +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code>. + </li> + <li><code>⟨<i>job</i>⟩.<font color="#aa0000">tex</font></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code> aus +<code>⟨<i>job</i>⟩.<font color="#aa0000">sty</font></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<font color="#aa0000">doc</font></code>, + </li> + <li>kann noch Dokumentation von +<font color="#aa0000">Ergänzungspaketen</font> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<font color="#aa0000">doc</font></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<font color="#aa0000">.doc</font></code>/<code>⟨<i>add</i>⟩<font color="#aa0000">.doc</font></code> +können<br>(nach <code>\RequirePackage{makedoc}</code>)<br> +ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt +und dann in der <code>{document}</code>-Umgebung mit +<font color="#aa0000"><code>\input</code></font> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <font color="#aa0000">flott</font> +Pakete schreiben/dokumentieren<br> +(auch mit <font color="#aa0000">Dokumentation</font> als +<font color="#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</font> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<font color="#aa0000">Workflows</font><br> +läuft mittlerweile meist alles <font color="#aa0000">„wie am Schnürchen“.</font> + </li> + <li> +<font color="#aa0000">Einrichten</font> eines solchen Workflows +war aufwändig,<br>dafür jetzt <font color="#aa0000">Vorlagen</font> +sowie <font color="#aa0000">Bash</font>- und +<font color="#aa0000"><code>fifinddo</code>-Skripts</font>. + </li> + <li><font color="#aa0000">Fehler</font> wegen Umwegs über +<font color="#aa0000">erzeugte</font> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <font color="#aa0000">schwer verständlich</font> … + </li> + <li> +In der <font color="#aa0000">Praxis</font> kann ich (derzeit) +doch <font color="#aa0000">LaTeX-Befehle</font><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<font color="#aa0000">nicht</font> ganz <font color="#aa0000">vermeiden</font>,<br> +wohl vor allem bei <font color="#aa0000">Verweisen</font> … + </li> + <li>Dennoch gelungene <font color="#aa0000">„Fremddokumentationen“:</font><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><code>arseneau.pdf</code></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><code>substr.pdf</code></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <font color="#aa0000">Zeichenkategorien</font> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <font color="#aa0000">Dokumentation</font>svorverarbeitung +Einlesen als <font color="#aa0000">„reinen Text“</font> +(<code>\dospecials</code> <font color="#aa0000">„<code>other</code>“</font>) + </li> + <li><font color="#aa0000"><code>\PatternCodes</code></font> für Ersetzungsregeln +anzupassen + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <font color="#aa0000">TeX-Syntax</font>, +<font color="#aa0000">expandiert</font> Makros zu <font color="#aa0000"><acronym>HTML</acronym></font>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<font color="#aa0000"><code>.tex</code></font> +zeilenweise +in ⟨<i>job</i>⟩<font color="#aa0000"><code>.html</code></font> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#bbccdd">Teil 10:</font> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<font color="#aa0000">HTML</font> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><font color="#aa0000">Nutzen</font> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><font color="#aa0000">Internetauftritt/CMS</font> + </li> + <li>„Elektronischer <font color="#aa0000">Zettelkasten</font>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <font color="#aa0000">Link-Sammlungen</font> + </li> + <li>Hervorhebung von <font color="#aa0000">Stichwörtern</font> +in Texten aus anderen Formaten + +(<a href="http://mterry.name/xpad" target="_blank">Xpad</a>/<a href="http://de.wikipedia.org/wiki/Tomboy (Software)" target="_blank">Tomboy</a>) + +</ol> + </li> + <li>besserer <font color="#aa0000">Lesefluss ohne Seiten</font>umbrüche,<br> +ohne problematische <font color="#aa0000">Zeilen</font>umbrüche + </li> + <li><font color="#aa0000">keine Arbeit mit Umbrüchen</font><br>(außer gedankliche Gliederung) + </li> + <li><font color="#aa0000">Bildschirmfläche</font> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><font color="#aa0000">HTML</font>-Erzeugung – <font color="#aa0000">Alternativen</font></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <font color="red">egal</font> + </li> + <li><strong><a href="http://ctan.org/pkg/tex4ht" target="_blank"><code>TeX4th</code></a></strong> +(Eitan Gurari†; +<i><a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank">Wikipedia</a></i> sehr informativ) +– <a href="http://de.wikipedia.org/wiki/TeX4ht" target="_blank"><font color="#aa0000">verarbeitet <code>.dvi</code></font></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <font color="#aa0000">Webseiten</font> pflegen<font color="red">?</font> + </li> + <li>diverse <strong>Syntax-Wandler</strong> wie +<a href="http://de.wikipedia.org/wiki/LaTeX2html" target="_blank">LaTeX2html</a> (Perl), <a href="http://hevea.inria.fr" target="_blank"><tt>hevea.inria.fr</tt></a>, +<a href="http://evalwhen.com/tex2page" target="_blank">TeX2page</a>, + +<a href="http://ctan.org/pkg/tth" target="_blank"><code>TtH</code></a> +(<a href="http://de.wikipedia.org/wiki/C (Programmiersprache)" target="_blank">C</a>; +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">Home:</a> Formeln!); +vgl. <a href="http://tug.org/interest.html#web" target="_blank"><tt>tug.org/interest.html#web</tt></a> + </li> + <li><code><strong>blog</strong>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +– expandiert Makros zu HTML; +<font color="#aa0000">LaTeX</font>-Makros <font color="#aa0000">umdefiniert</font>, +<font color="#aa0000">neue</font> Makros für bestimmte +<font color="#aa0000"><acronym>HTML</acronym>-Strukturen</font>, z. B.<code><font color="#aa0000">lnavicol</font>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <font color="#aa0000">selber Quelle</font>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <font color="#aa0000">„<code>htmlTeX</code>“</font><br> +(<font color="#aa0000"><acronym>HTML</acronym></font> regt zu Makros an, die <font color="#aa0000">auch</font> für +<font color="#aa0000"><acronym>PDF</acronym></font>-Erzeugung interessant wären,<br> +angefangen mit logischer Auszeichnung wie +<code><code></code>/<code>\code</code>, +<code><strong></code>/<code>\strong</code>.) + + </li> + <li><code><font color="#aa0000">texlinks</font>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <font color="#aa0000">Beispiele</font> für <font color="#aa0000">Makros</font>, +die <font color="#aa0000">gleichermaßen</font> +<ul> + </li> + <li>für <font color="#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></font> + </li> + <li>wie für <font color="#aa0000"><acronym>HTML</acronym></font>-Erzeugung mit +<code><font color="#aa0000">blog</font>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <font color="#aa0000">nur expandiert</font> werden, +vgl. <a href="http://de.wikipedia.org/wiki/Funktionale Programmierung" target="_blank">Funktionale Programmierung</a>): +Zähler, optionale Argumente, ∗-Varianten, <code>\unskip</code>, <code>\verb</code>; +<code>\begin</code> öffnet keine Gruppe für lokale Einstellungen, +solche können ohnehin nicht vorgenommen werden. +(„Was man an TeX hat.“) +– Mathe: Brüche/Wurzeln? vgl. dazu +<a href="http://hutchinson.belmont.ma.us/tth/" target="_blank">TtH</a>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +<font color="#aa0000">Ausweg</font> irgendwann: besondere Behandlung +von Zeilen, die bestimmte einzelne Makros enthalten, +wie etwa +<code>\EXECUTE{⟨<i>einstellungen</i>⟩}</code>, +<code>\begin</code>, <code>\end</code>. + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +Wandlung <font color="#aa0000">zeilenweise</font> erschwert auch Verteilen +von <font color="#aa0000">Makroargumenten über mehrere Zeilen</font> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><font color="#aa0000">blog</font>.sty</code> wurde (2010) +mittelbar/teilweise durch die +<a href="http://de.wikipedia.org/wiki/Deutsche Forschungsgemeinschaft" target="_blank">DFG</a> +unterstützt + </li> + <li>den <font color="#aa0000">Einstieg</font> in <font color="#aa0000"><acronym>HTML</acronym></font> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><tt>www.webdesign-bu.de</tt></a>) + </li> + <li>fürs <font color="#aa0000">Zuhören</font> <font color="#006600">[Zuschauen]</font> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <font color="#aa0000">Uwe Ziegenhagen</font> (u. a.) für Hinweis auf<br> +<a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a> und +<a href="http://johnmacfarlane.net/pandoc" target="_blank">pandoc</a>, + </li> + <li>an <font color="#aa0000">Bernd Raichle</font> für Hinweis auf +<font color="#aa0000">Kees van der Laan</font>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<font color="#aa0000">technischen</font> Helfern“ +(Kabel/ +<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/Master/texmf-dist/source/latex/fifinddo-info/dantev45.cfg b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.cfg new file mode 100644 index 00000000000..25738d8ba72 --- /dev/null +++ b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.cfg @@ -0,0 +1,24 @@ +\ProvidesFile{dantev45.cfg}[2011/10/15 local blogdot.sty config] +%% for type area width 668px and screen width minus +%% scroll bar: +% \renewcommand*{\leftpagemargin}{50} %% -> 768 +% \renewcommand*{\leftpagemargin}{162} %% -> 992 +% \renewcommand*{\leftpagemargin}{256} %% -> 1180 +% \renewcommand*{\rightpagemargin}{\leftpagemargin} +% \renewcommand*{\upperpagemargin}{80} +%% I prepared my presentation for a screen of +%% 600px height and tried to confine myself to a +%% type area height of 440px; a lower margin of 504px would hide +%% the next "page"/"slide" even on a screen 1024px high: +% \renewcommand*{\lowerpagemargin}{504} +% \renewcommand*{\typeareawidth}{640} +% \renewcommand*{\typeareaheight}{440} +%% Debugging: +% \ShowBlogDotBorders +% \ShowBlogDotFrame +% \FillBlogDotTypeArea +% \FillBlogDotBottom +% \ShowBlogDotFillText +%% Overall background color: +% \renewcommand*{\bodybgcolor}{\#ffffff} +\endinput diff --git a/Master/texmf-dist/source/latex/fifinddo-info/dantev45.fdf b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.fdf new file mode 100644 index 00000000000..c11d874c89f --- /dev/null +++ b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.fdf @@ -0,0 +1,59 @@ +\ProvidesFile{dantev45.fdf}[2011/10/14 blogdot settings for dantev45] +\RequirePackage{blogdot} +\renewcommand*{\leftpagemargin}{176} %% 2011/10/01 +%% wiki-listen: %% 2011/10/12 +\renewcommand*{\typeareawidth}{668} %% 2011/10/12 +\renewcommand*{\leftpagemargin}{162} %% 2011/10/12 +\renewcommand*{\typeareaheight}{440} +\renewcommand*{\bodybgcolor}{\#ffffff} +\renewcommand*{\pkgnamefmt}{\code} +\newcommand*{\section}{\cheading2} +\TryBlogDotCFG[dantev45] %% 2011/10/12 +%% The rest shouldn't be changed in recompiling: %% 2011/10/12 +\input{atari.fdf} +\input{lang-de.fdf} +\newcommand*{\labelsection}[1]{% + \nextnormalscreenpage{#1}\section} +\newcommand*{\labelcentersection}[1]{% %% 2011/09/25 + \nextcenterscreenpage{#1}\section} +\makeatletter %% TODO!? +%% Not used 2011/10/01: +% \newenvironment{maxitemize} +% {\textblock{\typeareawidth}% +% % <ul \@style{margin-left:0px}>% +% \itemize +% }{% +% % </ul>% +% \enditemize +% \endtextblock} +\newcommand*{\teilpage}[2]{% +% \labelcentersection{teil-#1} + \labelsection{teil-#1}%% 2011/10/11 + {\textcolor{\#bbccdd}{Teil #1:} + \vspace{21}% %% 2011/09/29 + #2}% +} +%% |\thesis{<label>}{<text>}| must be in a +%% |{theses}| environment +%% (TODO make package for more general use!): %% 2011/10/04 +\newenvironment*{theses} + {\startTable{\@cellpadding{9} + \@cellspacing{0}}} + {\endTable} +\newcommand*{\thesis}[2]{% + \TableRow{ thesis }{% +% \@style{margin:9px}% + \@valign@t + }% + \tablewidthcell{42px}{#1}% %% TODO generalize 2011/10/03 + \simplecell{#2}% + \endTableRow +} +\renewcommand*{\BlogDotRestart}{inhalt} +% \renewcommand*{\nextnormalscreenpage}{% +% \nextscreenpage{\@align@l}} %% 2011/10/11 +%% <- no difference, but still \@align@c differs +%% +%% 2011/10/05 getting around double quotes: +\newcommand*{\LucidaSans}{"Lucida Sans"} +\endinput diff --git a/Master/texmf-dist/source/latex/fifinddo-info/dantev45.tex b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.tex new file mode 100644 index 00000000000..5ec3a7b5957 --- /dev/null +++ b/Master/texmf-dist/source/latex/fifinddo-info/dantev45.tex @@ -0,0 +1,1582 @@ +\ProvidesFile{dantev45.tex}[2011/10/14 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} + \small %% <- 2011/10/13 -> + bzw. knapp unter Text + (\wikideref{Internet Explorer}{MSIE}) + \endsmall + und rechts unten fr \ancref{inhalt}{"Rckkehr"}\\ +\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}\,] %% gekrzt 2011/10/05 + \hrule +\titlescreenpage +\heading1{\mystrong{Paketdokumentation}\\und + \mystrong{Webseitenpflege} mit\\ + (\pkg{\mystrong{niceverb}.sty} + und)\\\pkg{\mystrong{fifinddo}.sty}} +Uwe Lck +\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 fr 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.) Bedrfnissen + 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{Irrtmer? Hinweise?} + \Endash \mystrong{Terminologie} erst in letzten zwei Wochen + "erarbeitet" + \item Vorstellung von \pkg{\mystrong{blogdot}.sty} + (\ctanpkgref{morehype}-Bndel) %% 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 Kster\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} +(fr \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{Anfhrung}szeichen, + \mystrong{Leerzeichen}, + und \mystrong{Strichen}. + %%% \myalert{Beispiele} + %%% [space factor, Ellipse, geschtzte Leerzeichen, Festabst„nde, + %%% Gedankenstriche, Anfhrungszeichen] + %%% \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}, Einrcken, + \mystrong{Listen}, Verweise,\Dots +% \answer{\Endash durch spezielle einzelne Zeichen (statt +% Backslash~\dots) +% \Endash Wikipedia, Hervorhebungen nicht so wichtig?} +\end{enumerate} +% Begrndung: +\Endash \mystrong{Unterscheidung} nur \mystrong{HTML}-Terminologie? +\\ +\HTML\ verwendet fr \mystrong{ersten} Fall +spezielle \mystrong{Zeichen} wie +\code{\ } (anders als \cs{dots}), +\\ +fr \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 + \\ + fr 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{Anfhrung}szeichen}{% +% \starttr +% \tablewidthcell{200}{(Doppelte) Anfhrungszeichen} +% \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 + Geschtztes~\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}-Bndels: +% \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{\ }}, + 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{Anfhrungszeichen} 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 Einfgen typografischer Zeichen) + \mystrong{"\code{.txt\to.tex}"} + in \ctanpkgref{nicetext}-Beschreibung + (Schw„che der Terminologie) + \item \emph{WARNUNG!} \mystrong{fehlerhafte} Automatisierung + typografischer \mystrong{Anfhrungszeichen} kann zum Verlust + des \ancref{motive-p}{\mystrong{Doktortitels}} + und politischer Žmter fhren! + (\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{Anfhrungszeichen} um + (s.~Datei + \mirrorctanfileref{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 fr Grafikeinbindung etc., + zuletzt 2004 +\end{enumerate} +\Endash fr \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 fr \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 Anfhrungszeichen} 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.~\mirrorctanfileref{\ltxcontrib nicetext/doc}{% + wikicheat.pdf}) + +\teilpage{4}{\mystrong{Implementierung}\\"minimalen Markups" + \\"mit \mystrong{\TeX\ allein}"} +\labelsection{implement}{% + \mystrong{Implementierung}smethoden fr\\"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 + stckweise 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 gengte 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}}-Bndel +implementiert die \ancref{wiki-markup}{zuvor} beschriebene +\mystrong{Wikipedia}-Syntax fr \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 fr 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}) hinzugefgt wird. + Entsprechend wird automatisch eine + \cs{begin{...}}- bzw. \cs{end{...}}-Zeile oder das Makro + \mystrong{\cs{item}} eingefgt +\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-Abschnittsberschrift}} + (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}}-Bndels} +\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 fr \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 fr 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 Einfgen \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 fr \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{Einrcken}} 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 fr \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 fr \mystrong{Paketnamen}. + \item \mystrong{einfache Anfhrung}szeichen + wirken wie \mystrong{\cs{texttt}} + \Endash fr \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} dafr 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{Anfhrung}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{Anfhrung}szeichen + % \mystrong{weglassen! (Backslash aktiv)} + \\ + \endash %%% <p> + \mystrong{Code} dafr 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}|}} krzt + \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 Anfhrungszeichen. + \item Im \strong{"Auto-Modus"} werden \LaTeX-Befehle nicht + ausgefhrt, 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 % Natrlich 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}} fr 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} (fr 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}-Bndel). %% "Bndel" 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 Shne}, + \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} einzufgen, 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} fr \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 verfgbaren). %% 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} fr %%% 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~fr~bestimmte Adressaten~\endash + \item als "Erinnerung" and frhere \mystrong{"Fehlversuche"}, + die auf frhere "š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 fr 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} eingefhrt. + 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, fr 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 fr + \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 natrlich 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 fr \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 fr + 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 frheren) + \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 frs \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}}} fhrt \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"} wrde 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}} +%% Zeilenumbrche/\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}}" +einfgen~\endash +\begin{enumerate} + \item \ctanpkgref{gmdoc} (\mystrong{Grzegorz Murzinowski}; + \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} einzufgen +% ("\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 + fr 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 +% \mirrorctanfileref{\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} + untersttzen unterschiedliche \mystrong{Dokumentationsstile} + (šbersicht: %% 2011/10/07 + \mirrorctanfileref{\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}"}, + Einfgen von "\mystrong{Listing}-Wrappern", + \mystrong{Zeichenkettenersetzungen} + fr \mystrong{Gliederung} und \mystrong{typografische Zeichen}, + dazu Datei + \mirrorctanfileref{\ltxcontrib nicetext/use}{% + mdoccorr.cfg}/\localfilenewref{% + mdoccorr.pdf}{\file{pdf}}, %% 2011/10/09 + \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} fr 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 Schnrchen".} + \item %% 2011/10/06 + \mystrong{Einrichten} eines solchen Workflows + war aufw„ndig,\\dafr 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":}\\ + \mirrorctanfileref{\ltxcontrib nicetext/demo}{arseneau.pdf}, + \mirrorctanfileref{\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 fr \mystrong{Dokumentation}svorverarbeitung + Einlesen als \mystrong{"reinen Text"} + (\cs{dospecials} \mystrong{"\code{other}"}) + \item \mystrong{\cs{PatternCodes}} fr Ersetzungsregeln + anzupassen + \item \pkg{\mystrong{blog}.sty} (\ctanpkgref{morehype}-Bndel) + 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}umbrche,\\ + ohne problematische \mystrong{Zeilen}umbrche + \item \mystrong{keine Arbeit mit Umbrchen}\\(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}-Bndel) %% "Bndel" 2011/10/03 + \Endash expandiert Makros zu HTML; + \mystrong{\LaTeX}-Makros \mystrong{umdefiniert}, + \mystrong{neue} Makros fr 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} fr + \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}-Bndel)\\ + bietet \mystrong{Beispiele} fr \mystrong{Makros}, + die \mystrong{gleichermažen} + \begin{itemize} + \item fr \mystrong{\pkg{hyperref}/\PDF} + \item wie fr \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 fr + \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 fr lokale Einstellungen, + solche k”nnen ohnehin nicht vorgenommen werden. + ("Was man an \TeX\ hat.") + \Endash Mathe: Brche/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"). + Knftige Alternativen w„ren \ctanpkgref{catchfile} + oder "bis zur n„chsten leeren Zeile am Stck" einlesen. +\end{textblock} + + +\labelcentersection{schluss}{Dank} %% schwarz 2011/10/14 +%% gekrzt 2011/10/05: +% \labelcentersection{schluss}{Schluss} +% Dieser Vortrag war fr mich eine \mystrong{Prfung}, +% \\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} + untersttzt + \item den \mystrong{Einstieg} in \mystrong{\HTML} + verdanke ich in erster Linie meinem Bruder, + Rainer Lck (\urlref{www.webdesign-bu.de}) + \item frs \mystrong{Zuh”ren} \answer{Zuschauen} + \end{itemize} +und \strong{nachtr„glich:} + \begin{itemize} + \item an \mystrong{Uwe Ziegenhagen} (\ua) fr Hinweis auf\\ + \Wikideref{Markdown} und + \httpref{johnmacfarlane.net/pandoc}{pandoc}, + \item an \mystrong{Bernd Raichle} fr Hinweis auf + \mystrong{Kees van der Laan}s (NTG) Arbeiten ber + "minimales Markup", + \item "\mystrong{technischen} Helfern" %% <- 2011/10/08 -> + (Kabel/% + \httpref{www.x.org/wiki/Projects/XRandR}{\code{xrandr}})! + \end{itemize} +\end{textblock} + +% \nextcenterscreenpage{} +% \labelsection{}{% +% \section{} +\screenbottom{START} +\finish + diff --git a/Master/texmf-dist/source/latex/fifinddo-info/expose.tex b/Master/texmf-dist/source/latex/fifinddo-info/expose.tex new file mode 100644 index 00000000000..c5e00851381 --- /dev/null +++ b/Master/texmf-dist/source/latex/fifinddo-info/expose.tex @@ -0,0 +1,94 @@ +\def\exposedate{2011/09/04} +\ProvidesFile{expose.tex}[\exposedate] +\documentclass[a4paper,11pt]{article} +\usepackage{german} +\newcommand*{\DQ}[1]{"`#1"'} +\usepackage{parskip} +\parskip=.84\parskip +\usepackage[atari]{umlaute} +\input{makedoc.cfg} +\providecommand{\pkg}{\pkgnamefmt} +\providecommand{\code}{\texttt} +\title{Paketdokumentation und Webseitenpflege\\ + mit (\pkg{niceverb.sty} und) \pkg{fifinddo.sty}} +\author{\acro{DANTE}-Herbsttagung 2011\\Uwe Lck} +\date{Entwurf \exposedate} +\begin{document} +\maketitle +\thispagestyle{empty} + +Das 'nicetext'-Bndel\urlpkgfoot{nicetext} +versucht sich an +\wikideref{Syntaktischer Zucker}{\strong{% + \DQ{syntaktischem Zucker}}:} +Schriftsatz in \TeX-Qualit„t +bei m”glichst wenig \TeX-artiger Auszeichnung. +% Grunds„tzlich sehe ich dafr zwei Methoden: +Das kann durch +(MS)~Zeichenkettenersetzung %%%, +oder (auch) durch +(MA)~aktive Zeichen +(die einige Fallunterscheidungen ausfhren) %%%. +% Sie schliežen sich keineswegs gegenseitig aus. +% Die praktische Bedeutung des Bndels liegt fr mich zur Zeit +% ganz in der Paketdokumentation. +erreicht werden. + +Die \DQ{herrschende Lehre} fr die \strong{Dokumentation} von \LaTeX-Paketen +ist die \DQ{\file{.dtx}}-Methode, die z.\,B. eine spezielle +Markierung des Paketcodes erfordert. +'makedoc.sty' aus dem 'nicetext'-Bndel dagegen +setzt die gute alte Idee um, dass man Kommentarzeilen schon +% dadurch dadurch von Codezeilen unterscheiden kann, +% dass erstere mit einem Kommentarzeichen (\lq\code{\%}\rq) beginnen! +am Kommentarzeichen (\lq`%'\rq) erkennt! + +Mit derselben Absicht verwendete Stephan B”ttcher die +\strong{Skriptsprache} \meta{\Wikideref{awk}} +% fr die Dokumentation von +zur Kommentierung von 'lineno.sty'.\urlpkgfoot{lineno} +'makedoc.sty' bietet % dem gegenber +stattdessen eine Skriptsprache, % deren Interpretationsengine +die wie bei 'docstrip.tex'\urlpkgfoot{docstrip} +durch die \TeX-Engine selbst verarbeitet wird, +zusammen mit besonderen Makros. +'makedoc' wandelt die Paketdatei in eine Dokumentationsdatei um, +indem Kommentarzeichen entfernt und Codezeilen in Listing-Umgebungen +eingebettet werden. Bei dieser Gelegenheit kann auch gem„ž Methode (MS) +\TeX-Code fr typografische Feinheiten eingefgt und die +\Wikideref{MediaWiki}-\wikideref{Hilfe:Inhaltsverzeichnis}{Gliederung} +umgesetzt werden. + +'niceverb.sty' (ebenfalls in 'nicetext') % bietet weitere Feinheiten +erm”glicht weiter +nach der Methode (MA) +% fr +eine geradezu \acro{WYS\-I\-WYG}-artige \strong{Syntaxbeschreibung} +fr Paketmakros. \linebreak +% Sogar Pakete anderer Autoren (z.\,B. Donald Arseneau) +% k”nnen in \TeX-Qualit„t aus der reinen ASCII-Dokumentation +% in der Paketdatei gesetzt werden, ohne Žnderungen an dieser Datei +% vorzunehmen. +% Bei eigenen Paketen erfordert die Kommentierung +% wenig mehr Aufwand als Kommentarzeichen, und der Kommentarcode +% ist so leserlich wie berhaupt nur m”glich. +Makros k”n\-nen \DQ{im Handumdrehen} kommentiert werden. +% (oder man schreibt zuerst den Kommentar als Plan)~\dots +Vorhandene \linebreak +\acro{ASCII}-Dokumentation kann \DQ{automatisch} +in \TeX-Qualit„t gesetzt werden. + +% \enlargethispage{1\baselineskip} + +'makedoc.sty' erweitert die \TeX-Skriptsprache aus 'fifinddo.sty' +zum Verarbeiten von Text-Dateien zu Text-Dateien. +'blog.sty' aus dem \ctanpkgref{morehype}-Bndel +setzt ebenfalls auf 'fifinddo' auf. +Im Gegensatz zu 'makedoc' werden dabei die Makros der Quelldateien +\emph{expandiert} -- in \strong{\acro{HTML}}-Tags und -Zeichen. + +Der Vortrag vergleicht diese Ans„tze mit denen +\httpref{www.webdesign-bu.de/uwe\string_lueck/heyctan.htm\#mine-related} + {\strong{anderer}} Autoren. + +\end{document} diff --git a/Master/texmf-dist/source/latex/fifinddo-info/makedot.tex b/Master/texmf-dist/source/latex/fifinddo-info/makedot.tex new file mode 100644 index 00000000000..7bd0f64625a --- /dev/null +++ b/Master/texmf-dist/source/latex/fifinddo-info/makedot.tex @@ -0,0 +1,25 @@ +\def \GenDate {2011/10/15} %% <- TODO update! +\ProvidesFile{makedot.tex}[\GenDate\space blogdot driver (UL)] +%% public packages: +\RequirePackage{blogdot,texlinks} +%% local settings (overridable for single documents): +% \input{atari.fdf} +% \input{lang-de.fdf} +% \input{lang-en.fdf} +%% local/experimental settings: +\input{texblog.fdf} +%% settings for single job: +\input{dantev45.fdf} +\def\htmljob{dantev45} +%% alternatively, load these settings from a file +%% `jobname.tex' that may be made with `echo'/by a script. + +\SumBlogDotWidth %% blogdot special + +%% as in all my blog.sty driver files: +\ResultFile{\htmljob\htmakeext} +\BlogCopyFile[\TextCodes + \MakeActiveDef\"{\catchdq}% + ]{\htmljob.tex} +\CloseResultFile +\stop diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index 9f1aae6928c..6d9e03ca7c7 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -153,7 +153,7 @@ my @TLP_working = qw( fancybox fancyhdr fancyhdr-it fancynum fancypar fancyref fancytabs fancytooltips fancyvrb FAQ-en fbithesis fbs fdsymbol featpost fenixpar - feyn feynmf fge fig4latex figbas figbib figflow figsize + feyn feynmf fge fifinddo-info fig4latex figbas figbib figflow figsize filecontents filehook fileinfo filemod findhyph fink finstrut first-latex-doc fix2col fixfoot fixlatvian fixme fixpdfmag diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds index d78ed7a76ad..5503eb8647e 100755 --- a/Master/tlpkg/libexec/ctan2tds +++ b/Master/tlpkg/libexec/ctan2tds @@ -1129,7 +1129,7 @@ $standardtex='\.(.bx|cfg|sty|clo|ldf|cls|def|fd|cmap|4ht)$'; 'epslatex-fr', 'NULL', 'esint-type1', 'esint.tex', 'europecv', 'EuropeFlag|europasslogo|\.cls|\.def', - 'fancytooltips', 'fancytipmark\..*|' . $standardtex, + 'fancytooltips', 'fancytipmark\..*|' . $standardtex, 'figflow', '\.tex', 'fjodor', 'fjodor\.sty', # not srbook-mem.sty 'flashmovie', '\.swf|' . $standardtex, diff --git a/Master/tlpkg/tlpsrc/collection-documentation-german.tlpsrc b/Master/tlpkg/tlpsrc/collection-documentation-german.tlpsrc index a35683cac09..54f5f98a8ad 100644 --- a/Master/tlpkg/tlpsrc/collection-documentation-german.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-documentation-german.tlpsrc @@ -1,5 +1,6 @@ category Collection shortdesc German documentation +depend fifinddo-info depend kopka depend l2picfaq depend l2tabu diff --git a/Master/tlpkg/tlpsrc/fifinddo-info.tlpsrc b/Master/tlpkg/tlpsrc/fifinddo-info.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d --- /dev/null +++ b/Master/tlpkg/tlpsrc/fifinddo-info.tlpsrc |