Howto's-met-LinuxDoc-mini-HOWTO: LinuxDoc vergeleken met DocBook

Next Previous Contents

## 3. LinuxDoc vergeleken met DocBook

Een manier om dit te doen is op de LDP-site te gaan kijken http://www.linuxdoc.org klik op HOWTOs en vergelijk de bronnen van dezelfde HOWTO dan in de twee formaten: LinuxDoc en DocBook. De DocBook tags zijn vaak langer dan de equivalente LinuxDoc tags en voor dezelfde taak zijn er soms meer van nodig . DocBook gebruikt <para> en </para> tags om paragrafen te omsluiten, terwijl LinuxDoc slechts een lege regel gebruikt om paragrafen van elkaar te scheiden (geen tags). Voor het benadrukken van het woord "release" is de vergelijking:

> `

>     <emphasis>release</emphasis> release
>     <em>release</em>

> `

Ja, in DocBook moet je het woord "release" tweemaal intikken. Voor het beginnen van een sectie:

> `

>     <sect>
>     <title>Introductie<title>

> `

Dus in DocBook moet je heel wat meer typen als je tags met de hand intikt. Maar voor DocBook zijn heel veel soorten tags die in LinuxDoc niet voorkomen, dus het biedt meer mogelijkheden. Slecht een subset van DocBook gebruiken helpt je zoals je kunt zien niet, zoals je uit de hierboven getoonde voorbeelden kunt afleiden. Het is met nog heel wat meer tags vervuild. Met meer en langere tags wordt het document moeilijker leesbaar, tenzij je een editor gebruikt, die ze verbergt. Maar ze verbergen heeft zijn nadelen aangezien het toch wel handig is als je ziet welke tags je hebt gebruikt.

Het aantal mensen die gebruik maken van DocBook neemt nog steeds erg toe boven het aantal dat LinuxDoc gebruikt. Maar als je besluit naar DocBook over te stappen dan is daar een programma voor van Reuben Thomas (ld2db) die van hulp kan zijn bij het uitvoeren van de conversie. Het is niet 100% perfect en het kan zijn dat je handmatig nog het een en ander aan moet passen. De LDP converteert een LinuxDoc HOWTO ook automatisch naar DocBook nadat je het hebt aangeleverd.

Next Previous Contents