DocBook XML/SGML verwerking met OpenJade

Saqib Ali


            
         

Vertaald door: Ellen Bokhorst

Wijzigingen
Herziening v2.010-09-2002Herzien door: sa
De sectie toegevoegd over het met behulp van Tomcat+Cocoon bekijken van de inhoud van DocBook XML 4.1.2
Herziening v1.52002-08-11Herzien door: sa
De XML-sectie toegevoegd en het XML-voorbeeldbestand.
Herziening v1.42002-08-08Herzien door: sa
Veel waardevolle aanpassingen/correcties aanbevolen door Lloyd D Budd. Bedankt Lloyd :)
Herziening v1.32002-08-02Herzien door: sa
De sectie "Extra bronnen" toegevoegd.
Herziening v1.22002-07-23Herzien door: sa
De sectie toegevoegd over het omzetten van HTML naar PDF met HTMLDOC. Met dank aan Luc De Louw voor de suggestie.
Herziening v1.119-07-2002Herzien door: KET
Grammaticale fouten gecorrigeerd, processen genummerd
Herziening v1.029-06-2002Herzien door: sa
Initiële publieke uitgave.

In deze HOWTO wordt uitgelegd hoe OpenJade in te stellen voor de verwerking van SGML/XML DocBook documenten.


Inhoudsopgave
Introductie
Benodigdheden
Installeren van de verwerkingstools - OpenJade
Gebruik van OpenJade
DocBook 4.1.2 XML bekijken via een webbrowser
Verdere informatie

Introductie

Een aantal acroniemen:

  1. SGML - Standard Generalized Markup Language

  2. XML - Extensible Markup Language

  3. RTF - Rich Text Format

  4. HTML - HyperText Markup Language

  5. PDF - Portable Document Format

Het doel van dit document is het opzetten van OpenJade om DocBook 3.2 en 4.2 Standaard Generalized Markup Language (SGML) en Extensible Markup Language (XML) documenten om te zetten in HyperText Markup Language (HTML), Rich Text Format (RTF) en Portable Document Format (PDF) documenten.

Copyright en Licentie

Dit document is auteursrechtelijk beschermd 2001 door Saqib Ali. Het is toegestaan dit document onder de voorwaarden van de GNU Free Documentation License, versie 1.1 of enige latere versie gepubliceerd door de Free Software Foundation te kopiëren, distribueren en of aan te passen; zonder Invariant secties, zonder Front-Cover teksten, en zonder back-cover teksten. Een kopie van de licentie is beschikbaar op http://www.gnu.org/copyleft/fdl.html

Krediet

Alle lof komt toe aan Allah, De heer van de wereld. Alle krediet gaat naar Allah. Alle fouten in dit document liggen aan mijzelf.

Bovendien zou ik graag de volgende mensen willen erkennen voor hun waardevolle bijdragen aan dit document:

  1. Greg Ferguson - voor de zeer behulpzame aanwijzingen/suggesties op de docbook mailing list

  2. Kristin Thomas - Voor de initiële voorbeschouwing van dit document.

  3. Luc de Louw - Voor suggesties over HTMLDOC (PDF -> HTML)

  4. Lloyd D Budd - Voor suggesties ter verbetering van de meeste secties in dit document

Wat is DocBook?

DocBook is een document type definitie (DTD). In een DTD wordt de syntax van een document gedefinieerd. DocBook beschrijft de in technische documenten te gebruiken typen structuren en formaten. Het wordt over het algemeen gebruikt vanwege zijn eenvoud en volledigheid.

In een DTD wordt de syntax van een document gedefinieerd. In wezen bestaat het uit een boek met regels waarin de set tags en attributen worden beschreven die zullen worden gebruikt om specifieke soorten inhoud te beschrijven. Dus DocBook is een boek met regels welke wordt gebruikt voor het schrijven van documenten. Elke TAG die wordt gebruikt bij het schrijven van een document, moet zeer specifiek en formeel worden gedefinieerd in de DTD.

Wat is DSSSL?

In een Document Style Semantics and Specification Language (DSSSL) wordt gedefinieerd hoe een Standard Generalized Markup Language (SGML) document in een voor mensen leesbaar formaat wordt omgezet.

Wat hebben we nodig?

De benodigde tools om met OpenJade SGML en XML om te zetten, zijn:

  • OpenJade

  • Entities

  • Norman Walsh's DSSSL

  • DocBook DTDs

  • LDP DSL

  • Norman Walsh's XSL

  • LDP XSL

OpmerkingNoot
 

Deze packages zijn vanaf het net vrij te downloaden. In het volgende hoofdstuk wordt uitgelegd hoe deze packages te downloaden.

Veronderstellingen

In dit document wordt verondersteld dat je het volgende reeds op je systeem hebt geïnstalleerd: