From cccdf1e8ee107f41bca9bb3f936501c0b1acd75d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 23 Oct 2011 22:25:40 +0000 Subject: fifinddo-info (23oct11) git-svn-id: svn://tug.org/texlive/trunk@24371 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/fifinddo-info/SrcFILEs.txt | 25 + .../doc/latex/fifinddo-info/dantev45.htm | 1131 ++++++++++---------- .../doc/latex/fifinddo-info/mdoccorr.pdf | Bin 94625 -> 94130 bytes .../variants/dantev45-1180-clean.html | 999 ++++++++--------- .../fifinddo-info/variants/dantev45-1180-com.html | 1131 ++++++++++---------- .../fifinddo-info/variants/dantev45-768-com.html | 1131 ++++++++++---------- .../variants/dantev45-768-exact-frame.html | 999 ++++++++--------- .../variants/dantev45-768-exact-show.html | 999 ++++++++--------- .../variants/dantev45-768-filltype-show.html | 1131 ++++++++++---------- .../fifinddo-info/variants/dantev45-992-com.html | 1131 ++++++++++---------- .../variants/dantev45-992-exact-frame.html | 999 ++++++++--------- .../fifinddo-info/variants/dantev45-992-exact.html | 999 ++++++++--------- 12 files changed, 5365 insertions(+), 5310 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/fifinddo-info/SrcFILEs.txt (limited to 'Master/texmf-dist/doc/latex/fifinddo-info') diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/SrcFILEs.txt b/Master/texmf-dist/doc/latex/fifinddo-info/SrcFILEs.txt new file mode 100644 index 00000000000..95b3cea2f89 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fifinddo-info/SrcFILEs.txt @@ -0,0 +1,25 @@ + + *File List* + MakeONE. + makedot.tex 2011/10/23 blogdot driver (UL) +dantev45.fdf 2011/10/22 blogdot settings for dantev45 +dantev45.tex 2011/10/22 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/13 extra blog settings + blogdot.cfg 2011/10/21 local blogdot.sty config +MakeVARs. +makedots.tex 2011/10/23 blogdot variants driver (UL) +dantev45.cfg 2011/10/22 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/23, 19:17 + from script file srcfiles.tex + diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm b/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm index e7a589dbbc5..33b03199c8d 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm +++ b/Master/texmf-dist/doc/latex/fifinddo-info/dantev45.htm @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-768-comneu laden

[ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
+ +  – more about the present file on: +CTAN + +
teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

Paketdokumentation
und Webseitenpflege mit
(niceverb.sty und)
fifinddo.sty

+

Paketdokumentation
und Webseitenpflege mit
(niceverb.sty und)
fifinddo.sty

Uwe Lück @@ -132,9 +136,9 @@ gehaltenen Vortrags
-2011-10-15 +2011-10-23 -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -160,13 +164,13 @@ gehaltenen Vortrags -

Teil 0: +

Teil 0:
Über den Vortrag

-

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -192,31 +196,31 @@ gehaltenen Vortrags -

Vortragstitel bedeutet (I):

+

Vortragstitel bedeutet (I):

„Paketdokumentation“
– Beschreibung von LaTeX-Makro-Paketen, d. h.
    -
  1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
  2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
  3. -
  4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
  5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
  6. -
  7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
  8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
    „Tippt man
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
    so erhält man …“
-

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

Vortragstitel bedeutet (II):

+

Vortragstitel bedeutet (II):

„Webseitenpflege“
-– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
    -
  • Internetauftritt (? +
  • Internetauftritt (? CMS? – ja …)
  • -
  • bequeme Textformat-Alternative zu PDF … +
  • bequeme Textformat-Alternative zu PDF …
    (Notizen zu Links, Beamer-Präsentation …) @@ -262,7 +266,7 @@ Beamer-Pr
-

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -289,14 +293,14 @@ Beamer-Pr -

Vortragstitel bedeutet (III):

-… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

Vortragstitel bedeutet (III):

+… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

-(– Zu HTML-Paketdokumentationen -
habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
habe ich es noch nicht gebracht …) -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -322,23 +326,23 @@ Beamer-Pr -

Vortrag interessant …

+

Vortrag interessant …

  1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
  2. -
  3. wenn man HTML schätzt und PDF +
  4. wenn man HTML schätzt und PDF vermeiden möchte …
  5. -
  6. wenn man Makro-Denksport mag +
  7. wenn man Makro-Denksport mag
-

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
+

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
@@ -370,26 +374,26 @@ vermeiden m
  • „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
  • -
  • „Missbrauch“ von TeX -als „Skriptsprache“ +
  • „Missbrauch“ von TeX +als „Skriptsprache“
    -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
  • -
  • kleine(?), einfache(?), experimentelle(!), +
  • kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
  • -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -417,25 +421,25 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    (und wohl auch ein wenig der beklagenswerten Eitelkeit …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -472,7 +476,7 @@ nicht richtig fertig, zu umfangreich, hasten, kein Experte in Typografie, HTML, CSS -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -502,31 +506,31 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -552,18 +556,18 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so
    (Begriffsklärung – oder so)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg
    typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,10 +633,10 @@ f -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -663,7 +667,7 @@ f „Traditionell“ -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -708,13 +712,13 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Typografische Zeichen mit TeX/LaTeX +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,21 +753,21 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -789,32 +793,32 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -845,18 +849,18 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,11 +921,11 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -947,32 +951,32 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -998,18 +1002,18 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“
    (Auszeichnung, Wikipedia)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1035,7 +1039,7 @@ zuletzt 2004 -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,12 +1058,12 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,17 +1117,17 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1149,13 +1153,13 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Implementierung
    „minimalen Markups“
    „mit TeX allein“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1181,17 +1185,17 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1219,33 +1223,33 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode,
    „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,18 +1288,18 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1321,27 +1325,27 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1367,34 +1371,34 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1422,18 +1426,18 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1459,19 +1463,19 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1497,36 +1501,36 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1552,39 +1556,39 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1610,13 +1614,13 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +niceverb.sty +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1682,7 +1686,7 @@ wirken wie \texttt

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1708,38 +1712,38 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1798,7 +1802,7 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1824,39 +1828,39 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1882,38 +1886,38 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1939,13 +1943,13 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7:
    „Kommentar“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1971,21 +1975,21 @@ einen solchen Funktionsumfang -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2011,33 +2015,33 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2063,27 +2067,27 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2109,13 +2113,13 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Methoden Kommentar „auszublenden“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2141,25 +2145,25 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2185,26 +2189,26 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2230,28 +2234,28 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2277,34 +2281,34 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2330,30 +2334,30 @@ Letztere schreiben den Code in die kompakte Paketdatei -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2379,14 +2383,14 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2412,23 +2416,23 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2454,36 +2458,36 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2531,7 +2535,7 @@ vor \input{⟨c+k⟩} aus, Effekt wie
      -- genug, 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2566,14 +2570,14 @@ vor \input{⟨c+k⟩} aus, Effekt wie \end{macrocode} -- genug, -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2619,7 +2623,7 @@ erh
     Dies erreichen …
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2645,9 +2649,9 @@ Dies erreichen … -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,27 +2659,27 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,12 +2725,12 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2752,37 +2756,37 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2809,34 +2813,34 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2866,39 +2870,39 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -
      Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2924,28 +2928,28 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2971,13 +2975,13 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +HTML erzeugen +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3003,35 +3007,35 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,12 +3085,12 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3144,7 +3148,7 @@ wie etwa \href,
      nur ein solches f
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3172,7 +3176,7 @@ wie etwa \href,
    nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,14 +3201,14 @@ wie etwa -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären
    catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3235,35 +3239,34 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf b/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf index e6e2ac95828..db0f90671b7 100644 Binary files a/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf and b/Master/texmf-dist/doc/latex/fifinddo-info/mdoccorr.pdf differ diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html index e14faae57cf..aa91ac84d5e 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-clean.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-1180-cleanneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,7 +136,7 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 @@ -160,7 +164,7 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0: @@ -192,25 +196,25 @@ gehaltenen Vortrags
    -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    9. @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

      Vortragstitel bedeutet (II):

      +

      Vortragstitel bedeutet (II):

      @@ -322,19 +326,19 @@ Beamer-Pr
      „Webseitenpflege“
      -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
        -
      • Internetauftritt (? +
      • Internetauftritt (? CMS? – ja …)
      • -
      • bequeme Textformat-Alternative zu PDF … +
      • bequeme Textformat-Alternative zu PDF …
        (Notizen zu Links, Beamer-Präsentation …) @@ -289,12 +293,12 @@ Beamer-Pr
      -

      Vortragstitel bedeutet (III):

      -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

      Vortragstitel bedeutet (III):

      +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

      -(– Zu HTML-Paketdokumentationen -
      habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
      habe ich es noch nicht gebracht …)
      -

      Vortrag interessant …

      +

      Vortrag interessant …

      1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
      2. -
      3. wenn man HTML schätzt und PDF +
      4. wenn man HTML schätzt und PDF vermeiden möchte …
      5. -
      6. wenn man Makro-Denksport mag +
      7. wenn man Makro-Denksport mag
      @@ -370,21 +374,21 @@ vermeiden m
    10. „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
    11. -
    12. „Missbrauch“ von TeX -als „Skriptsprache“ +
    13. „Missbrauch“ von TeX +als „Skriptsprache“
      -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
    14. -
    15. kleine(?), einfache(?), experimentelle(!), +
    16. kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
    @@ -417,18 +421,18 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden
    -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -502,27 +506,27 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    @@ -552,12 +556,12 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,7 +633,7 @@ f
    -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „Manuskript“/Typoskript, „Markup“, @@ -671,14 +675,14 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    @@ -708,12 +712,12 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    +Typografische Zeichen mit TeX/LaTeX

    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,18 +753,18 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] @@ -789,27 +793,27 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    @@ -845,14 +849,14 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,7 +921,7 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    @@ -947,30 +951,30 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … @@ -998,12 +1002,12 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“ @@ -1035,7 +1039,7 @@ zuletzt 2004
    -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,7 +1058,7 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,15 +1117,15 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) @@ -1149,12 +1153,12 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    +Implementierung
    „minimalen Markups“
    „mit TeX allein @@ -1181,14 +1185,14 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    @@ -1219,29 +1223,29 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,15 +1288,15 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    @@ -1321,24 +1325,24 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    @@ -1367,31 +1371,31 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    @@ -1422,15 +1426,15 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    @@ -1459,17 +1463,17 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) @@ -1497,32 +1501,32 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    @@ -1552,36 +1556,36 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    @@ -1610,12 +1614,12 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    +niceverb.sty @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1708,34 +1712,34 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1824,36 +1828,36 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    @@ -1882,34 +1886,34 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    @@ -1939,7 +1943,7 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7: @@ -1971,17 +1975,17 @@ einen solchen Funktionsumfang
    -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): @@ -2011,28 +2015,28 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    @@ -2063,25 +2067,25 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … @@ -2109,12 +2113,12 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    +Methoden Kommentar „auszublenden“ @@ -2141,21 +2145,21 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    @@ -2185,22 +2189,22 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    @@ -2230,25 +2234,25 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    @@ -2277,31 +2281,31 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    @@ -2330,26 +2334,26 @@ Letztere schreiben den Code in die kompakte Paketdatei
    -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    @@ -2379,12 +2383,12 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars @@ -2412,19 +2416,19 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    @@ -2454,32 +2458,32 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2566,12 +2570,12 @@ vor \input{⟨c+k⟩} aus, Effekt wie
         \end{macrocode} 
      -- genug, 
     
    -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2645,9 +2649,9 @@ Dies erreichen …
     
    -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,22 +2659,22 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,9 +2725,9 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    @@ -2752,34 +2756,34 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    @@ -2809,31 +2813,31 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    @@ -2866,36 +2870,36 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    @@ -2924,24 +2928,24 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    @@ -2971,12 +2975,12 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    +HTML erzeugen @@ -3003,32 +3007,32 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,9 +3085,9 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3172,7 +3176,7 @@ wie etwa \href,
      nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,8 +3201,8 @@ wie etwa
    -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. @@ -3235,31 +3239,30 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html index 2acb15f837e..142ecc9ee8c 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-1180-com.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-1180-comneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,9 +136,9 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -160,13 +164,13 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0:
    Über den Vortrag

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -192,31 +196,31 @@ gehaltenen Vortrags -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

    Vortragstitel bedeutet (II):

    +

    Vortragstitel bedeutet (II):

    „Webseitenpflege“
    -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
      -
    • Internetauftritt (? +
    • Internetauftritt (? CMS? – ja …)
    • -
    • bequeme Textformat-Alternative zu PDF … +
    • bequeme Textformat-Alternative zu PDF …
      (Notizen zu Links, Beamer-Präsentation …) @@ -262,7 +266,7 @@ Beamer-Pr
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -289,14 +293,14 @@ Beamer-Pr -

    Vortragstitel bedeutet (III):

    -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

    Vortragstitel bedeutet (III):

    +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

    -(– Zu HTML-Paketdokumentationen -
    habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
    habe ich es noch nicht gebracht …) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -322,23 +326,23 @@ Beamer-Pr -

    Vortrag interessant …

    +

    Vortrag interessant …

    1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
    2. -
    3. wenn man HTML schätzt und PDF +
    4. wenn man HTML schätzt und PDF vermeiden möchte …
    5. -
    6. wenn man Makro-Denksport mag +
    7. wenn man Makro-Denksport mag
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -370,26 +374,26 @@ vermeiden m
  • „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
  • -
  • „Missbrauch“ von TeX -als „Skriptsprache“ +
  • „Missbrauch“ von TeX +als „Skriptsprache“
    -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
  • -
  • kleine(?), einfache(?), experimentelle(!), +
  • kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
  • -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -417,25 +421,25 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    (und wohl auch ein wenig der beklagenswerten Eitelkeit …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -472,7 +476,7 @@ nicht richtig fertig, zu umfangreich, hasten, kein Experte in Typografie, HTML, CSS -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -502,31 +506,31 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -552,18 +556,18 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so
    (Begriffsklärung – oder so)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg
    typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,10 +633,10 @@ f -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „
      Manuskript“/Typoskript, „Markup“, @@ -671,18 +675,18 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -708,13 +712,13 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Typografische Zeichen mit TeX/LaTeX +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,21 +753,21 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -789,32 +793,32 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -845,18 +849,18 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,11 +921,11 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -947,32 +951,32 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -998,18 +1002,18 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“
    (Auszeichnung, Wikipedia)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1035,7 +1039,7 @@ zuletzt 2004 -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,12 +1058,12 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,17 +1117,17 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1149,13 +1153,13 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Implementierung
    „minimalen Markups“
    „mit TeX allein“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1181,17 +1185,17 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1219,33 +1223,33 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode,
    „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,18 +1288,18 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1321,27 +1325,27 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1367,34 +1371,34 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1422,18 +1426,18 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1459,19 +1463,19 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1497,36 +1501,36 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1552,39 +1556,39 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1610,13 +1614,13 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +niceverb.sty +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1682,7 +1686,7 @@ wirken wie \texttt

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1708,38 +1712,38 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1798,7 +1802,7 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1824,39 +1828,39 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1882,38 +1886,38 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1939,13 +1943,13 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7:
    „Kommentar“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1971,21 +1975,21 @@ einen solchen Funktionsumfang -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2011,33 +2015,33 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2063,27 +2067,27 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2109,13 +2113,13 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Methoden Kommentar „auszublenden“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2141,25 +2145,25 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2185,26 +2189,26 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2230,28 +2234,28 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2277,34 +2281,34 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2330,30 +2334,30 @@ Letztere schreiben den Code in die kompakte Paketdatei -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2379,14 +2383,14 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2412,23 +2416,23 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2454,36 +2458,36 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2531,7 +2535,7 @@ vor \input{⟨c+k⟩} aus, Effekt wie
      -- genug, 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2566,14 +2570,14 @@ vor \input{⟨c+k⟩} aus, Effekt wie \end{macrocode} -- genug, -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2619,7 +2623,7 @@ erh
     Dies erreichen …
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2645,9 +2649,9 @@ Dies erreichen … -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,27 +2659,27 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,12 +2725,12 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2752,37 +2756,37 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2809,34 +2813,34 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2866,39 +2870,39 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -
      Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2924,28 +2928,28 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2971,13 +2975,13 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +HTML erzeugen +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3003,35 +3007,35 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,12 +3085,12 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3144,7 +3148,7 @@ wie etwa \href,
      nur ein solches f
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3172,7 +3176,7 @@ wie etwa \href,
    nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,14 +3201,14 @@ wie etwa -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären
    catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3235,35 +3239,34 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html index e7a589dbbc5..33b03199c8d 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-com.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-768-comneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,9 +136,9 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -160,13 +164,13 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0:
    Über den Vortrag

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -192,31 +196,31 @@ gehaltenen Vortrags -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

    Vortragstitel bedeutet (II):

    +

    Vortragstitel bedeutet (II):

    „Webseitenpflege“
    -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
      -
    • Internetauftritt (? +
    • Internetauftritt (? CMS? – ja …)
    • -
    • bequeme Textformat-Alternative zu PDF … +
    • bequeme Textformat-Alternative zu PDF …
      (Notizen zu Links, Beamer-Präsentation …) @@ -262,7 +266,7 @@ Beamer-Pr
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -289,14 +293,14 @@ Beamer-Pr -

    Vortragstitel bedeutet (III):

    -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

    Vortragstitel bedeutet (III):

    +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

    -(– Zu HTML-Paketdokumentationen -
    habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
    habe ich es noch nicht gebracht …) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -322,23 +326,23 @@ Beamer-Pr -

    Vortrag interessant …

    +

    Vortrag interessant …

    1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
    2. -
    3. wenn man HTML schätzt und PDF +
    4. wenn man HTML schätzt und PDF vermeiden möchte …
    5. -
    6. wenn man Makro-Denksport mag +
    7. wenn man Makro-Denksport mag
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -370,26 +374,26 @@ vermeiden m
  • „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
  • -
  • „Missbrauch“ von TeX -als „Skriptsprache“ +
  • „Missbrauch“ von TeX +als „Skriptsprache“
    -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
  • -
  • kleine(?), einfache(?), experimentelle(!), +
  • kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
  • -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -417,25 +421,25 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    (und wohl auch ein wenig der beklagenswerten Eitelkeit …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -472,7 +476,7 @@ nicht richtig fertig, zu umfangreich, hasten, kein Experte in Typografie, HTML, CSS -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -502,31 +506,31 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -552,18 +556,18 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so
    (Begriffsklärung – oder so)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg
    typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,10 +633,10 @@ f -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „
      Manuskript“/Typoskript, „Markup“, @@ -671,18 +675,18 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -708,13 +712,13 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Typografische Zeichen mit TeX/LaTeX +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,21 +753,21 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -789,32 +793,32 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -845,18 +849,18 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,11 +921,11 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -947,32 +951,32 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -998,18 +1002,18 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“
    (Auszeichnung, Wikipedia)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1035,7 +1039,7 @@ zuletzt 2004 -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,12 +1058,12 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,17 +1117,17 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1149,13 +1153,13 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Implementierung
    „minimalen Markups“
    „mit TeX allein“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1181,17 +1185,17 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1219,33 +1223,33 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode,
    „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,18 +1288,18 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1321,27 +1325,27 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1367,34 +1371,34 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1422,18 +1426,18 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1459,19 +1463,19 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1497,36 +1501,36 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1552,39 +1556,39 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1610,13 +1614,13 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +niceverb.sty +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1682,7 +1686,7 @@ wirken wie \texttt

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1708,38 +1712,38 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1798,7 +1802,7 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1824,39 +1828,39 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1882,38 +1886,38 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1939,13 +1943,13 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7:
    „Kommentar“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1971,21 +1975,21 @@ einen solchen Funktionsumfang -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2011,33 +2015,33 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2063,27 +2067,27 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2109,13 +2113,13 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Methoden Kommentar „auszublenden“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2141,25 +2145,25 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2185,26 +2189,26 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2230,28 +2234,28 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2277,34 +2281,34 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2330,30 +2334,30 @@ Letztere schreiben den Code in die kompakte Paketdatei -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2379,14 +2383,14 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2412,23 +2416,23 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2454,36 +2458,36 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2531,7 +2535,7 @@ vor \input{⟨c+k⟩} aus, Effekt wie
      -- genug, 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2566,14 +2570,14 @@ vor \input{⟨c+k⟩} aus, Effekt wie \end{macrocode} -- genug, -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2619,7 +2623,7 @@ erh
     Dies erreichen …
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2645,9 +2649,9 @@ Dies erreichen … -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,27 +2659,27 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,12 +2725,12 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2752,37 +2756,37 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2809,34 +2813,34 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2866,39 +2870,39 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -
      Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2924,28 +2928,28 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2971,13 +2975,13 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +HTML erzeugen +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3003,35 +3007,35 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,12 +3085,12 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3144,7 +3148,7 @@ wie etwa \href,
      nur ein solches f
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3172,7 +3176,7 @@ wie etwa \href,
    nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,14 +3201,14 @@ wie etwa -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären
    catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3235,35 +3239,34 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html index f5b3e2c0a77..78affbad36f 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-frame.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-768-exact-frameneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,7 +136,7 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 @@ -160,7 +164,7 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0: @@ -192,25 +196,25 @@ gehaltenen Vortrags
    -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    9. @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

      Vortragstitel bedeutet (II):

      +

      Vortragstitel bedeutet (II):

      @@ -322,19 +326,19 @@ Beamer-Pr
      „Webseitenpflege“
      -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
        -
      • Internetauftritt (? +
      • Internetauftritt (? CMS? – ja …)
      • -
      • bequeme Textformat-Alternative zu PDF … +
      • bequeme Textformat-Alternative zu PDF …
        (Notizen zu Links, Beamer-Präsentation …) @@ -289,12 +293,12 @@ Beamer-Pr
      -

      Vortragstitel bedeutet (III):

      -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

      Vortragstitel bedeutet (III):

      +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

      -(– Zu HTML-Paketdokumentationen -
      habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
      habe ich es noch nicht gebracht …)
      -

      Vortrag interessant …

      +

      Vortrag interessant …

      1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
      2. -
      3. wenn man HTML schätzt und PDF +
      4. wenn man HTML schätzt und PDF vermeiden möchte …
      5. -
      6. wenn man Makro-Denksport mag +
      7. wenn man Makro-Denksport mag
      @@ -370,21 +374,21 @@ vermeiden m
    10. „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
    11. -
    12. „Missbrauch“ von TeX -als „Skriptsprache“ +
    13. „Missbrauch“ von TeX +als „Skriptsprache“
      -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
    14. -
    15. kleine(?), einfache(?), experimentelle(!), +
    16. kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
    @@ -417,18 +421,18 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden
    -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -502,27 +506,27 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    @@ -552,12 +556,12 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,7 +633,7 @@ f
    -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „Manuskript“/Typoskript, „Markup“, @@ -671,14 +675,14 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    @@ -708,12 +712,12 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    +Typografische Zeichen mit TeX/LaTeX

    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,18 +753,18 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] @@ -789,27 +793,27 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    @@ -845,14 +849,14 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,7 +921,7 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    @@ -947,30 +951,30 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … @@ -998,12 +1002,12 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“ @@ -1035,7 +1039,7 @@ zuletzt 2004
    -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,7 +1058,7 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,15 +1117,15 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) @@ -1149,12 +1153,12 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    +Implementierung
    „minimalen Markups“
    „mit TeX allein @@ -1181,14 +1185,14 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    @@ -1219,29 +1223,29 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,15 +1288,15 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    @@ -1321,24 +1325,24 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    @@ -1367,31 +1371,31 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    @@ -1422,15 +1426,15 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    @@ -1459,17 +1463,17 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) @@ -1497,32 +1501,32 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    @@ -1552,36 +1556,36 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    @@ -1610,12 +1614,12 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    +niceverb.sty @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1708,34 +1712,34 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1824,36 +1828,36 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    @@ -1882,34 +1886,34 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    @@ -1939,7 +1943,7 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7: @@ -1971,17 +1975,17 @@ einen solchen Funktionsumfang
    -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): @@ -2011,28 +2015,28 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    @@ -2063,25 +2067,25 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … @@ -2109,12 +2113,12 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    +Methoden Kommentar „auszublenden“ @@ -2141,21 +2145,21 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    @@ -2185,22 +2189,22 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    @@ -2230,25 +2234,25 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    @@ -2277,31 +2281,31 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    @@ -2330,26 +2334,26 @@ Letztere schreiben den Code in die kompakte Paketdatei
    -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    @@ -2379,12 +2383,12 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars @@ -2412,19 +2416,19 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    @@ -2454,32 +2458,32 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2566,12 +2570,12 @@ vor \input{⟨c+k⟩} aus, Effekt wie
         \end{macrocode} 
      -- genug, 
     
    -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2645,9 +2649,9 @@ Dies erreichen …
     
    -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,22 +2659,22 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,9 +2725,9 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    @@ -2752,34 +2756,34 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    @@ -2809,31 +2813,31 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    @@ -2866,36 +2870,36 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    @@ -2924,24 +2928,24 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    @@ -2971,12 +2975,12 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    +HTML erzeugen @@ -3003,32 +3007,32 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,9 +3085,9 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3172,7 +3176,7 @@ wie etwa \href,
      nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,8 +3201,8 @@ wie etwa
    -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. @@ -3235,31 +3239,30 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html index 7a2281e3806..8634ea6c467 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-exact-show.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-768-exact-showneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,7 +136,7 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 @@ -160,7 +164,7 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0: @@ -192,25 +196,25 @@ gehaltenen Vortrags
    -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    9. @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

      Vortragstitel bedeutet (II):

      +

      Vortragstitel bedeutet (II):

      @@ -322,19 +326,19 @@ Beamer-Pr
      „Webseitenpflege“
      -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
        -
      • Internetauftritt (? +
      • Internetauftritt (? CMS? – ja …)
      • -
      • bequeme Textformat-Alternative zu PDF … +
      • bequeme Textformat-Alternative zu PDF …
        (Notizen zu Links, Beamer-Präsentation …) @@ -289,12 +293,12 @@ Beamer-Pr
      -

      Vortragstitel bedeutet (III):

      -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

      Vortragstitel bedeutet (III):

      +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

      -(– Zu HTML-Paketdokumentationen -
      habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
      habe ich es noch nicht gebracht …)
      -

      Vortrag interessant …

      +

      Vortrag interessant …

      1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
      2. -
      3. wenn man HTML schätzt und PDF +
      4. wenn man HTML schätzt und PDF vermeiden möchte …
      5. -
      6. wenn man Makro-Denksport mag +
      7. wenn man Makro-Denksport mag
      @@ -370,21 +374,21 @@ vermeiden m
    10. „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
    11. -
    12. „Missbrauch“ von TeX -als „Skriptsprache“ +
    13. „Missbrauch“ von TeX +als „Skriptsprache“
      -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
    14. -
    15. kleine(?), einfache(?), experimentelle(!), +
    16. kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
    @@ -417,18 +421,18 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden
    -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -502,27 +506,27 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    @@ -552,12 +556,12 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,7 +633,7 @@ f
    -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „Manuskript“/Typoskript, „Markup“, @@ -671,14 +675,14 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    @@ -708,12 +712,12 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    +Typografische Zeichen mit TeX/LaTeX

    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,18 +753,18 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] @@ -789,27 +793,27 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    @@ -845,14 +849,14 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,7 +921,7 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    @@ -947,30 +951,30 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … @@ -998,12 +1002,12 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“ @@ -1035,7 +1039,7 @@ zuletzt 2004
    -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,7 +1058,7 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,15 +1117,15 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) @@ -1149,12 +1153,12 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    +Implementierung
    „minimalen Markups“
    „mit TeX allein @@ -1181,14 +1185,14 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    @@ -1219,29 +1223,29 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,15 +1288,15 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    @@ -1321,24 +1325,24 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    @@ -1367,31 +1371,31 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    @@ -1422,15 +1426,15 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    @@ -1459,17 +1463,17 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) @@ -1497,32 +1501,32 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    @@ -1552,36 +1556,36 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    @@ -1610,12 +1614,12 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    +niceverb.sty @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1708,34 +1712,34 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1824,36 +1828,36 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    @@ -1882,34 +1886,34 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    @@ -1939,7 +1943,7 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7: @@ -1971,17 +1975,17 @@ einen solchen Funktionsumfang
    -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): @@ -2011,28 +2015,28 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    @@ -2063,25 +2067,25 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … @@ -2109,12 +2113,12 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    +Methoden Kommentar „auszublenden“ @@ -2141,21 +2145,21 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    @@ -2185,22 +2189,22 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    @@ -2230,25 +2234,25 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    @@ -2277,31 +2281,31 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    @@ -2330,26 +2334,26 @@ Letztere schreiben den Code in die kompakte Paketdatei
    -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    @@ -2379,12 +2383,12 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars @@ -2412,19 +2416,19 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    @@ -2454,32 +2458,32 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2566,12 +2570,12 @@ vor \input{⟨c+k⟩} aus, Effekt wie
         \end{macrocode} 
      -- genug, 
     
    -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2645,9 +2649,9 @@ Dies erreichen …
     
    -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,22 +2659,22 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,9 +2725,9 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    @@ -2752,34 +2756,34 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    @@ -2809,31 +2813,31 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    @@ -2866,36 +2870,36 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    @@ -2924,24 +2928,24 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    @@ -2971,12 +2975,12 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    +HTML erzeugen @@ -3003,32 +3007,32 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,9 +3085,9 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3172,7 +3176,7 @@ wie etwa \href,
      nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,8 +3201,8 @@ wie etwa
    -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. @@ -3235,31 +3239,30 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html index 0894946b75d..66401bbdc8d 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-768-filltype-show.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-768-filltype-showneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,9 +136,9 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -160,13 +164,13 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0:
    Über den Vortrag

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -192,31 +196,31 @@ gehaltenen Vortrags -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

    Vortragstitel bedeutet (II):

    +

    Vortragstitel bedeutet (II):

    „Webseitenpflege“
    -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
      -
    • Internetauftritt (? +
    • Internetauftritt (? CMS? – ja …)
    • -
    • bequeme Textformat-Alternative zu PDF … +
    • bequeme Textformat-Alternative zu PDF …
      (Notizen zu Links, Beamer-Präsentation …) @@ -262,7 +266,7 @@ Beamer-Pr
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -289,14 +293,14 @@ Beamer-Pr -

    Vortragstitel bedeutet (III):

    -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

    Vortragstitel bedeutet (III):

    +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

    -(– Zu HTML-Paketdokumentationen -
    habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
    habe ich es noch nicht gebracht …) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -322,23 +326,23 @@ Beamer-Pr -

    Vortrag interessant …

    +

    Vortrag interessant …

    1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
    2. -
    3. wenn man HTML schätzt und PDF +
    4. wenn man HTML schätzt und PDF vermeiden möchte …
    5. -
    6. wenn man Makro-Denksport mag +
    7. wenn man Makro-Denksport mag
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -370,26 +374,26 @@ vermeiden m
  • „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
  • -
  • „Missbrauch“ von TeX -als „Skriptsprache“ +
  • „Missbrauch“ von TeX +als „Skriptsprache“
    -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
  • -
  • kleine(?), einfache(?), experimentelle(!), +
  • kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
  • -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -417,25 +421,25 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    (und wohl auch ein wenig der beklagenswerten Eitelkeit …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -472,7 +476,7 @@ nicht richtig fertig, zu umfangreich, hasten, kein Experte in Typografie, HTML, CSS -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -502,31 +506,31 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -552,18 +556,18 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so
    (Begriffsklärung – oder so)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg
    typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,10 +633,10 @@ f -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „
      Manuskript“/Typoskript, „Markup“, @@ -671,18 +675,18 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -708,13 +712,13 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Typografische Zeichen mit TeX/LaTeX +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,21 +753,21 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -789,32 +793,32 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -845,18 +849,18 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,11 +921,11 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -947,32 +951,32 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -998,18 +1002,18 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“
    (Auszeichnung, Wikipedia)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1035,7 +1039,7 @@ zuletzt 2004 -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,12 +1058,12 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,17 +1117,17 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1149,13 +1153,13 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Implementierung
    „minimalen Markups“
    „mit TeX allein“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1181,17 +1185,17 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1219,33 +1223,33 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode,
    „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,18 +1288,18 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1321,27 +1325,27 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1367,34 +1371,34 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1422,18 +1426,18 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1459,19 +1463,19 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1497,36 +1501,36 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1552,39 +1556,39 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1610,13 +1614,13 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +niceverb.sty +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1682,7 +1686,7 @@ wirken wie \texttt

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1708,38 +1712,38 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1798,7 +1802,7 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1824,39 +1828,39 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1882,38 +1886,38 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1939,13 +1943,13 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7:
    „Kommentar“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1971,21 +1975,21 @@ einen solchen Funktionsumfang -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2011,33 +2015,33 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2063,27 +2067,27 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2109,13 +2113,13 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Methoden Kommentar „auszublenden“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2141,25 +2145,25 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2185,26 +2189,26 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2230,28 +2234,28 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2277,34 +2281,34 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2330,30 +2334,30 @@ Letztere schreiben den Code in die kompakte Paketdatei -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2379,14 +2383,14 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2412,23 +2416,23 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2454,36 +2458,36 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2531,7 +2535,7 @@ vor \input{⟨c+k⟩} aus, Effekt wie
      -- genug, 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2566,14 +2570,14 @@ vor \input{⟨c+k⟩} aus, Effekt wie \end{macrocode} -- genug, -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2619,7 +2623,7 @@ erh
     Dies erreichen …
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2645,9 +2649,9 @@ Dies erreichen … -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,27 +2659,27 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,12 +2725,12 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2752,37 +2756,37 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2809,34 +2813,34 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2866,39 +2870,39 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -
      Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2924,28 +2928,28 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2971,13 +2975,13 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +HTML erzeugen +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3003,35 +3007,35 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,12 +3085,12 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3144,7 +3148,7 @@ wie etwa \href,
      nur ein solches f
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3172,7 +3176,7 @@ wie etwa \href,
    nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,14 +3201,14 @@ wie etwa -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären
    catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3235,35 +3239,34 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html index d021eeb03a3..04609afe2ae 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-com.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-992-comneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,9 +136,9 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -160,13 +164,13 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0:
    Über den Vortrag

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -192,31 +196,31 @@ gehaltenen Vortrags -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

    Vortragstitel bedeutet (II):

    +

    Vortragstitel bedeutet (II):

    „Webseitenpflege“
    -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
      -
    • Internetauftritt (? +
    • Internetauftritt (? CMS? – ja …)
    • -
    • bequeme Textformat-Alternative zu PDF … +
    • bequeme Textformat-Alternative zu PDF …
      (Notizen zu Links, Beamer-Präsentation …) @@ -262,7 +266,7 @@ Beamer-Pr
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -289,14 +293,14 @@ Beamer-Pr -

    Vortragstitel bedeutet (III):

    -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

    Vortragstitel bedeutet (III):

    +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

    -(– Zu HTML-Paketdokumentationen -
    habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
    habe ich es noch nicht gebracht …) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -322,23 +326,23 @@ Beamer-Pr -

    Vortrag interessant …

    +

    Vortrag interessant …

    1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
    2. -
    3. wenn man HTML schätzt und PDF +
    4. wenn man HTML schätzt und PDF vermeiden möchte …
    5. -
    6. wenn man Makro-Denksport mag +
    7. wenn man Makro-Denksport mag
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -370,26 +374,26 @@ vermeiden m
  • „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
  • -
  • „Missbrauch“ von TeX -als „Skriptsprache“ +
  • „Missbrauch“ von TeX +als „Skriptsprache“
    -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
  • -
  • kleine(?), einfache(?), experimentelle(!), +
  • kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
  • -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -417,25 +421,25 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    (und wohl auch ein wenig der beklagenswerten Eitelkeit …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -472,7 +476,7 @@ nicht richtig fertig, zu umfangreich, hasten, kein Experte in Typografie, HTML, CSS -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -502,31 +506,31 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -552,18 +556,18 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so
    (Begriffsklärung – oder so)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg
    typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,10 +633,10 @@ f -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „
      Manuskript“/Typoskript, „Markup“, @@ -671,18 +675,18 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -708,13 +712,13 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Typografische Zeichen mit TeX/LaTeX +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,21 +753,21 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -789,32 +793,32 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -845,18 +849,18 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,11 +921,11 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -947,32 +951,32 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -998,18 +1002,18 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“
    (Auszeichnung, Wikipedia)

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1035,7 +1039,7 @@ zuletzt 2004 -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,12 +1058,12 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,17 +1117,17 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1149,13 +1153,13 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Implementierung
    „minimalen Markups“
    „mit TeX allein“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1181,17 +1185,17 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1219,33 +1223,33 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode,
    „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,18 +1288,18 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1321,27 +1325,27 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1367,34 +1371,34 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1422,18 +1426,18 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1459,19 +1463,19 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1497,36 +1501,36 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1552,39 +1556,39 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1610,13 +1614,13 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +niceverb.sty +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1682,7 +1686,7 @@ wirken wie \texttt

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1708,38 +1712,38 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1798,7 +1802,7 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1824,39 +1828,39 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1882,38 +1886,38 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1939,13 +1943,13 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7:
    „Kommentar“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -1971,21 +1975,21 @@ einen solchen Funktionsumfang -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2011,33 +2015,33 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2063,27 +2067,27 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2109,13 +2113,13 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +Methoden Kommentar „auszublenden“ +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2141,25 +2145,25 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2185,26 +2189,26 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2230,28 +2234,28 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2277,34 +2281,34 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2330,30 +2334,30 @@ Letztere schreiben den Code in die kompakte Paketdatei -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2379,14 +2383,14 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2412,23 +2416,23 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2454,36 +2458,36 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2531,7 +2535,7 @@ vor \input{⟨c+k⟩} aus, Effekt wie
      -- genug, 
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2566,14 +2570,14 @@ vor \input{⟨c+k⟩} aus, Effekt wie \end{macrocode} -- genug, -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2619,7 +2623,7 @@ erh
     Dies erreichen …
     
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2645,9 +2649,9 @@ Dies erreichen … -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,27 +2659,27 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,12 +2725,12 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2752,37 +2756,37 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2809,34 +2813,34 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2866,39 +2870,39 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -
      Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2924,28 +2928,28 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -2971,13 +2975,13 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +HTML erzeugen +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3003,35 +3007,35 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,12 +3085,12 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3144,7 +3148,7 @@ wie etwa \href,
      nur ein solches f
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3172,7 +3176,7 @@ wie etwa \href,
    nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,14 +3201,14 @@ wie etwa -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären
    catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    @@ -3235,35 +3239,34 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    +

    X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html index 3628a857586..d5a0db7d350 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact-frame.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-992-exact-frameneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,7 +136,7 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 @@ -160,7 +164,7 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0: @@ -192,25 +196,25 @@ gehaltenen Vortrags
    -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    9. @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

      Vortragstitel bedeutet (II):

      +

      Vortragstitel bedeutet (II):

      @@ -322,19 +326,19 @@ Beamer-Pr
      „Webseitenpflege“
      -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
        -
      • Internetauftritt (? +
      • Internetauftritt (? CMS? – ja …)
      • -
      • bequeme Textformat-Alternative zu PDF … +
      • bequeme Textformat-Alternative zu PDF …
        (Notizen zu Links, Beamer-Präsentation …) @@ -289,12 +293,12 @@ Beamer-Pr
      -

      Vortragstitel bedeutet (III):

      -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

      Vortragstitel bedeutet (III):

      +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

      -(– Zu HTML-Paketdokumentationen -
      habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
      habe ich es noch nicht gebracht …)
      -

      Vortrag interessant …

      +

      Vortrag interessant …

      1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
      2. -
      3. wenn man HTML schätzt und PDF +
      4. wenn man HTML schätzt und PDF vermeiden möchte …
      5. -
      6. wenn man Makro-Denksport mag +
      7. wenn man Makro-Denksport mag
      @@ -370,21 +374,21 @@ vermeiden m
    10. „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
    11. -
    12. „Missbrauch“ von TeX -als „Skriptsprache“ +
    13. „Missbrauch“ von TeX +als „Skriptsprache“
      -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
    14. -
    15. kleine(?), einfache(?), experimentelle(!), +
    16. kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
    @@ -417,18 +421,18 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden
    -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -502,27 +506,27 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    @@ -552,12 +556,12 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,7 +633,7 @@ f
    -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „Manuskript“/Typoskript, „Markup“, @@ -671,14 +675,14 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    @@ -708,12 +712,12 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    +Typografische Zeichen mit TeX/LaTeX

    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,18 +753,18 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] @@ -789,27 +793,27 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    @@ -845,14 +849,14 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,7 +921,7 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    @@ -947,30 +951,30 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … @@ -998,12 +1002,12 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“ @@ -1035,7 +1039,7 @@ zuletzt 2004
    -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,7 +1058,7 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,15 +1117,15 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) @@ -1149,12 +1153,12 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    +Implementierung
    „minimalen Markups“
    „mit TeX allein @@ -1181,14 +1185,14 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    @@ -1219,29 +1223,29 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,15 +1288,15 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    @@ -1321,24 +1325,24 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    @@ -1367,31 +1371,31 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    @@ -1422,15 +1426,15 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    @@ -1459,17 +1463,17 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) @@ -1497,32 +1501,32 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    @@ -1552,36 +1556,36 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    @@ -1610,12 +1614,12 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    +niceverb.sty @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1708,34 +1712,34 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1824,36 +1828,36 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    @@ -1882,34 +1886,34 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    @@ -1939,7 +1943,7 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7: @@ -1971,17 +1975,17 @@ einen solchen Funktionsumfang
    -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): @@ -2011,28 +2015,28 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    @@ -2063,25 +2067,25 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … @@ -2109,12 +2113,12 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    +Methoden Kommentar „auszublenden“ @@ -2141,21 +2145,21 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    @@ -2185,22 +2189,22 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    @@ -2230,25 +2234,25 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    @@ -2277,31 +2281,31 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    @@ -2330,26 +2334,26 @@ Letztere schreiben den Code in die kompakte Paketdatei
    -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    @@ -2379,12 +2383,12 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars @@ -2412,19 +2416,19 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    @@ -2454,32 +2458,32 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2566,12 +2570,12 @@ vor \input{⟨c+k⟩} aus, Effekt wie
         \end{macrocode} 
      -- genug, 
     
    -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2645,9 +2649,9 @@ Dies erreichen …
     
    -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,22 +2659,22 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,9 +2725,9 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    @@ -2752,34 +2756,34 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    @@ -2809,31 +2813,31 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    @@ -2866,36 +2870,36 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    @@ -2924,24 +2928,24 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    @@ -2971,12 +2975,12 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    +HTML erzeugen @@ -3003,32 +3007,32 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,9 +3085,9 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3172,7 +3176,7 @@ wie etwa \href,
      nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,8 +3201,8 @@ wie etwa
    -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. @@ -3235,31 +3239,30 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    diff --git a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html index bc22e8a2f5d..bbe5db2ee33 100644 --- a/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html +++ b/Master/texmf-dist/doc/latex/fifinddo-info/variants/dantev45-992-exact.html @@ -1,8 +1,8 @@ + with blog.sty, 2011/10/23 --> @@ -31,17 +31,21 @@ a:active { color:blue; text-decoration:underline; } uwe_lueck > - texmap > dantev45neu laden + texmap > dantev45-992-exactneu laden

    [ START -<<< zuerst klicken, -dann auf Bildunterrand klicken - -bzw. knapp unter Text -(MSIE) - +<<< zuerst klicken, +dann auf Bildunterrand klicken + +bzw. knapp unter Text (MSIE) + und rechts unten für „Rückkehr“
    + +  – more about the present file on: +CTAN + +
    teil-0 | titelerlaeut1 | titelerlaeut2 | @@ -115,7 +119,7 @@ und rechts unten f -

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    +

    Paketdokumentation
    und Webseitenpflege mit
    (niceverb.sty und)
    fifinddo.sty

    Uwe Lück @@ -132,7 +136,7 @@ gehaltenen Vortrags
    -2011-10-15 +2011-10-23 @@ -160,7 +164,7 @@ gehaltenen Vortrags -

    Teil 0: +

    Teil 0: @@ -192,25 +196,25 @@ gehaltenen Vortrags
    -

    Vortragstitel bedeutet (I):

    +

    Vortragstitel bedeutet (I):

    „Paketdokumentation“
    – Beschreibung von LaTeX-Makro-Paketen, d. h.
      -
    1. in „Schreibmaschinenschrift“ („verbatim“) gesetzter -Paketcode wechselt mit in LaTeX-Qualität gesetztem -Kommentar ab („zeilenweise“) +
    2. in „Schreibmaschinenschrift“ („verbatim“) gesetzter +Paketcode wechselt mit in LaTeX-Qualität gesetztem +Kommentar ab („zeilenweise“)
    3. -
    4. der Kommentartext enthält -„verbatim“ gesetzten TeX-Code („inline“) +
    5. der Kommentartext enthält +„verbatim“ gesetzten TeX-Code („inline“) zur Bezugnahme – insbesondere:
    6. -
    7. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer: +
    8. Gebrauchsanleitung/Syntaxbeschreibung für Nutzer:
      „Tippt man
      -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩}, +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩},
      so erhält man …“
    9. @@ -242,19 +246,19 @@ zur Bezugnahme – insbesondere: -

      Vortragstitel bedeutet (II):

      +

      Vortragstitel bedeutet (II):

      @@ -322,19 +326,19 @@ Beamer-Pr
      „Webseitenpflege“
      -– „hochtrabend“, zunächst bloß: HTML-Erzeugung +– „hochtrabend“, zunächst bloß: HTML-Erzeugung –
        -
      • Internetauftritt (? +
      • Internetauftritt (? CMS? – ja …)
      • -
      • bequeme Textformat-Alternative zu PDF … +
      • bequeme Textformat-Alternative zu PDF …
        (Notizen zu Links, Beamer-Präsentation …) @@ -289,12 +293,12 @@ Beamer-Pr
      -

      Vortragstitel bedeutet (III):

      -… was haben Paketdokumentation und -HTML-Erzeugung miteinander zu tun?? +

      Vortragstitel bedeutet (III):

      +… was haben Paketdokumentation und +HTML-Erzeugung miteinander zu tun??

      -(– Zu HTML-Paketdokumentationen -
      habe ich es noch nicht gebracht …) +(– Zu HTML-Paketdokumentationen +
      habe ich es noch nicht gebracht …)
      -

      Vortrag interessant …

      +

      Vortrag interessant …

      1. wenn man als Makroprogrammierer -doc.sty und docstrip.tex -(„.dtx …“) +doc.sty und docstrip.tex +(„.dtx …“) zu aufwändig findet …
      2. -
      3. wenn man HTML schätzt und PDF +
      4. wenn man HTML schätzt und PDF vermeiden möchte …
      5. -
      6. wenn man Makro-Denksport mag +
      7. wenn man Makro-Denksport mag
      @@ -370,21 +374,21 @@ vermeiden m
    10. „minimales Markup“, „syntaktischer Zucker“ -(LaTeX-Qualität -möglichst ohne LaTeX-Befehle) +(LaTeX-Qualität +möglichst ohne LaTeX-Befehle)
    11. -
    12. „Missbrauch“ von TeX -als „Skriptsprache“ +
    13. „Missbrauch“ von TeX +als „Skriptsprache“
      -(„mit TeX muss und will ich keine andere Sprache lernen“; -statt PDF-Schriftsatz +(„mit TeX muss und will ich keine andere Sprache lernen“; +statt PDF-Schriftsatz – wie docstrip)
    14. -
    15. kleine(?), einfache(?), experimentelle(!), +
    16. kleine(?), einfache(?), experimentelle(!), („schrullige“,) gerade eigenen (U. L.) Bedürfnissen entsprechende Alternativen zu existierenden „professionelleren“ Paketen -(Erfolge – Scheitern …) +(Erfolge – Scheitern …)
    @@ -417,18 +421,18 @@ entsprechende Alternativen zu existierenden

    Persönliche Motive

    -(bemerkenswerte Mischung aus:) +(bemerkenswerte Mischung aus:)
      -
    1. gespannt auf Kommentare
      zu meinen Paketen, +
    2. gespannt auf Kommentare
      zu meinen Paketen,
    3. -
    4. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren +
    5. Vortrag soll aber auch über „Konkurrenzprodukte“ informieren
    6. -
    7. Irrtümer? Hinweise? -– Terminologie erst in letzten zwei Wochen +
    8. Irrtümer? Hinweise? +– Terminologie erst in letzten zwei Wochen „erarbeitet“
    9. -
    10. Vorstellung von blogdot.sty +
    11. Vorstellung von blogdot.sty (morehype-Bündel)
    @@ -461,7 +465,7 @@ entsprechende Alternativen zu existierenden
    -

    Status

    +

    Status

    nicht richtig fertig, zu umfangreich, hasten, überspringen @@ -502,27 +506,27 @@ kein Experte in Typografie, HTML, CSS
      -
    1. „Markup“? – Terminologie +
    2. „Markup“? – Terminologie
    3. -
    4. „typografische Zeichen“ +
    5. „typografische Zeichen“ mit TeX/LaTeX
    6. -
    7. „Formatierung“ +
    8. „Formatierung“
    9. -
    10. Implementierung -„minimalen Markups“ „mit TeX allein“ +
    11. Implementierung +„minimalen Markups“ „mit TeX allein
    12. -
    13. Paketdokumentation +
    14. Paketdokumentation
    15. -
    16. niceverb.sty +
    17. niceverb.sty
    18. „Kommentar“
    19. -
    20. Kommentar ausblenden +
    21. Kommentar ausblenden
    22. „Darstellung“ des Kommentars
    23. -
    24. HTML erzeugen +
    25. HTML erzeugen
    @@ -552,12 +556,12 @@ mit TeX/LaTeX -

    Teil 1: +

    Teil 1:
    -„Markup“ oder so +„Markup“ oder so @@ -591,7 +595,7 @@ mit TeX/LaTeX

    Von .txt zu .tex

    -Um reinen Text in LaTeX-Input +Um reinen Text in LaTeX-Input (für LaTeX-Qualität) umzuwandeln, muss man normalerweise Folgendes ergänzen/ändern: @@ -601,25 +605,25 @@ Folgendes erg typografische Zeichen – „typografische“ Varianten von -Auslassungspunkten, -Anführungszeichen, -Leerzeichen, -und Strichen. +Auslassungspunkten, +Anführungszeichen, +Leerzeichen, +und Strichen.
  • Formatierung – Umschalten zwischen -Zeichensätzen, Einrücken, -Listen, Verweise, … +Zeichensätzen, Einrücken, +Listen, Verweise, …
  • -– Unterscheidung nur HTML-Terminologie? +– Unterscheidung nur HTML-Terminologie?
    -HTML verwendet für ersten Fall -spezielle Zeichen wie +HTML verwendet für ersten Fall +spezielle Zeichen wie &nbsp; (anders als \dots),
    -für zweiten Einrahmung mit „Tags“ wie +für zweiten Einrahmung mit „Tags“ wie <i>...</i> (ähnlich LaTeX …); oder … @@ -629,7 +633,7 @@ f
    -[dachte zunächst, Wortschöpfung sei meine eigene] +[dachte zunächst, Wortschöpfung sei meine eigene] @@ -663,7 +667,7 @@ f „Traditionell“
      -
    • bezieht sich „Auszeichnung“ +
    • bezieht sich „Auszeichnung“
      (im „Manuskript“/Typoskript, „Markup“, @@ -671,14 +675,14 @@ f
      anscheinend nur auf „Formatieren“
      -(vielleicht weil der Setzer das nicht „ahnen“ +(vielleicht weil der Setzer das nicht „ahnen“ konnte),
    • während typografische Zeichenvarianten
      -für den Setzer eher „selbstverständlich“ waren +für den Setzer eher „selbstverständlich“ waren
      -und im „Manuskript“ nicht besonders angezeigt wurden. +und im „Manuskript“ nicht besonders angezeigt wurden.
    @@ -708,12 +712,12 @@ und im „Manuskript“ nicht besonders -

    Teil 2: +

    Teil 2:
    -Typografische Zeichen mit TeX/LaTeX

    +Typografische Zeichen mit TeX/LaTeX

    @@ -740,7 +744,7 @@ und im „Manuskript“ nicht besonders -

    Typografische Zeichen mit TeX/LaTeX

    +

    Typografische Zeichen mit TeX/LaTeX

    @@ -749,18 +753,18 @@ und im „Manuskript“ nicht besonders Zeichen - + - - + + - - + +
    realisiert durch
    Auslassungszeichen\dots
    Auslassungszeichen\dots
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Gedanken-/„bis“-Strich---“ (englisch), „--“ – Ligaturen
    (Doppelte) AnführungszeichenEnglisch: Ligaturen ``...'';
    Deutsch mit (n)german.sty oder babel.sty "`..."'aktive Zeichen
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...
    Geschütztes Leerzeichen, Festabstand~“ – aktives Zeichen, „\,
    Englisch: Leerraum nach Satzzeichen\ “ („Steuerungsleerzeichen“), „\@“, \sfcode`...

    -[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] +[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] @@ -789,27 +793,27 @@ und im „Manuskript“ nicht besonders -

    Bewertung –
    „minimales Markup“ genauer

    +

    Bewertung –
    „minimales Markup“ genauer

    -„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    +„LaTeX-Qualität möglichst ohne LaTeX-Befehle
    README des nicetext-Bündels: -
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    -– schließt „typografische Zeichen“ ein +
    „möglichst keine Zeichen im Dokumentquellcode,
    die nicht auch gedruckt werden!“

    +– schließt „typografische Zeichen“ ein – Schwäche meiner (damaligen) Terminologie –
      -
    1. weg mit Backslashs, -englischen Befehlen und -geschwungenen Klammern! +
    2. weg mit Backslashs, +englischen Befehlen und +geschwungenen Klammern!
    3. -
    4. überhaupt möglichst wenig Code-Zeichen +
    5. überhaupt möglichst wenig Code-Zeichen
    6. -
    7. Zeichen möglichst intuitiv +
    8. Zeichen möglichst intuitiv
    9. -
    10. … am besten so aussehen wie Ergebnis +
    11. … am besten so aussehen wie Ergebnis
    12. -
    13. ASCII-WYSIWYG +
    14. ASCII-WYSIWYG – vs. unisugar mit Unicode …
    @@ -845,14 +849,14 @@ geschwungenen Klammern! – von TeX/LaTeX:
      -
    1. TeX-Ligaturen schon ganz gut! +
    2. TeX-Ligaturen schon ganz gut!
    3. -
    4. aktive Zeichen … na ja … +
    5. aktive Zeichen … na ja … „~“ besser als „&nbsp;“, aber …
    6. -
    7. \dots schon übel … -(warum nicht Ligatur...“?) +
    8. \dots schon übel … +(warum nicht Ligatur...“?)
    @@ -882,32 +886,32 @@ aber … -

    Typografische Zeichen automatisch?

    +

    Typografische Zeichen automatisch?

      -
    1. automatische Umwandlung „reiner“ Zeichen +
    2. automatische Umwandlung „reiner“ Zeichen in „typografische“?
    3. -
    4. \sfcode`A=999 schon in diese Richtung +
    5. \sfcode`A=999 schon in diese Richtung (TeXbook S. 76)
    6. -
    7. so ja optional Anführungszeichen in -Word +
    8. so ja optional Anführungszeichen in +Word
    9. -
    10. und hier +
    11. und hier – simpel, solange nicht german/babel …:
      "..." expandiert zu \glqq...\grqq oder so
    12. eigentlich nur dies (automatisches Einfügen typografischer Zeichen) -.txt→.tex +.txt→.tex in nicetext-Beschreibung (Schwäche der Terminologie)
    13. -
    14. WARNUNG! fehlerhafte Automatisierung -typografischer Anführungszeichen kann zum Verlust -des Doktortitels +
    15. WARNUNG! fehlerhafte Automatisierung +typografischer Anführungszeichen kann zum Verlust +des Doktortitels und politischer Ämter führen! (gutten.sty) @@ -917,7 +921,7 @@ und politischer -[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ] +[ z. B. german.sty nicht geladen, \glqq, \grqq nicht definiert, Fehlermeldungen ignoriert ]
    @@ -947,30 +951,30 @@ und politischer -

    .txt.tex vor nicetext

    +

    .txt.tex vor nicetext

    – auf CTAN:
    1. txt2latex kleines Perl-Skript, -wandelt gerade TeXs spezielle Zeichen -(„&“ etc.), ... -und doppelte/einzelne Anführungszeichen um +wandelt gerade TeXs spezielle Zeichen +(„&“ etc.), ... +und doppelte/einzelne Anführungszeichen um (s. Datei -txt2latex) +txt2latex)
    2. txt2tex – Perl, erzeugt tatsächlich -LaTeX-Formatierung (Paketnamen „verkehrt“!) +LaTeX-Formatierung (Paketnamen „verkehrt“!)
    3. EasyLaTeX ähnlich oder mehr, -GUI(?), Ideen aus Wiki…-Markup; +GUI(?), Ideen aus Wiki…-Markup; zuletzt 2004 (README 2009 eher CTAN-Hand)
    4. SmileTeX Windows .exe? + Werkzeuge für Grafikeinbindung etc., zuletzt 2004
    -– für Paketdokumentation ist mir das zuviel … +– für Paketdokumentation ist mir das zuviel … @@ -998,12 +1002,12 @@ zuletzt 2004 -

    Teil 3: +

    Teil 3:
    -„Formatierung“ +„Formatierung“ @@ -1035,7 +1039,7 @@ zuletzt 2004
    -

    Wikipedia: Schriftauszeichnung

    +

    Wikipedia: Schriftauszeichnung

    – Anregungen wie für EasyLaTeX?

    @@ -1043,8 +1047,8 @@ zuletzt 2004 - - + + @@ -1054,7 +1058,7 @@ zuletzt 2004
    Wiki-Codewie LaTeX-CodeWiki-Codewie LaTeX-Code
    == Über ==\section{Über}
    === Unter ===\subsection{Unter}

    -– Intuition dahinter vielleicht: +– Intuition dahinter vielleicht: Bedeutungen von kursiv und
    doppelten Anführungszeichen verwandt, z. B. Buchtitel @@ -1085,16 +1089,16 @@ z. B. Buchtitel -

    Wikipedia: Listen und Zitate

    +

    Wikipedia: Listen und Zitate

    - - + + - - + + @@ -1113,15 +1117,15 @@ z. B. Buchtitel
    Wiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-CodeWiki-wie LaTeX-Code
    ∗ Eins
    ∗ Zwei

    -– immerhin recht „minimal“, -auch halbwegs intuitiv. +– immerhin recht „minimal“, +auch halbwegs intuitiv.
    -(vgl. wikicheat.pdf) +(vgl. wikicheat.pdf) @@ -1149,12 +1153,12 @@ auch halbwegs intuitiv. -

    Teil 4: +

    Teil 4:
    -Implementierung
    „minimalen Markups“
    „mit TeX allein

    +Implementierung
    „minimalen Markups“
    „mit TeX allein @@ -1181,14 +1185,14 @@ auch halbwegs intuitiv. -

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    +

    Implementierungsmethoden für
    „minimales Markup“ mit TeX

    - + - +
    (ML)Ligaturen – …
    (nicht mein Ding, Zukunft ohne METAFONT?)
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MS)„Substitution“ bzw. „Skript“, genauer: Vorverarbeitung der .tex-Datei, Zeichenkettenersetzung (und mehr) per Skript wie mit Perl / awk / etc. bzw. mit den beschriebenen Paketen
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    (MA)(„forschende“) aktive Zeichen – im „Schriftsatz-Modus“ (während TeX den Dokumentquelltext stückweise in Glyphen und Kästchen umwandelt) expandieren aktive Zeichen mehr oder weniger direkt zu „normalen“ LaTeX-Befehlen, „forschende“ aktive Zeichen „erkunden dabei ihre Umgebung
    @@ -1219,29 +1223,29 @@ auch halbwegs intuitiv.

    Methode (MS) – Anmerkungen I

    TeXs -Mechanismus, sog. „begrenzte Parameter“ +Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) -zu erkennen
    (und zu ersetzen). +zu erkennen
    (und zu ersetzen).
    1. Vor- und Nachteile entstehen daraus, dass ein „String“ aus „reinem Text“ von TeX intern -durch unterschiedliche „Token-Ketten“ „dargestellt“ -werden kann. Auch von Groß-/Kleinschreibung abzusehen +durch unterschiedliche „Token-Ketten“ „dargestellt“ +werden kann. Auch von Groß-/Kleinschreibung abzusehen ist nicht ganz einfach.
    2. Diese Methode wurde seit längerem von LaTeX’s internem -\@in-Makro +\@in-Makro [hauptsächlich zur Erkennung von Paket-Optionen] -und vom Paket substr +und vom Paket substr (Harald Harders bzw. Heiko Oberdiek) angewandt.
    3. -
    4. Gegenwärtig fußen auch fifinddo.sty und -makedoc.sty (nicetext) +
    5. Gegenwärtig fußen auch fifinddo.sty und +makedoc.sty (nicetext) auf dieser Methode – genügte bisher praktisch.
    @@ -1271,7 +1275,7 @@ auf dieser Methode – gen -

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    +

    Anmerkungen zu (MS) II
    (Strings und Scripting mit TeX)

    1. Die Pakete stringstrings (Steven Segletes), @@ -1284,15 +1288,15 @@ und ted (Manu coolstr (Nick Setzer) und texapi (Paul Isambert).
    2. -
    3. Eine „ernsthafte Skriptsprache“ +
    4. Eine „ernsthafte Skriptsprache“ bietet neben Zeichenersetzung -allgemeiner „Sortierung“ und „Filter“. +allgemeiner „Sortierung“ und „Filter“. Beispielsweise bietet docstrip eine TeX-basierte Skriptsprache, -die aus einer .dtx-Quelldatei -die „Kommentare“ entfernt +die aus einer .dtx-Quelldatei +die „Kommentare“ entfernt und den Rest in verschiedene -„kompakte“ TeX-Eingabedateien „sortiert“. +„kompakte“ TeX-Eingabedateien „sortiert“.
    @@ -1321,24 +1325,24 @@ und den Rest in verschiedene -

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    -wiki.sty aus dem nicetext-Bündel +

    „Minimales Markup“
    mit „forschenden“ aktiven Zeichen (MA)

    +wiki.sty aus dem nicetext-Bündel implementiert die zuvor beschriebene -Wikipedia-Syntax für TeX, d. h. mit wiki.sty +Wikipedia-Syntax für TeX, d. h. mit wiki.sty kann man in der {document}-Umgebung von LaTeX
      -
    1. statt \...section{...} einrahmende -Gleichheitszeichen-Folgen verwenden, +
    2. statt \...section{...} einrahmende +Gleichheitszeichen-Folgen verwenden,
    3. -
    4. Kursiv- und Fettschrift +
    5. Kursiv- und Fettschrift mit Folgen von -Apostroph-Ersatzzeichen“ +Apostroph-Ersatzzeichen“ (ASCII-Code 39) ein- und abschalten,
    6. -
    7. Listen und Blockzitate +
    8. Listen und Blockzitate aus Menschen- oder Programmiersprache durch -spezielle Zeilenanfänge anzeigen. +spezielle Zeilenanfänge anzeigen.
    @@ -1367,31 +1371,31 @@ spezielle Zeilenanf -

    wiki.stys „forschende“ Zeichen

    +

    wiki.stys „forschende“ Zeichen

      -
    1. Gleichheitszeichen werden aktive Zeichen, +
    2. Gleichheitszeichen werden aktive Zeichen, die feststellen, wieviele Gleichheitszeichen unmittelbar aufeinander folgen.
    3. -
    4. Ebenso funktionieren die Apostroph-Ersatzzeichen. +
    5. Ebenso funktionieren die Apostroph-Ersatzzeichen. Dabei werden \textit und \textbf nicht direkt -verwendet, das Umschalten und die -Kursivkorrektur -finden ohne „Gruppenbildung“ statt. +verwendet, das Umschalten und die +Kursivkorrektur +finden ohne „Gruppenbildung“ statt.
    6. -
    7. Um Listen und Zitate am Zeilenanfang -zu erkennen, wird das Zeilenende-Zeichen -(^^M) aktiv und ändert auch für kurze Zeit +
    8. Um Listen und Zitate am Zeilenanfang +zu erkennen, wird das Zeilenende-Zeichen +(^^M) aktiv und ändert auch für kurze Zeit die Kategorie des Leerzeichens. So analysiert ^^M den Anfang der nächsten Zeile und kann feststellen, ob eine Liste bzw. ein Blockzitat -beginnt, fortgesetzt wird, oder -endet, oder ob der Liste ein -weiterer Punkt (\item) hinzugefügt wird. +beginnt, fortgesetzt wird, oder +endet, oder ob der Liste ein +weiterer Punkt (\item) hinzugefügt wird. Entsprechend wird automatisch eine \begin{...}- bzw. \end{...}-Zeile oder das Makro -\item eingefügt +\item eingefügt
    @@ -1422,15 +1426,15 @@ Entsprechend wird automatisch eine

    (MA) vs. (MS)

    -Die Methoden (MA) (aktive Zeichen) -und (MS)
    (Substitution/Skript) -schließen sich nicht gegenseitig aus. +Die Methoden (MA) (aktive Zeichen) +und (MS)
    (Substitution/Skript) +schließen sich nicht gegenseitig aus.
    Welche Methode man anwendet, ist vielleicht „Geschmackssache“. -Die Wikipedia-Abschnittsüberschrift +Die Wikipedia-Abschnittsüberschrift (Gleichheitszeichen) wird in -wiki.sty nach Methode (MA),
    -in makedoc.sty nach Methode (MS) implementiert. +wiki.sty nach Methode (MA),
    +in makedoc.sty nach Methode (MS) implementiert.
    @@ -1459,17 +1463,17 @@ in makedoc.sty nach Methode (MS) imple -

    Teil 5: +

    Teil 5:
    -Dokumentation von LaTeX-Paketen +Dokumentation von LaTeX-Paketen
    - (mit nicetext)

    + (mit nicetext) @@ -1497,32 +1501,32 @@ in makedoc.sty nach Methode (MS) imple -

    Die Pakete des nicetext-Bündels

    +

    Die Pakete des nicetext-Bündels

    wiki.sty
    -Wikipedia-Markup gemäß (MA) +Wikipedia-Markup gemäß (MA) (s. o.)
    niceverb.sty
    -„minimales Markup“(?) speziell für Beschreibung +„minimales Markup“(?) speziell für Beschreibung
    -von LaTeX-Makros und LaTeX-Paketen +von LaTeX-Makros und LaTeX-Paketen (MA)
    makedoc.sty
    -Vorverarbeitung von +Vorverarbeitung von -Code+Kommentar-Dateien +Code+Kommentar-Dateien (MS)
    mdoccorr.cfg
    -Regeln zum Einfügen typografischer Zeichen (MS) +Regeln zum Einfügen typografischer Zeichen (MS)
    fifinddo.sty
    -makedoc.sty zugrundeliegende -Skriptsprache +makedoc.sty zugrundeliegende +Skriptsprache
    @@ -1552,36 +1556,36 @@ von LaTeX-Makros und LaTeX-Pa -

    wiki.sty

    +

    wiki.sty

      -
    1. Schriftkodierung -durch Folgen von Apostrophen finde ich -nicht intuitiv genug, +
    2. Schriftkodierung +durch Folgen von Apostrophen finde ich +nicht intuitiv genug, um andere Paketbearbeiter damit konfrontieren zu wollen, -[Publikum (U. Z.): Markdown!] +[Publikum (U. Z.): Markdown!]
    3. -
    4. … sie ist gegenwärtig auch inkompatibel mit der +
    5. … sie ist gegenwärtig auch inkompatibel mit der Verwendung „aktiver Apostrophe“ in -niceverb.sty. +niceverb.sty.
    6. -
    7. Überschriftenkodierung durch -Gleichheitszeichen verwende ich bisher in der -(MA)-Implementierung von makedoc.sty. +
    8. Überschriftenkodierung durch +Gleichheitszeichen verwende ich bisher in der +(MA)-Implementierung von makedoc.sty.
    9. -
    10. Dass Einrücken eine -verbatim-Umgebung auslöst, finde ich -unpraktisch. +
    11. Dass Einrücken eine +verbatim-Umgebung auslöst, finde ich +unpraktisch.
    12. -
    13. Im Quelltext sehe ich lieber „1.“, „2.“, +
    14. Im Quelltext sehe ich lieber „1.“, „2.“, …als „#“.
      -[Publikum: Markdown!] +[Publikum: Markdown!]
    15. -
    16. Unnummerierte Listen mit * sind -OK, -habe ich mal für „Fremddokumentation“ eingesetzt. +
    17. Unnummerierte Listen mit * sind +OK, +habe ich mal für „Fremddokumentation“ eingesetzt.
    @@ -1610,12 +1614,12 @@ habe ich mal f -

    Teil 6: +

    Teil 6:
    -niceverb.sty

    +niceverb.sty @@ -1642,23 +1646,23 @@ habe ich mal f -

    niceverb.sty – „Schriftauszeichnung

    +

    niceverb.sty – „Schriftauszeichnung

    „Fortsetzung“ der -Wikipedia-Schriftauszeichnung: +Wikipedia-Schriftauszeichnung:
      -
    1. Umrahmung mit einfachen Apostroph-Ersatzzeichen +
    2. Umrahmung mit einfachen Apostroph-Ersatzzeichen (’nicetext’) -wirkt wie \textsf -– für Paketnamen. +wirkt wie \textsf +– für Paketnamen.
    3. -
    4. einfache Anführungszeichen -wirken wie \texttt -– für Code +
    5. einfache Anführungszeichen +wirken wie \texttt +– für Code – tatsächlich wirkt \foo (solange nicht in Makro-Argument) wie -\verb+\foo+ -(Inline-verbatim). +\verb+\foo+ +(Inline-verbatim).
    @@ -1672,8 +1676,8 @@ wirken wie \texttt -Code mit niceverb.sty -wie Code sonst +Code mit niceverb.sty +wie Code sonst ’nicetext’\textsf{nicetext} \foo\verb+\foo+ @@ -1708,34 +1712,34 @@ wirken wie \texttt -

    Beschreibung von LaTeX-Makros

    +

    Beschreibung von LaTeX-Makros

    „Tippt man
     
    -\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
    +\foo∗[⟨opt-arg⟩]{⟨mand-arg⟩} 
     
    so erhält man …“ -– so soll die Beschreibung der Syntax von -\foo im .pdf aussehen. +– so soll die Beschreibung der Syntax von +\foo im .pdf aussehen. – -Code dafür mit niceverb.sty: +Code dafür mit niceverb.sty:
     
    -\foo∗[<opt-arg>]{<mand-arg>}’ 
    +\foo∗[<opt-arg>]{<mand-arg>}’ 
     
    -– ASCII-WYSIWYG +– ASCII-WYSIWYG
    – -\langle „typografisches“<“, +\langle „typografisches“<“,
    \rangle „typografisches“ „>“.
    – -Code dafür mit doc.sty +Code dafür mit doc.sty (aus der LaTeX-„base“-Distribution):
     
    -|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
    +|\foo∗[|\meta{opt-arg}|]{|\meta{mand-arg}|}| 
     
    @@ -1765,25 +1769,25 @@ wirken wie \texttt -

    Hervorhebung von Makrobeschreibungen

    +

    Hervorhebung von Makrobeschreibungen

    -Vertikalstriche (|\foo|) +Vertikalstriche (|\foo|)
      -
    • schalten im vorigen Beispiel (doc.sty) -– wie es sehr üblich ist – -verbatim-Modus an/aus, -d. h. |\foo| kürzt -\verb|\foo| ab – +
    • schalten im vorigen Beispiel (doc.sty) +– wie es sehr üblich ist – +verbatim-Modus an/aus, +d. h. |\foo| kürzt +\verb|\foo| ab –
    • -
    • sollen mit niceverb.sty -Code hervorheben und -beim Überfliegen der -Dokumentation herausstechen lassen +
    • sollen mit niceverb.sty +Code hervorheben und +beim Überfliegen der +Dokumentation herausstechen lassen („hier Erläuterung von \foo!“)
    -– Farbhinterlegung? derzeit -„Kästen“ wie mit \fbox, +– Farbhinterlegung? derzeit +„Kästen“ wie mit \fbox, intern soll \InlineCmdBox zusammenfassende Aufzählungen von Makros in einem Absatz ermöglichen. Beispiel Code/Ergebnis: @@ -1824,36 +1828,36 @@ intern soll \InlineCmdBox zusammenfassende Aufz -

    niceverb.sty noch:

    +

    niceverb.sty noch:

      -
    1. <meta> erzeugt „⟨meta⟩“ -sowohl innerhalb als auch +
    2. <meta> erzeugt „⟨meta⟩“ +sowohl innerhalb als auch außerhalb von einfachen Anführungszeichen.
    3. Im „Auto-Modus“ werden LaTeX-Befehle nicht -ausgeführt, sondern als verbatim-Text +ausgeführt, sondern als verbatim-Text interpretiert, etwa folgende Sterne und Klammern -als Syntaxbeschreibung dazu. +als Syntaxbeschreibung dazu.
    4. – dient besonders -der „Fremddokumentation“ +der „Fremddokumentation“ (vorhandene ASCII-Paketdokumentation anderer Autoren ohne Eingriff in LaTeX-Qualität setzen).
    5. -
    6. &“ -ist aktives Zeichen, welches in -Makroargumenten Befehlen und +
    7. &“ +ist aktives Zeichen, welches in +Makroargumenten Befehlen und Syntaxbeschreibungen vorangestellt werden kann, -um „nachzuhelfen“: +um „nachzuhelfen“:
       
      -\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
      +\footnote{&\foo∗[<opt-arg>]{<mand-arg>}} 
       
    8. -aktive Zeichen → Probleme … -Auswege … +aktive Zeichen → Probleme … +Auswege …
    @@ -1882,34 +1886,34 @@ um „nachzuhelfen“: -

    Ähnliche Pakete anderer Autoren

    +

    Ähnliche Pakete anderer Autoren

      -
    1. niceverb.sty ist wesentlich inspiriert -durch die Dokumentationsmethode Stephan Böttchers -in lineno.sty. +
    2. niceverb.sty ist wesentlich inspiriert +durch die Dokumentationsmethode Stephan Böttchers +in lineno.sty.
    3. Ähnliche Funktionalität liefert auch -ltxguide.cls für die „LaTeX-Guides“. +ltxguide.cls für die „LaTeX-Guides“.
    4. -
    5. Die bequeme Syntaxbeschreibung +
    6. Die bequeme Syntaxbeschreibung gibt es -(„mittlerweile“) auch in Martin Scharrers +(„mittlerweile“) auch in Martin Scharrers ydoc.
    7. -
    8. niceverb.sty ist ebenso wie -ydoc als Alternative -zu doc.sty konzipiert. -ydoc liefert dabei einen ähnlichen -Funktionsumfang wie doc.sty, +
    9. niceverb.sty ist ebenso wie +ydoc als Alternative +zu doc.sty konzipiert. +ydoc liefert dabei einen ähnlichen +Funktionsumfang wie doc.sty, während ich (für meine Zwecke) einen solchen Funktionsumfang überhaupt -nicht haben will. -– Allerdings habe ich einzelne -doc.sty-Funktionen in -makedoc.sty und in -readprov.sty +nicht haben will. +– Allerdings habe ich einzelne +doc.sty-Funktionen in +makedoc.sty und in +readprov.sty (fileinfo-Bündel).
    @@ -1939,7 +1943,7 @@ einen solchen Funktionsumfang -

    Teil 7: +

    Teil 7: @@ -1971,17 +1975,17 @@ einen solchen Funktionsumfang
    -

    Code und „Kommentar“

    +

    Code und „Kommentar“

    -[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil] +[vgl. Schuld und Sühne, Pride and Prejudice, Gesetzeskommentar zum Code civil]

    TeX bietet wie alle „normalen“ Programmiersprachen die Möglichkeit, -in Quelldateien Text einzufügen, der nicht -vom Compiler bzw. Interpreter (als Befehle/Daten) -verarbeitet werden soll, sondern an (menschliche) Leser -gerichtet ist – hier „Kommentar“. +in Quelldateien Text einzufügen, der nicht +vom Compiler bzw. Interpreter (als Befehle/Daten) +verarbeitet werden soll, sondern an (menschliche) Leser +gerichtet ist – hier „Kommentar“.
    -Einzelne Zwecke +Einzelne Zwecke (der Wikipedia-Artikel weiß noch mehr …): @@ -2011,28 +2015,28 @@ wei -

    Zwecke des Kommentars

    +

    Zwecke des Kommentars

    1. Erläuterungen für Programmierer, um die Wartung des Codes zu erleichtern –
    2. -
    3. gerade im Falle von TeX- und LaTeX-Paketen +
    4. gerade im Falle von TeX- und LaTeX-Paketen (alter Zeiten) -an Nutzer gerichtete „Erläuterungen“ +an Nutzer gerichtete „Erläuterungen“ im Sinne einer Gebrauchsanleitung
      (manchmal der einzig verfügbaren).
    5. In etwa gleichrangig Bedeutung des „Auskommentierens“ von Code, d. h. -„Kommentar“ enthält -eigentlich Befehle/Daten für -Compiler/Interpreter, die der Programmierer -(oder auch Dokumentautor) -„aufbewahren“ möchte statt völlig zu -löschen +„Kommentar“ enthält +eigentlich Befehle/Daten für +Compiler/Interpreter, die der Programmierer +(oder auch Dokumentautor) +„aufbewahren“ möchte statt völlig zu +löschen
    @@ -2063,25 +2067,25 @@ Compiler/Interpreter, die der Programmierer -

    Zwecke des „Auskommentierens“

    +

    Zwecke des „Auskommentierens“

    1. als eine Art „Versionskontrolle“: -man behält sich vor, den Code später wieder +man behält sich vor, den Code später wieder „an den Compiler/Interpreter zu richten“ (durch einfache Entfernung der Kommentarzeichen bzw. -„Kommentarbegrenzern“), +„Kommentarbegrenzern“), z. B. zum „Debugging“ oder für bestimmte Adressaten –
    2. -
    3. als „Erinnerung“ and frühere „Fehlversuche“, +
    4. als „Erinnerung“ and frühere „Fehlversuche“, die auf frühere „Überlegungen“ hinweist und so wieder der Wartung durch den Programmierer/Autor dient.
    Ich nehme an, bei vielen ist in der täglichen Praxis mit TeX/LaTeX das „Auskommentieren“ die hauptsächliche Funktion des -„Kommentars“ … +„Kommentars“ … @@ -2109,12 +2113,12 @@ das „Auskommentieren“ die haupts -

    Teil 8: +

    Teil 8:
    -Methoden Kommentar „auszublenden“

    +Methoden Kommentar „auszublenden“ @@ -2141,21 +2145,21 @@ Methoden Kommentar „auszublenden“ -

    Feinheiten des „Ausblendens“
    von Kommentar

    +

    Feinheiten des „Ausblendens“
    von Kommentar

      -
    1. Enthält eine TeX/LaTeX-Paketdatei +
    2. Enthält eine TeX/LaTeX-Paketdatei die TeX-Anweisungen und gleichzeitig die Gebrauchsanweisung, so umfasst sie typischerweise wesentlich mehr -Kommentarzeilen als Anweisungszeilen. +Kommentarzeilen als Anweisungszeilen.
    3. Auch „Programmierertext“, der die Implementierung sorgfältig diskutiert, kann im Verhältnis zum Code sehr umfangreich sein (z. B. lineno.sty).
    4. -
    5. „Vor langer Zeit“ forderte das Einlesen -von TeX-Makrodateien aufgrund der „Hardware-Umstände“ -bereits so viel Zeit, dass es sinnvoll war, +
    6. „Vor langer Zeit“ forderte das Einlesen +von TeX-Makrodateien aufgrund der „Hardware-Umstände“ +bereits so viel Zeit, dass es sinnvoll war, das Einlesen von Kommentarzeilen völlig zu vermeiden …
    @@ -2185,22 +2189,22 @@ das Einlesen von Kommentarzeilen v -

    „Ausblenden“ von Kommentar – Forts. …

    +

    „Ausblenden“ von Kommentar – Forts. …

      -
    1. Ein „primitiver“ Ansatz dazu war, +
    2. Ein „primitiver“ Ansatz dazu war, die „Gebrauchsanleitung“
      -„am Ende der Datei“ nach dem -\endinput-Befehl der Datei +„am Ende der Datei“ nach dem +\endinput-Befehl der Datei anzubringen. Die Datei enthielt dann gerne am -Anfang den Hinweis auf die Gebrauchsanleitung -der Datei an ihrem Ende.
      +Anfang den Hinweis auf die Gebrauchsanleitung +der Datei an ihrem Ende.
      Der \endinput-Befehl bricht die Verarbeitung der Datei ab, so dass die Zeilen darunter tatsächlich keine Verarbeitungszeit mehr beanspruchen.
    3. -
    4. Andererseits sollte für die Wartung -der Kommentar eben doch in der Nähe der +
    5. Andererseits sollte für die Wartung +der Kommentar eben doch in der Nähe der betreffenden Code-Zeilen angebracht werden …
    @@ -2230,25 +2234,25 @@ betreffenden Code-Zeilen angebracht werden … -

    docstrip blendet noch effizienter aus:

    +

    docstrip blendet noch effizienter aus:

      -
    1. Mit LaTeX2 hatten Paket-Dateien -die Endung .sty“.
      -Sie enthielten noch „Kommentar“ wie oben. +
    2. Mit LaTeX2 hatten Paket-Dateien +die Endung .sty“.
      +Sie enthielten noch „Kommentar“ wie oben.
    3. -
    4. Mit LaTeX2e wurden doc.sty und -docstrip.tex eingeführt. -Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung -.doc oder .dtx“. +
    5. Mit LaTeX2e wurden doc.sty und +docstrip.tex eingeführt. +Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung +.doc oder .dtx“. docstrip wandelt solche Dateien in Dateien mit Endungen -hauptsächlich wie .sty oder -.cls um; -diese sollen keinen Kommentar mehr enthalten -(bis auf Lizenz-Hinweise) und sind diejenigen, -die im TeX-Lauf tatsächlich eingelesen werden, -außer … +hauptsächlich wie .sty oder +.cls um; +diese sollen keinen Kommentar mehr enthalten +(bis auf Lizenz-Hinweise) und sind diejenigen, +die im TeX-Lauf tatsächlich eingelesen werden, +außer …
    @@ -2277,31 +2281,31 @@ die im TeX-Lauf tats -

    Kommentarzeichen

    +

    Kommentarzeichen

      -
    1. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich -durch das Kommentarzeichen („%“) +
    2. Kommentarzeilen sind mit TeX/LaTeX gewöhnlich +durch das Kommentarzeichen („%“) am Anfang gekennzeichnet.
    3. -
    4. (Nach \endinput wird Code auch -ohne Kommentarzeichen ignoriert; +
    5. (Nach \endinput wird Code auch +ohne Kommentarzeichen ignoriert; ebenso kann man im Prinzip „Kommentar“ ⟨kommentar⟩ mit -\iffalsekommentar\fi +\iffalsekommentar\fi einrahmen.)
    6. -
    7. Diese (ganz oben) Zeilen mit Kommentarzeichen -werden dann von docstrip entfernt … -d. h., diese Kommentarzeichen dienen gar nicht +
    8. Diese (ganz oben) Zeilen mit Kommentarzeichen +werden dann von docstrip entfernt … +d. h., diese Kommentarzeichen dienen gar nicht mehr dem Zweck, die Zeilen beim Einlesen der Paketdatei als „zu ignorieren“ zu kennzeichnen, vielmehr sind sie gar -nicht mehr da. Wieso dann noch Kommentarzeichen? +nicht mehr da. Wieso dann noch Kommentarzeichen?
    9. -
    10. … tatsächlich: Mit Paul Isamberts +
    11. … tatsächlich: Mit Paul Isamberts CodeDoc ist der „Kommentar“ -normaler, von Listing-Umgebungen +normaler, von Listing-Umgebungen unterbrochener Text (ohne „%“ links). -Letztere schreiben den Code in die kompakte Paketdatei. +Letztere schreiben den Code in die kompakte Paketdatei.
    @@ -2330,26 +2334,26 @@ Letztere schreiben den Code in die kompakte Paketdatei
    -

    Ohne docstrip heute

    +

    Ohne docstrip heute

    (docstrip fortsetzend:) … aber -es gibt die .sty-Pakete, -die mit Kommentarzeilen -(ohne docstrip einzuschalten) eingelesen werden, noch heute! +es gibt die .sty-Pakete, +die mit Kommentarzeilen +(ohne docstrip einzuschalten) eingelesen werden, noch heute!
    • verschiedene in TDS-ltxmisc/, darunter einige geniale, für manche unverzichtbare Pakete von -Donald Arseneau (ich sehe gerade framed …) +Donald Arseneau (ich sehe gerade framed …)
    • -
    • Stephan Böttchers lineno.sty +
    • Stephan Böttchers lineno.sty (Zeilennummerierung besonders für -kritische Editionen und Einreichungen) +kritische Editionen und Einreichungen) enthält gewaltig viel Kommentar – von mir übernommen, nie gehört, dass das Laden zu lange dauere …
    • alle (? \endinput) meine -eigenen +eigenen Pakete (was natürlich einfach eine Frechheit sein kann …)
    @@ -2379,12 +2383,12 @@ Pakete (was nat -

    Teil 9: +

    Teil 9:
    -„Darstellung“ des Kommentars

    +„Darstellung“ des Kommentars @@ -2412,19 +2416,19 @@ Pakete (was nat -

    „Darstellung“ des Kommentars – „Vorzeit“

    +

    „Darstellung“ des Kommentars – „Vorzeit“

      -
    1. Vor doc.sty -war der Kommentar in Paketdateien -dazu da, mit einem Texteditor gelesen oder -im „Text“-Modus +
    2. Vor doc.sty +war der Kommentar in Paketdateien +dazu da, mit einem Texteditor gelesen oder +im „Text“-Modus (als „Listing“, im Gegensatz zum für TeX -erforderlichen „Grafik“-Modus) -ausgedruckt zu werden. +erforderlichen „Grafik“-Modus) +ausgedruckt zu werden.
    3. Kommentar entsprechend -„reiner ASCII-Text“, +„reiner ASCII-Text“, weder „typografische Zeichen“ noch Auszeichnung.
    @@ -2454,32 +2458,32 @@ weder „typografische Zeichen“ noch Auszeichnung. -

    Darstellung des Kommentars mit doc.sty

    +

    Darstellung des Kommentars mit doc.sty

      -
    1. Erst mit doc.sty wurde -die heute von LaTeX-Paketen auf dem -CTAN gewohnte LaTeX-Druckqualität -des Kommentars möglich, -wobei man den Code als Imitation +
    2. Erst mit doc.sty wurde +die heute von LaTeX-Paketen auf dem +CTAN gewohnte LaTeX-Druckqualität +des Kommentars möglich, +wobei man den Code als Imitation der Texteditor- und Listing-Druckqualität auszeichnet. -Entscheidend ist dabei der -Don’t repeat yourself-Grundsatz -– die Code und -Kommentar mischende Quelldatei wird für +Entscheidend ist dabei der +Don’t repeat yourself-Grundsatz +– die Code und +Kommentar mischende Quelldatei wird für den Qualitätsausdruck nicht von Hand überarbeitet, -sondern „automatisch“ mit dem \DocInput-Befehl +sondern „automatisch“ mit dem \DocInput-Befehl verarbeitet.
    3. -
    4. (Wie war das eigentlich mit WEB?) +
    5. (Wie war das eigentlich mit WEB?)
    6. Dazu kann man allerdings (oder konnte bisher) -nicht (den früheren) -ASCII“-Kommentar verwenden, +nicht (den früheren) +ASCII“-Kommentar verwenden, der Kommentar muss vielmehr als „LaTeX-Input“ -mit typografischen Zeichen und -LaTeX-Markup -in der Code+Kommentar-Quelldatei stehen +mit typografischen Zeichen und +LaTeX-Markup +in der Code+Kommentar-Quelldatei stehen (vgl. ltxdoc-Dokumentation zu {oldcomments}).
    @@ -2509,10 +2513,10 @@ in der Code+Kommentar-Quelldatei stehen -

    \DocInput{⟨c+k⟩}

    -… (doc, gmdoc, …) -verarbeitet die Code/Kommentar mischende Datei -c+k so – sie enthalte als Beispiel +

    \DocInput{⟨c+k⟩}

    +… (doc, gmdoc, …) +verarbeitet die Code/Kommentar mischende Datei +c+k so – sie enthalte als Beispiel
     
     % \textit{dolce far niente:} 
    @@ -2521,7 +2525,7 @@ verarbeitet die Code/Kommentar mischende Datei
     %    \end{macrocode} 
     % -- genug, 
     
    -\DocInput{⟨c+k⟩} führt \MakePercentIgnore +\DocInput{⟨c+k⟩} führt \MakePercentIgnore vor \input{⟨c+k⟩} aus, Effekt wie
     
      \textit{dolce far niente:} 
    @@ -2566,12 +2570,12 @@ vor \input{⟨c+k⟩} aus, Effekt wie
         \end{macrocode} 
      -- genug, 
     
    -… so kommt der Code in eine -Listing-Umgebung, der Rest wird -„normal“ in LaTeX-Qualität gesetzt. +… so kommt der Code in eine +Listing-Umgebung, der Rest wird +„normal“ in LaTeX-Qualität gesetzt.

    -„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis … @@ -2599,7 +2603,7 @@ dass man dasselbe Ergebnis … -

    „Minimale“ Kennzeichnung des Codes

    +

    „Minimale“ Kennzeichnung des Codes

    … statt mit
     
    @@ -2645,9 +2649,9 @@ Dies erreichen …
     
    -

    „smartes“ \DocInput

    +

    „smartes“ \DocInput

    -– Algorithmus klar:
    +– Algorithmus klar:
     – nach Zeile mit%“ vor „ohne“\begin{macrocode}“,
    @@ -2655,22 +2659,22 @@ Dies erreichen … einfügen –
      -
    1. gmdoc (Grzegorz Murzinowski; -ich meine mich zu erinnern:
      +
    2. gmdoc (Grzegorz Murzinowski; +ich meine mich zu erinnern:
      wie bei wiki.sty sind die -Zeilenendzeichen aktiv
      +Zeilenendzeichen aktiv
      und schauen sich den nächsten Zeilenanfang an)
    3. -
    4. lineno (Stephan Böttcher) +
    5. lineno (Stephan Böttcher) – eine UNIX-Shell wendet ein in der Datei lineno.sty enthaltenes awk-Skript auf lineno.sty an, erzeugt Dokumentationsdatei lineno.tex …
    6. -
    7. makedoc.sty (selbst) bietet statt awk +
    8. makedoc.sty (selbst) bietet statt awk eine Art TeX-basierte Skriptsprache und unterschiedliche -Zeilenparser,
      +Zeilenparser,
      um jeweils eine Dokumentationsdatei zu erzeugen.
    @@ -2701,10 +2705,10 @@ um jeweils eine Dokumentationsdatei zu erzeugen. -

    „Interpretationen“ von Kommentarzeichen

    +

    „Interpretationen“ von Kommentarzeichen

    -echter Kommentar vs. „Auskommentieren“, +echter Kommentar vs. „Auskommentieren“, ich:
     
     \typeout{ok} %% Code 
    @@ -2713,7 +2717,7 @@ ich:
     %% % <- falls KO %% auskommentierter Kommentar 
     %% %% <- 2011/10/01 %% Kommentar zum Kommentar 
     
    -ergibt mit makedoc und von mir bevorzugten +ergibt mit makedoc und von mir bevorzugten Einstellungen:
    \typeout{ok} %% Code
    @@ -2721,9 +2725,9 @@ Einstellungen: ←falls ko
    – Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „%% verwenden +für verschiedene „Stile“, +etwa Pakete anderer Autoren, die +keine „%% verwenden
    @@ -2752,34 +2756,34 @@ etwa Pakete anderer Autoren, die -

    makedocs \DocInput{⟨job⟩}

    +

    makedocs \DocInput{⟨job⟩}

    Genaue Entsprechung zu \DocInput fehlt derzeit.
    „⟨job⟩“ ergibt sich von selbst, oder …
    -Verschiedene Skriptbefehle -unterstützen unterschiedliche Dokumentationsstile +Verschiedene Skriptbefehle +unterstützen unterschiedliche Dokumentationsstile (Übersicht: -mdoccheat.pdf).
    +mdoccheat.pdf).

    c+k-Dateien werden mit makedoc nicht direkt eingelesen.
    Die Hauptdatei

      -
    1. erzeugt aus (je)der c+k-Datei eine -Dokumentationsversion -(.txt.tex, -Einfügen von „Listing-Wrappern“, -Zeichenkettenersetzungen -für Gliederung und typografische Zeichen, +
    2. erzeugt aus (je)der c+k-Datei eine +Dokumentationsversion +(.txt.tex, +Einfügen von „Listing-Wrappern“, +Zeichenkettenersetzungen +für Gliederung und typografische Zeichen, dazu Datei -mdoccorr.cfg/pdf, +mdoccorr.cfg/mdoccorr.pdf,
    3. -
    4. liest und setzt die erzeugte Datei dann als -.tex. +
    5. liest und setzt die erzeugte Datei dann als +.tex.
    -Genauer … +Genauer …
    @@ -2809,31 +2813,31 @@ dazu Datei

    Dokumentationslauf

    -[Genauer] … kompiliere +[Genauer] … kompiliere ich typischerweise die Dokumentation
      -
    1. job⟩.pdf von -job⟩.sty aus -job⟩.tex. +
    2. job⟩.pdf von +job⟩.sty aus +job⟩.tex.
    3. -
    4. job⟩.tex +
    5. job⟩.tex enthält makedoc-Befehle zur Erzeugung von -job⟩.doc aus -job⟩.sty und zum Einlesen von -job⟩.doc, +job⟩.doc aus +job⟩.sty und zum Einlesen von +job⟩.doc,
    6. kann noch Dokumentation von -Ergänzungspaketen +Ergänzungspaketenadd⟩ via -add⟩.doc einbinden. +add⟩.doc einbinden.
    7. -
    8. job.doc/add.doc +
    9. job.doc/add.doc können
      (nach \RequirePackage{makedoc})
      ganz zu Anfang des TeX-Laufs innerhalb einer Gruppe erzeugt und dann in der {document}-Umgebung mit -\input eingelesen werden. +\input eingelesen werden.
    @@ -2866,36 +2870,36 @@ und dann in der {document}-Umgebung mit
      -
    1. Ich kann damit flott +
    2. Ich kann damit flott Pakete schreiben/dokumentieren
      -(auch mit Dokumentation als -Roadmap beginnen). +(auch mit Dokumentation als +Roadmap beginnen).
      Nach Einrichten des -Dokumentations-Workflows
      -läuft mittlerweile meist alles „wie am Schnürchen“. +Dokumentations-Workflows
      +läuft mittlerweile meist alles „wie am Schnürchen“.
    3. -Einrichten eines solchen Workflows -war aufwändig,
      dafür jetzt Vorlagen -sowie Bash- und -fifinddo-Skripts. +Einrichten eines solchen Workflows +war aufwändig,
      dafür jetzt Vorlagen +sowie Bash- und +fifinddo-Skripts.
    4. -
    5. Fehler wegen Umwegs über -erzeugte Dateien
      +
    6. Fehler wegen Umwegs über +erzeugte Dateien
      (mehr Zeilen als in Quelldatei) -manchmal schwer verständlich … +manchmal schwer verständlich …
    7. -In der Praxis kann ich (derzeit) -doch LaTeX-Befehle
      +In der Praxis kann ich (derzeit) +doch LaTeX-Befehle
      (Backslashs, …, vgl. Vorgabe) -nicht ganz vermeiden,
      -wohl vor allem bei Verweisen … +nicht ganz vermeiden,
      +wohl vor allem bei Verweisen …
    8. -
    9. Dennoch gelungene „Fremddokumentationen“:
      -arseneau.pdf, -substr.pdf. +
    10. Dennoch gelungene „Fremddokumentationen“:
      +arseneau.pdf, +substr.pdf.
    @@ -2924,24 +2928,24 @@ wohl vor allem bei Verweisen … -

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

    +

    Vorteile und Problematik der Zeichenkategorien (\catcode...)

      -
    1. für Dokumentationsvorverarbeitung -Einlesen als „reinen Text“ -(\dospecials other) +
    2. für Dokumentationsvorverarbeitung +Einlesen als „reinen Text“ +(\dospecials other)
    3. -
    4. \PatternCodes für Ersetzungsregeln +
    5. \PatternCodes für Ersetzungsregeln anzupassen
    6. -
    7. blog.sty (morehype-Bündel) -nutzt dagegen „minimale“ TeX-Syntax, -expandiert Makros zu HTML-Code +
    8. blog.sty (morehype-Bündel) +nutzt dagegen „minimale“ TeX-Syntax, +expandiert Makros zu HTML-Code (Hauptdatei „makehtml.tex“ o. ä. -wandelt ⟨job.tex +wandelt ⟨job.tex zeilenweise -in ⟨job.html um). +in ⟨job.html um).
    @@ -2971,12 +2975,12 @@ in ⟨job.html um). -

    Teil 10: +

    Teil 10:
    -HTML erzeugen

    +HTML erzeugen @@ -3003,32 +3007,32 @@ in ⟨job.html um). -

    Nutzen von HTML (vs. PDF)

    +

    Nutzen von HTML (vs. PDF)

      -
    1. Internetauftritt/CMS +
    2. Internetauftritt/CMS
    3. -
    4. „Elektronischer Zettelkasten“ +
    5. „Elektronischer Zettelkasten
      1. Querverweise
      2. -
      3. gegliederte/kommentierte Link-Sammlungen +
      4. gegliederte/kommentierte Link-Sammlungen
      5. -
      6. Hervorhebung von Stichwörtern +
      7. Hervorhebung von Stichwörtern in Texten aus anderen Formaten (Xpad/Tomboy)
    6. -
    7. besserer Lesefluss ohne Seitenumbrüche,
      -ohne problematische Zeilenumbrüche +
    8. besserer Lesefluss ohne Seitenumbrüche,
      +ohne problematische Zeilenumbrüche
    9. -
    10. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung) +
    11. keine Arbeit mit Umbrüchen
      (außer gedankliche Gliederung)
    12. -
    13. Bildschirmfläche voll nutzen +
    14. Bildschirmfläche voll nutzen
    @@ -3057,17 +3061,17 @@ ohne problematische Zeilenumbr -

    HTML-Erzeugung – Alternativen

    +

    HTML-Erzeugung – Alternativen

      -
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal +
    • HTML-Editoren, CMSe?; Formeln? keine Ahnung, egal
    • TeX4th (Eitan Gurari†; Wikipedia sehr informativ) -– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros +– verarbeitet .dvi, kommt insofern (wohl) mit allen Paketen/Makros zurecht, ohne sie einzeln zu behandeln -– damit Webseiten pflegen? +– damit Webseiten pflegen?
    • diverse Syntax-Wandler wie LaTeX2html (Perl), hevea.inria.fr, @@ -3081,9 +3085,9 @@ vgl. tug.org
    • blog.sty (morehype-Bündel) – expandiert Makros zu HTML; -LaTeX-Makros umdefiniert, -neue Makros für bestimmte -HTML-Strukturen, z. B.lnavicol.sty +LaTeX-Makros umdefiniert, +neue Makros für bestimmte +HTML-Strukturen, z. B.lnavicol.sty
    @@ -3112,29 +3116,29 @@ vgl. tug.org -

    HTML und PDF aus selber Quelle?

    +

    HTML und PDF aus selber Quelle?

      -
    1. \labelsection etc. – htmlTeX
      -(HTML regt zu Makros an, die auch für -PDF-Erzeugung interessant wären,
      +
    2. \labelsection etc. – htmlTeX
      +(HTML regt zu Makros an, die auch für +PDF-Erzeugung interessant wären,
      angefangen mit logischer Auszeichnung wie <code>/\code, <strong>/\strong.)
    3. -
    4. texlinks.sty +
    5. texlinks.sty (morehype-Bündel)
      -bietet Beispiele für Makros, -die gleichermaßen +bietet Beispiele für Makros, +die gleichermaßen
        -
      • für hyperref/PDF +
      • für hyperref/PDF
      • -
      • wie für HTML-Erzeugung mit -blog.sty +
      • wie für HTML-Erzeugung mit +blog.sty
      geeignet sind (fußen auf wenigen @@ -3172,7 +3176,7 @@ wie etwa \href,
      nur ein solches f

    Was (zur Zeit) nicht geht

    -(weil Makros nur expandiert werden, +(weil Makros nur expandiert werden, vgl. Funktionale Programmierung): Zähler, optionale Argumente, ∗-Varianten, \unskip, \verb; \begin öffnet keine Gruppe für lokale Einstellungen, @@ -3186,7 +3190,7 @@ solche k
    -Ausweg irgendwann: besondere Behandlung +Ausweg irgendwann: besondere Behandlung von Zeilen, die bestimmte einzelne Makros enthalten, wie etwa \EXECUTE{⟨einstellungen⟩}, @@ -3197,8 +3201,8 @@ wie etwa
    -Wandlung zeilenweise erschwert auch Verteilen -von Makroargumenten über mehrere Zeilen +Wandlung zeilenweise erschwert auch Verteilen +von Makroargumenten über mehrere Zeilen („Klammer rechtzeitig öffnen“). Künftige Alternativen wären catchfile oder „bis zur nächsten leeren Zeile am Stück“ einlesen. @@ -3235,31 +3239,30 @@ oder „bis zur n
      -
    • blog.sty wurde (2010) +
    • blog.sty wurde (2010) mittelbar/teilweise durch die DFG unterstützt
    • -
    • den Einstieg in HTML +
    • den Einstieg in HTML verdanke ich in erster Linie meinem Bruder, Rainer Lück (www.webdesign-bu.de)
    • -
    • fürs Zuhören [Zuschauen] +
    • fürs Zuhören [Zuschauen]
    und nachträglich:
      -
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      +
    • an Uwe Ziegenhagen (u. a.) für Hinweis auf
      Markdown und pandoc,
    • -
    • an Bernd Raichle für Hinweis auf -Kees van der Laans (NTG) Arbeiten über +
    • an Bernd Raichle für Hinweis auf +Kees van der Laans (NTG) Arbeiten über „minimales Markup“,
    • -
    • technischen Helfern“ -(Kabel/ -xrandr)! +
    • technischen Helfern“ +(Kabel/xrandr)!
    -- cgit v1.2.3