FAQs werden mit qandaset erstellt
Um die typischen Listen von Fragen und Antworten, die in Form der FAQ sehr beliebt sind zu erstellen gibt es in DocBook das Element qandaset (für Question and Answer). Ein qandaset besteht aus einem optionalen Titel, eventuell einigen einleitenden Absätzen und einer Reihe von FAQ-Abschnitten (qandadiv) oder FAQ-Einträgen (qandaentry). Ein Abschnitt eines solchen Fragen- und Antworten-Katalogs enthält wiederum optional einen Titel und einleitenden Text, und dann abermals verschiedene Unterabschnitte oder Einträge, jedoch niemals beides vermischt.
Der eigentliche Eintrag, also qandaentry wiederum besteht aus einer Frage (question) und einer beliebigen Anzahl von Antworten (answer), möglicherweise auch keiner Antwort. Fragen und Antworten können Blockelemente enthalten, da die Inhalte jedoch meist textuell sind, sollte ein para enthalten sein.
Beispiel 2.29. Ein kurzes Philosophisches FAQ
<!DOCTYPE qandaset PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<qandaset>
<qandaentry>
<question>
<para>
Was ist die Antwort auf die Frage nach dem Leben, dem
Universum und dem ganzen Rest?
</para>
</question>
<answer>
<para>
42.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
Wie war nochmal die genaue Frage?
</para>
</question>
</qandaentry>
</qandaset>
Da qandaset nicht in einem normalen para vorkommen darf, jedoch in einem listitem, erfolgt die Ankündigung auf diese Art und Weise:
1. | Was ist die Antwort auf die Frage nach dem Leben, dem Universum und dem ganzen Rest? |
42. | |
2. | Wie war nochmal die genaue Frage? |