Kapittel 3. Vanlige elementer

Innholdsfortegnelse
Strukturlementer: book, chapter, appendix, section
Avsnitt: para
Lister: orderedlist, itemizedlist, procedure, qandaset
Tabeller: table, informaltable
"Attention-grabbers": caution, important, note, tip, warning
Tekstelementer: screen, userinput, computeroutput, menuchoice, guimenu, guimenuitem, filename, emphasis, firstterm
Kryssreferanser: xref, ulink, link

Dette kapittelet beskriver de elementene som sannsynligvis er de mest brukte. Mer utførlig beskrivelse for alt som beskrives her, finnes blant annet i Docbook: The Definitive guide på DocBook.org.

Strukturlementer: book, chapter, appendix, section

Rot-elementet for en håndbok er ikke overraskende <book>. En <book> inneholde <title>, enten direkte eller som del av <bookinfo> pluss minst ett element av type <para> eller ett eller flere <chapter>, eventuelt også et eller flere <appendix>.

<bookinfo>, som hvis det finnes, opptrer direkte etter innledende <book>-kode, kan inneholde bokens <title>, opplysninger om forfatter (<author>), opphavsrett (<copyright>) og eventuelt annen juridisk og bibliografisk informasjon. Antakelig vil <bookinfo> i Skolelinux' dokumenter i alt vesentlig bli basert på kopiering fra eksisterende dokumenter.

Kapittel og tillegg

De to elementene <chapter> og <appendix> opptrer på samme nivå i dokumentstrukturen, og har derfor svært mye til felles. De inneholde <title> og enten ett eller flere <section>-elementer eller ett eller flere <para> fulgt av ett eller flere <section>.

Underinndelinger kan lages enten ved nestede <section>-elementer eller eksplisitt angitte nivåer med elementene <section1>, <section2> … <section5>.