Uvod v namizje K

3.2. Struktura DocBook datoteke

V tem razdelku pokrite značke so naštete spodaj.
Book - knjiga
Chapter - poglavje knjige
Title - besedilo glave ali naslov bločno orientiranega elementa
Para - odstavek


Primer 3.1. Primer minimalne DocBook knjižne datoteke

 <!DOCTYPE Book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
 <book lang="sl" id="kprog">
 <bookinfo>
 <title>Priročnik za Kprogram</title>
 <bookinfo>
 <chapter id="introduction">
 <title>Uvod</title>
 <para></para>
 </chapter>
 </book>

Zgornji primer prikazuje ogrodje vseh zahtevanih strukturnih značk. Prva značka v vsaki DocBook datoteki je DTD deklaracija ki označuje kateri DTD se naj uporabi za procesiranje tega dokumenta. KDE dokumentacija uporablja razširitev običajnega DocBook 3.1 DTD, ki z grafiko povezanim DocBook značkam doda podporo za PNG grafiko. Kot naslednji pride vsebinski model, ki je <Book> za vso KDE dokumentacijo. Upoštevajte uporabo lastnosti Lang in ID. Jezikovno določilo mora biti vedno uporabljeno, da olajša določitev jezika, v katerem je dokument spisan. Človeku berljive lastnosti (nenumerične) za značke <Book>, <Chapter>, in <Sect> so zahtevane iz dveh vzrokov:

Po znački <Book> sledi meta informacija o dokumentu ki je enkapsulirana znotraj značke <BookInfo>. Ta informacija bo podrobneje opisana v razdelku Meta informacije. Potem sledijo poglavja knjige, ki lahko vsebujejo enega ali več razdelkov (<Sect1> - <Sect5>). Poglavja in razdelki morajo vsebovati vsaj znački <Title> in prazen <Para>. Da si lažje predstavljate, kako so razdelki povezani eden z drugim, si poglejte dokumentacijsko predlogo.

Vsebina v DocBook-u je vsebovana znotraj značke <Para>, ki je zelo podobna znački <P> v HTML in Linuxdoc, le da mora biti vedno zaprta z </Para>.