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 |
Initial commit
Diffstat (limited to 'info/fifinddo-info')
27 files changed, 34934 insertions, 0 deletions
diff --git a/info/fifinddo-info/LIESMICH.txt b/info/fifinddo-info/LIESMICH.txt new file mode 100644 index 0000000000..e1553e2816 --- /dev/null +++ b/info/fifinddo-info/LIESMICH.txt @@ -0,0 +1,48 @@ + + LIESMICH.txt fuer `fifinddo-info' + (C) Uwe Lueck 2011/10/16 + + +Die Datei `dantev45.htm' ist eine "HTML-Beamer-Praesentation" ueber + + "Paketdokumentation und Webseitenpflege (HTML-Erzeugung) + mit (`niceverb.sty' und) `fifinddo.sty'" + +- ueberarbeitete Fassung meines Vortrags auf der +DANTE-Herbsttagung 2011, zu oeffnen mit einem Webbrowser. +In der zweiten Zeile mit "START" sollte die Gebrauchsanleitung +zu finden sein. + +`dante-mv45-lueck.pdf' ist ausserdem eine Zusammenfassung. + +`dantev45.htm' und die uebrigen Dateien dienen auch als Beispiel +fuer das im `morehype'-Buendel (http://ctan.org/pkg/morehype) +enthaltene und dort in `blog.pdf' beschriebene Paket `blogdot.sty' +fuer "HTML-Beamer-Praesentationen". + +Im Verzeichnis `variants' finden sich Versionen der Datei fuer +unterschiedliche Bildschirme und Browser. Die Zahl im Dateinamen +ist die Breite der "Folien" in Pixeln ("geraten" fuer +Bildschirmbreiten 800 und ca. 1200). "exact" bedeutet genaue +Abstimmung fuer die angegebene Breite und einen Schirm der Hoehe +600 fuer die Browser Firefox, Google Chrome und Opera. "com" +sollte auch mit Internet Explorer und breiteren Schirmen gut +aussehen und (halbwegs) funktionieren. "frame" sollte auf einem +groesseren Schirm die Abmessungen fuer einen kleineren durch einen +Rahmen sichtbar machen. "show" zeigt die Randgrenzen und (evtl.) +den sonst unsichtbaren Fuelltext (fuer "filltype" und "com", +siehe `\FillBlogDotTypeArea' in der Dokumentation von `blogdot'). +"clean" bedeutet, dass kein Fuelltext verwendet wird. + +Die Dateien unterliegen der LaTeX Project Public License ab v1.3c: + + http://www.latex-project.org/lppl.txt + +Eine TDS-Version ist + + http://mirror.ctan.org/install/info/fifinddo.tds.zip + +Bemerkungen erbitte ich unter + + http://www.contact-ednotes.sty.de.vu + diff --git a/info/fifinddo-info/README b/info/fifinddo-info/README new file mode 100644 index 0000000000..6f61fb5cf9 --- /dev/null +++ b/info/fifinddo-info/README @@ -0,0 +1,49 @@ + + README for `fifinddo-info' + (C) Uwe Lueck 2011/10/23 + +Here you find (i) files (in `source/') that demonstrate making +an "HTML beamer presentation" with `blogdot.sty' from the +`morehype' bundle (described in `blog.pdf'), (ii) a German +sketch of package documentation and HTML generation based on +`fifinddo.sty' (`nicetext' bundle): `dantev45.htm' +(cf. `LIESMICH.txt'). + +TRYING the presentation: open `dantev45.htm' with a browser, +click on "START", later click on screen bottom for next view +or on lower right corner of screen for the overview. With MSIE +however, this does not work, find something to click at right +below the text. + +VARIANTs: dantev45.htm is a "compromise" version of the +presentation. Directory `variants' contains versions for different +screens and browsers, exemplifying "recompilation" according to +the `blogdot' documentation. + +KEYWORDs: beamer presentations, literate macro programming, HTML; +font selection, lists, punctuation, quotation, spacing, +text decoration, computer text/verbatim text. + +The files can be redistributed and/or modified under the terms +of the LaTeX Project Public License; either version 1.3c of the +License, or any later version, see + + http://www.latex-project.org/lppl.txt + +We did our best to help you, but there is NO WARRANTY. + +The CTAN directory `/info/fifinddo/' is author-maintained in the +sense of this license. + +The latest public version of the package is available at + + http://mirror.ctan.org/info/fifinddo/ + +A TDS version of the package is available as + + http://mirror.ctan.org/install/info/fifinddo.tds.zip + +Please report bugs, problems, and suggestions via + + http://www.contact-ednotes.sty.de.vu + diff --git a/info/fifinddo-info/dante-mv45-lueck.pdf b/info/fifinddo-info/dante-mv45-lueck.pdf Binary files differnew file mode 100644 index 0000000000..7f4710a8a0 --- /dev/null +++ b/info/fifinddo-info/dante-mv45-lueck.pdf diff --git a/info/fifinddo-info/dantev45.htm b/info/fifinddo-info/dantev45.htm new file mode 100644 index 0000000000..a629d5fa31 --- /dev/null +++ b/info/fifinddo-info/dantev45.htm @@ -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/mdoccorr.pdf b/info/fifinddo-info/mdoccorr.pdf Binary files differnew file mode 100644 index 0000000000..db0f90671b --- /dev/null +++ b/info/fifinddo-info/mdoccorr.pdf diff --git a/info/fifinddo-info/source/SrcFILEs.txt b/info/fifinddo-info/source/SrcFILEs.txt new file mode 100644 index 0000000000..ebb62ca7f3 --- /dev/null +++ b/info/fifinddo-info/source/SrcFILEs.txt @@ -0,0 +1,25 @@ + + *File List* + MakeONE. + makedot.tex 2011/10/25 blogdot driver (UL) +dantev45.fdf 2011/10/22 blogdot settings for dantev45 +dantev45.tex 2011/10/25 DANTE Herbst '11 +MOREHYPE. +texlinks.sty 2011/10/21 v0.5 TeX-related links (UL) + blog.sty 2011/10/22 v0.62 simple fast HTML (UL) + blogdot.sty 2011/10/22 v0.4 HTML presentations (UL) + lang-de.fdf 2011/09/24 German settings for blog.sty + texblog.fdf 2011/10/24 extra blog settings + blogdot.cfg 2011/10/21 local blogdot.sty config +MakeVARs. +makedots.tex 2011/10/25 blogdot variants driver (UL) +dantev45.cfg 2011/10/23 local blogdot.sty config +MakeELSE. + expose.tex 2011/09/04 +mdoccorr.tex 2011/10/22 documenting mdoccorr.cfg +srcfiles.tex 2011/10/23 file infos -> SrcFILEs.txt + *********** + + List made at 2011/10/25, 10:34 + from script file srcfiles.tex + diff --git a/info/fifinddo-info/source/makeelse/expose.tex b/info/fifinddo-info/source/makeelse/expose.tex new file mode 100644 index 0000000000..c5e0085138 --- /dev/null +++ b/info/fifinddo-info/source/makeelse/expose.tex @@ -0,0 +1,94 @@ +\def\exposedate{2011/09/04} +\ProvidesFile{expose.tex}[\exposedate] +\documentclass[a4paper,11pt]{article} +\usepackage{german} +\newcommand*{\DQ}[1]{"`#1"'} +\usepackage{parskip} +\parskip=.84\parskip +\usepackage[atari]{umlaute} +\input{makedoc.cfg} +\providecommand{\pkg}{\pkgnamefmt} +\providecommand{\code}{\texttt} +\title{Paketdokumentation und Webseitenpflege\\ + mit (\pkg{niceverb.sty} und) \pkg{fifinddo.sty}} +\author{\acro{DANTE}-Herbsttagung 2011\\Uwe Lck} +\date{Entwurf \exposedate} +\begin{document} +\maketitle +\thispagestyle{empty} + +Das 'nicetext'-Bndel\urlpkgfoot{nicetext} +versucht sich an +\wikideref{Syntaktischer Zucker}{\strong{% + \DQ{syntaktischem Zucker}}:} +Schriftsatz in \TeX-Qualit„t +bei m”glichst wenig \TeX-artiger Auszeichnung. +% Grunds„tzlich sehe ich dafr zwei Methoden: +Das kann durch +(MS)~Zeichenkettenersetzung %%%, +oder (auch) durch +(MA)~aktive Zeichen +(die einige Fallunterscheidungen ausfhren) %%%. +% Sie schliežen sich keineswegs gegenseitig aus. +% Die praktische Bedeutung des Bndels liegt fr mich zur Zeit +% ganz in der Paketdokumentation. +erreicht werden. + +Die \DQ{herrschende Lehre} fr die \strong{Dokumentation} von \LaTeX-Paketen +ist die \DQ{\file{.dtx}}-Methode, die z.\,B. eine spezielle +Markierung des Paketcodes erfordert. +'makedoc.sty' aus dem 'nicetext'-Bndel dagegen +setzt die gute alte Idee um, dass man Kommentarzeilen schon +% dadurch dadurch von Codezeilen unterscheiden kann, +% dass erstere mit einem Kommentarzeichen (\lq\code{\%}\rq) beginnen! +am Kommentarzeichen (\lq`%'\rq) erkennt! + +Mit derselben Absicht verwendete Stephan B”ttcher die +\strong{Skriptsprache} \meta{\Wikideref{awk}} +% fr die Dokumentation von +zur Kommentierung von 'lineno.sty'.\urlpkgfoot{lineno} +'makedoc.sty' bietet % dem gegenber +stattdessen eine Skriptsprache, % deren Interpretationsengine +die wie bei 'docstrip.tex'\urlpkgfoot{docstrip} +durch die \TeX-Engine selbst verarbeitet wird, +zusammen mit besonderen Makros. +'makedoc' wandelt die Paketdatei in eine Dokumentationsdatei um, +indem Kommentarzeichen entfernt und Codezeilen in Listing-Umgebungen +eingebettet werden. Bei dieser Gelegenheit kann auch gem„ž Methode (MS) +\TeX-Code fr typografische Feinheiten eingefgt und die +\Wikideref{MediaWiki}-\wikideref{Hilfe:Inhaltsverzeichnis}{Gliederung} +umgesetzt werden. + +'niceverb.sty' (ebenfalls in 'nicetext') % bietet weitere Feinheiten +erm”glicht weiter +nach der Methode (MA) +% fr +eine geradezu \acro{WYS\-I\-WYG}-artige \strong{Syntaxbeschreibung} +fr Paketmakros. \linebreak +% Sogar Pakete anderer Autoren (z.\,B. Donald Arseneau) +% k”nnen in \TeX-Qualit„t aus der reinen ASCII-Dokumentation +% in der Paketdatei gesetzt werden, ohne Žnderungen an dieser Datei +% vorzunehmen. +% Bei eigenen Paketen erfordert die Kommentierung +% wenig mehr Aufwand als Kommentarzeichen, und der Kommentarcode +% ist so leserlich wie berhaupt nur m”glich. +Makros k”n\-nen \DQ{im Handumdrehen} kommentiert werden. +% (oder man schreibt zuerst den Kommentar als Plan)~\dots +Vorhandene \linebreak +\acro{ASCII}-Dokumentation kann \DQ{automatisch} +in \TeX-Qualit„t gesetzt werden. + +% \enlargethispage{1\baselineskip} + +'makedoc.sty' erweitert die \TeX-Skriptsprache aus 'fifinddo.sty' +zum Verarbeiten von Text-Dateien zu Text-Dateien. +'blog.sty' aus dem \ctanpkgref{morehype}-Bndel +setzt ebenfalls auf 'fifinddo' auf. +Im Gegensatz zu 'makedoc' werden dabei die Makros der Quelldateien +\emph{expandiert} -- in \strong{\acro{HTML}}-Tags und -Zeichen. + +Der Vortrag vergleicht diese Ans„tze mit denen +\httpref{www.webdesign-bu.de/uwe\string_lueck/heyctan.htm\#mine-related} + {\strong{anderer}} Autoren. + +\end{document} diff --git a/info/fifinddo-info/source/makeelse/mdoccorr.tex b/info/fifinddo-info/source/makeelse/mdoccorr.tex new file mode 100644 index 0000000000..5e2d7307ae --- /dev/null +++ b/info/fifinddo-info/source/makeelse/mdoccorr.tex @@ -0,0 +1,10 @@ +\ProvidesFile{mdoccorr.tex}[2011/10/22 documenting mdoccorr.cfg] +\RequirePackage{makedoc} +\documentclass{article} +\input{makedoc.cfg} +\begin{document} +\pagestyle{empty} +\hbox{}\kern-5\baselineskip +\MakeInputJobDoc[cfg]{0}{\ProcessInputWith{comment}} +\end{document} + diff --git a/info/fifinddo-info/source/makeelse/srcfiles.tex b/info/fifinddo-info/source/makeelse/srcfiles.tex new file mode 100644 index 0000000000..ea0d246b0d --- /dev/null +++ b/info/fifinddo-info/source/makeelse/srcfiles.tex @@ -0,0 +1,10 @@ +\RequirePackage{myfilist} +\ProvidesFile{srcfiles.tex}[2011/10/23 file infos -> SrcFILEs.txt] +\EmptyFileList %%% [readprov.sty,myfilist.sty] +\ReadFileInfos{MakeONE.,makedot,dantev45.fdf,dantev45} +\ReadFileInfos{MOREHYPE.} +\ReadPackageInfos{texlinks,blog,blogdot} +\ReadFileInfos{lang-de.fdf,texblog.fdf,blogdot.cfg} +\ReadFileInfos{MakeVARs.,makedots,dantev45.cfg} +\ReadFileInfos{MakeELSE.,expose,mdoccorr.tex,srcfiles} +\ListInfos[SrcFILEs.txt] diff --git a/info/fifinddo-info/source/makeelse/updsfl.sh b/info/fifinddo-info/source/makeelse/updsfl.sh new file mode 100755 index 0000000000..5dba87c025 --- /dev/null +++ b/info/fifinddo-info/source/makeelse/updsfl.sh @@ -0,0 +1,8 @@ +## This script updates SrcFILEs.txt by creating dummy files +## for srcfiles.tex which it then runs -- U.L. 2011/10/25. +echo \\ProvidesFile{MakeONE.}[] > MakeONE. +echo \\ProvidesFile{MOREHYPE.}[] > MOREHYPE. +echo \\ProvidesFile{MakeVARs.}[] > MakeVARs. +echo \\ProvidesFile{MakeELSE.}[] > MakeELSE. +latex srcfiles.tex +rm *. diff --git a/info/fifinddo-info/source/makeone/dantev45.fdf b/info/fifinddo-info/source/makeone/dantev45.fdf new file mode 100644 index 0000000000..608d636fec --- /dev/null +++ b/info/fifinddo-info/source/makeone/dantev45.fdf @@ -0,0 +1,61 @@ +\ProvidesFile{dantev45.fdf}[2011/10/22 blogdot settings for dantev45] +\RequirePackage{blogdot} +% \renewcommand*{\leftpagemargin}{176} %% "theory" 2011/10/01 +%% wiki-listen: %% 2011/10/12 +\renewcommand*{\typeareawidth}{668} %% 2011/10/12 +\renewcommand*{\leftpagemargin}{162} %% 2011/10/12 +\renewcommand*{\typeareaheight}{440} +\renewcommand*{\bodybgcolor}{\#ffffff} +\renewcommand*{\pkgnamefmt}{\code} +\newcommand*{\section}{\cheading2} +%% 2011/10/22 making sure: +\usemirrorctan +\TryBlogDotCFG[dantev45] %% 2011/10/12 +%% The rest shouldn't be changed in recompiling: %% 2011/10/12 +\input{atari.fdf} +\input{lang-de.fdf} +\newcommand*{\labelsection}[1]{% + \nextnormalscreenpage{#1}\section} +\newcommand*{\labelcentersection}[1]{% %% 2011/09/25 + \nextcenterscreenpage{#1}\section} +\makeatletter %% TODO!? +%% Not used 2011/10/01: +% \newenvironment{maxitemize} +% {\textblock{\typeareawidth}% +% % <ul \@style{margin-left:0px}>% +% \itemize +% }{% +% % </ul>% +% \enditemize +% \endtextblock} +\newcommand*{\teilpage}[2]{% +% \labelcentersection{teil-#1} + \labelsection{teil-#1}%% 2011/10/11 + {\textcolor{\#bbccdd}{Teil #1:} + \vspace{21}% %% 2011/09/29 + #2}% +} +%% |\thesis{<label>}{<text>}| must be in a +%% |{theses}| environment +%% (TODO make package for more general use!): %% 2011/10/04 +\newenvironment*{theses} + {\startTable{\@cellpadding{9} + \@cellspacing{0}}} + {\endTable} +\newcommand*{\thesis}[2]{% + \TableRow{ thesis }{% +% \@style{margin:9px}% + \@valign@t + }% + \tablewidthcell{42px}{#1}% %% TODO generalize 2011/10/03 + \simplecell{#2}% + \endTableRow +} +\renewcommand*{\BlogDotRestart}{inhalt} +% \renewcommand*{\nextnormalscreenpage}{% +% \nextscreenpage{\@align@l}} %% 2011/10/11 +%% <- no difference, but still \@align@c differs +%% +%% 2011/10/05 getting around double quotes: +\newcommand*{\LucidaSans}{"Lucida Sans"} +\endinput diff --git a/info/fifinddo-info/source/makeone/dantev45.tex b/info/fifinddo-info/source/makeone/dantev45.tex new file mode 100644 index 0000000000..e0b9413761 --- /dev/null +++ b/info/fifinddo-info/source/makeone/dantev45.tex @@ -0,0 +1,1588 @@ +\ProvidesFile{dantev45.tex}[2011/10/25 DANTE Herbst \string'11] +\ifFillBlogDotTypeArea \comment{ \string"Kompromiss\string" mit + \string\FillBlogDotTypeArea\ }\fi +\CommentBlogDotWholeWidth +\head \charset{ISO-8859-1} %%% {utf-8} + \texrobots +% \stylesheet{all}{blogdot} + \begin{style}{all} + h1 { font-size: 42px; margin-bottom: 21px } + h2 { font-size: 30px; margin-bottom: 21px } + % h3 { font-size: 24px; } + % h4 { font-size: 21px; } + + td { +% font-family:Arial,Verdana,"Lucida Sans",sans-serif; + font-family:Arial,Verdana,\LucidaSans,sans-serif; %% 2011/10/05 + color:#000000; + font-size: 21px + } + + p { margin-bottom:0px } + dl, ol, ul { + padding-left: 1em; + margin-left: 1em; margin-top: 18px; margin-bottom: 18px; + vertical-align: middle; + } + dt { margin: 0px; margin-top: 18px; margin-bottom: 9px; padding: 0px } + li { margin: 0px; margin-top: 9px; margin-bottom: 9px; padding: 0px } + blockquote { margin-left: 2em } + pre { margin-left:2em; margin-top:0px } + + a:link { color:#0000d0; text-decoration:none; } + a:visited { color:purple; text-decoration:none; } + a:hover { color:blue; text-decoration:underline; } + a:active { color:blue; text-decoration:underline; } + \end{style} + \title{Dokumentation und HTML mit fifinddo} +\body +% \topofpage +% \deTeXtopofpage{| \Fileref{heyctan}~| \Fileref{texhax}} + \deTeXtopofpage{} +\endgraf + [\,\STS{big}{\strong{\autref{START}}}%%%\\~| %% big 2011/10/08 + \myalert{<<< zuerst klicken}, + \mystrong{dann auf Bildunterrand klicken} + \begin{small} + bzw. knapp unter Text (\wikideref{Internet Explorer}{MSIE}) + \end{small} + und rechts unten fr \ancref{inhalt}{"Rckkehr"}\\ + \begin{small} %% 2011/10/21 + \quad\pardash\myalert{more} about the present file on: + \CtanPkgRef{fifinddo-info}{CTAN} + \end{small} + \hrule +\quad \autref{teil-0}~| + \autref{titelerlaeut1}~| + \autref{titelerlaeut2}~| + \autref{titelerlaeut3}~| + \autref{interessant}~| + \autref{motive-t}~| + \autref{motive-p}~| + \autref{status}~| +\strong{\autref{inhalt}}\\%%%~| +\quad \autref{teil-1}~| + \autref{txt2tex}~| + \autref{txt2tex-trad}\\%%%~| +\quad \autref{teil-2}~| + \autref{typoz-latex}~| %% 2011/10/05 umgestellt + \autref{minimal-mehr}~| + \autref{typoz-bewert}~| + \autref{typoz-auto}~| + \autref{typoz-ctan}\\%%%~| +\quad \autref{teil-3}~| + \autref{wiki-markup}~| + \autref{wiki-listen}\\%%%~| +\quad \autref{teil-4}~| + \autref{implement}~| + \autref{implement-ms}~| + \autref{implement-ms2}~| + \autref{implement-ma}~| + \autref{implement-ma+}~| + \autref{implement-mas}\\%%%~| +\quad \autref{teil-5}~| + \autref{nicetext}~| + \autref{wiki}\\%%%~| %%% \autref{min-markup-doku}~| \autref{doku-format}~| +\quad \autref{teil-6}~| + \autref{niceverb}~| + \autref{syntax}~| + \autref{vert}~| + \autref{niceverb-noch}~| + \autref{niceverb-sim}\\%%%~| +\quad \autref{teil-7}~| %%% \autref{txt2tex-doku}~| + \autref{kommentar}~| + \autref{kommentarzw}~| + \autref{kommentarzwa}\\%%%~| +\quad \autref{teil-8}~| + \autref{kommentar-ignor}~| + \autref{kommentar-ignor-mehr}~| + \autref{docstrip}~| + \autref{kommentarzch}~| + \autref{ohne-docstrip}\\%%%~| +\quad \autref{teil-9}~| + \autref{doku-vor}~| + \autref{doku-doc}~| + \autref{docinput}~| + \autref{docinput2}~| + \autref{docinput-min}~| + \autref{makedoc-input}~| %% neu statt \autref{mdoccorr} 2011/10/05 + \autref{makedoc-lauf}~| %% neu 2011/10/06 + \autref{erfolg}~| %% ausgebaut 2011/10/05f. + \autref{catcodes}\\%%%~| \\ %% ausgebaut 2011/10/06 +\quad \autref{teil-10}~| + \autref{html-alt}~| + \autref{html-statt-pdf}~| + \autref{html-und-pdf}~| %% 2011/10/06 ausgebaut + \autref{blog-probleme}~| + \autref{schluss}\,] %% gekrzt 2011/10/05 + \hrule +\titlescreenpage +\heading1{\mystrong{Paketdokumentation}\\und + \mystrong{Webseitenpflege} mit\\ + (\pkg{\mystrong{niceverb}.sty} + und)\\\pkg{\mystrong{fifinddo}.sty}} +Uwe Lck +\vspace{18} +šberarbeitete Fassung des auf der\\ +\httpref{www.dante.de/events/mv45/Programm.html}{% + \acronym{DANTE}-Herbsttagung 2011}\\ +gehaltenen Vortrags +\vspace{18} +\Isodate\GenDate + +\teilpage{0}{šber den Vortrag} +\labelsection{titelerlaeut1}{% + \mystrong{Vortragstitel} bedeutet (I):} +\begin{description} + \ditem{"Paketdokumentation"} + \Endash Beschreibung von \LaTeX-Makro-Paketen, \dh +% bzw. der \mystrong{Syntax} einzelner \mystrong{Makros}, +% ihrer \mystrong{Argumente}, der \mystrong{Wirkung}~\dots%%%\\ + \begin{enumerate} + \item in "Schreibmaschinenschrift" (\mystrong{"verbatim"}) gesetzter + \mystrong{Paketcode} wechselt mit in \LaTeX-Qualit„t gesetztem + \mystrong{Kommentar} ab ("zeilenweise") + \item der \mystrong{Kommentar}text \mystrong{enth„lt} + "verbatim" gesetzten \TeX-\mystrong{Code} ("inline") + zur Bezugnahme\pardash insbesondere: + \item \mystrong{Gebrauchsanleitung}/Syntaxbeschreibung fr Nutzer: + \\\meta{\bdquo Tippt man} + \begin{quote} + \mystrong{% + \cs{foo\ast[\metavar{opt-arg}]{\metavar{mand-arg}}}}, + \end{quote} + \meta{so erh„lt man~\dots\ldquo} + \end{itemize} +\end{description} + +\labelcentersection{titelerlaeut2}{% + \mystrong{\ancref{START}{Vortragstitel}} bedeutet (II):} +\begin{textblock}{560} + \begin{description} + \ditem{"Webseitenpflege"} + \Endash "hochtrabend", zun„chst blož: \mystrong{\HTML}-Erzeugung + \Endash + \begin{itemize} + \item \mystrong{Internet}auftritt~(? + \wikideref{Content-Management-System}{CMS}? + \Endash \webdesignref{schreibt.html}{ja~\dots}) + \item bequeme \mystrong{Textformat}-Alternative zu \PDF~\dots + \\ + (Notizen zu \webdesignref{heyctan.htm}{Links}, + Beamer-Pr„sentation~\dots) + \end{itemize} + \end{description} +\end{textblock} + +\nextcenterscreenpage{titelerlaeut3} +\section{\mystrong{\ancref{START}{Vortragstitel}} bedeutet (III):} +\dots\ was haben \mystrong{Paketdokumentation} und +\mystrong{\HTML-Erzeugung} miteinander zu tun\mystrong{??} +\\\\ +(\Endash Zu \mystrong{\HTML-Paketdokumentationen} + \\habe ich es noch \mystrong{nicht} gebracht~\dots) + +\labelcentersection{interessant}{% + Vortrag \mystrong{interessant}~\dots} +\begin{textblock}{600} + \begin{enumerate} + \item wenn man als Makroprogrammierer + \pkg{\mystrong{doc}.sty} und \file{\mystrong{docstrip}.tex} + ("\file{\mystrong{.dtx}}~\dots") + zu aufw„ndig findet~\dots + \item wenn man \mystrong{\HTML} sch„tzt und \mystrong{\PDF} + vermeiden m”chte~\dots + \item wenn man \mystrong{Makro-\Wikideref{Denksport}} mag + \end{enumerate} +\end{textblock} + +\labelcentersection{motive-t}{Inhaltliche Motive} +\begin{textblock}{560} + \begin{enumerate} + \item \strong{"minimales Markup"}, + "\Wikideref{syntaktischer Zucker}" + (\LaTeX-\mystrong{Qualit„t} + \emph{m”glichst ohne} \LaTeX-\mystrong{Befehle}) + \item \strong{"Missbrauch"} von \mystrong{\TeX} + als "\mystrong{Skript}sprache" + \\ + (\dqtd{mit \TeX\ muss und will ich + \mystrong{keine andere} Sprache lernen}; + \mystrong{statt} \PDF-\mystrong{Schriftsatz} + \Endash wie \ctanpkgref{docstrip}) + \item \mystrong{kleine}(?), einfache(?), experimentelle(!), + ("schrullige",) gerade eigenen (U.\,L.) Bedrfnissen + entsprechende \strong{Alternativen} zu existierenden + "professionelleren" Paketen + (\mystrong{Erfolge}\pardash Scheitern~\dots) +% \Endash gespannt auf \mystrong{Kommentare}.) + \end{enumerate} +\end{textblock} +% \begin{description} +% \ditem{"minimales Markup", "syntaktischer Zucker"} +% \begin{itemize} +% \item m”glichst wenig +% \end{itemize} +% \end{description} + +\labelcentersection{motive-p}{Pers”nliche Motive} +\begin{textblock}{424} %% aus 440 2011/10/15 +(bemerkenswerte \mystrong{Mischung} aus:) + \begin{enumerate} + \item gespannt auf \mystrong{Kommentare}\\zu \mystrong{meinen} Paketen, + \item Vortrag soll aber auch ber \mystrong{"Konkurrenzprodukte" informieren} + \item \mystrong{Irrtmer? Hinweise?} + \Endash \mystrong{Terminologie} erst in letzten zwei Wochen + "erarbeitet" + \item Vorstellung von \pkg{\mystrong{blogdot}.sty} + (\ctanpkgref{morehype}-Bndel) %% 2011/10/06 +% \item \wikideref{Worms}{Wormser} \wikideref{Nibelungenlied}{Rache} + \end{enumerate} +(und wohl auch ein wenig der beklagenswerten +\wikideref{Verfassung und Verfassungsvertrag\#Entstehung}{Eitelkeit}~\dots) +\end{textblock} +\labelcentersection{status}{\mystrong{Status}} +% mein erster Tagungsvortrag seit langem\vspace{9} +% Johannes Kster\vspace{9} %% Anregung "keine Zeit" ... 2011/10/03 +nicht richtig fertig, zu umfangreich, hasten, berspringen +\vspace{9} +kein Experte in Typografie, \HTML, \acronym{CSS} + +\labelcentersection{inhalt}{Vortragsteile} +\begin{textblock}{420} + \begin{enumerate} + \item \ancref{teil-1}{\mystrong{"Markup"?}}\pardash Terminologie + \item \ancref{teil-2}{\mystrong{"typografische Zeichen"}} + mit \TeX/\LaTeX + \item \ancref{teil-3}{\mystrong{"Formatierung"}} + \item \ancref{teil-4}{\mystrong{Implementierung}} + "minimalen Markups" "\mystrong{mit \TeX\ allein}" + \item \ancref{teil-5}{Paket\mystrong{dokumentation}} + \item \ancref{teil-6}{\pkg{\mystrong{niceverb}.sty}} + \item \ancref{teil-7}{"Kommentar"} + \item \ancref{teil-8}{Kommentar \mystrong{ausblenden}} + \item \ancref{teil-9}{% +% \mystrong{Vorverarbeitung}} +% von Code+Kommentar-Dateien + "Darstellung"} des Kommentars + \item \ancref{teil-10}{\mystrong{HTML}} erzeugen + \end{enumerate} +\end{textblock} + +\teilpage{1}{\mystrong{"Markup"} oder so + \vspace{18} + \small(Begriffskl„rung\pardash oder so)\endsmall} +\labelsection{txt2tex}{% + Von \file{.txt} zu \file{.tex}} +% \section{Typografische Erg„nzungen reinen Texts} +% \answer{worum man reinen Text erweitern muss, um typografische +% Qualit„t zu erhalten\pardash "minimal" sp„ter!} +Um \mystrong{reinen Text} in \mystrong{\LaTeX-Input} +(fr \LaTeX-Qualit„t) umzuwandeln, muss man normalerweise +Folgendes erg„nzen/„ndern: +% (Versuch~einer +% Unterscheidung und \mystrong{Terminologie}): +\begin{enumerate} + \item %%% \answer{automatische} + %%% \strong{"typografische Anreicherung"}, + %%% \file{.txt}\to\file{.tex}; + \strong{"\wikideref{Typografische Zeichen in HTML}{% + typografische Zeichen}"} + \Endash "typografische" Varianten von + \wikideref{Auslassungspunkte}{% + \mystrong{Auslassungspunkten}}, + \mystrong{Anfhrung}szeichen, + \mystrong{Leerzeichen}, + und \mystrong{Strichen}. + %%% \myalert{Beispiele} + %%% [space factor, Ellipse, geschtzte Leerzeichen, Festabst„nde, + %%% Gedankenstriche, Anfhrungszeichen] + %%% \answer{\pkg{easylatex} etc. + %%% (\webdesignref{heyctan.htm\#mine-related}{% + %%% mine-related}) + %%% bzw. zu \autref{implement}} + \item \strong{"\wikideref{Textformatierung}{% + Formatierung}"}\pardash Umschalten zwischen + \mystrong{Zeichens„tzen}, Einrcken, + \mystrong{Listen}, Verweise,\Dots +% \answer{\Endash durch spezielle einzelne Zeichen (statt +% Backslash~\dots) +% \Endash Wikipedia, Hervorhebungen nicht so wichtig?} +\end{enumerate} +% Begrndung: +\Endash \mystrong{Unterscheidung} nur \mystrong{HTML}-Terminologie? +\\ +\HTML\ verwendet fr \mystrong{ersten} Fall +spezielle \mystrong{Zeichen} wie +\code{\ } (anders als \cs{dots}), +\\ +fr \mystrong{zweiten} Einrahmung mit "Tags" wie +\code{\lt i\gt...\lt/i\gt} +(„hnlich~\LaTeX~\dots); oder~\dots +\vspace{9} +\begin{small} + \answer{dachte zun„chst, Wortsch”pfung sei meine eigene} +\end{small} + +% \answer{\dots\ vgl. +% \wikideref{Auszeichnungssprache\#Beispiele}{Wikipedia}} + +\labelcentersection{txt2tex-trad}{"Auszeichnung"} + \begin{textblock}{540} +"Traditionell" +\begin{itemize} + \item bezieht sich \mystrong{"Auszeichnung"} + \\ + (im "\Wikideref{Manuskript}"/\Wikideref{Typoskript}, + "Markup", + "\Wikideref{Schriftauszeichnung}"/\Wikideref{% + Auszeichnungssprache}) + \\ + anscheinend nur auf \strong{"Formatieren"} + \\ + (vielleicht weil der \mystrong{Setzer} das nicht "ahnen" + konnte), + \item w„hrend \strong{typografische Zeichen}varianten + \\ + fr den \mystrong{Setzer} eher "selbstverst„ndlich" waren + \\ + und im "Manuskript" \mystrong{nicht} besonders \mystrong{angezeigt} wurden. +\end{itemize} + \end{textblock} + +\teilpage{2}{\mystrong{Typografische Zeichen} mit \TeX/\LaTeX} +\labelcentersection{typoz-latex}{% + Typografische Zeichen mit \mystrong{\TeX/\LaTeX}} +% \begin{small} +% \answer{\Endash zur Erinnerung~\dots} +% \end{small} +% <p> +\begin{allrulestable}{8}{}%%%{612} + \begin{tablecoloredrow}{ typoz-latex }{\#eeefff} + \simplecell{\strong{Zeichen}} + \simplecell{\strong{realisiert durch}} + \end{tablecoloredrow} + \rowoftwocells{\mystrong{Auslassung}szeichen}{\cs{dots}} +% \starttr +% \tablewidthcell{200}{Auslassungspunkte} +% \tablewidthcell{412}{\cs{dots}} +% \simplecell{\cs{dots}} +% \endtr + \rowoftwocells{% + Gedanken-/"bis"-\mystrong{Strich}}{% + \dqtd{\code{---}} (englisch), + \dqtd{\code{--}}\pardash\mystrong{Ligaturen}} + \rowoftwocells{% + (Doppelte) \mystrong{Anfhrung}szeichen}{% +% \starttr +% \tablewidthcell{200}{(Doppelte) Anfhrungszeichen} +% \tablewidthcell{412}{% + Englisch: \mystrong{Ligaturen} \code{``...\texcs'\texcs'}; + \\ + Deutsch mit \code{(n)german.sty} oder \code{babel.sty} + \code{\texcs"`...\texcs"\texcs'} + \Endash \mystrong{aktive Zeichen}} +% \endtr + \rowoftwocells{% %% tiefer 2011/10/05 + Geschtztes~\mystrong{Leer}zeichen, Festabstand}{% + \dqtd{\texcs~} + \Endash\mystrong{aktives Zeichen}, \dqtd{\cs{,}}} + \rowoftwocells{% + Englisch: \mystrong{Leer}raum nach Satzzeichen}{% + \dqtd{\cs{ }} ("Steuerungsleerzeichen"), + \dqtd{\cs{@}}, \cs{sfcode`...}} +\end{allrulestable} + <p> +\begin{small} + \answer{"Aktive Zeichen" verhalten sich wie Makros, +% werden mit +% \cs{catcode...13} +% \cs{catcode`\texcs\~=13}} +% eingestellt. + \TeX book S.\,37 + } +\end{small} + +\labelcentersection{minimal-mehr}{Bewertung~\endash\\%%%Vertiefung + %%% von + \mystrong{"minimales Markup"} + genauer + } +\begin{textblock}{560} + \itqtd{\LaTeX-\mystrong{Qualit„t} + \emph{m”glichst ohne} \LaTeX-\mystrong{Befehle}}\\ + \Endash \file{README} des \ctanpkgref{nicetext}-Bndels: +% \begin{itquote} + \\\itqtd{m”glichst keine \mystrong{Zeichen} im Dokument\mystrong{quell}code, + \\die nicht auch \mystrong{gedruckt} werden!% + +% \end{itquote} + }\\ + \Endash schliežt \mystrong{"typografische Zeichen"} ein + \Endash Schw„che meiner (damaligen) Terminologie~\endash + \begin{enumerate} + \item \mystrong{weg} mit \mystrong{Backslash}s, + englischen \mystrong{Befehlen} und + geschwungenen \mystrong{Klammern!} %% ngneng 2011/10/03 + \item berhaupt m”glichst wenig Code-\mystrong{Zeichen} + \item Zeichen m”glichst \mystrong{intuitiv} + \item \dots\ am besten so \mystrong{aussehen wie Ergebnis} + \item \Endash \mystrong{"\acronym{ASCII-WYSIWYG}"} + \Endash vs.~\ctanpkgref{unisugar} mit Unicode~\dots + \end{enumerate} +\end{textblock} + +\labelcentersection{typoz-bewert}{%% center/textblock 2011/10/14 + Typografische Zeichen\pardash Bewertung} +\begin{textblock}{640} + \Endash von \ancref{typoz-latex}{\TeX/\LaTeX:} + \begin{enumerate} + \item \mystrong{\TeX-Ligaturen} schon ganz gut! + \item \mystrong{aktive Zeichen}\Dots na ja\Dots + \dqtd{\texcs~} besser als \dqtd{\code{\ }}, + aber~\dots + \item \mystrong{\cs{dots}} schon bel~\dots + (warum nicht \mystrong{Ligatur} \dqtd{\code{...}}?) + \end{enumerate} +\end{textblock} + +\labelsection{typoz-auto}{% + Typografische Zeichen \mystrong{automatisch?}} +\begin{enumerate} + \item \mystrong{automatische} Umwandlung "reiner" Zeichen + in "typografische"?\\ + \item \mystrong{\cs{sfcode`A=999}} schon in diese Richtung + (\TeX book~S.\,76) + \item so ja optional \mystrong{Anfhrungszeichen} in + \mystrong{\meta{Word}} + \item \dots\ \emph{\mystrong{und hier}} \comment{ texblog.fdf } + \Endash simpel, solange nicht \pkg{german}/\pkg{babel}~\dots: + \\\code{\texcs"...\texcs"} expandiert zu + \cs{glqq...}\cs{grqq} oder so + \item eigentlich \emph{nur dies} + (automatisches Einfgen typografischer Zeichen) + \mystrong{"\code{.txt\to.tex}"} + in \ctanpkgref{nicetext}-Beschreibung + (Schw„che der Terminologie) + \item \emph{WARNUNG!} \mystrong{fehlerhafte} Automatisierung + typografischer \mystrong{Anfhrungszeichen} kann zum Verlust + des \ancref{motive-p}{\mystrong{Doktortitels}} + und politischer Žmter fhren! + (\pkg{gutten.sty}) + \vspace{9} + \begin{small} + \answer{\,\zB\ \pkg{german.sty} nicht geladen, + \cs{glqq}, \cs{grqq} nicht definiert, + Fehlermeldungen ignoriert\,} + \end{small} +\end{enumerate} + +\labelsection{typoz-ctan}{% + \mystrong{\file{.txt}\to\file{.tex}} \emph{vor} \pkg{nicetext}} +\Endash auf CTAN: +\begin{enumerate} + \item \ctanpkgref{txt2latex} kleines + \Wikidedisambref{Perl}{Programmiersprache}-Skript, + wandelt gerade \mystrong{\TeX s spezielle Zeichen} + ("\code{\&}" etc.), \mystrong{\dqtd{\code{...}}} + und doppelte/einzelne \mystrong{Anfhrungszeichen} um + (s.~Datei + \ctanfileref{support/txt2latex}{txt2latex}) + \item \ctanpkgref{txt2tex}\pardash Perl, erzeugt tats„chlich + \LaTeX-\mystrong{Formatierung} (Paketnamen "verkehrt"!) + \item \CtanPkgRef{easylatex}{EasyLaTeX} „hnlich oder mehr, + \mystrong{GUI}(?), Ideen aus \mystrong{Wiki\dots-Markup}; + zuletzt 2004 (\file{README} 2009 eher CTAN-Hand) + \item \CtanPkgRef{smiletex}{SmileTeX} Windows \file{.exe}? + +~Werkzeuge fr Grafikeinbindung etc., + zuletzt 2004 +\end{enumerate} +\Endash fr \mystrong{Paketdokumentation} ist mir das zuviel~\dots + + +\teilpage{3}{\mystrong{"Formatierung"} + \vspace{18pt} + \small(Auszeichnung, Wikipedia)\endsmall} +\labelcentersection{wiki-markup}{% + \mystrong{Wikipedia}: Schriftauszeichnung} +\Endash Anregungen wie fr \ancref{typoz-auto}{\pkg{EasyLaTeX}}? + <p> +\begin{allrulestable}{8}{}%%%{610} +% \rowoftwocells{\strong{\mystrong{Wiki}-Code}}{% +% \strong{wie \mystrong{\LaTeX}-Code}} + \begin{tablecoloredrow}{ wiki-markup 1 }{\#eeefff} + \simplecell{\strong{\mystrong{Wiki}-Code}} + \simplecell{\strong{wie \mystrong{LaTeX}-Code}} + \end{tablecoloredrow} + \rowoftwocells{\code{ == šber ==}} {\cs{section{šber}}} + \rowoftwocells{\code{===~Unter~===}}{\cs{subsection{Unter}}} + \rowoftwocells{\code{% + \urlapostr\urlapostr\urlapostr + fett\urlapostr\urlapostr\urlapostr}}{% + \cs{textbf{fett}}} + \rowoftwocells{\code{% + \urlapostr\urlapostr kursiv\urlapostr\urlapostr}}{% + \cs{textit{kursiv}}} + \rowoftwocells{\code{% + \urlapostr\urlapostr\urlapostr\urlapostr\urlapostr + Fett-\urlapostr\urlapostr\urlapostr + Kur\urlapostr\urlapostr}}{% + \cs{textit{\cs{textbf{Fett-}}Kur}}} +\end{allrulestable} + <p> +\Endash \mystrong{Intuition} dahinter vielleicht: +Bedeutungen von \emph{kursiv} und\\ +\emph{doppelten Anfhrungszeichen} verwandt, +\zB\ Buchtitel + +\labelcentersection{wiki-listen}{% + \mystrong{Wikipedia}: Listen und Zitate} +\begin{allrulestable}{8}{}%%%{640} + \begin{tablecoloredrow}{ wiki-markup 2 }{\#eeefff} + \simplecell{\strong{\mystrong{Wiki}-}} + \simplecell{\strong{wie \mystrong{LaTeX}-Code}} +% \simplecell{} + \simplecell{\strong{\mystrong{Wiki}-}} + \simplecell{\strong{wie \mystrong{LaTeX}-Code}} + \end{tablecoloredrow} + \starttr + \simplecell{\code{\ast~Eins\\\ast~Zwei}} + \simplecell{\cs{begin{itemize}}\\ + \cs{item Eins}\\\cs{item Zwei}\\ + \cs{end{itemize}}} +% \simplecell{} +% \simplecell{\code{Er~nur:\\:Ja,~...}} + \simplecell{\code{Er~nur:\\:Ja,~\dots}} + \simplecell{\code{Er~nur:\\\cs{begin{quote}}\\ +% Ja,~...\\\cs{end{quote}}}} +% Ja,~\dots\\\cs{end{quote}}}} + Ja,~\cs{dots}\\\cs{end{quote}}}} + \endtr + \starttr + \simplecell{\code{# Eins\\# Zwei}} + \simplecell{\cs{begin{enumerate}}\\ + \cs{item Eins}\\\cs{item Zwei}\\ + \cs{end{enumerate}}} +% \simplecell{} + \simplecell{\code{Code:\\\enspace\cs{relax}}} + \simplecell{\code{Code:\\\cs{begin{verbatim}}\\ + \cs{relax}\\\cs{end{verbatim}}}}} + \endtr +\end{allrulestable} +\\ +\Endash immerhin recht \mystrong{"minimal"}, +auch halbwegs \mystrong{intuitiv.} +\vspace{9} +(vgl.~\ctanfileref{\ltxcontrib nicetext/doc}{% + wikicheat.pdf}) + +\teilpage{4}{\mystrong{Implementierung}\\"minimalen Markups" + \\"mit \mystrong{\TeX\ allein}"} +\labelsection{implement}{% + \mystrong{Implementierung}smethoden fr\\"minimales Markup" + mit \mystrong{\TeX}} +\begin{theses} + \thesis{(ML)}{\strong{Ligaturen}\pardash\dots + \\(nicht mein Ding, Zukunft ohne \acronym{METAFONT}?)} + \thesis{(MS)}{\strong{"Substitution"} bzw. \strong{"Skript"}, + genauer: \mystrong{Vorverarbeitung} der + \file{.tex}-Datei, + \mystrong{Zeichenkettenersetzung} + (und mehr) + %%% \\ %% rm. 2011/10/15 + per \wikideref{Skriptsprache}{Skript} + wie mit Perl~/ \wikideref{awk}{awk}~/~etc. + bzw. mit den \ancref{typoz-auto}{beschriebenen} + Paketen} + \thesis{(MA)}{\strong{("forschende") aktive Zeichen} + \Endash im \mystrong{"Schriftsatz-Modus"} + (w„hrend \TeX\ den Dokumentquelltext + stckweise in Glyphen und K„stchen umwandelt) + \mystrong{expandieren} aktive Zeichen mehr oder weniger + direkt zu \mystrong{"normalen"} \LaTeX-Befehlen, + \mystrong{"forschende"} aktive Zeichen + "\mystrong{erkunden} dabei ihre \mystrong{Umgebung}"} +\end{theses} + +\labelsection{implement-ms}{Methode (MS)\pardash Anmerkungen~I} + \TeX s %% apostrophe rm. 2011/10/03 + Mechanismus, sog. \mystrong{"begrenzte Parameter"} + von Makros zu erkennen + (\TeX book S.\,203), %% moved komma 2011/10/03 + bietet eine bequeme, aber auch "begrenzte" Methode, + \wikideref{Zeichenkette}{"Zeichenketten"} ("Strings") + zu erkennen\\(und zu \mystrong{ersetzen}). + \begin{enumerate} + \item Vor- und Nachteile entstehen daraus, dass + ein "String" aus "reinem Text" von \TeX\ intern + durch unterschiedliche \mystrong{"Token-Ketten"} "dargestellt" + werden kann. Auch von \mystrong{Grož-/Kleinschreibung} abzusehen + ist nicht ganz einfach. + \item Diese Methode wurde seit l„ngerem von \LaTeX's internem + \mystrong{\cs{@in}}-Makro + [haupts„chlich zur Erkennung von Paket-Optionen] + und vom Paket \mystrong{\ctanpkgref{substr}} + (Harald Harders bzw. Heiko Oberdiek) + angewandt. %%% angewendet. %% 2011/10/03 + \item Gegenw„rtig fužen auch \mystrong{\file{fifinddo.sty}} und + \mystrong{\file{makedoc.sty}} (\ctanpkgref{nicetext}) + auf dieser Methode\pardash gengte bisher \emph{praktisch}. + \end{enumerate} + +\labelsection{implement-ms2}{Anmerkungen zu (MS)~II + \\(\mystrong{String}s und \mystrong{Scripting} mit + \mystrong{\TeX})} +\begin{enumerate} + \item Die Pakete \ctanpkgref{stringstrings} (Steven Segletes), + \ctanpkgref{xstring} (Christian Tellechea, \CtanPkgRef{etex}{e-\TeX}) + und \ctanpkgref{ted} (Manuel P\'egouri\'e-Gonnard) liefern String-Funktionen + "auf h”chstem Niveau". + \item String-Funktionen finden sich auch in + \ctanpkgref{datatool} (Nicola Talbot), + \ctanpkgref{coolstr} (Nick Setzer) und + \ctanpkgref{texapi} (Paul Isambert). + \item Eine "ernsthafte \mystrong{Skriptsprache}" + bietet neben Zeichenersetzung + allgemeiner \mystrong{"Sortierung"} und \mystrong{"Filter".} + Beispielsweise bietet \ctanpkgref{docstrip} + eine \TeX-basierte Skriptsprache, + die aus einer \mystrong{\file{.dtx}-Quelldatei} + die \mystrong{"Kommentare" entfernt} + und den Rest in verschiedene + \mystrong{"kompakte" \TeX-Eingabedateien} "sortiert". +\end{enumerate} + +\labelsection{implement-ma}{"Minimales Markup"\\ + mit \mystrong{"forschenden" aktiven Zeichen} (MA)} +\mystrong{\pkg{wiki.sty}} aus dem \mystrong{\pkg{nicetext}}-Bndel +implementiert die \ancref{wiki-markup}{zuvor} beschriebene +\mystrong{Wikipedia}-Syntax fr \TeX, \dh\ mit \pkg{wiki.sty} +kann man in der \code{{document}}-Umgebung von \LaTeX +\begin{enumerate} + \item statt \mystrong{\cs{...section{...}}} einrahmende + \mystrong{Gleichheitszeichen}-Folgen verwenden, + \item \mystrong{Kursiv}- und \mystrong{Fett}schrift + mit Folgen von + \wikideref{Apostroph}{% + "\mystrong{Apostroph}-Ersatzzeichen"} + (ASCII-Code~39) ein- und abschalten, + \item \mystrong{Listen} und \mystrong{Blockzitate} + aus Menschen- oder Programmiersprache durch + spezielle \mystrong{Zeilenanf„nge} anzeigen. +\end{enumerate} + +\labelsection{implement-ma+}{\pkg{\mystrong{wiki}.sty}s + \mystrong{"forschende"} Zeichen} +\begin{enumerate} + \item \mystrong{Gleichheitszeichen} werden \emph{aktive} Zeichen, + die feststellen, wieviele Gleichheitszeichen unmittelbar + aufeinander folgen. + \item Ebenso funktionieren die \mystrong{Apostroph}-Ersatzzeichen. + Dabei werden \cs{textit} und \cs{textbf} nicht direkt + verwendet, das \mystrong{Umschalten} und die + \mystrong{Kursivkorrektur} + finden \mystrong{ohne} \mystrong{"Gruppenbildung"} statt. + \item Um \mystrong{Listen} und \mystrong{Zitate} am Zeilenanfang + zu erkennen, wird das \mystrong{Zeilenende}-Zeichen + (\code{^^M}) \mystrong{aktiv} und „ndert auch fr kurze Zeit + die Kategorie des Leerzeichens. + So analysiert \code{^^M} den Anfang der n„chsten Zeile + und kann feststellen, ob eine Liste bzw. ein Blockzitat + \mystrong{beginnt}, \mystrong{fortgesetzt} wird, oder + \mystrong{endet}, oder ob der Liste ein + \mystrong{weiterer Punkt} (\cs{item}) hinzugefgt wird. + Entsprechend wird automatisch eine + \cs{begin{...}}- bzw. \cs{end{...}}-Zeile oder das Makro + \mystrong{\cs{item}} eingefgt +\end{enumerate} + +\labelcentersection{implement-mas}{(MA) vs. (MS)} +\begin{textblock}{600} + Die Methoden \mystrong{(MA)} (aktive Zeichen) + und \mystrong{(MS)}\\(Substitution/Skript) + \mystrong{schliežen sich \emph{nicht} gegenseitig aus.} + \\Welche Methode man anwendet, + ist vielleicht "Geschmackssache". + Die \ancref{wiki-markup}{\mystrong{Wikipedia-Abschnittsberschrift}} + (Gleichheitszeichen) wird in + \file{\mystrong{wiki}.sty} nach Methode (MA),\\ + in \file{\mystrong{makedoc}.sty} nach Methode (MS) implementiert. +\end{textblock} + +\teilpage{5}{\mystrong{Dokumentation} von \LaTeX-Paketen + \vspace{18} + \small(mit \mystrong{\pkg{nicetext}})\endsmall} + +% \labelsection{min-markup-doku}{% +% \mystrong{"Minimales Markup"} in der Paket\mystrong{dokumentation} +% mit \pkg{nicetext}} +% +\labelcentersection{nicetext}{Die \mystrong{Pakete} %% center 2011/10/14 + des \mystrong{\pkg{nicetext}}-Bndels} +\begin{textblock}{600} %% aus 640 2011/10/15 + \begin{description} + \ditem{\pkg{wiki.sty}} + % Implementierung von + \mystrong{Wikipedia-Markup} gem„ž (MA) + (\ancref{implement-ma}{\so}) + \ditem{\pkg{niceverb.sty}} + \mystrong{"minimales Markup"}(?) speziell fr \mystrong{Beschreibung} + \\ %% 2011/10/15 + von \mystrong{\LaTeX-Makros} und \LaTeX-\mystrong{Paketen} + % in gewisser Weise auch "typografische Varianten" + % von ASCII-Zeichen, alles gem„ž + (MA) + \ditem{\pkg{makedoc.sty}} + % \mystrong{Skript}sprache fr die + \mystrong{Vorverarbeitung} von + % Dateien, die \mystrong{Code und Kommentar} ("gemischt") enthalten, + \mystrong{Code+Kommentar}-Dateien + % implementiert insbesondere + % \mystrong{Wikipedia-šberschriften}, alles + (MS) + \ditem{\pkg{mdoccorr.cfg}} + \mystrong{Regeln} zum Einfgen \mystrong{typografischer Zeichen} (MS) + \ditem{\pkg{fifinddo.sty}} + % allgemeine \mystrong{Skript}sprache, um \mystrong{aus Text}dateien + % andere \mystrong{Text}dateien zu \mystrong{erzeugen}, + % Grundlage fr \mystrong{\pkg{makedoc.sty}} + \mystrong{\pkg{makedoc.sty}} zugrundeliegende + \mystrong{Skript}sprache + \end{description} +\end{textblock} + +% \labelsection{doku-format}{% +% Paketdokumentation: \mystrong{Formatierung}} +% +\labelsection{wiki}{% + \pkg{\mystrong{wiki}.sty}} +% \begin{textblock}{480} + \begin{enumerate} + \item \ancref{implement-ma}{\mystrong{Schrift}kodierung} + durch \emph{Folgen} von \mystrong{Apostrophen} finde ich + \mystrong{nicht intuitiv genug}, + um andere Paketbearbeiter damit konfrontieren zu wollen, + \small\answer{Publikum (U.\,Z.): \Wikideref{Markdown}!}\endsmall + \item \dots\ sie ist gegenw„rtig auch \mystrong{inkompatibel} mit der + Verwendung "aktiver Apostrophe" in + \pkg{\mystrong{niceverb}.sty}. + \item \ancref{implement-ma}{\mystrong{šberschriften}kodierung} durch + \mystrong{Gleichheitszeichen} verwende ich bisher in der + (MA)-Implementierung von \pkg{\mystrong{makedoc}.sty}. + \item Dass \ancref{implement-ma+}{\mystrong{Einrcken}} eine + \mystrong{verbatim}-Umgebung ausl”st, finde ich + \mystrong{unpraktisch.} + \item Im Quelltext sehe ich lieber \mystrong{"1."}, \mystrong{"2."}, + \dots als "\code{\#}". + \\ + \small\answer{Publikum: \Wikideref{Markdown}!}\endsmall + \item \mystrong{Unnummerierte Listen} mit \texcs* sind + \mystrong{OK}, + habe ich mal fr \mystrong{"Fremddokumentation"} eingesetzt. + \end{enumerate} +% \end{textblock} + + +\teilpage{6}{\pkg{\mystrong{niceverb}.sty}} +\labelsection{niceverb}{% + \pkg{\mystrong{niceverb}.sty}\pardash "Schrift\mystrong{auszeichnung}"} + \wikideref{Definitionsmenge}{"Fortsetzung"} der + \ancref{wiki-markup}{\mystrong{Wikipedia}-Schriftauszeichnung:} +\begin{enumerate} + \item Umrahmung mit \mystrong{einfachen Apostroph}-Ersatzzeichen + (\code{'nicetext'}) %% verb->text 2011/10/08 + wirkt wie \mystrong{\cs{textsf}} + \Endash fr \mystrong{Paketnamen}. + \item \mystrong{einfache Anfhrung}szeichen + wirken wie \mystrong{\cs{texttt}} + \Endash fr \mystrong{Code} + \Endash tats„chlich wirkt \code{\lq\cs{foo}'} + (solange nicht in Makro-Argument) wie + \mystrong{\cs{verb}\code{+\cs{foo}+}} + (\mystrong{Inline-verbatim}). +% \item \mystrong{Vertikalstriche} (\code{|\cs{foo}|}) +% sollen \mystrong{Code} beim \mystrong{šberfliegen} der +% Dokumentation \mystrong{herausstechen} lassen +% ("hier Erl„uterung von \cs{foo}!") +% \Endash \mystrong{Farbhinterlegung}? derzeit +% \mystrong{"K„sten"} wie mit \cs{fbox}: +% \begin{quote} +% \allrulestable{2}{}\starttr +% \simplecell{\cs{foo}} +% \endtr\endallrulestable +% \end{quote} +% % Allerdings achte ich darauf, dass alle dieselbe +% % H”he haben und die Zeilenh”he und -tiefe nicht „ndern +% % (\cs{InlineCmdBox}). +% "Intern" wird zwischen \mystrong{\cs{VerticalCmdBox}} und +% \mystrong{\cs{InlineCmdBox}} +% (erm”glicht zusammenfassende Aufz„hlung von Makros +% in \emph{einem} Absatz) gew„hlt. +\end{enumerate} + \vspace{0} + <p \@align@c> +\begin{allrulestable}{8}{} + \begin{tablecoloredrow}{ wiki-markup 1 }{\#eeefff} + \simplecell{\strong{Code mit \mystrong{niceverb}.sty}} + \simplecell{\strong{wie Code \mystrong{sonst}}} + \end{tablecoloredrow} + \rowoftwocells{\code{'nicetext'}}{\cs{textsf{nicetext}}} + \rowoftwocells{\code{\lq\cs{foo}'}}{\cs{verb+}\cs{foo+}} + \rowoftwocells{\code{\lq README.txt'}}{\cs{texttt{README.txt}}} +\end{allrulestable} + </p> + +\labelcentersection{syntax}{\mystrong{Beschreibung} von \LaTeX-Makros} +\begin{textblock}{640} %% 2011/10/15 + \meta{\bdquo Tippt man} + \begin{verbatim} + \mystrong{% + \texcs\foo\ast[\metavar{opt-arg}]{\metavar{mand-arg}}} + \end{verbatim} + \meta{so erh„lt man~\dots\ldquo} + \Endash so soll die Beschreibung der \mystrong{Syntax} von + \mystrong{\cs{foo}} im \mystrong{\file{.pdf}} aussehen. + \endash %%% <p> + \mystrong{Code} dafr mit \pkg{\mystrong{niceverb}.sty}: + \begin{verbatim} + \mystrong{% + \lq\texcs\foo\ast[\lt opt-arg\gt]{\lt mand-arg\gt}\rq} + \end{verbatim} + % (mittlerweile auch mit \mystrong{Martin Scharrer}s \ctanpkgref{ydoc}, + % abgesehen von den \mystrong{Anfhrung}szeichen}). + \Endash \mystrong{"\acronym{ASCII-WYSIWYG}"} + %% <- mod. 2011/10/03 -> + \\\endash + \cs{langle} \mystrong{"typografisches"} "\code{\lt}", + \\\endash + \cs{rangle} "typografisches" "\code{\gt}". + % Im \mystrong{"Auto-Modus"} kann man die umrahmenden + % \mystrong{Anfhrung}szeichen + % \mystrong{weglassen! (Backslash aktiv)} + \\ + \endash %%% <p> + \mystrong{Code} dafr mit \pkg{\mystrong{doc}.sty} + (aus der \LaTeX-"base"-Distribution): + \begin{verbatim} + \mystrong{% + \texcs|\texcs\foo\ast[|% + \texcs\meta{opt-arg}|]{|% + \texcs\meta{mand-arg}|}|} + \end{verbatim} +\end{textblock} + +\labelsection{vert}{\mystrong{Hervorhebung} von + Makro\mystrong{beschreibungen}} +%% TODO Link weiter fkt. nicht mit Firefox im Internetshop 2011/10/12 +\mystrong{Vertikalstriche} (\code{|\cs{foo}|}) +\begin{itemize} + \item schalten im vorigen Beispiel (\pkg{\mystrong{doc}.sty}) + \endashed{wie es sehr \mystrong{blich} ist} + \mystrong{verbatim}-Modus an/aus, + \dh\ \mystrong{\code{|\cs{foo}|}} krzt + \mystrong{\cs{verb|}\cs{foo|}} ab~\endash + \item sollen mit \pkg{\mystrong{niceverb}.sty} + \mystrong{Code hervorheben} und + beim \mystrong{šberfliegen} der + Dokumentation \mystrong{herausstechen} lassen + (\itqtd{hier~Erl„uterung~von~\cs{foo}!}) +\end{itemize} +\Endash \mystrong{Farbhinterlegung}? derzeit +\mystrong{"K„sten"} wie mit \cs{fbox}, +% \begin{quote} +% \allrulestable{2}{}\starttr +% \simplecell{\cs{foo}} +% \endtr\endallrulestable +% \end{quote} +% Allerdings achte ich darauf, dass alle dieselbe +% H”he haben und die Zeilenh”he und -tiefe nicht „ndern +% (\cs{InlineCmdBox}). +% "Intern" wird zwischen \mystrong{\cs{VerticalCmdBox}} und +% \mystrong{\cs{InlineCmdBox}} +% (erm”glicht zusammenfassende Aufz„hlung von Makros +% in \emph{einem} Absatz) gew„hlt. +intern soll \cs{InlineCmdBox} zusammenfassende Aufz„hlungen von Makros +\emph{in einem Absatz} erm”glichen. \strong{Beispiel}~Code/Ergebnis: +\begin{verbatim} + |\texcs\foo\ast[\lt opt-arg\gt]{\lt mand-arg\gt}| +\end{verbatim} +\begin{quote} + \allrulestable{2}{}\starttr + \simplecell{% + \,\cs{foo\ast[\metavar{opt-arg}]% + {\metavar{mand-arg}}}\,} + \endtr\endallrulestable +\end{quote} + +\labelsection{niceverb-noch}{% + \pkg{\mystrong{niceverb}.sty} \mystrong{noch:}} +\begin{enumerate} + \item \mystrong{"\code{\lt meta\gt}"} erzeugt "\metavar{meta}" + \mystrong{sowohl} innerhalb \mystrong{als auch} + aužerhalb von einfachen Anfhrungszeichen. + \item Im \strong{"Auto-Modus"} werden \LaTeX-Befehle nicht + ausgefhrt, sondern als \mystrong{verbatim}-Text + interpretiert, etwa folgende Sterne und Klammern + als \mystrong{Syntaxbeschreibung} dazu. %% . 2011/10/03 + \item \Endash dient besonders + der \mystrong{"Fremddokumentation"} + (vorhandene \acronym{ASCII}-Paketdokumentation + anderer Autoren ohne Eingriff in \LaTeX-Qualit„t setzen). + \item "\code{\mystrong{\&}}" %% \mystrong 2011/10/08 + ist \mystrong{aktives Zeichen}, welches in + \mystrong{Makroargumenten} Befehlen und + Syntaxbeschreibungen vorangestellt werden kann, + um \mystrong{"nachzuhelfen"}: + \begin{verbatim} + \mystrong{% + \cs{footnote{\texcs&\texcs\foo\ast + [\lt opt-arg\gt]% + {\lt mand-arg\gt}}}} + \end{verbatim} + \item % Natrlich gibt es mit all diesen \mystrong{aktiven Zeichen} + % auch \mystrong{Probleme}, und \mystrong{Auswege} dazu~\dots + \mystrong{aktive Zeichen}~\to\ \mystrong{Probleme}~\dots + \mystrong{Auswege}~\dots +\end{enumerate} + +\labelsection{niceverb-sim}{\mystrong{Žhnliche} Pakete + \mystrong{anderer} Autoren} +% \\\answer{\pkg{ltxdoc.cls} +\begin{enumerate} + \item \pkg{\mystrong{niceverb}.sty} ist wesentlich inspiriert + durch die Dokumentationsmethode \mystrong{Stephan B”ttcher}s + in \CtanPkgRef{lineno}{\mystrong{lineno}.sty}. + \item Žhnliche Funktionalit„t liefert auch + \mystrong{\pkg{ltxguide.cls}} fr die "\LaTeX-Guides". + \item Die \ancref{syntax}{bequeme \mystrong{Syntaxbeschreibung}} + gibt es + ("mittlerweile") auch in \mystrong{Martin Scharrers} + \ctanpkgref{ydoc}. + \item \pkg{\mystrong{niceverb}.sty} ist ebenso wie + \pkg{\mystrong{ydoc}} als \strong{Alternative} + zu \pkg{\mystrong{doc}.sty} konzipiert. + \pkg{\mystrong{ydoc}} liefert dabei einen „hnlichen + \mystrong{Funktionsumfang} wie \pkg{\mystrong{doc}.sty}, + w„hrend \emph{ich} (fr meine Zwecke) + einen solchen Funktionsumfang berhaupt + \mystrong{nicht haben will.} + \Endash \mystrong{Allerdings} habe ich einzelne + \pkg{\mystrong{doc}.sty}-Funktionen in + \pkg{\mystrong{makedoc}.sty} und in + \pkg{\mystrong{readprov}.sty} + (\ctanpkgref{fileinfo}-Bndel). %% "Bndel" 2011/10/03 +\end{enumerate} + + +\teilpage{7}{"Kommentar"} +\labelsection{kommentar}{% + \mystrong{Code} und \mystrong{"Kommentar"}} +% "Perversion der \mystrong{Kommentarzeichen}"} +\small\answer{vgl. \Wikideref{Schuld und Shne}, + \Wikideref{Pride and Prejudice}, + \Wikideref{Gesetzeskommentar} zum + \Wikideref{Code civil}}\endsmall + <p> +\TeX\ bietet wie alle "normalen" Programmiersprachen die M”glichkeit, +\mystrong{in Quelldateien Text} einzufgen, der \mystrong{nicht} +vom Compiler bzw. Interpreter (als \mystrong{Befehle/Daten}) +verarbeitet werden soll, sondern an (menschliche) \mystrong{Leser} +gerichtet ist\pardash hier \mystrong{"Kommentar"}. +\\ %% 2011/10/15 +Einzelne \mystrong{Zwecke} +(der \wikideref{Kommentar (Programmierung)}{Wikipedia-Artikel} + weiž noch mehr~\dots): + +\labelcentersection{kommentarzw}{\mystrong{Zwecke} des Kommentars} +\begin{textblock}{576} %% 2011/10/15 + \begin{enumerate} + \item \strong{Erl„uterungen} fr \strong{Programmierer}, + um die \strong{Wartung} des Codes zu erleichtern~\endash + \item gerade im Falle von \mystrong{\TeX}- und \LaTeX-Paketen + (alter~Zeiten) %%% enth„lt/enthielt der "Kommentar" + an \strong{Nutzer} gerichtete \mystrong{"Erl„uterungen"} + im~Sinne einer \strong{Gebrauchsanleitung}\\ + (manchmal der einzig verfgbaren). %% Genitiv 2011/10/15 + \item In etwa gleichrangig %%% ist die + Bedeutung des \strong{"Auskommentierens"} von Code, + \dh %%% der + \mystrong{"Kommentar"}~enth„lt %%% in diesem Fall + eigentlich \mystrong{Befehle/Daten} fr %%% den + Compiler/Interpreter, die der \mystrong{Programmierer} + (oder~auch~Dokument\mystrong{autor}) %%% m”chte diesen + \mystrong{"aufbewahren"} m”chte statt v”llig zu + \mystrong{l”schen} %% <- 2011/10/15 -> +% \mystrong{Code nicht} ganz und gar \mystrong{l”schen}, +% sondern ihn \mystrong{"aufbewahren"~\dots} + \end{enumerate} +\end{textblock} + +\labelsection{kommentarzwa}{Zwecke des \mystrong{"Auskommentierens"}} +\begin{enumerate-a} + \item als eine Art \strong{"Versionskontrolle"}: + man \mystrong{beh„lt sich vor}, den~Code~sp„ter wieder + "an den Compiler/Interpreter zu richten" + (durch einfache Entfernung der + \Wikideref{Kommentarzeichen} bzw. + \mystrong{"Kommentarbegrenzern"}), + \zB\ zum "\Wikideref{Debugging}" + oder~fr~bestimmte Adressaten~\endash + \item als "Erinnerung" and frhere \mystrong{"Fehlversuche"}, + die auf frhere "šberlegungen" hinweist und so wieder + der \strong{Wartung} durch den Programmierer/Autor dient. +\end{enumerate-a} +Ich nehme an, bei vielen ist in der t„glichen Praxis mit \TeX/\LaTeX +das "Auskommentieren" die \strong{haupts„chliche} Funktion des +\mystrong{"Kommentars"}~\dots + + +\teilpage{8}{Methoden Kommentar \mystrong{"auszublenden"}} +\labelsection{kommentar-ignor}{% + \mystrong{Feinheiten} des \mystrong{"Ausblendens"}\\von Kommentar} +\begin{enumerate} + \item Enth„lt eine \mystrong{\TeX/\LaTeX-Paketdatei} + die \TeX-Anweisungen und gleichzeitig die \strong{Gebrauchsanweisung}, + so umfasst sie typischerweise wesentlich mehr + \mystrong{Kommentarzeilen} als \mystrong{Anweisungszeilen}. + \item Auch \strong{"Programmierertext"}, der die Implementierung + sorgf„ltig diskutiert, kann im Verh„ltnis zum Code sehr + umfangreich sein (\zB\ \pkg{\file{lineno}.sty}). + \item \mystrong{"Vor langer Zeit"} forderte das \strong{Einlesen} + von \TeX-Makrodateien aufgrund der "\mystrong{Hardware}-Umst„nde" + bereits so viel Zeit, dass es \mystrong{sinnvoll} war, + das Einlesen von Kommentarzeilen v”llig zu \strong{vermeiden}~\dots +\end{enumerate} + +\labelsection{kommentar-ignor-mehr}{% + \mystrong{"Ausblenden"} von Kommentar\pardash\mystrong{Forts.}~\dots} +\begin{enumerate} + \item Ein \mystrong{"primitiver" Ansatz} dazu war, + die \strong{"Gebrauchsanleitung"}\\ + "am Ende der Datei" \mystrong{nach} dem + \mystrong{\cs{endinput}}-Befehl der Datei + anzubringen. Die Datei enthielt dann gerne am + \mystrong{Anfang} den Hinweis auf die Gebrauchsanleitung + der Datei an ihrem \mystrong{Ende}.\\ + Der \cs{endinput}-Befehl bricht die Verarbeitung der Datei ab, + so dass die Zeilen darunter tats„chlich + keine Verarbeitungszeit mehr beanspruchen. + \item \mystrong{Andererseits} sollte fr die \strong{Wartung} + der Kommentar eben doch in der \mystrong{N„he} der + betreffenden Code-Zeilen angebracht werden~\dots +\end{enumerate} + +\labelsection{docstrip}{% + \pkg{docstrip} \mystrong{blendet} noch \mystrong{effizienter} aus:} + +\begin{enumerate} + \item Mit \mystrong{\LaTeX2} hatten \mystrong{Paket-Dateien} + die Endung \mystrong{"\file{.sty}".}\\ + Sie \mystrong{enthielten} noch \mystrong{"Kommentar"} wie oben. + \item Mit \mystrong{\LaTeX2e} wurden \pkg{\mystrong{doc}.sty} und + \pkg{\mystrong{docstrip}.tex} eingefhrt. + Dateien, die \mystrong{Code} und \mystrong{Kommentar + "gemischt"} enthielten, bekamen nun die Endung + \mystrong{"\file{.doc}"} oder \mystrong{"\file{.dtx}".} + \pkg{docstrip} wandelt solche Dateien in Dateien mit Endungen + haupts„chlich wie \mystrong{"\code{.sty}"} oder + \mystrong{"\code{.cls}"} um; + diese sollen \mystrong{keinen Kommentar} mehr enthalten + (bis auf \mystrong{Lizenz}-Hinweise) und sind diejenigen, + die~im~\TeX-Lauf tats„chlich \mystrong{eingelesen} werden, + \mystrong{aužer\Dots} +\end{enumerate} + +\labelsection{kommentarzch}{Kommentar\mystrong{zeichen}} +\begin{enumerate} + \item Kommentar\mystrong{zeilen} sind mit \TeX/\LaTeX\ gew”hnlich + durch das Kommentar\mystrong{zeichen} ("\code{\%}") + am Anfang gekennzeichnet. + \item (Nach \mystrong{\cs{endinput}} wird Code auch + \mystrong{ohne} Kommentarzeichen ignoriert; + ebenso kann man im Prinzip "Kommentar" \metavar{kommentar} mit + \mystrong{"\cs{iffalse}\metavar{kommentar}\cs{fi}"} + einrahmen.) + \item Diese (ganz oben) \mystrong{Zeilen mit Kommentarzeichen} + werden dann von \mystrong{\pkg{docstrip}} entfernt~\dots + \dh, diese Kommentarzeichen dienen gar \mystrong{nicht} + mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei + als "zu ignorieren" zu kennzeichnen, vielmehr sind sie gar + nicht mehr da. \mystrong{Wieso dann noch Kommentarzeichen?} + \item \dots\ tats„chlich: Mit \mystrong{Paul Isambert}s + \CtanPkgRef{codedoc}{CodeDoc} ist der "Kommentar" + normaler, von \mystrong{Listing-Umgebungen} + unterbrochener Text (ohne "\code{\%}" links). + Letztere schreiben den Code in die \mystrong{kompakte Paketdatei}. +\end{enumerate} + +\labelsection{ohne-docstrip}{% + \emph{Ohne} \pkg{docstrip} \mystrong{heute}} +(\autref{docstrip} fortsetzend:)\Dots +\emph{aber} %% emph 2011/10/08 +es gibt die \mystrong{\file{.sty}-Pakete}, +die \mystrong{\emph{mit} Kommentarzeilen} +(ohne \pkg{docstrip} einzuschalten) eingelesen werden, \mystrong{noch +heute!} +\begin{itemize} + \item verschiedene in \acronym{TDS}-\file{ltxmisc/}, darunter + einige geniale, fr manche unverzichtbare Pakete von + \httpref{ctan.org/author/id/arseneau}{\mystrong{% + Donald Arseneau}} (ich sehe gerade \ctanpkgref{framed}~\dots) + \item \mystrong{Stephan B”ttcher}s \CtanPkgRef{lineno}{lineno.sty} + (Zeilennummerierung besonders fr + \mystrong{kritische Editionen} und \mystrong{Einreichungen}) + enth„lt gewaltig viel Kommentar\pardash von mir bernommen, + nie geh”rt, dass das Laden zu lange dauere~\dots + \item alle (? \cs{endinput}) meine + \httpref{ctan.org/author/id/lueck}{\mystrong{eigenen}} + Pakete (was natrlich einfach eine Frechheit sein kann~\dots) +\end{itemize} + + +\teilpage{9}{\mystrong{"Darstellung"} des Kommentars} +% \mystrong{Vorverarbeitung}\\von Code+Kommentar-Dateien} +% Verarbeitung als Dokumentation +\labelsection{doku-vor}{"Darstellung" des Kommentars + \Endash \mystrong{"Vorzeit"}} +\begin{enumerate} + \item \emph{Vor} \pkg{\mystrong{doc}.sty} + war der \mystrong{Kommentar} in \mystrong{Paketdateien} + dazu da, mit einem \mystrong{Texteditor} gelesen oder + im \mystrong{"Text"}-Modus + (als "Listing", im Gegensatz zum fr \TeX\ + erforderlichen \mystrong{"Grafik"}-Modus) + ausge\mystrong{druckt} zu werden. + \item Kommentar entsprechend + "reiner \mystrong{\acronym{ASCII}}-Text", + weder "typografische Zeichen" noch Auszeichnung. +\end{enumerate} + +\labelsection{doku-doc}{% + Darstellung des Kommentars mit \pkg{\mystrong{doc}.sty}} +\begin{enumerate} + \item Erst mit \pkg{\mystrong{doc}.sty} wurde + die heute von \mystrong{\LaTeX-Paketen} auf dem + \mystrong{CTAN} gewohnte \LaTeX-Druck\mystrong{qualit„t} + des \mystrong{Kommentars} m”glich, + wobei man den \mystrong{Code} als Imitation + der Texteditor- und Listing-Druckqualit„t auszeichnet. + \mystrong{Entscheidend} ist dabei der + \mystrong{"\Wikideref{Don't repeat yourself}"}-Grundsatz + \Endash die \mystrong{Code} und + \mystrong{Kommentar mischende} Quelldatei wird fr + den Qualit„tsausdruck nicht von Hand berarbeitet, + sondern "automatisch" mit dem \mystrong{\cs{DocInput}}-Befehl + verarbeitet. + \item (Wie war das eigentlich mit \mystrong{\acronym{WEB}?}) + \item Dazu kann man allerdings (oder konnte bisher) + \mystrong{nicht} (den frheren) + \mystrong{"\acronym{ASCII}"-Kommentar} verwenden, + der Kommentar muss vielmehr als "\LaTeX-Input" + mit \mystrong{typografischen Zeichen} und + \LaTeX-\mystrong{Markup} + in der \mystrong{Code+Kommentar}-Quelldatei stehen + (vgl. \pkg{ltxdoc}-Dokumentation zu \code{{oldcomments}}). +\end{enumerate} + +\labelsection{docinput}{% + \mystrong{\cs{DocInput}}\cb{\metavar{c+k}}}} +\dots~(\mystrong{\pkg{doc}}, \ctanpkgref{gmdoc},~\dots) +verarbeitet die \mystrong{Code/Kommentar mischende} Datei +\mystrong{\metavar{c+k}} so\pardash sie enthalte als Beispiel +% dass die nette \cs{rmfamily}/\cs{ttfamily}-Mischung frs \file{.pdf} +% entsteht +\begin{verbatim} + \% \cs{textit{dolce far niente:}} + \% \ \ \ \cs{begin{macrocode}} + \ \ \cs{relax} + \% \ \ \ \cs{end{macrocode}} + \% -- genug, +\end{verbatim} +\cs{DocInput{\metavar{c+k}}} fhrt \mystrong{\cs{MakePercentIgnore}} +vor \cs{input{\metavar{c+k}}} aus, Effekt wie +\begin{verbatim} %% 2011/10/03 exakt "%" weggelassen + \ \cs{textit{dolce far niente:}} + \ \ \ \ \cs{begin{macrocode}} + \ \ \cs{relax} + \ \ \ \ \cs{end{macrocode}} + \ -- genug, +\end{verbatim} + +\labelsection{docinput2}{(\cs{DocInput})} +(šbertrag:) +\begin{verbatim} + \ \cs{textit{dolce far niente:}} + \ \ \ \ \cs{begin{macrocode}} + \ \ \cs{relax} + \ \ \ \ \cs{end{macrocode}} + \ -- genug, +\end{verbatim} +\dots~so kommt der \mystrong{Code} in eine +\mystrong{Listing}-Umgebung, der \mystrong{Rest} wird +\mystrong{"normal"} in \LaTeX-Qualit„t gesetzt. + <p> +\mystrong{"Minimales Markup"} wrde bedeuten, +dass man \mystrong{dasselbe} Ergebnis~\dots + +\labelcentersection{docinput-min}{%% center 2011/10/14 + \mystrong{"Minimale" Kennzeichnung} des Codes}} +\begin{textblock}{420} + \dots~statt mit + \begin{verbatim} + \% \cs{textit{dolce far niente:}} + \% \ \ \ \cs{begin{macrocode}} + \ \ \cs{relax} + \% \ \ \ \cs{end{macrocode}} + \% -- genug, + \end{verbatim} + schon mit + \begin{verbatim} + \% \cs{textit{dolce far niente:}} + \ \ \cs{relax} + \% -- genug, + \end{verbatim} + erh„lt. %%% bekommt. %% 2011/10/14 + Dies erreichen~\dots +\end{textblock} + +\labelsection{docinput-alt}{% + \mystrong{"smartes"} \cs{DocInput}} +%% Zeilenumbrche/\Endash 2011/10/08: +\Endash \mystrong{Algorithmus} klar:\\ +\quad \Endash nach Zeile +\emph{mit} "\code{\%}" vor \emph{"ohne"} %% war verkehrtrum 2011/10/03 +"\cs{begin{macrocode}}",\\ +\quad \Endash im umgekehrten Fall "\cs{end{macrocode}}" +einfgen~\endash +\begin{enumerate} + \item \ctanpkgref{gmdoc} + (\mystrong{Grzegorz Murzynowski}; %% y 2011/10/25 + \myalert{ich meine mich zu erinnern:}\\ + wie bei \pkg{wiki.sty} sind die + \mystrong{Zeilenendzeichen aktiv}\\ + und schauen sich den n„chsten Zeilenanfang an) + \item \ctanpkgref{lineno} (\mystrong{Stephan B”ttcher}) + \Endash eine \acronym{UNIX}-Shell wendet ein + in der Datei \pkg{lineno.sty} enthaltenes + \Wikideref{awk}-Skript auf \file{lineno.sty} + an, erzeugt Dokumentationsdatei \file{lineno.tex}~\dots + \item \pkg{\mystrong{makedoc}.sty} (selbst) bietet statt awk +% zusammen mit \pkg{\mystrong{fifinddo}.sty} + eine Art \TeX-basierte Skriptsprache und unterschiedliche + \mystrong{Zeilenparser},\\ + um jeweils eine Dokumentationsdatei zu erzeugen. +% Auf Kommentarzeilen werden in +% \mystrong{\file{mdoccorr.cfg}} festgelegte +% Zeichenkettenersetzungen angewendet, um +% \mystrong{typografische Zeichen} einzufgen +% ("\file{.txt}\to\file{.tex}"). +\end{enumerate} + +\labelcentersection{kommentarz-kombi}{% + \mystrong{"Interpretationen"} von Kommentarzeichen} + +\begin{textblock}{560} +\mystrong{echter} Kommentar vs. \mystrong{"Auskommentieren"}, +ich: %%% "\code{\%\%}" vs. "\code{\%}") + \begin{verbatim} + \cs{typeout{ok}} \%\% Code + \%\ \cs{typeout{ko}} \%\% auskommentierter Code + \%\% \lt- falls ko \%\% Kommentar + \%\% \% \lt- falls KO \%\% auskommentierter Kommentar + \%\% \%\% \lt- 2011/10/01 \%\% Kommentar zum Kommentar + \end{verbatim} + \mystrong{ergibt} mit \pkg{makedoc} und von mir bevorzugten + Einstellungen: + \begin{quote} + \ \ \cs{typeout{ok} \%\% Code}\\ + \%\ \cs{typeout{ko} \%\% auskommentierter Code}\\ + \gets falls ko + \end{quote} + \Endash Parsermakros %% c -> k 2011/10/14 + fr verschiedene \mystrong{"Stile"}, + etwa Pakete \mystrong{anderer} Autoren, die + \mystrong{keine "\code{\%\%}"} verwenden +\end{textblock} + +% \labelcentersection{mdoccorr}{\pkg{mdoccorr.cfg}} +% Textersetzungen nur in Kommentarzeilen +% \vspace{9} +% (s.~Datei +% \ctanfileref{\ltxcontrib nicetext/use}{mdoccorr.cfg}) + +\labelcentersection{makedoc-input}{% + \mystrong{\pkg{makedoc}}s %% \mystrong 2011/10/08 + \cs{DocInput{\metavar{job}}}} +\begin{textblock}{600} + %% <- 2011/10/07 -> + Genaue Entsprechung zu \cs{DocInput} fehlt derzeit.\\ + "\metavar{job}" ergibt sich von selbst, oder~\dots\\ + Verschiedene \mystrong{Skriptbefehle} + untersttzen unterschiedliche \mystrong{Dokumentationsstile} + (šbersicht: %% 2011/10/07 + \ctanfileref{\ltxcontrib nicetext/doc}{% + mdoccheat.pdf}).\\ + <p> + c+k-Dateien werden mit \pkg{makedoc} \emph{nicht direkt} eingelesen. + \\Die Hauptdatei + \begin{enumerate} + \item \mystrong{erzeugt} aus (je)der c+k-Datei eine + \mystrong{Dokumentationsversion} + (\mystrong{"\file{.txt}\to\file{.tex}"}, + Einfgen von "\mystrong{Listing}-Wrappern", + \mystrong{Zeichenkettenersetzungen} + fr \mystrong{Gliederung} und \mystrong{typografische Zeichen}, + dazu Datei + \ctanfileref{\ltxcontrib nicetext/use}{% + mdoccorr.cfg% + }/\ctanfileref{info/fifinddo-info}{% + mdoccorr.pdf}, + \item liest und \mystrong{setzt} die erzeugte Datei dann als + \mystrong{\file{.tex}.} + \end{enumerate} + %% 2011/10/06: + \mystrong{Genauer}~\dots +\end{textblock} + +\labelsection{makedoc-lauf}{Dokumentationslauf} %% 2011/10/06 +[Genauer]~\dots~\mystrong{kompiliere} %% 2011/10/07 +ich typischerweise die Dokumentation +\begin{enumerate} + \item \file{\metavar{job}.\mystrong{pdf}} von + \file{\metavar{job}.\mystrong{sty}} aus + \file{\metavar{job}.\mystrong{tex}}. + \item \file{\metavar{job}.\mystrong{tex}} + enth„lt \pkg{makedoc}-Befehle + zur Erzeugung von + \file{\metavar{job}.\mystrong{doc}} aus + \file{\metavar{job}.\mystrong{sty}} und zum Einlesen von + \file{\metavar{job}.\mystrong{doc}}, + \item kann noch Dokumentation von + \mystrong{Erg„nzungspaketen} + \metavar{add} via + \file{\metavar{add}.\mystrong{doc}} einbinden. + \item \file{\metavar{job}\mystrong{.doc}}/\file{\metavar{add}\mystrong{.doc}} + k”nnen\\(nach \cs{RequirePackage{makedoc}})\\ + ganz zu Anfang des \TeX-Laufs innerhalb einer Gruppe erzeugt + und dann in der \code{{document}}-Umgebung mit + \mystrong{\cs{input}} eingelesen werden. +\end{enumerate} + +% \labelsection{txt2tex-doku}{% +% Paketdokumentation~\dots} +% % \section{Markup in der \mystrong{Paketdokumentation}} +% \dots\ betrifft Dateien, die gleichzeitig Makrocode und +% dessen Kommentierung enthalten: +% \TODO: sp„ter oder anders? +% \begin{enumerate} +% \item verbatim im Kommentar +% \item Hervorhebung beschriebener Makros +% \item "Metavariablen" im Kommentar +% \item Listing\pardash Kennzeichnung von Code/Kommentar +% \item \cs{textsf} fr Paketnamen +% \item "minimal": Pakete anderer Autoren +% \item \cs{DoNotIndex} +% \end{enumerate} +% \\ +% [\ctanpkgref{xdoc}, \ctanpkgref{ydoc}, +% \ctanpkgref{DoX}, \ctanpkgref{pauldoc}] + +\labelsection{erfolg}{Erfolge/Scheitern} +% \begin{textblock}{360} + \begin{enumerate} + \item Ich kann damit \mystrong{flott} + Pakete schreiben/dokumentieren\\ + (auch mit \mystrong{Dokumentation} als + \mystrong{"\Wikideref{Roadmap}"} beginnen). + \\ %%% \item %% 2011/10/06 + \emph{Nach} Einrichten des + Dokumentations-\mystrong{Workflows}\\ + l„uft mittlerweile meist alles \mystrong{"wie am Schnrchen".} + \item %% 2011/10/06 + \mystrong{Einrichten} eines solchen Workflows + war aufw„ndig,\\dafr jetzt \mystrong{Vorlagen} + sowie \mystrong{Bash}- und + \mystrong{\pkg{fifinddo}-Skripts}. + \item \mystrong{Fehler} wegen Umwegs ber + \mystrong{erzeugte} Dateien\\ + (mehr Zeilen als in Quelldatei) + manchmal \mystrong{schwer verst„ndlich}~\dots + \item %% 2011/10/06 + In der \mystrong{Praxis} kann ich (derzeit) + doch \mystrong{\LaTeX-Befehle}\\ + (Backslashs, \dots, vgl.~\ancref{minimal-mehr}{Vorgabe}) + \mystrong{nicht} ganz \mystrong{vermeiden},\\ + wohl vor allem bei \mystrong{Verweisen}~\dots + \item Dennoch gelungene \mystrong{"Fremddokumentationen":}\\ + \ctanfileref{\ltxcontrib nicetext/demo}{arseneau.pdf}, + \ctanfileref{\ltxcontrib nicetext/demo}{substr.pdf}. + \end{enumerate} +% \end{textblock} + +\labelcentersection{catcodes}{% + Vorteile und Problematik der + \mystrong{Zeichenkategorien} (\cs{catcode...})% +} +\begin{textblock}{560} + \begin{enumerate} + \item fr \mystrong{Dokumentation}svorverarbeitung + Einlesen als \mystrong{"reinen Text"} + (\cs{dospecials} \mystrong{"\code{other}"}) + \item \mystrong{\cs{PatternCodes}} fr Ersetzungsregeln + anzupassen + \item \pkg{\mystrong{blog}.sty} (\ctanpkgref{morehype}-Bndel) + nutzt dagegen "minimale" \mystrong{\TeX-Syntax}, + \mystrong{expandiert} Makros zu \mystrong{\HTML}-Code + (Hauptdatei "\file{makehtml.tex}" \oae\ + wandelt \metavar{job}\mystrong{\file{.tex}} + zeilenweise + in \metavar{job}\mystrong{\file{.html}} um). + \end{enumerate} +\end{textblock} + +\teilpage{10}{\mystrong{HTML} erzeugen} +\labelcentersection{html-statt-pdf}{% +% Notizen in reinem Text~/ \HTML~/ \PDF} + \mystrong{Nutzen} von \HTML\ (vs.~\PDF)} +\begin{textblock}{520} %% 560 -> 520 2011/10/14 + \begin{enumerate} + \item \mystrong{Internetauftritt/CMS} + \item "Elektronischer \mystrong{Zettelkasten}" + \begin{enumerate-a} + \item Querverweise + \item gegliederte/kommentierte \mystrong{Link-Sammlungen} + \item Hervorhebung von \mystrong{Stichw”rtern} + in Texten aus anderen Formaten +% (Xpad/Tomboy) + %% <- unterer Link funktioniert nicht mehr 2011/10/03; + %% OK mit </li> in allen \item -> + (\httpref{mterry.name/xpad}{Xpad}/\Wikidedisambref{Tomboy}{Software}) + %% <- Software 2011/10/04 + \end{enumerate-a} + \item besserer \mystrong{Lesefluss ohne Seiten}umbrche,\\ + ohne problematische \mystrong{Zeilen}umbrche + \item \mystrong{keine Arbeit mit Umbrchen}\\(aužer gedankliche Gliederung) + \item \mystrong{Bildschirmfl„che} voll nutzen + \end{enumerate} +\end{textblock} +\labelsection{html-alt}{% + \mystrong{HTML}-Erzeugung\pardash \mystrong{Alternativen}} +\begin{itemize} + \item HTML-Editoren, CMSe?; Formeln? keine Ahnung, \myalert{egal} + \item \strong{\CtanPkgRef{tex4ht}{TeX4th}} + (Eitan Gurari\dagger; + \meta{\wikideref{TeX4ht}{Wikipedia}} sehr informativ) + \Endash \wikideref{TeX4ht}{\mystrong{verarbeitet + \file{.dvi}}}, kommt insofern (wohl) mit allen Paketen/Makros + zurecht, ohne sie einzeln zu behandeln + \Endash damit \mystrong{Webseiten} pflegen\myalert{?} + \item diverse \strong{Syntax-Wandler} wie + \Wikideref{LaTeX2html} (Perl), \urlref{hevea.inria.fr}, + \httpref{evalwhen.com/tex2page}{\TeX2page}, + %% <- \ctanpkgref{tex2page}: not on CTAN + \CtanPkgRef{tth}{TtH} + (\Wikidedisambref{C}{Programmiersprache}; + \httpref{hutchinson.belmont.ma.us/tth/}{Home:} Formeln!); + vgl.~\urlref{tug.org/interest.html\#web}%%%~\TODO + \item \pkg{\strong{blog}.sty} + (\ctanpkgref{morehype}-Bndel) %% "Bndel" 2011/10/03 + \Endash expandiert Makros zu HTML; + \mystrong{\LaTeX}-Makros \mystrong{umdefiniert}, + \mystrong{neue} Makros fr bestimmte + \mystrong{\HTML-Strukturen}, \zB \pkg{\mystrong{lnavicol}.sty} +\end{itemize} + +\labelcentersection{html-und-pdf}{% + \HTML\ und \PDF\ aus \mystrong{selber Quelle}?} +%% ausgebaut 2011/10/06: +\begin{textblock}{540} + \begin{enumerate} + \item \cs{labelsection} etc.\pardash \mystrong{"\pkg{html\TeX}"}\\ + (\mystrong{\HTML} regt zu Makros an, die \mystrong{auch} fr + \mystrong{\PDF}-Erzeugung interessant w„ren,\\ + angefangen mit logischer Auszeichnung wie + \code{\lt code\gt}/\cs{code}, + \code{\lt strong\gt}/\cs{strong}.) + % \vspace{9} + \item \pkg{\mystrong{texlinks}.sty} + (\ctanpkgref{morehype}-Bndel)\\ + bietet \mystrong{Beispiele} fr \mystrong{Makros}, + die \mystrong{gleichermažen} + \begin{itemize} + \item fr \mystrong{\pkg{hyperref}/\PDF} + \item wie fr \mystrong{\HTML}-Erzeugung mit + \pkg{\mystrong{blog}.sty} + \end{itemize} + geeignet sind + (fužen auf wenigen + "\Wikideref{Pivot}/\Wikideref{Angelpunkt}"-Makros + wie etwa \cs{href},\\nur ein solches fr + \pkg{hyperref} vs. \pkg{blog} unterschiedlich zu definieren). + \end{enumerate} +\end{textblock} + +\labelcentersection{blog-probleme}{% + Was (zur Zeit) \emph{nicht} geht} %% emph 2011/10/08 +\begin{textblock}{560} + (weil Makros \mystrong{nur expandiert} werden, %% 2011/10/06 + vgl.~\Wikideref{Funktionale Programmierung}): + Z„hler, optionale Argumente, \ast-Varianten, \cs{unskip}, \cs{verb}; + \cs{begin} ”ffnet keine Gruppe fr lokale Einstellungen, + solche k”nnen ohnehin nicht vorgenommen werden. + ("Was man an \TeX\ hat.") + \Endash Mathe: Brche/Wurzeln? vgl. dazu + \httpref{hutchinson.belmont.ma.us/tth/}{TtH}. + \vspace{9} + \mystrong{Ausweg} irgendwann: besondere Behandlung + von Zeilen, die bestimmte einzelne Makros enthalten, + wie etwa + \cs{EXECUTE{\metavar{einstellungen}}}, + \cs{begin}, \cs{end}. + \vspace{9} + Wandlung \mystrong{zeilenweise} erschwert auch Verteilen + von \mystrong{Makroargumenten ber mehrere Zeilen} + ("Klammer rechtzeitig ”ffnen"). + Knftige Alternativen w„ren \ctanpkgref{catchfile} + oder "bis zur n„chsten leeren Zeile am Stck" einlesen. +\end{textblock} + + +\labelcentersection{schluss}{Dank} %% schwarz 2011/10/14 +%% gekrzt 2011/10/05: +% \labelcentersection{schluss}{Schluss} +% Dieser Vortrag war fr mich eine \mystrong{Prfung}, +% \\die ich hoffentlich mit \mystrong{"Auszeichnung"} bestanden habe! +% \\("Markup") +% \vspace{42} +% \cheading2{Dank} +\begin{textblock}{600} + \begin{itemize} + \item \pkg{\mystrong{blog}.sty} wurde (2010) + mittelbar/teilweise durch die + \wikideref{Deutsche Forschungsgemeinschaft}{DFG} + untersttzt + \item den \mystrong{Einstieg} in \mystrong{\HTML} + verdanke ich in erster Linie meinem Bruder, + Rainer Lck (\urlref{www.webdesign-bu.de}) + \item frs \mystrong{Zuh”ren} \answer{Zuschauen} + \end{itemize} +und \strong{nachtr„glich:} + \begin{itemize} + \item an \mystrong{Uwe Ziegenhagen} (\ua) fr Hinweis auf\\ + \Wikideref{Markdown} und + \httpref{johnmacfarlane.net/pandoc}{pandoc}, + \item an \mystrong{Bernd Raichle} fr Hinweis auf + \mystrong{Kees van der Laan}s (NTG) Arbeiten ber + "minimales Markup", + \item "\mystrong{technischen} Helfern" %% <- 2011/10/08 -> + (Kabel/\httpref{% %% line break 2011/10/21 + www.x.org/wiki/Projects/XRandR}{\code{xrandr}})! + \end{itemize} +\end{textblock} + +% \nextcenterscreenpage{} +% \labelsection{}{% +% \section{} +\screenbottom{START} +\finish + diff --git a/info/fifinddo-info/source/makeone/makedot.tex b/info/fifinddo-info/source/makeone/makedot.tex new file mode 100644 index 0000000000..1c537b5f11 --- /dev/null +++ b/info/fifinddo-info/source/makeone/makedot.tex @@ -0,0 +1,26 @@ +\def \GenDate {2011/10/25} %% <- TODO update! +\ProvidesFile{makedot.tex}[\GenDate\space blogdot driver (UL)] +%% public packages: +\RequirePackage{blogdot,texlinks} +%% local settings (overridable for single documents): +% \input{atari.fdf} +% \input{lang-de.fdf} +% \input{lang-en.fdf} +%% local/experimental settings: +\input{texblog.fdf} +%% settings for single job: +\input{dantev45.fdf} +\def\htmljob{dantev45} +%% alternatively, load these settings from a file +%% `jobname.tex' that may be made with `echo'/by a script. + +\SumBlogDotWidth %% blogdot special +% \show\leftpagemargin %% debug + +%% as in all my blog.sty driver files: +\ResultFile{\htmljob\htmakeext} +\BlogCopyFile[\TextCodes + \MakeActiveDef\"{\catchdq}% + ]{\htmljob.tex} +\CloseResultFile +\stop diff --git a/info/fifinddo-info/source/makevars/bashvars.sh b/info/fifinddo-info/source/makevars/bashvars.sh new file mode 100755 index 0000000000..4f5b31695f --- /dev/null +++ b/info/fifinddo-info/source/makevars/bashvars.sh @@ -0,0 +1,55 @@ +#!/bin/bash +# my bash script for generating variants of dantev45.htm +# needs longdan.sh and a directory LongHTML +# save manual version of dantev45.cfg, dantev45.cfg is overwritten here +# U.L., 2011-10-23 +echo +echo ' ** dantev45 VARIANTs **' +echo +echo ' ** dantev45 "992-exact" **' +#echo "" > dantev45.cfg +rm dantev45.cfg # remove symbolic link +latex makedot; ./longdan.sh 992-exact +echo +echo ' ** dantev45 "992-exact-frame" **' +echo \\ShowBlogDotFrame > dantev45.cfg +latex makedot; ./longdan.sh 992-exact-frame +echo +echo ' ** dantev45 "992-com" **' +echo \\def\\lowerpagemargin{504} \\FillBlogDotTypeArea > dantev45.cfg +latex makedot; ./longdan.sh 992-com +echo +echo ' ** dantev45 "1180-com" **' +echo \\def\\leftpagemargin{256} \\def\\lowerpagemargin{504} > dantev45.cfg +echo \\FillBlogDotTypeArea >> dantev45.cfg +latex makedot; ./longdan.sh 1180-com +echo +echo ' ** dantev45 "1180-clean" **' +echo \\def\\leftpagemargin{256} \\def\\lowerpagemargin{504} > dantev45.cfg +latex makedot; ./longdan.sh 1180-clean +echo +echo ' ** dantev45 "768-com" **' +echo \\def\\leftpagemargin{50} \\def\\lowerpagemargin{504} > dantev45.cfg +echo \\FillBlogDotTypeArea >> dantev45.cfg +latex makedot; ./longdan.sh 768-com +echo +echo ' ** dantev45 "768-exact-frame" **' +echo \\def\\leftpagemargin{50} \\ShowBlogDotFrame > dantev45.cfg +latex makedot; ./longdan.sh 768-exact-frame +echo +echo ' ** dantev45 "768-exact-show" **' +echo \\def\\leftpagemargin{50} > dantev45.cfg +echo \\ShowBlogDotFrame \\ShowBlogDotBorders >> dantev45.cfg +latex makedot; ./longdan.sh 768-exact-show +echo +echo ' ** dantev45 "768-filltype-show" **' +echo \\ProvidesFile{dantev45.cfg}[201?/??/?? generated] > dantev45.cfg +echo \\def\\leftpagemargin{50} >> dantev45.cfg +echo \\ShowBlogDotFrame \\ShowBlogDotBorders >> dantev45.cfg +echo \\FillBlogDotTypeArea \\ShowBlogDotFillText >> dantev45.cfg +latex makedot; ./longdan.sh 768-filltype-show +echo +echo ' * restoring symbolic link for manual .cfg (on my netbook) *' +ln -sf SRC/DANTEV45.CFG dantev45.cfg +echo ' ** DONE. **' +echo diff --git a/info/fifinddo-info/source/makevars/dantev45.cfg b/info/fifinddo-info/source/makevars/dantev45.cfg new file mode 100644 index 0000000000..ca3570e463 --- /dev/null +++ b/info/fifinddo-info/source/makevars/dantev45.cfg @@ -0,0 +1,27 @@ +\ProvidesFile{dantev45.cfg}[2011/10/23 local blogdot.sty config] +%% for type area width 668px and screen width minus +%% scroll bar: +\renewcommand*{\leftpagemargin}{50} %% -> 768 +% \renewcommand*{\leftpagemargin}{162} %% -> 992 +% \renewcommand*{\leftpagemargin}{256} %% -> 1180 +% \renewcommand*{\rightpagemargin}{\leftpagemargin} +% \renewcommand*{\upperpagemargin}{80} +%% I prepared my presentation for a screen of +%% 600px height and tried to confine myself to a +%% type area height of 440px; a lower margin of 504px would hide +%% the next "page"/"slide" even on a screen 1024px high: +\renewcommand*{\lowerpagemargin}{504} +% \renewcommand*{\typeareawidth}{640} +% \renewcommand*{\typeareaheight}{440} +%% Debugging: +% \ShowBlogDotBorders +% \ShowBlogDotFrame +\FillBlogDotTypeArea +% \FillBlogDotBottom +% \ShowBlogDotFillText +%% overall background color: +% \renewcommand*{\bodybgcolor}{\#ffffff} +%% open example files: +% \usemirrorctan +% \usecurrdirctan +\endinput diff --git a/info/fifinddo-info/source/makevars/longdan.sh b/info/fifinddo-info/source/makevars/longdan.sh new file mode 100755 index 0000000000..f1ffdd3123 --- /dev/null +++ b/info/fifinddo-info/source/makevars/longdan.sh @@ -0,0 +1 @@ +cp -ipv dantev45.htm LongHTML/dantev45-$1.html diff --git a/info/fifinddo-info/source/makevars/makedots.tex b/info/fifinddo-info/source/makevars/makedots.tex new file mode 100644 index 0000000000..7e95b06aa7 --- /dev/null +++ b/info/fifinddo-info/source/makevars/makedots.tex @@ -0,0 +1,50 @@ +\def \GenDate {2011/10/25} %% <- TODO update! +\ProvidesFile{makedots.tex}[\GenDate\space blogdot variants driver (UL)] + +\RequirePackage{blogdot,texlinks} +\input{texblog.fdf} \input{dantev45.fdf} + +\newcommand*{\makedantevvar}[1]{% + \def\htmljob{dantev45-#1}% %% for texblog ... + \ResultFile{\htmljob.html}% + \SumBlogDotWidth + \BlogCopyFile[\TextCodes + \MakeActiveDef\"{\catchdq}% + ]{dantev45.tex}% + \CloseResultFile} + +\makedantevvar{992-exact} + +\ShowBlogDotFrame +\makedantevvar{992-exact-frame} +\DontShowBlogDotFrame + +\renewcommand*{\lowerpagemargin}{504} + +\FillBlogDotTypeArea +\makedantevvar{992-com} + +\renewcommand*{\leftpagemargin}{256} + +\makedantevvar{1180-com} +\DontFillBlogDotTypeArea + +\makedantevvar{1180-clean} + +\renewcommand*{\leftpagemargin}{50} + +\FillBlogDotTypeArea +\makedantevvar{768-com} +\DontFillBlogDotTypeArea + +\renewcommand*{\lowerpagemargin}{\upperpagemargin} +\ShowBlogDotFrame +\makedantevvar{768-exact-frame} + +\ShowBlogDotBorders +\makedantevvar{768-exact-show} + +\FillBlogDotTypeArea \ShowBlogDotFillText +\makedantevvar{768-filltype-show} + +\stop diff --git a/info/fifinddo-info/source/makevars/texvars.sh b/info/fifinddo-info/source/makevars/texvars.sh new file mode 100755 index 0000000000..d18b6c6281 --- /dev/null +++ b/info/fifinddo-info/source/makevars/texvars.sh @@ -0,0 +1,12 @@ +#!/bin/bash +# make dantev45.htm variants using makedots.tex +# U.L. 2011-10-23 +echo +echo remove symbolic .cfg link: +rm dantev45.cfg +latex makedots +mv -iv *.html LongHTML +echo restore symbolic .cfg link: +ln -sf SRC/DANTEV45.CFG dantev45.cfg +echo ' * DONE. *' +echo 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> + |