Ta učbenik vas bo naučil dovolj docbook-a za pisanje KDE dokumentacije. Naučili se boste kako:
razumeti format docbook značke
pravilno strukturirati vaše dokumente
uporabljati sezname in tabele za oragnizacijo podatkov
opisate GUI elemente in UNIX-ove ukaze
vključiti grafiko v vašo dokumentacijo
ustvariti povezave na URL-je in ustvariti navzkrižne povezave
DocBook značka sestoji iz elementa in lastnosti. Na primer <Chapter ID="Uvod"> vsebuje element Chapter in lastnost ID. Element spremeni besedilo v oklepajih, njegove lastnosti pa ga samega spremenijo. Značka Chapter pove da naj je vso besedilo vključeno med začetno in končno značko obravnavano kot poglavje, medtem ko ID označi poglavje tako, da je lahko uporabljen kot datotečno ime, kadar je DocBook preveden v drug format.
Večina docbook značk vsebuje splošen nabor lastnosti. Najpogosteje boste uporabljali Lang, ki določa jezik znotraj značke in ID, ki označi značko.
 | Vse DocBook značke morajo imeti začetno in končno značko. Če preberete DocBook Reference, boste opazili, da vse DocBook značke ne zahtevajo začetne in končne značke. Izpuščanje zaključnih značk kjer niso zahtevane ne pride v poštev, ker bo to naredilo vaš dokument nekonsistenten z ostalo KDE dokumentacijo in bo otežilo prehod na na XML DocBook. Poskrbite za pravilno velikost črk v znački, ker je XML občutljiv zanje. |
Za podrobne informacije o značkah in seznam vseh dosegljivih značk preglejte DocBook 3.0 Reference in DocBook 3.1 Quick Reference.