diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm')
-rw-r--r-- | Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm | 3283 |
1 files changed, 3283 insertions, 0 deletions
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> + |