SGML är en ISO standard (ISO 8879:1986) för att beskriva dokument på ett sätt som datorer och människor kan förstå. Detta betyder att SGML inte är ett filformat som t.ex. TEX, .doc eller LATEXutan ett sätt att beskriva dokumentsstruktur. SGMLtools är en samling program som gör att dokument som har en sådan beskrivning kan tryckas, användas och publiceras.
Den mest använda SGML beskrivningen är HTML, som är konstruerad för att publicera material på internet. Eftersom de flesta dokument som vanliga människor skriver inte skall publiceras på internet så är det ganska naturligt att SGMLtools har valt DocBook som sin dokumenttyps beskrivning. Dokumenttypen DocBook är konstruerad utifrån krav från elektronik- och högteknologiföretag av Davenport gruppen (ArborText, Fujitsu, O'Reilly and Associates, mfl.).
Ett dokument skrivet enligt DocBook standarden kan bearbetas i många program innom SGMLtools används JADE för bearbetningen. JADE är vad man kallar en validerande SGML översättare, detta betyder att den först kollar att det du skrivit följer den SGML dokumenttypsbeskrivning du angivit (i SGMLtool är detta DocBook). Där efter så gör JADE om ditt dokument till objekt vilka skickas igenom ett filter (ett stilark) som gör vissa saker med dokumentet och sedan skickas slutresultatet till en fil.
För att skriva ett dokument så behöver man inte veta så här mycket teori, men det hjälper för att förstå DocBook.
Låt oss säga att hej.sgml ser ut så här:
<!DOCTYPE book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
]>
<book id="hej" lang="svse">
<title>En intorduktion till DocBook</title>
<bookinfo>
<title>En introduktion till DocBook</title>
</bookinfo>
<toc></toc>
<chapter id="kapitel1">
<title>Hej</title>
<para>
Mitt första dokument som är skrivet i DocBook!
</para>
<sect1 id="Text">
<title>DocBook är mycket struktur, lite layout</title>
<para>
För att skriva i DocBook måste man i första han tänka på
struktur och inte på hur saker och ting ser ut. Det är
inte upp till dig som författare att bestämma hur texten
ser ut, utan det avgörs av den som skriver stilbladet.
</para>
</sect1>
</chapter>
</book>
$ sgmltools -b ps hej.sgml