DocBookIntroducció al DocbookDocbook es un estandard XML d'OASIS pel marcatge de documents tècnics. Actualment està en la versió 5.0.
Dockbook està pensat per donar una estructura semàntica als llibres, això vol dir que els llibres es marquen sense tenir en compte el format de sortida, sinó que el que es té en compte és el significat de l'informació. L'editorial O'Reilly ha adoptat aquest format com a format dels seus llibres.
Com es crea un document en format Docbook?
Nomès necessitem un editor de texte, com per exemple el Notepad++, Ultra edit o també podem utilitzar una cosa més sofisticada com el XML Mind, altova o Oxygen.
Quina estructura té docbook?
Aquesta és l'estructura bàsica d'un document docbook:
<book xml:lang="es" version="5.0">
<info>
<title>Docbook tutorial</title>
</info>
<chapter>
<info></info>
<sect1></sect1>
</chapter>
.....
</book>
exemple 1.
Book és la principal, i se li ha d'especificar, l'idioma del llibre amb l'atribut xml:lang i quina versió de docbook estem utilitzant, en aquest cas la 5.
L'etiqueta book ha de tenir title o un title dins de info.
Chapter marca els capitols que contindrà el llibre, pot tenir més d'un.
Ha de tenir title o un title dins del tag info.
Sec1 (sect1-5) marca les seccions internes d'un capítol. Quan volem posar una secció dins un altre li canviem la numeració mantenint el tag, així sect2 va dins de sect1.
Ha de tenir title o un title dins de info.
Amb aquest esquelet ja podriem començar a treballar.
Té errors el meu Docbook?
Quan es crear un document en Docbook és molt important assegurar-se que s'està creant bé, per això tenim una eina que distribueix docbook i que servei per validar els documents que creem.
Aquest validador el podeu trobar a http://www.docbook.org/docs/howto/#validators.
Es pot validar un docbook amb la següent comanda:
java -Xss512K -jar C:\docbook\validator\relames.jar C:\docbook\validator\docbook.rng c:\docbook\output\document_docbook.xml
Aquest validador ens retornarà els errors, tant de format (etiquetes mal posades dins d'altres, etiquetes que no existeixen,...) com sintàctics (etiquetes mal tancades, caràcters incorrectes,...), en cas que no estigui ben fet, si es correcte retorna valid.
Comencem a marcar un document
Ara que ja tenim l'esqueles creat (exemple 1), començarem a escriure text, per això el primer que crearem son paràgrafs.
De paragrafs n'hi ha de tres típus:
para: Aquesta etiqueta marca un paràgraf i pot contenir tant text com altres etiquetes, com poden ser etiquetes inline, figures, blocs,...
simpara: També marca un paràgraf, però nomès pot contenir text o elements inline.
formpara: És un paràgraf amb títol.
Continuarà...