Was ist DocBook?
Auszeichnungssprache/Dokumentenformat
Standard wird von OASIS gepflegt
Organization for the Advancement of Structured Information Standards)
Umwandlung von Dokumenten mittels XSLT-Stylesheets in Ausgabeformate HTML, HTMLHelp, PDF
An eigene Erfordernisse anpassbar “Customized DTD”
DocBook ermöglicht Bücher und Artikel (=Elemente)
Wie sehen Minimaldokumente in DocBook aus?
Was sind Grundelemente von DocBook?
Wurzel: book bzw. article
Metadaten: innerhalb von bookinfo
Kapitel: chapter
Abschnitte: section (verschachtelt bzw. sect1 bis sect5)
Titel: title (für book, article, chapter, section)
Absätze: para (darin weitere Formatierungen)
Metadaten:
Verschachtelte Abschnitte:
Wie werden bei DocBook mehrere Autoren angegeben?
in den Metadaten (bookinfo) mit Element authorgroup
Was gibt es in DocBook für Metainformationen zu Büchern?
author/authorgroup: Autor/ mehrere Autoren
date: Publikationsdatum
releaseinfo: Versionsnummer
abstract: Zusammenfassung
keywordset mit Kindelement(en) keyword: Angabe von Stichwörtern für Index
Welche Formatierenden Elemente gibt es in DocBook?
emphasis (Hervorhebung)
emphasis mit role-Attribut: role=”bold” und role=”italic”
subscript und superscript für tief-/hochgestellt
Welche Arten von Warnhinweisen (o.ä.) gibt es und wie werden sie eingebunden?
caution
important
note
tip
warning
Welche Arten von Listen gibt es in DocBook?
simplelist ohne Aufzählungssymbol
<simplelist>
<member>
itemizedlist mit Aufzählungssymbol
<itemizedlist>
<listitem>
<para>
orderedlist mit Nummerierung
variablelist wie Definitionsliste
<variablelist>
<varlistentry>
<term>
<listitem><para>
segmentedlist
<segmentedlist>
<segtitle>
<seglistitem>
<seg>
Was ist eine simplelist?
Liste ohne Aufzählungssymbol
Was ist eine itemizedlist?
Liste mit Aufzählungssymbol analog zu ul in HTML
Was ist eine orderedlist?
Nummerierung analog zu ol in HTML
Was ist eine variablelist?
analog zu Definitionsliste dl in HTML
term -> dt
listitem -> dd
auch mehrere Begriffe in einer Beschreibung
Was ist eine segmentedlist?
Aufgeteilte Liste
Wie werden FAQs in DocBook umgesetzt?
mit Element qandaset
Wie werden Handlungsanweisungen in DocBook umgesetzt?
mit Element procedure
Schritte = step
Untergliederungen = substeps
Welche Tabellenelemente gibt es in DocBook?
Tabelle: table
unbetitelte Tabelle: informaltable
Kopfbereich: thead
Fußbereich: tfoot
Hauptteil: tbody
Gruppierung: tgroup
Reihe (in thead, tfoot, tbody): row
Zelle innerhalb von row: entry
Welche Grafikelemente gibt es in DocBook?
mediaobject: Containerelement für imagobject, textobject, audioobject, videoobject
inlinemediaobject: inzeiliges Containerelement
imageobject / imagedata: referenzierte Medienobjekte
screenshot…screeninfo…mediaobject…caption: Beschreibung von Screenshots
Welche Arten von Links gibt es in Docbook?
email
link (zu Sprungmarke in Dokument)
ulink (zu URL)
Wie können Beispiele bzw. Beispielcode in DocBook umgesetzt werden?
example: Beispiele
informalexample: unbetiteltes Beispiel
programlisting: Quellcode
screen: am Bildschirm sichtbarer Text (Code)
literallayout: ggf. für die umgebrochene Zeilen (analog pre in HTML)
Was sind GUI-Interface Elements in DocBook?
GUIButton
GUIIcon
GUILabel
MenuChoice
MouseButton
Was sind Command Line Elements in DocBook?
command
filename
function
option
parameter
userinput
Was sind Labelling Elements in DocBook?
application (Programmname)
markup (zb. HTML-Code)
Last changeda year ago