uwe_lueck
>
texmap
>
dantev45-768-com
– neu laden
–
[ START
<<< zuerst klicken,
dann auf Bildunterrand klicken
bzw. knapp unter Text (MSIE)
und rechts unten f�r „R�ckkehr“CTAN
teil-0
|
titelerlaeut1
|
titelerlaeut2
|
titelerlaeut3
|
interessant
|
motive-t
|
motive-p
|
status
|
inhalt
teil-1
|
txt2tex
|
txt2tex-trad
teil-2
|
typoz-latex
|
minimal-mehr
|
typoz-bewert
|
typoz-auto
|
typoz-ctan
teil-3
|
wiki-markup
|
wiki-listen
teil-4
|
implement
|
implement-ms
|
implement-ms2
|
implement-ma
|
implement-ma+
|
implement-mas
teil-5
|
nicetext
|
wiki
teil-6
|
niceverb
|
syntax
|
vert
|
niceverb-noch
|
niceverb-sim
teil-7
|
kommentar
|
kommentarzw
|
kommentarzwa
teil-8
|
kommentar-ignor
|
kommentar-ignor-mehr
|
docstrip
|
kommentarzch
|
ohne-docstrip
teil-9
|
doku-vor
|
doku-doc
|
docinput
|
docinput2
|
docinput-min
|
makedoc-input
|
makedoc-lauf
|
erfolg
|
catcodes
teil-10
|
html-alt
|
html-statt-pdf
|
html-und-pdf
|
blog-probleme
|
schluss
]
| ||||
Paketdokumentation
Uwe L�ck
|
| ||||
Teil 0: | ||||
|
|
| ||||
Vortragstitel bedeutet (I):
| ||||
|
|
| ||||
Vortragstitel bedeutet (II): | ||||
|
|
| ||||
Vortragstitel bedeutet (III):… was haben Paketdokumentation und HTML-Erzeugung miteinander zu tun??(– Zu HTML-Paketdokumentationen habe ich es noch nicht gebracht …) | ||||
|
|
| ||||
Vortrag interessant …
| ||||
|
|
| ||||
Inhaltliche Motive
| ||||
|
|
| ||||
Pers�nliche Motive
| ||||
|
|
| ||||
Statusnicht richtig fertig, zu umfangreich, hasten, �berspringen | ||||
|
|
| ||||
Vortragsteile
| ||||
|
|
| ||||
Teil 1: | ||||
|
|
| ||||
Von
Um reinen Text in LaTeX-Input
(f�r LaTeX-Qualit�t) umzuwandeln, muss man normalerweise
Folgendes erg�nzen/�ndern:
|
| ||||
„Auszeichnung“
| ||||
|
|
| ||||
Teil 2: | ||||
|
|
| ||||||||||||||
Typografische Zeichen mit TeX/LaTeX
[„Aktive Zeichen“ verhalten sich wie Makros, TeXbook S. 37 ] | ||||||||||||||
|
|
| ||||
Bewertung –
|
„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 – Schw�che meiner (damaligen) Terminologie –
|
| ||||
Typografische Zeichen – Bewertung
| ||||
|
|
| ||||
Typografische Zeichen automatisch?
| ||||
|
|
| ||||
– auf CTAN:
| ||||
|
|
| ||||
Teil 3: | ||||
|
|
| ||||||||||||||
Wikipedia: Schriftauszeichnung– Anregungen wie f�rEasyLaTeX ?
– Intuition dahinter vielleicht:
Bedeutungen von kursiv und | ||||||||||||||
|
|
| |||||||||||||||
Wikipedia: Listen und Zitate
– immerhin recht „minimal“, auch halbwegs intuitiv. | |||||||||||||||
|
|
| ||||
Teil 4:„minimalen Markups“ „mit TeX allein“ | ||||
|
|
| ||||||||
Implementierungsmethoden f�r
|
(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 |
(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“ |
| ||||
Methode (MS) – Anmerkungen ITeXs Mechanismus, sog. „begrenzte Parameter“ von Makros zu erkennen (TeXbook S. 203), bietet eine bequeme, aber auch „begrenzte“ Methode, „Zeichenketten“ („Strings“) zu erkennen(und zu ersetzen).
| ||||
|
|
| ||||
Anmerkungen zu (MS) II
| ||||
|
|
| ||||
„Minimales Markup“
| ||||
|
|
| ||||
| ||||
|
|
| ||||
(MA) vs. (MS)
| ||||
|
|
| ||||
Teil 5:nicetext )
| ||||
|
|
| ||||
Die Pakete des
|
|
| ||||
| ||||
|
|
| ||||
Teil 6:niceverb.sty
| ||||
|
|
| |||||||||||
„Fortsetzung“ der
Wikipedia-Schriftauszeichnung:
|
Code mit niceverb.sty | wie Code sonst |
’nicetext’ | \textsf{nicetext} |
‘ | \verb+ \foo+ |
‘README.txt’ | \texttt{README.txt} |
| ||||
Beschreibung von LaTeX-Makros
| ||||
|
|
| ||||
Hervorhebung von MakrobeschreibungenVertikalstriche (| )
\fbox ,
intern soll \InlineCmdBox zusammenfassende Aufz�hlungen von Makros
in einem Absatz erm�glichen. Beispiel Code/Ergebnis:
|
| ||||
|
|
| ||||
| ||||
|
|
| ||||
�hnliche Pakete anderer Autoren
| ||||
|
|
| ||||
Teil 7: | ||||
|
|
| ||||
Code und „Kommentar“[vgl. Schuld und S�hne, Pride and Prejudice, Gesetzeskommentar zum Code civil]
TeX bietet wie alle „normalen“ Programmiersprachen die M�glichkeit,
in Quelldateien Text einzuf�gen, der nicht
vom Compiler bzw. Interpreter (als Befehle/Daten)
verarbeitet werden soll, sondern an (menschliche) Leser
gerichtet ist – hier „Kommentar“.
| ||||
|
|
| ||||
Zwecke des Kommentars
| ||||
|
|
| ||||
Zwecke des „Auskommentierens“
| ||||
|
|
| ||||
Teil 8: | ||||
|
|
| ||||
Feinheiten des „Ausblendens“
| ||||
|
|
| ||||
„Ausblenden“ von Kommentar – Forts. …
| ||||
|
|
| ||||
| ||||
|
|
| ||||
Kommentarzeichen
| ||||
|
|
| ||||
Ohne
( | ||||
|
|
| ||||
Teil 9: | ||||
|
|
| ||||
„Darstellung“ des Kommentars – „Vorzeit“
| ||||
|
|
| ||||
Darstellung des Kommentars mit
| ||||
|
|
| ||||
… ( | ||||
|
|
| ||||
(
(�bertrag:)
| ||||
|
|
| ||||
„Minimale“ Kennzeichnung des Codes
| ||||
|
|
| ||||
„smartes“
– Algorithmus klar: | ||||
|
|
| ||||
„Interpretationen“ von Kommentarzeichen
| ||||
|
|
| ||||
|
Genaue Entsprechung zu \DocInput fehlt derzeit.„⟨job⟩“ ergibt sich von selbst, oder … Verschiedene Skriptbefehle unterst�tzen unterschiedliche Dokumentationsstile (�bersicht: mdoccheat.pdf).
c+k-Dateien werden mit
|
| ||||
Dokumentationslauf[Genauer] … kompiliere ich typischerweise die Dokumentation
| ||||
|
|
| ||||
Erfolge/Scheitern
| ||||
|
|
| ||||
Vorteile und Problematik der Zeichenkategorien (
|
|
| ||||
Teil 10: | ||||
|
|
| ||||
Nutzen von HTML (vs. PDF)
| ||||
|
|
| ||||
HTML-Erzeugung – Alternativen
| ||||
|
|
| ||||
HTML und PDF aus selber Quelle?
| ||||
|
|
| |||||
Was (zur Zeit) nicht geht
| |||||
|
|
| ||||
Dank
| ||||
|
|