Vorwort 1 DocBook in 10 Minuten 1 Teil 1 Grundlagen 11 2 Einführung in XML 13 3 Dokumententyp-Definitionen (DTDs) 41 4 RELAX NC 73

Größe: px

Ab Seite anzeigen:

Download "Vorwort 1 DocBook in 10 Minuten 1 Teil 1 Grundlagen 11 2 Einführung in XML 13 3 Dokumententyp-Definitionen (DTDs) 41 4 RELAX NC 73"

Helga Lenz
vor 7 Jahren
Abrufe

1 Vorwort 1 DocBook in 10 Minuten Warum DocBook? Wie sieht ein DocBook-Dokument aus? Welche Verarbeitungsschritte werden benötigt? Schreiben eines DocBook-Dokuments Überprüfen eines DocBook-Dokuments Umwandeln eines DocBook-Dokuments Formatieren eines DocBook-Dokuments Eine XML-Umgebung Die Reise beginnt 9 Teil 1 Grundlagen 11 2 Einführung in XML Geschichtliches zu SGML, HTML und XML Was ist XML? Ein erstes Beispiel Der Aufbau von XML Einheitliche Adressierung durch URIs Die DOCTYPE-Deklaration Kodierung Namensräume Wohlgeformte und gültige XML-Dokumente XML-Anwendungen Ergänzungen zu XML Zusammenfassung 38 3 Dokumententyp-Definitionen (DTDs) Wozu DTDs? Elementdeklarationen Entity-Deklarationen Attributdeklarationen Notationen Bedingte Abschnitte Aufbau von öffentlichen Bezeichnern Beispiel-DTD einer CD-Musiksammlung Zusammenfassung 71 4 RELAX NC Wozu RELAX NG? Aufbau eines RELAX NG-Schema Die 3 Grundmuster: Text-, Element- und Attribut Auswahl, Wiederholung und Gruppierung Erweitertes Beispiel: Das CDList-Schema Definitionsmuster Grammatik- und Start-Muster CDList-Schema verbessern Datentypen RELAX NG-Schemata anpassen 91

2 4.11. RELAX NG-Schemata dokumentieren Mit der XML-Syntax arbeiten RELAX NG-Schemata validieren In andere Schemasprachen umwandeln Zusammenfassung 98 5 XML-Kataloge Wozu Kataloge? Ein erstes Beispiel Zwischen Haupt- und Benutzer-Katalog unterscheiden XML-Kataloge erstellen XML-Kataloge überprüfen URIs ersetzen XML-Kataloge modularisieren URIs delegieren Zusammenfassung 107 Teil 2 DocBook-Markup Übersicht über DocBook Was ist DocBook? Sinnvolle Dokumentation mit DocBook Schemadschungel Verweis auf ein DocBook 5-Schema Unterschiede zwischen DocBook 4 und Strukturelemente Über die Darstellung der DocBook-Elemente Allgemeine Attribute Metainformationen Buchreihen Bücher Buchteile Kapitel und Anhänge Artikel Referenzseiten Literaturverzeichnisse Glossare Verzeichnisse Abschnitte Block-Elemente Versionsgeschichten Tabellen Grafiken Indexeinträge Listen FAQs Handlungsanweisungen Aufgaben 170

3 8.9. Programmlistings Poesie Markierungspunkte (Callouts) Synopsen Gleichungen Randnotizen Rechtliche Hinweise Zitate und Sinnsprüche Anmerkungen Warnhinweise Produktionsregeln (EBNF) Absatz-Elemente Inline-Elemente Programmspezifische Elemente Betriebssystemspezifische Elemente Markupspezifische Elemente GUI-spezifische Elemente Tastenspezifische Elemente Technikspezifische Elemente Produktspezifische Elemente Fußnoten Verschiedenes Querverweise und Links Warum Verweise? Interne Querverweise Externe Links Dokumentenübergreifende Links Quellenverweise Mit XLinks verlinken Vergleich verschiedener Verweiselemente Modulare Dokumente Wozu aufteilen? Aufteilungsmethoden von Dokumenten Einbinden über externe Entities Einbinden über XIncludes Teilweises Einfügen mit XPointer XIncludes in DocBook 4.x aufnehmen XIncludes in DocBook Vergleich von externen Entities und XIncludes Zusammenfassung Anpassen von DocBook Warum DocBook anpassen? Überlegungen vor der Anpassung Anpassungen benennen DocBook 4-Struktur DocBook 5-Struktur Elemente hinzufügen Attribute ändern und hinzufügen 264

