{title: DocBookFormat im Wiki} {author: io} {date: 24. Juni 2003} {abstract: Kurze Erklärung, wie mit einem kleinen Konversions-Tool schicke HTML-Seiten aus unseren haesslichen Wiki-Texten entschlüpfen können ...} {version: 0.2}

Warum

Einheitliches Layout und gute Lesbarkeit der späteren html- oder auch pdf-Version unserer wiki:senselab/CryptoSeminarAnleitungen.

= Wie funktioniert es =

zuerst mal per Hand

du nimmst den Text (wie auch immer man ihn einfacher aus dem Wiki holen kann, als per copy/paste) und bringst ihn in eine Datei
dann startest du:

parsewiki -f docbook datei >ausgabeDatei

dat geht ganz fix; doch nun kommt die Umwandlung in html:

openjade -t sgml -d /usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl ausgabeDatei oder openjade -t sgml -d /home/public.senselab/CryptoSeminar/Anleitungen/ldp.dsl#html ausgabeDatei oder docbook2html ausgabeDatei (das ist wohl die netteste Variante)

und das dauert unglaublich lange (halbe Stunde?) -- warum auch immer

nun per Mausklick

einfach die betreffende Seite im Wiki auswählen und dann DocBook-Konvertierung im Seitenkopf anwählen

Woher weiß ich, wie ich meinen Inhalt formatiere?

Prinzipiell funktioniert das Ganze mit normalem Wiki-Text; die wenigen speziellen Tags findest du in der [https://systemausfall.org/wiki/senselab/wiki2html/doc/parsewiki/t1.html Doku] zu parsewiki. Der dazugehörige [https://systemausfall.org/wiki/senselab/wiki2html/doc/parsewiki/manual-en.txt Quelltext] hilft vielleicht noch mehr.

In Kürze:

Zeilen, die mit einem Leerzeichen beginnen, werden verbatim also im Programmstil dargestellt
Kapitel oder Unterkapital werden folgendermassen gestaltet: <nowiki>= Titel des Kapitels =</nowiki>
- die Leerzeichen sind dabei relevant
- die Anzahl der =-Zeichen entspricht (wie immer) der Hierarchie-Ebene dieses Elements
Listen
- nummeriert: "#" am Zeilenanfang
- ungeordnet: "*" am Zeilenanfang
- Beschreibung: mit ";" und ":", also in der Form: ;Begriff: Beschreibung
- die verschiedenen Listen können (auch gemischt) ineinander verschachtelt werden
Links
- die http-Form wird automatisch erkannt - die komplette Adresse erscheint dann im Text
- falls ein Ersatztext angezeigt werden soll, dann geht das so: <nowiki>[https://systemausfall.org TEXT]</nowiki>
- bei lokalen Links sind zwei eckige Klammern nötig
Bilder werden analog zu Links eingefügt - folgende Endungen werden anschließend als Grafik eingefügt: jpg, jpeg, png, bmp, gif
Schriften
- kursiv: von zwei Doppel-Apostrophen umschliessen oder als: <nowiki><em>Text</em></nowiki>
- fett: drei Apostrophe oder: <nowiki><strong>Text</strong></nowiki>
- monospaced: zwischen zwei Doppelkommata oder: <nowiki>Text</nowiki>
- das alles gilt immer nur für eine Zeile, ansonsten: Zeilen mit Backslash verbinden

Zusätzlich kannst du folgende Meta-Informationen hinzufuegen: title, date, version, author und abstract. Sie können nach folgendem Muster in den ersten Zeilen einer Wiki-Seite benutzt werden: <nowiki>{title: Heute erkläre ich die Welt} {version: 2.7}</nowiki>

Wo finde ich ein Beispiel?

Ein Beispiel für eine DocBookFormat-Doku ist wiki:senselab/CryptoSeminarDocBookMozilla. Daraus wurde die [https://systemausfall.org/wiki/senselab/wiki2html/doc/Mozilla/mozilla.docbook docbook-Datei] erzeugt und natürlich die resultierenden HTML-Dokumente:

[https:://systemausfall.org/wiki/senselab/wiki2html/doc/CryptoSeminarDocBookMozilla/t1.html Variante I]: falls du openjade gestartet hast [https:://systemausfall.org/wiki/senselab/wiki2html/doc/CryptoSeminarDocBookMozilla/index.html Variante II]: falls du docbook2html benutzt

Alles klar?

so denn, ihr könnt dann ja mal so langsam beginnen, eure Dokus umzubasteln ...

FAQ für das DocBookFormat

Q: Fußnoten, verdammt!

A: Durch das docbook-Element <footnote>... text ...</footnote> (theoretisch)

Q: Wo hätte ich das mit den Fußnoten selber herausfinden können?

A: [http://www.docbook.org/tdg/en/html/docbook.html hier]

Q: Der openjade-Aufruf mit der ldp.dsl funktioniert nicht!

A: Keine Ahnung, alternativ kannst du es aber auch mal mit: docbook2html ausgabeDatei versuchen (alles ungetestet, weil es so unglaublich lange dauert)