diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /info/fifinddo-info/variants |
Initial commit
Diffstat (limited to 'info/fifinddo-info/variants')
-rw-r--r-- | info/fifinddo-info/variants/dantev45-1180-clean.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-1180-com.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-768-com.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-768-exact-frame.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-768-exact-show.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-768-filltype-show.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-992-com.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-992-exact-frame.html | 3287 | ||||
-rw-r--r-- | info/fifinddo-info/variants/dantev45-992-exact.html | 3287 |
9 files changed, 29583 insertions, 0 deletions
diff --git a/info/fifinddo-info/variants/dantev45-1180-clean.html b/info/fifinddo-info/variants/dantev45-1180-clean.html new file mode 100644 index 0000000000..a01f536d3a --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-1180-clean.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> + +<!-- slide width = 1180 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; color:#000000; font-size: 21px } + +p { margin-bottom:0px } +dl, ol, ul { padding-left: 1em; margin-left: 1em; margin-top: 18px; margin-bottom: 18px; vertical-align: middle; } +dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } +li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } +blockquote { margin-left: 2em } +pre { margin-left:2em; margin-top:0px } + +a:link { color:#0000d0; text-decoration:none; } +a:visited { color:purple; text-decoration:none; } +a:hover { color:blue; text-decoration:underline; } +a:active { color:blue; text-decoration:underline; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45-1180-clean</code> – <a href="dantev45-1180-clean.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-1180-com.html b/info/fifinddo-info/variants/dantev45-1180-com.html new file mode 100644 index 0000000000..0b3e6a842e --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-1180-com.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 1180 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; color:#000000; font-size: 21px } + +p { margin-bottom:0px } +dl, ol, ul { padding-left: 1em; margin-left: 1em; margin-top: 18px; margin-bottom: 18px; vertical-align: middle; } +dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } +li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } +blockquote { margin-left: 2em } +pre { margin-left:2em; margin-top:0px } + +a:link { color:#0000d0; text-decoration:none; } +a:visited { color:purple; text-decoration:none; } +a:hover { color:blue; text-decoration:underline; } +a:active { color:blue; text-decoration:underline; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45-1180-com</code> – <a href="dantev45-1180-com.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +<p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +<p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +<p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +<p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +<p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +<p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +<p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +<p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +<p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +<p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +<p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +<p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +<p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +<p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +<p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +<p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +<p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +<p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +<p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +<p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +<p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +<p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +<p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +<p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +<p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +<p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +<p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +<p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +<p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +<p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +<p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +<p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +<p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +<p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +<p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +<p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +<p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +<p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +<p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +<p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +<p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +<p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +<p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +<p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +<p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +<p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +<p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +<p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +<p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +<p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +<p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +<p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +<p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +<p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +<p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +<p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +<p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +<p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +<p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +<p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +<p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +<p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +<p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +<p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +<p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="256"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="256"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +<p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="256" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-768-com.html b/info/fifinddo-info/variants/dantev45-768-com.html new file mode 100644 index 0000000000..a629d5fa31 --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-768-com.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> +<!-- "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-768-com</code> – <a href="dantev45-768-com.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <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><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +<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"><span style="color:#bbccdd">Teil 0:</span> +<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"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</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"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-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"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> 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 <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> 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-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – 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 <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.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"><span style="color:#aa0000">Status</span></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"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></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"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> 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 <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</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 <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> 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"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> 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 <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</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><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– 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><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<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 <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</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"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> 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"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<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"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> 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"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></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"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</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"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</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. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<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>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „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 <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> 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><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> 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 <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.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"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</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 <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>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><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> 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"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.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><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></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"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</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"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> 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><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</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"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.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"><span style="color:#bbccdd">Teil 7:</span> +<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"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(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"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</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 <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +<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"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></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"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> 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"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> 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> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</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<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</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> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></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"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> 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 – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-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><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-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"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +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 <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> 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"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> 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"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<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"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> 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"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</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] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> 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 <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></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 <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> 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"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> 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"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> 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"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.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 <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„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><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +<p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-768-exact-frame.html b/info/fifinddo-info/variants/dantev45-768-exact-frame.html new file mode 100644 index 0000000000..bf1125c2ca --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-768-exact-frame.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> + +<!-- 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-768-exact-frame</code> – <a href="dantev45-768-exact-frame.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-768-exact-show.html b/info/fifinddo-info/variants/dantev45-768-exact-show.html new file mode 100644 index 0000000000..a1aeb84009 --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-768-exact-show.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> + +<!-- 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-768-exact-show</code> – <a href="dantev45-768-exact-show.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-768-filltype-show.html b/info/fifinddo-info/variants/dantev45-768-filltype-show.html new file mode 100644 index 0000000000..c05b401121 --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-768-filltype-show.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> +<!-- "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-768-filltype-show</code> – <a href="dantev45-768-filltype-show.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +<p><a href="#teil-0"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +<p><a href="#titelerlaeut2"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +<p><a href="#interessant"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +<p><a href="#motive-t"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +<p><a href="#motive-p"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +<p><a href="#teil-1"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> 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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +<p><a href="#txt2tex-trad"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +<p><a href="#teil-2"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +<p><a href="#typoz-latex"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +<p><a href="#minimal-mehr"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– 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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +<p><a href="#typoz-auto"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +<p><a href="#typoz-ctan"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +<p><a href="#teil-3"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +<p><a href="#wiki-listen"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +<p><a href="#teil-4"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +<p><a href="#implement"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +<p><a href="#implement-ms"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +<p><a href="#implement-ma"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +<p><a href="#implement-ma+"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +<p><a href="#implement-mas"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +<p><a href="#teil-5"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +<p><a href="#nicetext"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +<p><a href="#wiki"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +<p><a href="#teil-6"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +<p><a href="#niceverb"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +<p><a href="#vert"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> 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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +<p><a href="#niceverb-sim"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +<p><a href="#kommentarzw"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +<p><a href="#kommentarzwa"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +<p><a href="#teil-8"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +<p><a href="#kommentar-ignor"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +<p><a href="#kommentar-ignor-mehr"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +<p><a href="#docstrip"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +<p><a href="#kommentarzch"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +<p><a href="#ohne-docstrip"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +<p><a href="#teil-9"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +<p><a href="#doku-vor"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +<p><a href="#doku-doc"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +<p><a href="#docinput"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +<p><a href="#docinput-min"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> 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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +<p><a href="#kommentarz-kombi"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +<p><a href="#makedoc-input"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +<p><a href="#makedoc-lauf"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +<p><a href="#erfolg"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +<p><a href="#catcodes"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +<p><a href="#teil-10"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +<p><a href="#html-statt-pdf"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +<p><a href="#html-alt"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +<p><a href="#html-und-pdf"><center><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"rules="all"frame="box"> +<tr><td width="50"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="50"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> 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><span style="color:red">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </span> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="50" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-992-com.html b/info/fifinddo-info/variants/dantev45-992-com.html new file mode 100644 index 0000000000..7a3d34d619 --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-992-com.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> +<!-- "Kompromiss" mit \FillBlogDotTypeArea --> +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; color:#000000; font-size: 21px } + +p { margin-bottom:0px } +dl, ol, ul { padding-left: 1em; margin-left: 1em; margin-top: 18px; margin-bottom: 18px; vertical-align: middle; } +dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } +li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } +blockquote { margin-left: 2em } +pre { margin-left:2em; margin-top:0px } + +a:link { color:#0000d0; text-decoration:none; } +a:visited { color:purple; text-decoration:none; } +a:hover { color:blue; text-decoration:underline; } +a:active { color:blue; text-decoration:underline; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45-992-com</code> – <a href="dantev45-992-com.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +<p><a href="#teil-0"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +<p><a href="#titelerlaeut1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +<p><a href="#titelerlaeut2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +<p><a href="#titelerlaeut3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +<p><a href="#interessant"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +<p><a href="#motive-t"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +<p><a href="#motive-p"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +<p><a href="#status"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +<p><a href="#inhalt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +<p><a href="#teil-1"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +<p><a href="#txt2tex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +<p><a href="#txt2tex-trad"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +<p><a href="#teil-2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +<p><a href="#typoz-latex"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +<p><a href="#minimal-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +<p><a href="#typoz-bewert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +<p><a href="#typoz-auto"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +<p><a href="#typoz-ctan"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +<p><a href="#teil-3"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +<p><a href="#wiki-markup"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +<p><a href="#wiki-listen"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +<p><a href="#teil-4"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +<p><a href="#implement"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +<p><a href="#implement-ms"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +<p><a href="#implement-ms2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +<p><a href="#implement-ma"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +<p><a href="#implement-ma+"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +<p><a href="#implement-mas"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +<p><a href="#teil-5"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +<p><a href="#nicetext"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +<p><a href="#wiki"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +<p><a href="#teil-6"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +<p><a href="#niceverb"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +<p><a href="#syntax"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +<p><a href="#vert"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +<p><a href="#niceverb-noch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +<p><a href="#niceverb-sim"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +<p><a href="#teil-7"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +<p><a href="#kommentar"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +<p><a href="#kommentarzw"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +<p><a href="#kommentarzwa"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +<p><a href="#teil-8"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +<p><a href="#kommentar-ignor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +<p><a href="#kommentar-ignor-mehr"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +<p><a href="#docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +<p><a href="#kommentarzch"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +<p><a href="#ohne-docstrip"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +<p><a href="#teil-9"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +<p><a href="#doku-vor"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +<p><a href="#doku-doc"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +<p><a href="#docinput"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +<p><a href="#docinput2"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +<p><a href="#docinput-min"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +<p><a href="#docinput-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +<p><a href="#kommentarz-kombi"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +<p><a href="#makedoc-input"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +<p><a href="#makedoc-lauf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +<p><a href="#erfolg"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +<p><a href="#catcodes"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +<p><a href="#teil-10"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +<p><a href="#html-statt-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +<p><a href="#html-alt"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +<p><a href="#html-und-pdf"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +<p><a href="#blog-probleme"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +<p><a href="#schluss"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +<p><a href="#START"><center><font color="#ffffff">X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X </font> </center></a></td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="504" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-992-exact-frame.html b/info/fifinddo-info/variants/dantev45-992-exact-frame.html new file mode 100644 index 0000000000..5b78b68aea --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-992-exact-frame.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> + +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; color:#000000; font-size: 21px } + +p { margin-bottom:0px } +dl, ol, ul { padding-left: 1em; margin-left: 1em; margin-top: 18px; margin-bottom: 18px; vertical-align: middle; } +dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } +li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } +blockquote { margin-left: 2em } +pre { margin-left:2em; margin-top:0px } + +a:link { color:#0000d0; text-decoration:none; } +a:visited { color:purple; text-decoration:none; } +a:hover { color:blue; text-decoration:underline; } +a:active { color:blue; text-decoration:underline; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45-992-exact-frame</code> – <a href="dantev45-992-exact-frame.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"frame="box"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + diff --git a/info/fifinddo-info/variants/dantev45-992-exact.html b/info/fifinddo-info/variants/dantev45-992-exact.html new file mode 100644 index 0000000000..fdcdcc5e39 --- /dev/null +++ b/info/fifinddo-info/variants/dantev45-992-exact.html @@ -0,0 +1,3287 @@ +<!-- generated from + + dantev45.tex, 2011/10/25 DANTE Herbst '11, + + with blog.sty, 2011/10/25 --> + +<!-- slide width = 992 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + +<style type="text/css" media="all"> +h1 { font-size: 42px; margin-bottom: 21px } +h2 { font-size: 30px; margin-bottom: 21px } + +td { font-family:Arial,Verdana,"Lucida Sans",sans-serif; color:#000000; font-size: 21px } + +p { margin-bottom:0px } +dl, ol, ul { padding-left: 1em; margin-left: 1em; margin-top: 18px; margin-bottom: 18px; vertical-align: middle; } +dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } +li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } +blockquote { margin-left: 2em } +pre { margin-left:2em; margin-top:0px } + +a:link { color:#0000d0; text-decoration:none; } +a:visited { color:purple; text-decoration:none; } +a:hover { color:blue; text-decoration:underline; } +a:active { color:blue; text-decoration:underline; } +</style> + <title>Dokumentation und HTML mit fifinddo</title> +</head><body bgcolor="#ffffff"> + +<a name="top-of-page"> + <small><code>uwe_lueck</code> <code>></code> + <a href="texmap.htm"><code>texmap</code></a> <code>></code> <code>dantev45-992-exact</code> – <a href="dantev45-992-exact.htm"><i>neu laden</i></a></small> +</a> – +</p> +[ <big><strong><a href="#START"><code>START</code></a></strong></big> +<span style="color:red"><<< zuerst klicken</span>, +<span style="color:#aa0000">dann auf Bildunterrand klicken</span> +<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> +<small> +  – <span style="color:red">more</span> about the present file on: +<a href="http://ctan.org/pkg/fifinddo-info" target="_blank"><code>CTAN</code></a> +</small> +<hr> + <a href="#teil-0"><code>teil-0</code></a> | +<a href="#titelerlaeut1"><code>titelerlaeut1</code></a> | +<a href="#titelerlaeut2"><code>titelerlaeut2</code></a> | +<a href="#titelerlaeut3"><code>titelerlaeut3</code></a> | +<a href="#interessant"><code>interessant</code></a> | +<a href="#motive-t"><code>motive-t</code></a> | +<a href="#motive-p"><code>motive-p</code></a> | +<a href="#status"><code>status</code></a> | +<strong><a href="#inhalt"><code>inhalt</code></a></strong><br> + <a href="#teil-1"><code>teil-1</code></a> | +<a href="#txt2tex"><code>txt2tex</code></a> | +<a href="#txt2tex-trad"><code>txt2tex-trad</code></a><br> + <a href="#teil-2"><code>teil-2</code></a> | +<a href="#typoz-latex"><code>typoz-latex</code></a> | +<a href="#minimal-mehr"><code>minimal-mehr</code></a> | +<a href="#typoz-bewert"><code>typoz-bewert</code></a> | +<a href="#typoz-auto"><code>typoz-auto</code></a> | +<a href="#typoz-ctan"><code>typoz-ctan</code></a><br> + <a href="#teil-3"><code>teil-3</code></a> | +<a href="#wiki-markup"><code>wiki-markup</code></a> | +<a href="#wiki-listen"><code>wiki-listen</code></a><br> + <a href="#teil-4"><code>teil-4</code></a> | +<a href="#implement"><code>implement</code></a> | +<a href="#implement-ms"><code>implement-ms</code></a> | +<a href="#implement-ms2"><code>implement-ms2</code></a> | +<a href="#implement-ma"><code>implement-ma</code></a> | +<a href="#implement-ma+"><code>implement-ma+</code></a> | +<a href="#implement-mas"><code>implement-mas</code></a><br> + <a href="#teil-5"><code>teil-5</code></a> | +<a href="#nicetext"><code>nicetext</code></a> | +<a href="#wiki"><code>wiki</code></a><br> + <a href="#teil-6"><code>teil-6</code></a> | +<a href="#niceverb"><code>niceverb</code></a> | +<a href="#syntax"><code>syntax</code></a> | +<a href="#vert"><code>vert</code></a> | +<a href="#niceverb-noch"><code>niceverb-noch</code></a> | +<a href="#niceverb-sim"><code>niceverb-sim</code></a><br> + <a href="#teil-7"><code>teil-7</code></a> | +<a href="#kommentar"><code>kommentar</code></a> | +<a href="#kommentarzw"><code>kommentarzw</code></a> | +<a href="#kommentarzwa"><code>kommentarzwa</code></a><br> + <a href="#teil-8"><code>teil-8</code></a> | +<a href="#kommentar-ignor"><code>kommentar-ignor</code></a> | +<a href="#kommentar-ignor-mehr"><code>kommentar-ignor-mehr</code></a> | +<a href="#docstrip"><code>docstrip</code></a> | +<a href="#kommentarzch"><code>kommentarzch</code></a> | +<a href="#ohne-docstrip"><code>ohne-docstrip</code></a><br> + <a href="#teil-9"><code>teil-9</code></a> | +<a href="#doku-vor"><code>doku-vor</code></a> | +<a href="#doku-doc"><code>doku-doc</code></a> | +<a href="#docinput"><code>docinput</code></a> | +<a href="#docinput2"><code>docinput2</code></a> | +<a href="#docinput-min"><code>docinput-min</code></a> | +<a href="#makedoc-input"><code>makedoc-input</code></a> | +<a href="#makedoc-lauf"><code>makedoc-lauf</code></a> | +<a href="#erfolg"><code>erfolg</code></a> | +<a href="#catcodes"><code>catcodes</code></a><br> + <a href="#teil-10"><code>teil-10</code></a> | +<a href="#html-alt"><code>html-alt</code></a> | +<a href="#html-statt-pdf"><code>html-statt-pdf</code></a> | +<a href="#html-und-pdf"><code>html-und-pdf</code></a> | +<a href="#blog-probleme"><code>blog-probleme</code></a> | +<a href="#schluss"><code>schluss</code></a> ] +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h1><span style="color:#aa0000">Paketdokumentation</span><br>und <span style="color:#aa0000">Webseitenpflege</span> mit<br> (<code><span style="color:#aa0000">niceverb</span>.sty</code> und)<br><code><span style="color:#aa0000">fifinddo</span>.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-25 + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-0"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 0:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Über den Vortrag</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Vortragstitel</span> bedeutet (I):</h2> +<dl> + <dt><strong>„Paketdokumentation“</strong><dd> +– Beschreibung von LaTeX-Makro-Paketen, d. h. + +<ol> + </li> + <li>in „Schreibmaschinenschrift“ (<span style="color:#aa0000">„verbatim“</span>) gesetzter +<span style="color:#aa0000">Paketcode</span> wechselt mit in LaTeX-Qualität gesetztem +<span style="color:#aa0000">Kommentar</span> ab („zeilenweise“) + </li> + <li>der <span style="color:#aa0000">Kommentar</span>text <span style="color:#aa0000">enthält</span> +„verbatim“ gesetzten TeX-<span style="color:#aa0000">Code</span> („inline“) +zur Bezugnahme – insbesondere: + </li> + <li><span style="color:#aa0000">Gebrauchsanleitung</span>/Syntaxbeschreibung für Nutzer: +<br><i>„Tippt man</i> +<blockquote> +<span style="color:#aa0000"><code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code></span>, +</blockquote> +<i>so erhält man …“</i> +</li></ul> +</dl> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (II):</h2> +<table width="560"><tr><td > +<dl> + <dt><strong>„Webseitenpflege“</strong><dd> +– „hochtrabend“, zunächst bloß: <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung +– +<ul> + </li> + <li><span style="color:#aa0000">Internet</span>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 <span style="color:#aa0000">Textformat</span>-Alternative zu <acronym>PDF</acronym> … +<br> +(Notizen zu <a href="http://www.webdesign-bu.de/uwe_lueck/heyctan.htm" target="_blank">Links</a>, +Beamer-Präsentation …) +</li></ul> +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="titelerlaeut3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> + +<h2 align="center"><span style="color:#aa0000"><a href="#START">Vortragstitel</a></span> bedeutet (III):</h2> +… was haben <span style="color:#aa0000">Paketdokumentation</span> und +<span style="color:#aa0000"><acronym>HTML</acronym>-Erzeugung</span> miteinander zu tun<span style="color:#aa0000">??</span> +<br><br> +(– Zu <span style="color:#aa0000"><acronym>HTML</acronym>-Paketdokumentationen</span> +<br>habe ich es noch <span style="color:#aa0000">nicht</span> gebracht …) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="interessant"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortrag <span style="color:#aa0000">interessant</span> …</h2> +<table width="600"><tr><td > +<ol> + </li> + <li>wenn man als Makroprogrammierer +<code><span style="color:#aa0000">doc</span>.sty</code> und <code><span style="color:#aa0000">docstrip</span>.tex</code> +(„<code><span style="color:#aa0000">.dtx</span></code> …“) +zu aufwändig findet … + </li> + <li>wenn man <span style="color:#aa0000"><acronym>HTML</acronym></span> schätzt und <span style="color:#aa0000"><acronym>PDF</acronym></span> +vermeiden möchte … + </li> + <li>wenn man <span style="color:#aa0000">Makro-<a href="http://de.wikipedia.org/wiki/Denksport" target="_blank">Denksport</a></span> mag +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-t"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Inhaltliche Motive</h2> +<table width="560"><tr><td > +<ol> + </li> + <li><strong>„minimales Markup“</strong>, +„<a href="http://de.wikipedia.org/wiki/syntaktischer Zucker" target="_blank">syntaktischer Zucker</a>“ +(LaTeX-<span style="color:#aa0000">Qualität</span> +<em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>) + </li> + <li><strong>„Missbrauch“</strong> von <span style="color:#aa0000">TeX</span> +als „<span style="color:#aa0000">Skript</span>sprache“ +<br> +(„mit TeX muss und will ich <span style="color:#aa0000">keine andere</span> Sprache lernen“; +<span style="color:#aa0000">statt</span> <acronym>PDF</acronym>-<span style="color:#aa0000">Schriftsatz</span> +– wie <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a>) + </li> + <li><span style="color:#aa0000">kleine</span>(?), einfache(?), experimentelle(!), +(„schrullige“,) gerade eigenen (U. L.) Bedürfnissen +entsprechende <strong>Alternativen</strong> zu existierenden +„professionelleren“ Paketen +(<span style="color:#aa0000">Erfolge</span> – Scheitern …) + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="motive-p"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Persönliche Motive</h2> +<table width="424"><tr><td > +(bemerkenswerte <span style="color:#aa0000">Mischung</span> aus:) +<ol> + </li> + <li>gespannt auf <span style="color:#aa0000">Kommentare</span><br>zu <span style="color:#aa0000">meinen</span> Paketen, + </li> + <li>Vortrag soll aber auch über <span style="color:#aa0000">„Konkurrenzprodukte“ informieren</span> + </li> + <li><span style="color:#aa0000">Irrtümer? Hinweise?</span> +– <span style="color:#aa0000">Terminologie</span> erst in letzten zwei Wochen +„erarbeitet“ + </li> + <li>Vorstellung von <code><span style="color:#aa0000">blogdot</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) + +</li></ol> +(und wohl auch ein wenig der beklagenswerten +<a href="http://de.wikipedia.org/wiki/Verfassung und Verfassungsvertrag#Entstehung" target="_blank">Eitelkeit</a> …) +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="status"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Status</span></h2> + +nicht richtig fertig, zu umfangreich, hasten, überspringen + +<table width="" height="9" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + +kein Experte in Typografie, <acronym>HTML</acronym>, <acronym>CSS</acronym> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="inhalt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vortragsteile</h2> +<table width="420"><tr><td > +<ol> + </li> + <li><a href="#teil-1"><span style="color:#aa0000">„Markup“?</span></a> – Terminologie + </li> + <li><a href="#teil-2"><span style="color:#aa0000">„typografische Zeichen“</span></a> +mit TeX/LaTeX + </li> + <li><a href="#teil-3"><span style="color:#aa0000">„Formatierung“</span></a> + </li> + <li><a href="#teil-4"><span style="color:#aa0000">Implementierung</span></a> +„minimalen Markups“ „<span style="color:#aa0000">mit TeX allein</span>“ + </li> + <li><a href="#teil-5">Paket<span style="color:#aa0000">dokumentation</span></a> + </li> + <li><a href="#teil-6"><code><span style="color:#aa0000">niceverb</span>.sty</code></a> + </li> + <li><a href="#teil-7">„Kommentar“</a> + </li> + <li><a href="#teil-8">Kommentar <span style="color:#aa0000">ausblenden</span></a> + </li> + <li><a href="#teil-9">„Darstellung“</a> des Kommentars + </li> + <li><a href="#teil-10"><span style="color:#aa0000">HTML</span></a> erzeugen +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-1"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 1:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Markup“</span> oder so +<table width="" height="18" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Begriffsklärung – oder so)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Von <code>.txt</code> zu <code>.tex</code></h2> + +Um <span style="color:#aa0000">reinen Text</span> in <span style="color:#aa0000">LaTeX-Input</span> +(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"><span style="color:#aa0000">Auslassungspunkten</span></a>, +<span style="color:#aa0000">Anführung</span>szeichen, +<span style="color:#aa0000">Leerzeichen</span>, +und <span style="color:#aa0000">Strichen</span>. + + </li> + <li><strong>„<a href="http://de.wikipedia.org/wiki/Textformatierung" target="_blank">Formatierung</a>“</strong> – Umschalten zwischen +<span style="color:#aa0000">Zeichensätzen</span>, Einrücken, +<span style="color:#aa0000">Listen</span>, Verweise, … + +</li></ol> + +– <span style="color:#aa0000">Unterscheidung</span> nur <span style="color:#aa0000">HTML</span>-Terminologie? +<br> +<acronym>HTML</acronym> verwendet für <span style="color:#aa0000">ersten</span> Fall +spezielle <span style="color:#aa0000">Zeichen</span> wie +<code>&nbsp;</code> (anders als <code>\dots</code>), +<br> +für <span style="color:#aa0000">zweiten</span> 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> +<span style="color:#006600">[dachte zunächst, Wortschöpfung sei meine eigene]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="txt2tex-trad"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">„Auszeichnung“</h2> +<table width="540"><tr><td > +„Traditionell“ +<ul> + </li> + <li>bezieht sich <span style="color:#aa0000">„Auszeichnung“</span> +<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 <span style="color:#aa0000">Setzer</span> das nicht „ahnen“ +konnte), + </li> + <li>während <strong>typografische Zeichen</strong>varianten +<br> +für den <span style="color:#aa0000">Setzer</span> eher „selbstverständlich“ waren +<br> +und im „Manuskript“ <span style="color:#aa0000">nicht</span> besonders <span style="color:#aa0000">angezeigt</span> wurden. +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 2:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Typografische Zeichen</span> mit TeX/LaTeX</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-latex"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen mit <span style="color:#aa0000">TeX/LaTeX</span></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><span style="color:#aa0000">Auslassung</span>szeichen</td><td><code>\dots</code></td></tr> + +<tr><td>Gedanken-/„bis“-<span style="color:#aa0000">Strich</span></td><td>„<code>---</code>“ (englisch), „<code>--</code>“ – <span style="color:#aa0000">Ligaturen</span></td></tr> +<tr><td>(Doppelte) <span style="color:#aa0000">Anführung</span>szeichen</td><td>Englisch: <span style="color:#aa0000">Ligaturen</span> <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> – <span style="color:#aa0000">aktive Zeichen</span></td></tr> + +<tr><td>Geschütztes <span style="color:#aa0000">Leer</span>zeichen, Festabstand</td><td>„<code>~</code>“ – <span style="color:#aa0000">aktives Zeichen</span>, „<code>\,</code>“</td></tr> +<tr><td>Englisch: <span style="color:#aa0000">Leer</span>raum nach Satzzeichen</td><td>„<code>\ </code>“ („Steuerungsleerzeichen“), „<code>\@</code>“, <code>\sfcode`...</code></td></tr> + </tbody> +</table> +<p> +<small> +<span style="color:#006600">[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ]</span> +</small> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="minimal-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Bewertung –<br><span style="color:#aa0000">„minimales Markup“</span> genauer </h2> +<table width="560"><tr><td > +<i>„LaTeX-<span style="color:#aa0000">Qualität</span> <em>möglichst ohne</em> LaTeX-<span style="color:#aa0000">Befehle</span>“</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 <span style="color:#aa0000">Zeichen</span> im Dokument<span style="color:#aa0000">quell</span>code, <br>die nicht auch <span style="color:#aa0000">gedruckt</span> werden!“</i><br> +– schließt <span style="color:#aa0000">„typografische Zeichen“</span> ein +– Schwäche meiner (damaligen) Terminologie – +<ol> + </li> + <li><span style="color:#aa0000">weg</span> mit <span style="color:#aa0000">Backslash</span>s, +englischen <span style="color:#aa0000">Befehlen</span> und +geschwungenen <span style="color:#aa0000">Klammern!</span> + </li> + <li>überhaupt möglichst wenig Code-<span style="color:#aa0000">Zeichen</span> + </li> + <li>Zeichen möglichst <span style="color:#aa0000">intuitiv</span> + </li> + <li>… am besten so <span style="color:#aa0000">aussehen wie Ergebnis</span> + </li> + <li>– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> +– vs. <a href="http://ctan.org/pkg/unisugar" target="_blank"><code>unisugar</code></a> mit Unicode … +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-bewert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Typografische Zeichen – Bewertung</h2> +<table width="640"><tr><td > +– von <a href="#typoz-latex">TeX/LaTeX:</a> +<ol> + </li> + <li><span style="color:#aa0000">TeX-Ligaturen</span> schon ganz gut! + </li> + <li><span style="color:#aa0000">aktive Zeichen</span> … na ja … +„<code>~</code>“ besser als „<code>&nbsp;</code>“, +aber … + </li> + <li><span style="color:#aa0000"><code>\dots</code></span> schon übel … +(warum nicht <span style="color:#aa0000">Ligatur</span> „<code>...</code>“?) +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-auto"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Typografische Zeichen <span style="color:#aa0000">automatisch?</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">automatische</span> Umwandlung „reiner“ Zeichen +in „typografische“?<br> + </li> + <li><span style="color:#aa0000"><code>\sfcode`A=999</code></span> schon in diese Richtung +(TeXbook S. 76) + </li> + <li>so ja optional <span style="color:#aa0000">Anführungszeichen</span> in +<span style="color:#aa0000"><i>Word</i></span> + </li> + <li>… <em><span style="color:#aa0000">und hier</span></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) +<span style="color:#aa0000">„<code>.txt→.tex</code>“</span> +in <a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>-Beschreibung +(Schwäche der Terminologie) + </li> + <li><em>WARNUNG!</em> <span style="color:#aa0000">fehlerhafte</span> Automatisierung +typografischer <span style="color:#aa0000">Anführungszeichen</span> kann zum Verlust +des <a href="#motive-p"><span style="color:#aa0000">Doktortitels</span></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> +<span style="color:#006600">[ z. B. <code>german.sty</code> nicht geladen, <code>\glqq</code>, <code>\grqq</code> nicht definiert, Fehlermeldungen ignoriert ]</span> +</small> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="typoz-ctan"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>.txt</code>→<code>.tex</code></span> <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 <span style="color:#aa0000">TeXs spezielle Zeichen</span> +(„<code>&</code>“ etc.), <span style="color:#aa0000">„<code>...</code>“</span> +und doppelte/einzelne <span style="color:#aa0000">Anführungszeichen</span> um +(s. Datei +<a href="http://mirror.ctan.org/support/txt2latex/txt2latex" target="_blank"><tt>txt2latex</tt></a>) + </li> + <li><a href="http://ctan.org/pkg/txt2tex" target="_blank"><code>txt2tex</code></a> – Perl, erzeugt tatsächlich +LaTeX-<span style="color:#aa0000">Formatierung</span> (Paketnamen „verkehrt“!) + </li> + <li><a href="http://ctan.org/pkg/easylatex" target="_blank"><code>EasyLaTeX</code></a> ähnlich oder mehr, +<span style="color:#aa0000">GUI</span>(?), Ideen aus <span style="color:#aa0000">Wiki…-Markup</span>; +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 <span style="color:#aa0000">Paketdokumentation</span> ist mir das zuviel … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-3"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 3:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Formatierung“</span> +<table width="" height="18pt" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> + <small>(Auszeichnung, Wikipedia)</small></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-markup"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: 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><span style="color:#aa0000">Wiki</span>-Code</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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> +– <span style="color:#aa0000">Intuition</span> dahinter vielleicht: +Bedeutungen von <em>kursiv</em> und<br> +<em>doppelten Anführungszeichen</em> verwandt, +z. B. Buchtitel + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki-listen"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Wikipedia</span>: Listen und Zitate</h2> +<table cellpadding="8" width="" frame="box" rules="all"> + <tbody> + <!-- wiki-markup 2 --> + <tr bgcolor="#eeefff"> +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-Code</strong></td> + +<td><strong><span style="color:#aa0000">Wiki</span>-</strong></td> +<td><strong>wie <span style="color:#aa0000">LaTeX</span>-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 <span style="color:#aa0000">„minimal“</span>, +auch halbwegs <span style="color:#aa0000">intuitiv.</span> + +<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"><tt>wikicheat.pdf</tt></a>) + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-4"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 4:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Implementierung</span><br>„minimalen Markups“ <br>„mit <span style="color:#aa0000">TeX allein</span>“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Implementierung</span>smethoden für<br>„minimales Markup“ mit <span style="color:#aa0000">TeX</span></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: <span style="color:#aa0000">Vorverarbeitung</span> der <code>.tex</code>-Datei, <span style="color:#aa0000">Zeichenkettenersetzung</span> (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 <span style="color:#aa0000">„Schriftsatz-Modus“</span> (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) <span style="color:#aa0000">expandieren</span> aktive Zeichen mehr oder weniger direkt zu <span style="color:#aa0000">„normalen“</span> LaTeX-Befehlen, <span style="color:#aa0000">„forschende“</span> aktive Zeichen „<span style="color:#aa0000">erkunden</span> dabei ihre <span style="color:#aa0000">Umgebung</span>“</td> </tr> +</table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Methode (MS) – Anmerkungen I</h2> +TeXs +Mechanismus, sog. <span style="color:#aa0000">„begrenzte Parameter“</span> +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 <span style="color:#aa0000">ersetzen</span>). +<ol> + </li> + <li>Vor- und Nachteile entstehen daraus, dass +ein „String“ aus „reinem Text“ von TeX intern +durch unterschiedliche <span style="color:#aa0000">„Token-Ketten“</span> „dargestellt“ +werden kann. Auch von <span style="color:#aa0000">Groß-/Kleinschreibung</span> abzusehen +ist nicht ganz einfach. + </li> + <li>Diese Methode wurde seit längerem von LaTeX’s internem +<span style="color:#aa0000"><code>\@in</code></span>-Makro +[hauptsächlich zur Erkennung von Paket-Optionen] +und vom Paket <span style="color:#aa0000"><a href="http://ctan.org/pkg/substr" target="_blank"><code>substr</code></a></span> +(Harald Harders bzw. Heiko Oberdiek) +angewandt. + </li> + <li>Gegenwärtig fußen auch <span style="color:#aa0000"><code>fifinddo.sty</code></span> und +<span style="color:#aa0000"><code>makedoc.sty</code></span> (<a href="http://ctan.org/pkg/nicetext" target="_blank"><code>nicetext</code></a>) +auf dieser Methode – genügte bisher <em>praktisch</em>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ms2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Anmerkungen zu (MS) II <br>(<span style="color:#aa0000">String</span>s und <span style="color:#aa0000">Scripting</span> mit <span style="color:#aa0000">TeX</span>)</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 <span style="color:#aa0000">Skriptsprache</span>“ +bietet neben Zeichenersetzung +allgemeiner <span style="color:#aa0000">„Sortierung“</span> und <span style="color:#aa0000">„Filter“.</span> +Beispielsweise bietet <a href="http://ctan.org/pkg/docstrip" target="_blank"><code>docstrip</code></a> +eine TeX-basierte Skriptsprache, +die aus einer <span style="color:#aa0000"><code>.dtx</code>-Quelldatei</span> +die <span style="color:#aa0000">„Kommentare“ entfernt</span> +und den Rest in verschiedene +<span style="color:#aa0000">„kompakte“ TeX-Eingabedateien</span> „sortiert“. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Minimales Markup“<br> mit <span style="color:#aa0000">„forschenden“ aktiven Zeichen</span> (MA)</h2> +<span style="color:#aa0000"><code>wiki.sty</code></span> aus dem <span style="color:#aa0000"><code>nicetext</code></span>-Bündel +implementiert die <a href="#wiki-markup">zuvor</a> beschriebene +<span style="color:#aa0000">Wikipedia</span>-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 <span style="color:#aa0000"><code>\...section{...}</code></span> einrahmende +<span style="color:#aa0000">Gleichheitszeichen</span>-Folgen verwenden, + </li> + <li><span style="color:#aa0000">Kursiv</span>- und <span style="color:#aa0000">Fett</span>schrift +mit Folgen von +<a href="http://de.wikipedia.org/wiki/Apostroph" target="_blank">„<span style="color:#aa0000">Apostroph</span>-Ersatzzeichen“</a> +(ASCII-Code 39) ein- und abschalten, + </li> + <li><span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Blockzitate</span> +aus Menschen- oder Programmiersprache durch +spezielle <span style="color:#aa0000">Zeilenanfänge</span> anzeigen. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-ma+"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code>s <span style="color:#aa0000">„forschende“</span> Zeichen</h2> +<ol> + </li> + <li><span style="color:#aa0000">Gleichheitszeichen</span> werden <em>aktive</em> Zeichen, +die feststellen, wieviele Gleichheitszeichen unmittelbar +aufeinander folgen. + </li> + <li>Ebenso funktionieren die <span style="color:#aa0000">Apostroph</span>-Ersatzzeichen. +Dabei werden <code>\textit</code> und <code>\textbf</code> nicht direkt +verwendet, das <span style="color:#aa0000">Umschalten</span> und die +<span style="color:#aa0000">Kursivkorrektur</span> +finden <span style="color:#aa0000">ohne</span> <span style="color:#aa0000">„Gruppenbildung“</span> statt. + </li> + <li>Um <span style="color:#aa0000">Listen</span> und <span style="color:#aa0000">Zitate</span> am Zeilenanfang +zu erkennen, wird das <span style="color:#aa0000">Zeilenende</span>-Zeichen +(<code>^^M</code>) <span style="color:#aa0000">aktiv</span> 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 +<span style="color:#aa0000">beginnt</span>, <span style="color:#aa0000">fortgesetzt</span> wird, oder +<span style="color:#aa0000">endet</span>, oder ob der Liste ein +<span style="color:#aa0000">weiterer Punkt</span> (<code>\item</code>) hinzugefügt wird. +Entsprechend wird automatisch eine +<code>\begin{...}</code>- bzw. <code>\end{...}</code>-Zeile oder das Makro +<span style="color:#aa0000"><code>\item</code></span> eingefügt +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="implement-mas"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">(MA) vs. (MS)</h2> +<table width="600"><tr><td > +Die Methoden <span style="color:#aa0000">(MA)</span> (aktive Zeichen) +und <span style="color:#aa0000">(MS)</span><br>(Substitution/Skript) +<span style="color:#aa0000">schließen sich <em>nicht</em> gegenseitig aus.</span> +<br>Welche Methode man anwendet, +ist vielleicht „Geschmackssache“. +Die <a href="#wiki-markup"><span style="color:#aa0000">Wikipedia-Abschnittsüberschrift</span></a> +(Gleichheitszeichen) wird in +<code><span style="color:#aa0000">wiki</span>.sty</code> nach Methode (MA),<br> +in <code><span style="color:#aa0000">makedoc</span>.sty</code> nach Methode (MS) implementiert. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-5"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 5:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">Dokumentation</span> 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 <span style="color:#aa0000"><code>nicetext</code></span>)</small></h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="nicetext"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Die <span style="color:#aa0000">Pakete</span> des <span style="color:#aa0000"><code>nicetext</code></span>-Bündels</h2> +<table width="600"><tr><td > +<dl> + <dt><strong><code>wiki.sty</code></strong><dd> + +<span style="color:#aa0000">Wikipedia-Markup</span> gemäß (MA) +(<a href="#implement-ma">s. o.</a>) + <dt><strong><code>niceverb.sty</code></strong><dd> +<span style="color:#aa0000">„minimales Markup“</span>(?) speziell für <span style="color:#aa0000">Beschreibung</span> +<br> +von <span style="color:#aa0000">LaTeX-Makros</span> und LaTeX-<span style="color:#aa0000">Paketen</span> + +(MA) + <dt><strong><code>makedoc.sty</code></strong><dd> + +<span style="color:#aa0000">Vorverarbeitung</span> von + +<span style="color:#aa0000">Code+Kommentar</span>-Dateien + +(MS) + <dt><strong><code>mdoccorr.cfg</code></strong><dd> +<span style="color:#aa0000">Regeln</span> zum Einfügen <span style="color:#aa0000">typografischer Zeichen</span> (MS) + <dt><strong><code>fifinddo.sty</code></strong><dd> + +<span style="color:#aa0000"><code>makedoc.sty</code></span> zugrundeliegende +<span style="color:#aa0000">Skript</span>sprache +</dl> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="wiki"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">wiki</span>.sty</code></h2> + +<ol> + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Schrift</span>kodierung</a> +durch <em>Folgen</em> von <span style="color:#aa0000">Apostrophen</span> finde ich +<span style="color:#aa0000">nicht intuitiv genug</span>, +um andere Paketbearbeiter damit konfrontieren zu wollen, +<small><span style="color:#006600">[Publikum (U. Z.): <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li>… sie ist gegenwärtig auch <span style="color:#aa0000">inkompatibel</span> mit der +Verwendung „aktiver Apostrophe“ in +<code><span style="color:#aa0000">niceverb</span>.sty</code>. + </li> + <li><a href="#implement-ma"><span style="color:#aa0000">Überschriften</span>kodierung</a> durch +<span style="color:#aa0000">Gleichheitszeichen</span> verwende ich bisher in der +(MA)-Implementierung von <code><span style="color:#aa0000">makedoc</span>.sty</code>. + </li> + <li>Dass <a href="#implement-ma+"><span style="color:#aa0000">Einrücken</span></a> eine +<span style="color:#aa0000">verbatim</span>-Umgebung auslöst, finde ich +<span style="color:#aa0000">unpraktisch.</span> + </li> + <li>Im Quelltext sehe ich lieber <span style="color:#aa0000">„1.“</span>, <span style="color:#aa0000">„2.“</span>, +…als „<code>#</code>“. +<br> +<small><span style="color:#006600">[Publikum: <a href="http://de.wikipedia.org/wiki/Markdown" target="_blank">Markdown</a>!]</span></small> + </li> + <li><span style="color:#aa0000">Unnummerierte Listen</span> mit <code>*</code> sind +<span style="color:#aa0000">OK</span>, +habe ich mal für <span style="color:#aa0000">„Fremddokumentation“</span> eingesetzt. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-6"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 6:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<code><span style="color:#aa0000">niceverb</span>.sty</code></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> – „Schrift<span style="color:#aa0000">auszeichnung</span>“</h2> +<a href="http://de.wikipedia.org/wiki/Definitionsmenge" target="_blank">„Fortsetzung“</a> der +<a href="#wiki-markup"><span style="color:#aa0000">Wikipedia</span>-Schriftauszeichnung:</a> +<ol> + </li> + <li>Umrahmung mit <span style="color:#aa0000">einfachen Apostroph</span>-Ersatzzeichen +(<code>’nicetext’</code>) +wirkt wie <span style="color:#aa0000"><code>\textsf</code></span> +– für <span style="color:#aa0000">Paketnamen</span>. + </li> + <li><span style="color:#aa0000">einfache Anführung</span>szeichen +wirken wie <span style="color:#aa0000"><code>\texttt</code></span> +– für <span style="color:#aa0000">Code</span> +– tatsächlich wirkt <code>‘<code>\foo</code>’</code> +(solange nicht in Makro-Argument) wie +<span style="color:#aa0000"><code>\verb</code><code>+<code>\foo</code>+</code></span> +(<span style="color:#aa0000">Inline-verbatim</span>). + +</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 <span style="color:#aa0000">niceverb</span>.sty</strong></td> +<td><strong>wie Code <span style="color:#aa0000">sonst</span></strong></td> + </tr> +<tr><td><code>’nicetext’</code></td><td><code>\textsf{nicetext}</code></td></tr> +<tr><td><code>‘<code>\foo</code>’</code></td><td><code>\verb+</code><code>\foo+</code></td></tr> +<tr><td><code>‘README.txt’</code></td><td><code>\texttt{README.txt}</code></td></tr> + </tbody> +</table> +</p> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="syntax"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Beschreibung</span> von LaTeX-Makros</h2> +<table width="640"><tr><td > +<i>„Tippt man</i> +<pre> +<span style="color:#aa0000"><code>\foo</code>∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</span> +</pre> +<i>so erhält man …“</i> +– so soll die Beschreibung der <span style="color:#aa0000">Syntax</span> von +<span style="color:#aa0000"><code>\foo</code></span> im <span style="color:#aa0000"><code>.pdf</code></span> aussehen. +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">niceverb</span>.sty</code>: +<pre> +<span style="color:#aa0000">‘<code>\foo</code>∗[<opt-arg>]{<mand-arg>}’</span> +</pre> + +– <span style="color:#aa0000">„<acronym>ASCII-WYSIWYG</acronym>“</span> + +<br>– +<code>\langle</code> <span style="color:#aa0000">„typografisches“</span> „<code><</code>“, +<br>– +<code>\rangle</code> „typografisches“ „<code>></code>“. + +<br> +– +<span style="color:#aa0000">Code</span> dafür mit <code><span style="color:#aa0000">doc</span>.sty</code> +(aus der LaTeX-„base“-Distribution): +<pre> +<span style="color:#aa0000"><code>|</code><code>\foo</code>∗[|<code>\meta</code>{opt-arg}|]{|<code>\meta</code>{mand-arg}|}|</span> +</pre> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="vert"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Hervorhebung</span> von Makro<span style="color:#aa0000">beschreibungen</span></h2> + +<span style="color:#aa0000">Vertikalstriche</span> (<code>|<code>\foo</code>|</code>) +<ul> + </li> + <li>schalten im vorigen Beispiel (<code><span style="color:#aa0000">doc</span>.sty</code>) +– wie es sehr <span style="color:#aa0000">üblich</span> ist – +<span style="color:#aa0000">verbatim</span>-Modus an/aus, +d. h. <span style="color:#aa0000"><code>|<code>\foo</code>|</code></span> kürzt +<span style="color:#aa0000"><code>\verb|</code><code>\foo|</code></span> ab – + </li> + <li>sollen mit <code><span style="color:#aa0000">niceverb</span>.sty</code> +<span style="color:#aa0000">Code hervorheben</span> und +beim <span style="color:#aa0000">Überfliegen</span> der +Dokumentation <span style="color:#aa0000">herausstechen</span> lassen +(<i>„hier Erläuterung von <code>\foo</code>!“</i>) +</li></ul> +– <span style="color:#aa0000">Farbhinterlegung</span>? derzeit +<span style="color:#aa0000">„Kästen“</span> wie mit <code>\fbox</code>, + +intern soll <code>\InlineCmdBox</code> zusammenfassende Aufzählungen von Makros +<em>in einem Absatz</em> ermöglichen. <strong>Beispiel</strong> Code/Ergebnis: +<pre> +|<code>\foo</code>∗[<opt-arg>]{<mand-arg>}| +</pre> +<blockquote> +<table cellpadding="2" width="" frame="box" rules="all"> + <tbody><tr> +<td> <code>\foo∗[⟨<i>opt-arg</i>⟩]{⟨<i>mand-arg</i>⟩}</code> </td> +</tr> </tbody> +</table> +</blockquote> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-noch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code><span style="color:#aa0000">niceverb</span>.sty</code> <span style="color:#aa0000">noch:</span></h2> +<ol> + </li> + <li><span style="color:#aa0000">„<code><meta></code>“</span> erzeugt „⟨<i>meta</i>⟩“ +<span style="color:#aa0000">sowohl</span> innerhalb <span style="color:#aa0000">als auch</span> +außerhalb von einfachen Anführungszeichen. + </li> + <li>Im <strong>„Auto-Modus“</strong> werden LaTeX-Befehle nicht +ausgeführt, sondern als <span style="color:#aa0000">verbatim</span>-Text +interpretiert, etwa folgende Sterne und Klammern +als <span style="color:#aa0000">Syntaxbeschreibung</span> dazu. + </li> + <li>– dient besonders +der <span style="color:#aa0000">„Fremddokumentation“</span> +(vorhandene <acronym>ASCII</acronym>-Paketdokumentation +anderer Autoren ohne Eingriff in LaTeX-Qualität setzen). + </li> + <li>„<code><span style="color:#aa0000">&</span></code>“ +ist <span style="color:#aa0000">aktives Zeichen</span>, welches in +<span style="color:#aa0000">Makroargumenten</span> Befehlen und +Syntaxbeschreibungen vorangestellt werden kann, +um <span style="color:#aa0000">„nachzuhelfen“</span>: +<pre> +<span style="color:#aa0000"><code>\footnote{<code>&</code><code>\foo</code>∗[<opt-arg>]{<mand-arg>}}</code></span> +</pre> + </li> + <li> + +<span style="color:#aa0000">aktive Zeichen</span> → <span style="color:#aa0000">Probleme</span> … +<span style="color:#aa0000">Auswege</span> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="niceverb-sim"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Ähnliche</span> Pakete <span style="color:#aa0000">anderer</span> Autoren</h2> + +<ol> + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist wesentlich inspiriert +durch die Dokumentationsmethode <span style="color:#aa0000">Stephan Böttcher</span>s +in <a href="http://ctan.org/pkg/lineno" target="_blank"><code><span style="color:#aa0000">lineno</span>.sty</code></a>. + </li> + <li>Ähnliche Funktionalität liefert auch +<span style="color:#aa0000"><code>ltxguide.cls</code></span> für die „LaTeX-Guides“. + </li> + <li>Die <a href="#syntax">bequeme <span style="color:#aa0000">Syntaxbeschreibung</span></a> +gibt es +(„mittlerweile“) auch in <span style="color:#aa0000">Martin Scharrers</span> +<a href="http://ctan.org/pkg/ydoc" target="_blank"><code>ydoc</code></a>. + </li> + <li><code><span style="color:#aa0000">niceverb</span>.sty</code> ist ebenso wie +<code><span style="color:#aa0000">ydoc</span></code> als <strong>Alternative</strong> +zu <code><span style="color:#aa0000">doc</span>.sty</code> konzipiert. +<code><span style="color:#aa0000">ydoc</span></code> liefert dabei einen ähnlichen +<span style="color:#aa0000">Funktionsumfang</span> wie <code><span style="color:#aa0000">doc</span>.sty</code>, +während <em>ich</em> (für meine Zwecke) +einen solchen Funktionsumfang überhaupt +<span style="color:#aa0000">nicht haben will.</span> +– <span style="color:#aa0000">Allerdings</span> habe ich einzelne +<code><span style="color:#aa0000">doc</span>.sty</code>-Funktionen in +<code><span style="color:#aa0000">makedoc</span>.sty</code> und in +<code><span style="color:#aa0000">readprov</span>.sty</code> +(<a href="http://ctan.org/pkg/fileinfo" target="_blank"><code>fileinfo</code></a>-Bündel). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-7"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 7:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +„Kommentar“</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Code</span> und <span style="color:#aa0000">„Kommentar“</span></h2> + +<small><span style="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>]</span></small> +<p> +TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, +<span style="color:#aa0000">in Quelldateien Text</span> einzufügen, der <span style="color:#aa0000">nicht</span> +vom Compiler bzw. Interpreter (als <span style="color:#aa0000">Befehle/Daten</span>) +verarbeitet werden soll, sondern an (menschliche) <span style="color:#aa0000">Leser</span> +gerichtet ist – hier <span style="color:#aa0000">„Kommentar“</span>. +<br> +Einzelne <span style="color:#aa0000">Zwecke</span> +(der <a href="http://de.wikipedia.org/wiki/Kommentar (Programmierung)" target="_blank">Wikipedia-Artikel</a> +weiß noch mehr …): + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzw"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Zwecke</span> 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 <span style="color:#aa0000">TeX</span>- und LaTeX-Paketen +(alter Zeiten) +an <strong>Nutzer</strong> gerichtete <span style="color:#aa0000">„Erläuterungen“</span> +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. +<span style="color:#aa0000">„Kommentar“</span> enthält +eigentlich <span style="color:#aa0000">Befehle/Daten</span> für +Compiler/Interpreter, die der <span style="color:#aa0000">Programmierer</span> +(oder auch Dokument<span style="color:#aa0000">autor</span>) +<span style="color:#aa0000">„aufbewahren“</span> möchte statt völlig zu +<span style="color:#aa0000">löschen</span> + +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzwa"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Zwecke des <span style="color:#aa0000">„Auskommentierens“</span></h2> +<ol type="a" + </li> + <li>als eine Art <strong>„Versionskontrolle“</strong>: +man <span style="color:#aa0000">behält sich vor</span>, 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. +<span style="color:#aa0000">„Kommentarbegrenzern“</span>), +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 <span style="color:#aa0000">„Fehlversuche“</span>, +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 +<span style="color:#aa0000">„Kommentars“</span> … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-8"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 8:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +Methoden Kommentar <span style="color:#aa0000">„auszublenden“</span></h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">Feinheiten</span> des <span style="color:#aa0000">„Ausblendens“</span><br>von Kommentar</h2> +<ol> + </li> + <li>Enthält eine <span style="color:#aa0000">TeX/LaTeX-Paketdatei</span> +die TeX-Anweisungen und gleichzeitig die <strong>Gebrauchsanweisung</strong>, +so umfasst sie typischerweise wesentlich mehr +<span style="color:#aa0000">Kommentarzeilen</span> als <span style="color:#aa0000">Anweisungszeilen</span>. + </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><span style="color:#aa0000">„Vor langer Zeit“</span> forderte das <strong>Einlesen</strong> +von TeX-Makrodateien aufgrund der „<span style="color:#aa0000">Hardware</span>-Umstände“ +bereits so viel Zeit, dass es <span style="color:#aa0000">sinnvoll</span> war, +das Einlesen von Kommentarzeilen völlig zu <strong>vermeiden</strong> … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentar-ignor-mehr"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„Ausblenden“</span> von Kommentar – <span style="color:#aa0000">Forts.</span> …</h2> +<ol> + </li> + <li>Ein <span style="color:#aa0000">„primitiver“ Ansatz</span> dazu war, +die <strong>„Gebrauchsanleitung“</strong><br> +„am Ende der Datei“ <span style="color:#aa0000">nach</span> dem +<span style="color:#aa0000"><code>\endinput</code></span>-Befehl der Datei +anzubringen. Die Datei enthielt dann gerne am +<span style="color:#aa0000">Anfang</span> den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem <span style="color:#aa0000">Ende</span>.<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><span style="color:#aa0000">Andererseits</span> sollte für die <strong>Wartung</strong> +der Kommentar eben doch in der <span style="color:#aa0000">Nähe</span> der +betreffenden Code-Zeilen angebracht werden … +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><code>docstrip</code> <span style="color:#aa0000">blendet</span> noch <span style="color:#aa0000">effizienter</span> aus:</h2> + +<ol> + </li> + <li>Mit <span style="color:#aa0000">LaTeX2</span> hatten <span style="color:#aa0000">Paket-Dateien</span> +die Endung <span style="color:#aa0000">„<code>.sty</code>“.</span><br> +Sie <span style="color:#aa0000">enthielten</span> noch <span style="color:#aa0000">„Kommentar“</span> wie oben. + </li> + <li>Mit <span style="color:#aa0000">LaTeX2e</span> wurden <code><span style="color:#aa0000">doc</span>.sty</code> und +<code><span style="color:#aa0000">docstrip</span>.tex</code> eingeführt. +Dateien, die <span style="color:#aa0000">Code</span> und <span style="color:#aa0000">Kommentar „gemischt“</span> enthielten, bekamen nun die Endung +<span style="color:#aa0000">„<code>.doc</code>“</span> oder <span style="color:#aa0000">„<code>.dtx</code>“.</span> +<code>docstrip</code> wandelt solche Dateien in Dateien mit Endungen +hauptsächlich wie <span style="color:#aa0000">„<code>.sty</code>“</span> oder +<span style="color:#aa0000">„<code>.cls</code>“</span> um; +diese sollen <span style="color:#aa0000">keinen Kommentar</span> mehr enthalten +(bis auf <span style="color:#aa0000">Lizenz</span>-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich <span style="color:#aa0000">eingelesen</span> werden, +<span style="color:#aa0000">außer … </span> +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarzch"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Kommentar<span style="color:#aa0000">zeichen</span></h2> +<ol> + </li> + <li>Kommentar<span style="color:#aa0000">zeilen</span> sind mit TeX/LaTeX gewöhnlich +durch das Kommentar<span style="color:#aa0000">zeichen</span> („<code>%</code>“) +am Anfang gekennzeichnet. + </li> + <li>(Nach <span style="color:#aa0000"><code>\endinput</code></span> wird Code auch +<span style="color:#aa0000">ohne</span> Kommentarzeichen ignoriert; +ebenso kann man im Prinzip „Kommentar“ ⟨<i>kommentar</i>⟩ mit +<span style="color:#aa0000">„<code>\iffalse</code>⟨<i>kommentar</i>⟩<code>\fi</code>“</span> +einrahmen.) + </li> + <li>Diese (ganz oben) <span style="color:#aa0000">Zeilen mit Kommentarzeichen</span> +werden dann von <span style="color:#aa0000"><code>docstrip</code></span> entfernt … +d. h., diese Kommentarzeichen dienen gar <span style="color:#aa0000">nicht</span> +mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei +als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar +nicht mehr da. <span style="color:#aa0000">Wieso dann noch Kommentarzeichen?</span> + </li> + <li>… tatsächlich: Mit <span style="color:#aa0000">Paul Isambert</span>s +<a href="http://ctan.org/pkg/codedoc" target="_blank"><code>CodeDoc</code></a> ist der „Kommentar“ +normaler, von <span style="color:#aa0000">Listing-Umgebungen</span> +unterbrochener Text (ohne „<code>%</code>“ links). +Letztere schreiben den Code in die <span style="color:#aa0000">kompakte Paketdatei</span>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="ohne-docstrip"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><em>Ohne</em> <code>docstrip</code> <span style="color:#aa0000">heute</span></h2> +(<a href="#docstrip"><code>docstrip</code></a> fortsetzend:) … +<em>aber</em> +es gibt die <span style="color:#aa0000"><code>.sty</code>-Pakete</span>, +die <span style="color:#aa0000"><em>mit</em> Kommentarzeilen</span> +(ohne <code>docstrip</code> einzuschalten) eingelesen werden, <span style="color:#aa0000">noch heute!</span> +<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"><span style="color:#aa0000">Donald Arseneau</span></a> (ich sehe gerade <a href="http://ctan.org/pkg/framed" target="_blank"><code>framed</code></a> …) + </li> + <li><span style="color:#aa0000">Stephan Böttcher</span>s <a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno.sty</code></a> +(Zeilennummerierung besonders für +<span style="color:#aa0000">kritische Editionen</span> und <span style="color:#aa0000">Einreichungen</span>) +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"><span style="color:#aa0000">eigenen</span></a> +Pakete (was natürlich einfach eine Frechheit sein kann …) +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-9"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 9:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">„Darstellung“</span> des Kommentars</h2> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-vor"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">„Darstellung“ des Kommentars – <span style="color:#aa0000">„Vorzeit“</span></h2> +<ol> + </li> + <li><em>Vor</em> <code><span style="color:#aa0000">doc</span>.sty</code> +war der <span style="color:#aa0000">Kommentar</span> in <span style="color:#aa0000">Paketdateien</span> +dazu da, mit einem <span style="color:#aa0000">Texteditor</span> gelesen oder +im <span style="color:#aa0000">„Text“</span>-Modus +(als „Listing“, im Gegensatz zum für TeX +erforderlichen <span style="color:#aa0000">„Grafik“</span>-Modus) +ausge<span style="color:#aa0000">druckt</span> zu werden. + </li> + <li>Kommentar entsprechend +„reiner <span style="color:#aa0000"><acronym>ASCII</acronym></span>-Text“, +weder „typografische Zeichen“ noch Auszeichnung. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="doku-doc"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Darstellung des Kommentars mit <code><span style="color:#aa0000">doc</span>.sty</code></h2> +<ol> + </li> + <li>Erst mit <code><span style="color:#aa0000">doc</span>.sty</code> wurde +die heute von <span style="color:#aa0000">LaTeX-Paketen</span> auf dem +<span style="color:#aa0000">CTAN</span> gewohnte LaTeX-Druck<span style="color:#aa0000">qualität</span> +des <span style="color:#aa0000">Kommentars</span> möglich, +wobei man den <span style="color:#aa0000">Code</span> als Imitation +der Texteditor- und Listing-Druckqualität auszeichnet. +<span style="color:#aa0000">Entscheidend</span> ist dabei der +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Don’t repeat yourself" target="_blank">Don’t repeat yourself</a>“</span>-Grundsatz +– die <span style="color:#aa0000">Code</span> und +<span style="color:#aa0000">Kommentar mischende</span> Quelldatei wird für +den Qualitätsausdruck nicht von Hand überarbeitet, +sondern „automatisch“ mit dem <span style="color:#aa0000"><code>\DocInput</code></span>-Befehl +verarbeitet. + </li> + <li>(Wie war das eigentlich mit <span style="color:#aa0000"><acronym>WEB</acronym>?</span>) + </li> + <li>Dazu kann man allerdings (oder konnte bisher) +<span style="color:#aa0000">nicht</span> (den früheren) +<span style="color:#aa0000">„<acronym>ASCII</acronym>“-Kommentar</span> verwenden, +der Kommentar muss vielmehr als „LaTeX-Input“ +mit <span style="color:#aa0000">typografischen Zeichen</span> und +LaTeX-<span style="color:#aa0000">Markup</span> +in der <span style="color:#aa0000">Code+Kommentar</span>-Quelldatei stehen +(vgl. <code>ltxdoc</code>-Dokumentation zu <code>{oldcomments}</code>). +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000"><code>\DocInput</code></span><code>{⟨<i>c+k</i>⟩}</code></h2> +… (<span style="color:#aa0000"><code>doc</code></span>, <a href="http://ctan.org/pkg/gmdoc" target="_blank"><code>gmdoc</code></a>, …) +verarbeitet die <span style="color:#aa0000">Code/Kommentar mischende</span> Datei +<span style="color:#aa0000">⟨<i>c+k</i>⟩</span> 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 <span style="color:#aa0000"><code>\MakePercentIgnore</code></span> +vor <code>\input{⟨<i>c+k</i>⟩}</code> aus, Effekt wie +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput2"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">(<code>\DocInput</code>)</h2> +(Übertrag:) +<pre> + <code>\textit{dolce far niente:}</code> + <code>\begin{macrocode}</code> + <code>\relax</code> + <code>\end{macrocode}</code> + -- genug, +</pre> +… so kommt der <span style="color:#aa0000">Code</span> in eine +<span style="color:#aa0000">Listing</span>-Umgebung, der <span style="color:#aa0000">Rest</span> wird +<span style="color:#aa0000">„normal“</span> in LaTeX-Qualität gesetzt. +<p> +<span style="color:#aa0000">„Minimales Markup“</span> würde bedeuten, +dass man <span style="color:#aa0000">dasselbe</span> Ergebnis … + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-min"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Minimale“ Kennzeichnung</span> des Codes</h2> +<table width="420"><tr><td > +… statt mit +<pre> +% <code>\textit{dolce far niente:}</code> +% <code>\begin{macrocode}</code> + <code>\relax</code> +% <code>\end{macrocode}</code> +% -- genug, +</pre> +schon mit +<pre> +% <code>\textit{dolce far niente:}</code> + <code>\relax</code> +% -- genug, +</pre> +erhält. +Dies erreichen … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="docinput-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">„smartes“</span> <code>\DocInput</code></h2> + +– <span style="color:#aa0000">Algorithmus</span> 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> +(<span style="color:#aa0000">Grzegorz Murzynowski</span>; +<span style="color:red">ich meine mich zu erinnern:</span><br> +wie bei <code>wiki.sty</code> sind die +<span style="color:#aa0000">Zeilenendzeichen aktiv</span><br> +und schauen sich den nächsten Zeilenanfang an) + </li> + <li><a href="http://ctan.org/pkg/lineno" target="_blank"><code>lineno</code></a> (<span style="color:#aa0000">Stephan Böttcher</span>) +– 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><span style="color:#aa0000">makedoc</span>.sty</code> (selbst) bietet statt awk + +eine Art TeX-basierte Skriptsprache und unterschiedliche +<span style="color:#aa0000">Zeilenparser</span>,<br> +um jeweils eine Dokumentationsdatei zu erzeugen. + +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="kommentarz-kombi"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">„Interpretationen“</span> von Kommentarzeichen</h2> + +<table width="560"><tr><td > +<span style="color:#aa0000">echter</span> Kommentar vs. <span style="color:#aa0000">„Auskommentieren“</span>, +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> +<span style="color:#aa0000">ergibt</span> 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 <span style="color:#aa0000">„Stile“</span>, +etwa Pakete <span style="color:#aa0000">anderer</span> Autoren, die +<span style="color:#aa0000">keine „<code>%%</code>“</span> verwenden +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-input"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000"><code>makedoc</code></span>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 <span style="color:#aa0000">Skriptbefehle</span> +unterstützen unterschiedliche <span style="color:#aa0000">Dokumentationsstile</span> +(Übersicht: +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/doc/mdoccheat.pdf" target="_blank"><tt>mdoccheat.pdf</tt></a>).<br> +<p> +c+k-Dateien werden mit <code>makedoc</code> <em>nicht direkt</em> eingelesen. +<br>Die Hauptdatei +<ol> + </li> + <li><span style="color:#aa0000">erzeugt</span> aus (je)der c+k-Datei eine +<span style="color:#aa0000">Dokumentationsversion</span> +(<span style="color:#aa0000">„<code>.txt</code>→<code>.tex</code>“</span>, +Einfügen von „<span style="color:#aa0000">Listing</span>-Wrappern“, +<span style="color:#aa0000">Zeichenkettenersetzungen</span> +für <span style="color:#aa0000">Gliederung</span> und <span style="color:#aa0000">typografische Zeichen</span>, +dazu Datei +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/use/mdoccorr.cfg" target="_blank"><tt>mdoccorr.cfg</tt></a>/<a href="http://mirror.ctan.org/info/fifinddo-info/mdoccorr.pdf" target="_blank"><tt>mdoccorr.pdf</tt></a>, + </li> + <li>liest und <span style="color:#aa0000">setzt</span> die erzeugte Datei dann als +<span style="color:#aa0000"><code>.tex</code>.</span> +</li></ol> + +<span style="color:#aa0000">Genauer</span> … +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="makedoc-lauf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Dokumentationslauf</h2> +[Genauer] … <span style="color:#aa0000">kompiliere</span> +ich typischerweise die Dokumentation +<ol> + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">pdf</span></code> von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code>. + </li> + <li><code>⟨<i>job</i>⟩.<span style="color:#aa0000">tex</span></code> +enthält <code>makedoc</code>-Befehle +zur Erzeugung von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code> aus +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">sty</span></code> und zum Einlesen von +<code>⟨<i>job</i>⟩.<span style="color:#aa0000">doc</span></code>, + </li> + <li>kann noch Dokumentation von +<span style="color:#aa0000">Ergänzungspaketen</span> +⟨<i>add</i>⟩ via +<code>⟨<i>add</i>⟩.<span style="color:#aa0000">doc</span></code> einbinden. + </li> + <li><code>⟨<i>job</i>⟩<span style="color:#aa0000">.doc</span></code>/<code>⟨<i>add</i>⟩<span style="color:#aa0000">.doc</span></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 +<span style="color:#aa0000"><code>\input</code></span> eingelesen werden. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="erfolg"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center">Erfolge/Scheitern</h2> + +<ol> + </li> + <li>Ich kann damit <span style="color:#aa0000">flott</span> +Pakete schreiben/dokumentieren<br> +(auch mit <span style="color:#aa0000">Dokumentation</span> als +<span style="color:#aa0000">„<a href="http://de.wikipedia.org/wiki/Roadmap" target="_blank">Roadmap</a>“</span> beginnen). +<br> +<em>Nach</em> Einrichten des +Dokumentations-<span style="color:#aa0000">Workflows</span><br> +läuft mittlerweile meist alles <span style="color:#aa0000">„wie am Schnürchen“.</span> + </li> + <li> +<span style="color:#aa0000">Einrichten</span> eines solchen Workflows +war aufwändig,<br>dafür jetzt <span style="color:#aa0000">Vorlagen</span> +sowie <span style="color:#aa0000">Bash</span>- und +<span style="color:#aa0000"><code>fifinddo</code>-Skripts</span>. + </li> + <li><span style="color:#aa0000">Fehler</span> wegen Umwegs über +<span style="color:#aa0000">erzeugte</span> Dateien<br> +(mehr Zeilen als in Quelldatei) +manchmal <span style="color:#aa0000">schwer verständlich</span> … + </li> + <li> +In der <span style="color:#aa0000">Praxis</span> kann ich (derzeit) +doch <span style="color:#aa0000">LaTeX-Befehle</span><br> +(Backslashs, …, vgl. <a href="#minimal-mehr">Vorgabe</a>) +<span style="color:#aa0000">nicht</span> ganz <span style="color:#aa0000">vermeiden</span>,<br> +wohl vor allem bei <span style="color:#aa0000">Verweisen</span> … + </li> + <li>Dennoch gelungene <span style="color:#aa0000">„Fremddokumentationen“:</span><br> +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/arseneau.pdf" target="_blank"><tt>arseneau.pdf</tt></a>, +<a href="http://mirror.ctan.org/macros/latex/contrib/nicetext/demo/substr.pdf" target="_blank"><tt>substr.pdf</tt></a>. +</li></ol> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="catcodes"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Vorteile und Problematik der <span style="color:#aa0000">Zeichenkategorien</span> (<code>\catcode...</code>)</h2> +<table width="560"><tr><td > +<ol> + </li> + <li>für <span style="color:#aa0000">Dokumentation</span>svorverarbeitung +Einlesen als <span style="color:#aa0000">„reinen Text“</span> +(<code>\dospecials</code> <span style="color:#aa0000">„<code>other</code>“</span>) + </li> + <li><span style="color:#aa0000"><code>\PatternCodes</code></span> für Ersetzungsregeln +anzupassen + </li> + <li><code><span style="color:#aa0000">blog</span>.sty</code> (<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel) +nutzt dagegen „minimale“ <span style="color:#aa0000">TeX-Syntax</span>, +<span style="color:#aa0000">expandiert</span> Makros zu <span style="color:#aa0000"><acronym>HTML</acronym></span>-Code +(Hauptdatei „<code>makehtml.tex</code>“ o. ä. +wandelt ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.tex</code></span> +zeilenweise +in ⟨<i>job</i>⟩<span style="color:#aa0000"><code>.html</code></span> um). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="teil-10"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#bbccdd">Teil 10:</span> +<table width="" height="21" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +<span style="color:#aa0000">HTML</span> erzeugen</h2> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-statt-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><span style="color:#aa0000">Nutzen</span> von <acronym>HTML</acronym> (vs. <acronym>PDF</acronym>)</h2> +<table width="520"><tr><td > +<ol> + </li> + <li><span style="color:#aa0000">Internetauftritt/CMS</span> + </li> + <li>„Elektronischer <span style="color:#aa0000">Zettelkasten</span>“ +<ol type="a" + </li> + <li>Querverweise + </li> + <li>gegliederte/kommentierte <span style="color:#aa0000">Link-Sammlungen</span> + </li> + <li>Hervorhebung von <span style="color:#aa0000">Stichwörtern</span> +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 <span style="color:#aa0000">Lesefluss ohne Seiten</span>umbrüche,<br> +ohne problematische <span style="color:#aa0000">Zeilen</span>umbrüche + </li> + <li><span style="color:#aa0000">keine Arbeit mit Umbrüchen</span><br>(außer gedankliche Gliederung) + </li> + <li><span style="color:#aa0000">Bildschirmfläche</span> voll nutzen +</li></ol> +</td></tr></table> +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-alt"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"> +<h2 align="center"><span style="color:#aa0000">HTML</span>-Erzeugung – <span style="color:#aa0000">Alternativen</span></h2> +<ul> + </li> + <li>HTML-Editoren, CMSe?; Formeln? keine Ahnung, <span style="color:red">egal</span> + </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"><span style="color:#aa0000">verarbeitet <code>.dvi</code></span></a>, kommt insofern (wohl) mit allen Paketen/Makros +zurecht, ohne sie einzeln zu behandeln +– damit <span style="color:#aa0000">Webseiten</span> pflegen<span style="color:red">?</span> + </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"><code>hevea.inria.fr</code></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"><code>tug.org/interest.html#web</code></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; +<span style="color:#aa0000">LaTeX</span>-Makros <span style="color:#aa0000">umdefiniert</span>, +<span style="color:#aa0000">neue</span> Makros für bestimmte +<span style="color:#aa0000"><acronym>HTML</acronym>-Strukturen</span>, z. B.<code><span style="color:#aa0000">lnavicol</span>.sty</code> +</li></ul> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="html-und-pdf"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center"><acronym>HTML</acronym> und <acronym>PDF</acronym> aus <span style="color:#aa0000">selber Quelle</span>?</h2> + +<table width="540"><tr><td > +<ol> + </li> + <li><code>\labelsection</code> etc. – <span style="color:#aa0000">„<code>htmlTeX</code>“</span><br> +(<span style="color:#aa0000"><acronym>HTML</acronym></span> regt zu Makros an, die <span style="color:#aa0000">auch</span> für +<span style="color:#aa0000"><acronym>PDF</acronym></span>-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><span style="color:#aa0000">texlinks</span>.sty</code> +(<a href="http://ctan.org/pkg/morehype" target="_blank"><code>morehype</code></a>-Bündel)<br> +bietet <span style="color:#aa0000">Beispiele</span> für <span style="color:#aa0000">Makros</span>, +die <span style="color:#aa0000">gleichermaßen</span> +<ul> + </li> + <li>für <span style="color:#aa0000"><code>hyperref</code>/<acronym>PDF</acronym></span> + </li> + <li>wie für <span style="color:#aa0000"><acronym>HTML</acronym></span>-Erzeugung mit +<code><span style="color:#aa0000">blog</span>.sty</code> +</li></ul> +geeignet sind +(fußen auf wenigen +„<a href="http://de.wikipedia.org/wiki/Pivot" target="_blank">Pivot</a>/<a href="http://de.wikipedia.org/wiki/Angelpunkt" target="_blank">Angelpunkt</a>“-Makros +wie etwa <code>\href</code>,<br>nur ein solches für +<code>hyperref</code> vs. <code>blog</code> unterschiedlich zu definieren). +</li></ol> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="blog-probleme"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Was (zur Zeit) <em>nicht</em> geht</h2> +<table width="560"><tr><td > +(weil Makros <span style="color:#aa0000">nur expandiert</span> 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> + +<span style="color:#aa0000">Ausweg</span> 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 <span style="color:#aa0000">zeilenweise</span> erschwert auch Verteilen +von <span style="color:#aa0000">Makroargumenten über mehrere Zeilen</span> +(„Klammer rechtzeitig öffnen“). +Künftige Alternativen wären <a href="http://ctan.org/pkg/catchfile" target="_blank"><code>catchfile</code></a> +oder „bis zur nächsten leeren Zeile am Stück“ einlesen. +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +<hr> +<table cellpadding="0" cellspacing="0"> +<tr><td width="162"height="80"></td><td> +<a name="schluss"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a> +</td><td width="162"></td></tr><tr><td /><td height="440"align="center"> +<h2 align="center">Dank</h2> + +<table width="600"><tr><td > +<ul> + </li> + <li><code><span style="color:#aa0000">blog</span>.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 <span style="color:#aa0000">Einstieg</span> in <span style="color:#aa0000"><acronym>HTML</acronym></span> +verdanke ich in erster Linie meinem Bruder, +Rainer Lück (<a href="http://www.webdesign-bu.de" target="_blank"><code>www.webdesign-bu.de</code></a>) + </li> + <li>fürs <span style="color:#aa0000">Zuhören</span> <span style="color:#006600">[Zuschauen]</span> +</li></ul> +und <strong>nachträglich:</strong> +<ul> + </li> + <li>an <span style="color:#aa0000">Uwe Ziegenhagen</span> (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 <span style="color:#aa0000">Bernd Raichle</span> für Hinweis auf +<span style="color:#aa0000">Kees van der Laan</span>s (NTG) Arbeiten über +„minimales Markup“, + </li> + <li>„<span style="color:#aa0000">technischen</span> Helfern“ +(Kabel/<a href="http://www.x.org/wiki/Projects/XRandR" target="_blank"><code>xrandr</code></a>)! +</li></ul> +</td></tr></table> + +</td><td /></tr> + <!-- bottom margin --> + <tr valign="top"><td /> +<td align="center"><a href="#START"> +<table width="668" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> +<td><a href="#inhalt"> +<table width="162" height="80" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> +</tbody></table> +</a></td> </tr> +</table> +</body></html> + |