Poglavje 1. Kaj je docbook

DocBook je opisni jezik iz družine SGML. Sem spada kot najbolj znan predstavnik HTML. Obstaja še en jezik, to je LinuxDoc. Če verjetno skoraj prav vsak pozna HTML, je z LinuxDoc že težje. Gre za zelo podoben jezik, ki je nastal za potrebe pisanja dokumentacije za prosto programje (GNU/Linux). Ker pa je imel LinuxDoc vrsto hib (slaba podpora za slike, tabele, neangleške znake itd.) je nastal DocBook. Ta je precej bolj zmogljiv, hkrati pa za vsakogar, ki pozna LinuxDoc ali HTML ne bi smel biti prehud.

Kratek odstavek za zgled:

 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
 <book lang="sl">
 <bookinfo>
 <title>Naslov knjige</title>
 </bookinfo>
 <chapter id="Uvod">
 <title>Naj bo uvod</title>
 <para>To je odstavek, ki se mora obvezno zaključiti.</para>
 </book>
  

Kot je videti, je DocBook bolj strog pri logičnih razdelitvah dokumenta (poglavja, razdelki) od HTML. Po teh lastnostih spominja na LaTeX (kdor ne ve, kaj je to, naj se ne žre). Mogoče je kdo že zaslutil (tisti, ki so delali z LinuxDoc ali LaTeX-om pa že vedo), da ta datoteka ne predstavlja nič uporabnega (še ne). Stvar bo treba prevesti. In sicer v

• HTML

• TeX (DVI)

• postscript

• PDF

• RTF

Tako lahko dobimo spletno pomoč, prenosljivo datoteko ali pa kar knjigo (PostScript). In še ena zla slutnja: za DocBook zaenkrat ne obstaja nič WYSIWYG. Kako torej (in s čim sestavimo priročnik)?