Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 | ||
---|---|---|
forrige | Kapitel 3. DocBook i XML : Ett konkret exempel | næste |
Huvuddokumentet är väldigt likt dess SGML-kusin. Skillanden ligger i att ?xml? taggen skall finnas med, och att en URL till docbooks DTD skall finnas med. Jag brukar lägga in en lokal referens när jag jobbar med dokumentet, annars hämtas den in via nätverket varje gång, och det tar längre tid.
<?xml version="1.0"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "file:///usr/share/sgml/docbook/xml-dtd-4.2/docbookx.dtd" [ ]> <!-- <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ ]> --> <book id="SSLUG" lang="en"> <bookinfo> <title>En bra titel</title> </bookinfo> <toc id="toc"></toc> Inkluderat autogenererat dokument skapat enligt ovan </book>
För att lyckas med DocBook i XML bör man tänka på följande:
Alla taggar skall avslutas. Taggar utan avslutande tagg skall skrivas som tomma taggar. Ex <xref linkend=...../>. Notera den sista '/'.
Alla taggar skall skrivas med små bokstäver.
Inga genvägar är tillåtna, som i SGML där man kan skriva <tag> ....</>