From cccdf1e8ee107f41bca9bb3f936501c0b1acd75d Mon Sep 17 00:00:00 2001
From: Karl Berry uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-768-com
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
|
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
.txt
zu .tex
(anders als \dots
),
<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]
-realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ] -
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
-
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,17 +1117,17 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
-(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,18 +1288,18 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
-makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
-niceverb.sty
+niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
-\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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
-\InlineCmdBox
zusammenfassende Aufz
niceverb.sty
noch:niceverb.sty
noch:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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 …):
-
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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,
\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 … -
… statt mit
@@ -2619,7 +2623,7 @@ erh Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f |
\href
,
-(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
|
\EXECUTE{〈einstellungen〉}
,
@@ -3197,14 +3201,14 @@ wie etwa
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
-
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-1180-clean
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
| ||
-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 …) |
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
Von
-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.
|
realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ]
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,15 +1117,15 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,15 +1288,15 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
+niceverb.sty
niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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
-… 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.\textit{dolce far niente:}
@@ -2566,12 +2570,12 @@ vor\input{〈c+k〉}
aus, Effekt wie\end{macrocode}
-- genug,
-„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis …
… statt mit
@@ -2645,9 +2649,9 @@ Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f | |||
Was (zur Zeit) nicht geht
\EXECUTE{〈einstellungen〉} ,
@@ -3197,8 +3201,8 @@ wie etwa
| |||
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
@@ -3235,31 +3239,30 @@ oder „bis zur n
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-1180-com
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
|
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
.txt
zu .tex
(anders als \dots
),
<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]
-realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ] -
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
-
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,17 +1117,17 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
-(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,18 +1288,18 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
-makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
-niceverb.sty
+niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
-\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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
-\InlineCmdBox
zusammenfassende Aufz
niceverb.sty
noch:niceverb.sty
noch:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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 …):
-
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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,
\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 … -
… statt mit
@@ -2619,7 +2623,7 @@ erh Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f |
\href
,
-(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
|
\EXECUTE{〈einstellungen〉}
,
@@ -3197,14 +3201,14 @@ wie etwa
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
-
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-768-com
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
|
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
.txt
zu .tex
(anders als \dots
),
<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]
-realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ] -
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
-
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,17 +1117,17 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
-(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,18 +1288,18 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
-makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
-niceverb.sty
+niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
-\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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
-\InlineCmdBox
zusammenfassende Aufz
niceverb.sty
noch:niceverb.sty
noch:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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 …):
-
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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,
\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 … -
… statt mit
@@ -2619,7 +2623,7 @@ erh Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f |
\href
,
-(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
|
\EXECUTE{〈einstellungen〉}
,
@@ -3197,14 +3201,14 @@ wie etwa
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
-
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-768-exact-frame
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
| ||
-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 …) |
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
Von
-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.
|
realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ]
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,15 +1117,15 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,15 +1288,15 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
+niceverb.sty
niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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
-… 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.\textit{dolce far niente:}
@@ -2566,12 +2570,12 @@ vor\input{〈c+k〉}
aus, Effekt wie\end{macrocode}
-- genug,
-„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis …
… statt mit
@@ -2645,9 +2649,9 @@ Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f | |||
Was (zur Zeit) nicht geht
\EXECUTE{〈einstellungen〉} ,
@@ -3197,8 +3201,8 @@ wie etwa
| |||
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
@@ -3235,31 +3239,30 @@ oder „bis zur n
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-768-exact-show
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
| ||
-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 …) |
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
Von
-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.
|
realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ]
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,15 +1117,15 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,15 +1288,15 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
+niceverb.sty
niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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
-… 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.\textit{dolce far niente:}
@@ -2566,12 +2570,12 @@ vor\input{〈c+k〉}
aus, Effekt wie\end{macrocode}
-- genug,
-„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis …
… statt mit
@@ -2645,9 +2649,9 @@ Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f | |||
Was (zur Zeit) nicht geht
\EXECUTE{〈einstellungen〉} ,
@@ -3197,8 +3201,8 @@ wie etwa
| |||
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
@@ -3235,31 +3239,30 @@ oder „bis zur n
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-768-filltype-show
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
|
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
.txt
zu .tex
(anders als \dots
),
<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]
-realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ] -
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
-
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,17 +1117,17 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
-(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,18 +1288,18 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
-makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
-niceverb.sty
+niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
-\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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
-\InlineCmdBox
zusammenfassende Aufz
niceverb.sty
noch:niceverb.sty
noch:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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 …):
-
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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,
\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 … -
… statt mit
@@ -2619,7 +2623,7 @@ erh Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f |
\href
,
-(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
|
\EXECUTE{〈einstellungen〉}
,
@@ -3197,14 +3201,14 @@ wie etwa
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
-
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-992-com
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
|
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
.txt
zu .tex
(anders als \dots
),
<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]
-realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ] -
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
-
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,17 +1117,17 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
-(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,18 +1288,18 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
-makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
-niceverb.sty
+niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
-\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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
-\InlineCmdBox
zusammenfassende Aufz
niceverb.sty
noch:niceverb.sty
noch:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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 …):
-
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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,
\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 … -
… statt mit
@@ -2619,7 +2623,7 @@ erh Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f |
\href
,
-(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
|
\EXECUTE{〈einstellungen〉}
,
@@ -3197,14 +3201,14 @@ wie etwa
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
-
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-992-exact-frame
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
| ||
-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 …) |
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
Von
-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.
|
realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ]
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,15 +1117,15 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,15 +1288,15 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
+niceverb.sty
niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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
-… 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.\textit{dolce far niente:}
@@ -2566,12 +2570,12 @@ vor\input{〈c+k〉}
aus, Effekt wie\end{macrocode}
-- genug,
-„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis …
… statt mit
@@ -2645,9 +2649,9 @@ Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f | |||
Was (zur Zeit) nicht geht
\EXECUTE{〈einstellungen〉} ,
@@ -3197,8 +3201,8 @@ wie etwa
| |||
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
@@ -3235,31 +3239,30 @@ oder „bis zur n
|
uwe_lueck
>
- texmap
>
dantev45
– neu laden
+ texmap
>
dantev45-992-exact
– neu 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“CTAN
+
+teil-0
|
titelerlaeut1
|
titelerlaeut2
|
@@ -115,7 +119,7 @@ und rechts unten f
niceverb.sty
und)fifinddo.sty
niceverb.sty
und)fifinddo.sty
-so erhält man …“\foo∗[〈opt-arg〉]{〈mand-arg〉}
, +\foo∗[〈opt-arg〉]{〈mand-arg〉}
,
| ||
-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 …) |
docstrip
)
-(bemerkenswerte Mischung aus:)
+(bemerkenswerte Mischung aus:)
|
|
Von
-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.
|
realisiert durch | -|
Auslassungszeichen | \dots |
Auslassungszeichen | \dots |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: Ligaturen ``... ; Deutsch mit (n)german.sty oder babel.sty – aktive Zeichen |
Gedanken-/„bis“-Strich | „--- “ (englisch), „-- “ – Ligaturen |
(Doppelte) Anführungszeichen | Englisch: 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 ]
-„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 –
|
~
“ besser als „
“,
aber …
\dots
schon übel …
-(warum nicht Ligatur „...
“?)
+ \dots
schon übel …
+(warum nicht Ligatur „...
“?)
\sfcode`A=999
schon in diese Richtung
+ \sfcode`A=999
schon in diese Richtung
(TeXbook S. 76)
german
/babel
…:
"
..."
expandiert zu
\glqq...
\grqq
oder so
.txt→.tex
“
+„.txt→.tex
“
in nicetext
-Beschreibung
(Schwäche der Terminologie)
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 ]
.txt
→.tex
vor nicetext
.txt
→.tex
vor nicetext
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)
txt2tex
– Perl, erzeugt tatsächlich
-LaTeX-Formatierung (Paketnamen „verkehrt“!)
+LaTeX-Formatierung (Paketnamen „verkehrt“!)
EasyLaTeX
ähnlich oder mehr,
-GUI(?), Ideen aus Wiki…-Markup;
+GUI(?), Ideen aus Wiki…-Markup;
zuletzt 2004 (README
2009 eher CTAN-Hand)
SmileTeX
Windows .exe
?
+ Werkzeuge für Grafikeinbindung etc.,
zuletzt 2004
EasyLaTeX
?
Wiki-Code | -wie LaTeX-Code | +Wiki-Code | +wie 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
Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code | -Wiki- | -wie LaTeX-Code | +Wiki- | +wie LaTeX-Code |
∗ Eins |
@@ -1113,15 +1117,15 @@ z. B. Buchtitel
wikicheat.pdf
)
+(vgl. wikicheat.pdf)
(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“ |
\@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.
fifinddo.sty
und
-makedoc.sty
(nicetext
)
+ fifinddo.sty
und
+makedoc.sty
(nicetext
)
auf dieser Methode – genügte bisher praktisch.
stringstrings
(Steven Segletes),
@@ -1284,15 +1288,15 @@ und ted
(Manu
coolstr
(Nick Setzer) und
texapi
(Paul Isambert).
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“.
wiki.sty
aus dem nicetext
-Bündel
+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
\...section{...}
einrahmende
-Gleichheitszeichen-Folgen verwenden,
+ \...section{...}
einrahmende
+Gleichheitszeichen-Folgen verwenden,
wiki.sty
s „forschende“ Zeichenwiki.sty
s „forschende“ Zeichen\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.
^^M
) aktiv und ändert auch für kurze Zeit
+ ^^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
-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.
|
makedoc.sty
nach Methode (MS) imple
nicetext
)
+ (mit nicetext
)
makedoc.sty
nach Methode (MS) imple
nicetext
-Bündelsnicetext
-Bündels
|
wiki.sty
wiki.sty
niceverb.sty
.
+niceverb.sty
.
makedoc.sty
.
+ makedoc.sty
.
#
“.
*
sind
-OK,
-habe ich mal für „Fremddokumentation“ eingesetzt.
+ *
sind
+OK,
+habe ich mal für „Fremddokumentation“ eingesetzt.
niceverb.sty
+niceverb.sty
niceverb.sty
– „Schriftauszeichnung“niceverb.sty
– „Schriftauszeichnung“’nicetext’
)
-wirkt wie \textsf
-– für Paketnamen.
+wirkt wie \textsf
+– für Paketnamen.
\texttt
-– für Code
+ \texttt
+– für Code
– tatsächlich wirkt ‘\foo
’
(solange nicht in Makro-Argument) wie
-\verb
+\foo
+
-(Inline-verbatim).
+\verb
+\foo
+
+(Inline-verbatim).
\texttt
’nicetext’
\textsf{nicetext}
‘\foo
’
\verb+
\foo+
\texttt
„Tippt man
-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 :
-‘-– „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):
- |
\texttt
|\foo
|
)
+Vertikalstriche (|\foo
|
)
doc.sty
)
-– wie es sehr üblich ist –
-verbatim-Modus an/aus,
-d. h. |\foo
|
kürzt
-\verb|
\foo|
ab –
+ doc.sty
)
+– wie es sehr üblich ist –
+verbatim-Modus an/aus,
+d. h. |\foo
|
kürzt
+\verb|
\foo|
ab –
niceverb.sty
-Code hervorheben und
-beim Überfliegen der
-Dokumentation herausstechen lassen
+ niceverb.sty
+Code hervorheben und
+beim Überfliegen der
+Dokumentation herausstechen lassen
(„hier Erläuterung von \foo
!“)
\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:<meta>
“ erzeugt „〈meta〉“
-sowohl innerhalb als auch
+ <meta>
“ erzeugt „〈meta〉“
+sowohl innerhalb als auch
außerhalb von einfachen Anführungszeichen.
&
“
-ist aktives Zeichen, welches in
-Makroargumenten Befehlen und
+ &
“
+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>}}
niceverb.sty
ist wesentlich inspiriert
-durch die Dokumentationsmethode Stephan Böttchers
-in lineno.sty
.
+ niceverb.sty
ist wesentlich inspiriert
+durch die Dokumentationsmethode Stephan Böttchers
+in lineno.sty
.
ltxguide.cls
für die „LaTeX-Guides“.
+ltxguide.cls
für die „LaTeX-Guides“.
ydoc
.
niceverb.sty
ist ebenso wie
-ydoc
als Alternative
-zu doc.sty
konzipiert.
-ydoc
liefert dabei einen ähnlichen
-Funktionsumfang wie doc.sty
,
+ 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).
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
|
lineno
.sty
).
\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.\endinput
-Befehl bricht die Verarbeitung der Datei ab,
so dass die Zeilen darunter tatsächlich
keine Verarbeitungszeit mehr beanspruchen.
docstrip
blendet noch effizienter aus:docstrip
blendet noch effizienter aus:.sty
“..sty
“.doc.sty
und
-docstrip.tex
eingeführt.
-Dateien, die Code und Kommentar „gemischt“ enthielten, bekamen nun die Endung
-„.doc
“ oder „.dtx
“.
+ 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 …
%
“)
+ %
“)
am Anfang gekennzeichnet.
\endinput
wird Code auch
-ohne Kommentarzeichen ignoriert;
+ \endinput
wird Code auch
+ohne Kommentarzeichen ignoriert;
ebenso kann man im Prinzip „Kommentar“ 〈kommentar〉 mit
-„\iffalse
〈kommentar〉\fi
“
+„\iffalse
〈kommentar〉\fi
“
einrahmen.)
docstrip
entfernt …
-d. h., diese Kommentarzeichen dienen gar nicht
+ 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?
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.
docstrip
heutedocstrip
heutedocstrip
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!
ltxmisc/
, darunter
einige geniale, für manche unverzichtbare Pakete von
-Donald Arseneau (ich sehe gerade framed
…)
+Donald Arseneau (ich sehe gerade framed
…)
lineno.sty
+ 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 …
\endinput
) meine
-eigenen
+eigenen
Pakete (was natürlich einfach eine Frechheit sein kann …)
doc.sty
-war der Kommentar in Paketdateien
-dazu da, mit einem Texteditor gelesen oder
-im „Text“-Modus
+ 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.
doc.sty
doc.sty
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
+ 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.
ltxdoc
-Dokumentation zu {oldcomments}
).
\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
-… 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.\textit{dolce far niente:}
@@ -2566,12 +2570,12 @@ vor\input{〈c+k〉}
aus, Effekt wie\end{macrocode}
-- genug,
-„Minimales Markup“ würde bedeuten, -dass man dasselbe Ergebnis … +„Minimales Markup“ würde bedeuten, +dass man dasselbe Ergebnis …
… statt mit
@@ -2645,9 +2649,9 @@ Dies erreichen … |
\DocInput
\DocInput
%
“ vor „ohne“
„\begin{macrocode}
“,gmdoc
(Grzegorz Murzinowski;
-ich meine mich zu erinnern:gmdoc
(Grzegorz Murzinowski;
+ich meine mich zu erinnern:wiki.sty
sind die
-Zeilenendzeichen aktivlineno
(Stephan Böttcher)
+ 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
…
makedoc.sty
(selbst) bietet statt awk
+ makedoc.sty
(selbst) bietet statt awk
eine Art TeX-basierte Skriptsprache und unterschiedliche
-Zeilenparser,
-echter Kommentar vs. „Auskommentieren“,
+echter Kommentar vs. „Auskommentieren“,
ich:
-ergibt mit makedoc und von mir bevorzugten
+ergibt mit makedoc und von mir bevorzugten
Einstellungen:
– Parsermakros -für verschiedene „Stile“, -etwa Pakete anderer Autoren, die -keine „ %% “ verwenden
+für verschiedene „Stile“,
+etwa Pakete anderer Autoren, die
+keine „%% “ verwenden
|
makedoc
s \DocInput{〈job〉}
makedoc
s \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
|
〈job〉.pdf
von
-〈job〉.sty
aus
-〈job〉.tex
.
+ 〈job〉.pdf
von
+〈job〉.sty
aus
+〈job〉.tex
.
〈job〉.tex
+ 〈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
,
〈add〉.doc
einbinden.
+〈add〉.doc
einbinden.
〈job〉.doc
/〈add〉.doc
+ 〈job〉.doc
/〈add〉.doc
können\RequirePackage{makedoc}
){document}
-Umgebung mit
-\input
eingelesen werden.
+\input
eingelesen werden.
{document}
-Umgebung mit
fifinddo
-Skripts.
+Einrichten eines solchen Workflows
+war aufwändig,fifinddo
-Skripts.
arseneau.pdf
,
-substr.pdf
.
+ \catcode...
)\catcode...
)
|
.html
um).
.html
um).
|
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?
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
\href ,nur ein solches f | |||
Was (zur Zeit) nicht geht
\EXECUTE{〈einstellungen〉} ,
@@ -3197,8 +3201,8 @@ wie etwa
| |||
catchfile
oder „bis zur nächsten leeren Zeile am Stück“ einlesen.
@@ -3235,31 +3239,30 @@ oder „bis zur n
|