4 12.8. Elemente entfernen Attribute entfernen Erlaubte Wurzelelemente korrigieren DocBook 4 erweitern DocBook 5 erweitern Zusammenfassung 286 Teil 3 DocBook-Transformationen XPath Wozu XPath? Was ist ein XPath? Knotenarten XPath Grundtypen Der Kontext Lokalisierungspfade Lokalisierungsschritte XPath-Abkürzungen Wildcards XPath-Funktionen XPath in Aktion Zusammenfassung XSLT Wozu XSLT? Übersicht über XSL, XSLT und XSL-FO Der Transformationsvorgang Eine Beispieltransformation XSLT-Elemente XSLT-Funktionen Template-Regeln und Templates Knoten verarbeiten Mit Modi arbeiten XPath-Ausdrücke mit xsl:value-of ausgeben Eingebaute Template-Regeln kennen XSLT-Verzweigungselemente Neue Elemente und Attribute erzeugen Objekte mit xslxopy oder xsl:copy-of kopieren XML-Dokumente zusammenführen Stylesheets kombinieren Variablen verwenden Benannte Templates Mit xsksort sortieren Meldungen ausgeben Erweiterungen Erweiterungen mit EXSLT Beispiele Zusammenfassung XSL-FO Wozu XSL-FO? 351

5 15.2. Ein erstes Beispiel mit XSL-FO Formatierung von XSL-FO Seitenmodell von XSL-FO Vererbung und Voreinstellungen Schreibrichtung Umbrüche Blöcke Listen Tabellen Grafiken und Formeln Textformatierung Zusammenfassung Die DocBook-XSL-Stylesheets Überblick über die Stylesheets DocBook XSL Stylesheets anpassen Teilweises Transformieren Erweiterungsfunktionen und Erweiterungselemente Lokalisierung ändern Querverweise anpassen Dokumentenübergreifende Verweise erzeugen Indirektes Anpassen einer Titelseite Direktes Anpassen einer Titelseite Endformat mit Verarbeitungsanweisungen justieren Aktuelle Zeit- und Datumsangaben einfügen Mit gemeinsamen Templates arbeiten Gemeinsame Datenbank für Literatur und Glossar nutzen Zusammenfassung Konditionale Elemente (Profiling) Wozu Profiling? Verarbeitungsschritte Profiling-Informationen einfügen Profiling und Validierung Profilingmethoden Mehrfach-Profiling anwenden Profiling für eigene Attribute nutzen Automatisches Einfügen durch Profiling Zusammenfassung (X)HTML erzeugen Verfügbare Stylesheets Eine Beispieltransformation Anpassungsdatei für (X)HTML anlegen Einzelne (X)HTML-Dateien erzeugen Verlinkte Teildateien erzeugen (X)HTML mit CSS formatieren Inhaltsverzeichnisse erzeugen Überschriften formatieren Kopf- und Fußzeilen bearbeiten Mathematische Formeln in (X)HTML einfügen Weitere Ausgabemöglichkeiten Zusammenfassung 468

6 19 FO (PDF) erzeugen Verfügbare Stylesheets Anpassungsdatei für XSL-FO anlegen Seitenformate ändern Beispiele für verschiedene Buchtypen Titelseiten anpassen Kopf- und Fußzeile bearbeiten Inhaltsverzeichnisse darstellen Überschriften formatieren Typografie modifizieren Erweiterungen nutzen Zusammenfassung E-Book-Format EPUB erzeugen Was sind E-Books und EPUB? Anpassungsdatei für EPUB anlegen EPUB als E-Book erzeugen EPub-Format anzeigen EPUB in MobiPocket konvertieren Cover anpassen Zusammenfassung 512 Teil 4 DocBook vertiefen Tipps und Tricks für DocBook Welches DocBook-Schema? Was und wieviel auszeichnen? Tipps aus der täglichen Praxis Konsistenz erreichen und bewahren DocBook anpassen Migrieren nach DocBook Von DocBook 4 nach DocBook Migrieren nach DocBook Austauschen von DocBook-Dokumenten DocBook Ein Ausblick Entwicklung von DocBook Einflüsse von anderen Dokumentenformaten NVDL XSLT 2, XPath 2 und XSL-FO XProc 553 A Verwendete Platzhalter 555 B XML-Umgebung einrichten 557 B.1. XML-Tools installieren 557 B.2. DocBook-Schemata und XSL-Stylesheets installieren 561

7 B.3. XML-Kataloge konfigurieren 563 B.4. jedit als XML-Editor 564 B.5. Emacs als XML-Editor 566 B.6. XML-Umgebung anwenden 570 B.7. Makefiles 572 B.8. Übersicht über wichtige Optionen 574 C Übersicht aller DocBook-Elemente 575 C.1. Thematische Sortierung 575 C.2. Alphabetische Sortierung 579 Glossar 599 Literaturverzeichnis 609 Index 617

Ähnliche Dokumente

Inhaltsverzeichnis. 1 Grundlagen. Vorwort VII

Inhaltsverzeichnis. 1 Grundlagen. Vorwort VII Vorwort 1 DocBook in 10 Minuten 1.1 XML als universelle Datenstruktur 1.2 Ein DocBook-Dokument entsteht 1.3 Überprüfen eines DocBook-Dokuments 1.4 Umwandlung von DocBook 1.5 Die Reise beginnt... VII 1