Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > d667a145d78a93cee78c5358ca99c039 > files > 30

howto-text-nl-2006-5mdv2010.0.noarch.rpm


DocBook XML/SGML verwerking met OpenJade

Saqib Ali

               <[1]saqib@seagate.com>

Vertaald door: Ellen Bokhorst

   <[2]bokkie@nl.linux.org>
   Wijzigingen
   Herziening v2.0 10-09-2002 Herzien door: sa
   De sectie toegevoegd over het met behulp van Tomcat+Cocoon bekijken
   van de inhoud van DocBook XML 4.1.2
   Herziening v1.5 2002-08-11 Herzien door: sa
   De XML-sectie toegevoegd en het XML-voorbeeldbestand.
   Herziening v1.4 2002-08-08 Herzien door: sa
   Veel waardevolle aanpassingen/correcties aanbevolen door Lloyd D Budd.
   Bedankt Lloyd :)
   Herziening v1.3 2002-08-02 Herzien door: sa
   De sectie "Extra bronnen" toegevoegd.
   Herziening v1.2 2002-07-23 Herzien 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.1 19-07-2002 Herzien door: KET
   Grammaticale fouten gecorrigeerd, processen genummerd
   Herziening v1.0 29-06-2002 Herzien 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
   [3]Introductie
   [4]Benodigdheden
   [5]Installeren van de verwerkingstools - OpenJade
   [6]Gebruik van OpenJade
   [7]DocBook 4.1.2 XML bekijken via een webbrowser
   [8]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
   [9]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 <[10]gferg (at) hoop.timonium.sgi.com> - voor de
       zeer behulpzame aanwijzingen/suggesties op de docbook mailing list
    2. Kristin Thomas <[11]kristint (at) us.ibm.com> - Voor de initiële
       voorbeschouwing van dit document.
    3. Luc de Louw <[12]luc@delouw.ch> - Voor suggesties over HTMLDOC
       (PDF -> HTML)
    4. Lloyd D Budd <[13]ldp@foolswisdom.org> - 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

   Opmerking Noot


   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:

     * gzip - beschikbaar vanaf[14]http://www.gnu.org
     * gcc en GNU make - beschikbaar vanaf [15]http://www.gnu.org
     _________________________________________________________________

Benodigdheden

   Je hoeft slechts één package (OpenJade) te downloaden en compileren.
   In deze HOWTO wordt het compilatieproces uitgelegd, maar er wordt
   verwacht dat je reeds ervaring hebt met een installatie vanuit de
   broncode.

   De meeste packages die we nodig hebben, zijn de vinden op de website
   van [16]Het Linux Documentatie Project (TLDP)
     _________________________________________________________________

Voorbereiding

   Maak een directory /tmp/downloads aan. We zullen deze directory
   gebruiken om de broncode die we gaan downloaden in op te slaan.
     _________________________________________________________________

OpenJade

   OpenJade zal worden gebruikt om DocBook documenten te verwerken.
   OpenJade kan worden gedownload vanaf:
   [17]http://openjade.sourceforge.net/.

   Op moment van schrijven is OpenJade 1.3.1 beschikbaar. Download het
   openjade-1.3.x.tar.gz bestand.
     _________________________________________________________________

DocBook DTD

   Alle DocBook DTD's zijn beschikbaar vanaf de website van het Linux
   Documentatie Project op
   [18]http://www.tldp.org/authors/index.html#resources

   Download [19]DocBook SGML v4.1, [20]DocBook SGML v3.1, en [21]DocBook
   XML v4.1.2

   Opmerking Noot


   Download alsjeblieft alle zip-archieven.
     _________________________________________________________________

ISO-entiteiten

   [22]Het Linux Documentatie Project heeft voor het gemak van de
   gebruikers alle entiteiten in één groot tar-bestand verpakt en dit
   geplaatst op [23]http://www.tldp.org/authors/tools/entities.tar.gz.
   Met dank aan de TLDP.
     _________________________________________________________________

DSSSL van Norman Walsh

   DSSSL van Norman Walsh kan worden gedownload vanaf de website van het
   DocBook project op
   [24]http://sourceforge.net/project/showfiles.php?group_id=21935.

   Tijdens dit schrijven was docbook-dsssl-1.76 beschikbaar.
     _________________________________________________________________

Door de LDP aangepaste DSL-stylesheets

   LDP DSL is een aangepaste stylesheet welke wordt gebruikt door [25]het
   Linux Documentatie Project (TLDP). Het is een uitbreiding op DSSSL van
   Norman Walsh. Het voegt het een en ander toe, zoals een achtergrond en
   een inhoudsopgave. Het kan worden gedownload vanaf
   [26]http://www.tldp.org/authors/tools/ldp.dsl.

   Voor ldp.dsl is DSSSL nodig van Norman Walsh
     _________________________________________________________________

HTMLDOC (optioneel)

   HTMLDOC kan worden gebruikt voor het omzetten van HTML in PDF. Als je
   PDF documenten wilt kunnen produceren, download dan HTMLDOC vanaf
   [27]http://www.easysw.com/htmldoc/software.php
     _________________________________________________________________

Norman Walsh's XSL (optioneel)

   Dit is niet noodzakelijk. Maar als je met Tomcat+Cocoon DocBook 4.1.2
   XML wilt kunnen bekijken, dan zul je de XML stylesheets van Norman
   Walsh nodig hebben.

   De Stylesheets kunnen worden gedownload vanaf
   [28]http://sourceforge.net/projects/docbook/

   Download het package genaamd docbook-xsl
     _________________________________________________________________

Door de LDP aangepaste XSL (optioneel)

   Download tevens de door de LDP aangepaste XML vanaf
   [29]http://www.tldp.org/authors/tools/ldp-xsl.zip
     _________________________________________________________________

Installeren van de verwerkingstools - OpenJade

   In deze sectie zullen we alle tools in de juiste directory's
   installeren. Alle tools komen terecht in de directory
   /usr/local/dbtools/. Maak deze directory met de volgende opdracht aan:
   mkdir /usr/local/dbtools
     _________________________________________________________________

OpenJade installeren

   Dit proces is het makkelijke deel, maar het kost wel de meeste tijd.
   Houdt in gedachten dat het lang duurt eer OpenJade is gecompileerd.
   Voltooi de volgende stappen om OpenJade te installeren:

    1. Ga naar de directory /tmp/downloads.

        # cd /tmp/downloads

    2. Decomprimeer het bestand.

        # gzip -d openjade-1.3.x.tar.gz

    3. Pak het archief uit.

        # tar -xvf openjade-1.3.x.tar

    4. Ga naar de directory openjade-1.3

        # cd openjade-1.3.x

    5. Start de opdracht ./configure.

        # ./configure
        --prefix=/usr/local/dbtools/openjade

    6. Start de opdracht make.

        # make

    7. Voer de opdracht make install uit. Na deze stap zullen de openjade
       binary's worden geïnstalleerd onder /usr/local/dbtools/openjade.

        # make install

    8. Kopieer de directory dsssl vanuit /tmp/downloads/openjade-1.3.x
       naar /usr/local/dbtools/openjade

        # cp -dpR dsssl /usr/local/dbtools/openjade/
     _________________________________________________________________

DSSSL van Norman Walsh installeren

   In deze stap zullen we DSSSL van Norman Walsh op de juiste lokatie
   gaan installeren. De DSSSL hoeft niet te worden gecompileerd.

    1. Ga naar de directory /tmp/downloads

        # cd /tmp/downloads

    2. Decomprimeer het bestand.

        # gzip -d docbook-dsssl-1.76.tar.gz

    3. Pak het archief uit.

        # tar -xvf docbook-dsssl-1.76.tar

    4. Verplaats het bestand naar /usr/local/dbtools/docbook-dsssl.

        # mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
     _________________________________________________________________

DocBook DTD's installeren

   In deze sectie zullen we de DocBook DTD's installeren.

    1. Ga naar de directory /usr/local/dbtools.

        # cd /usr/local/dbtools

    2. Maak nieuwe directory's genaamd dtd3.1 dtd4.1 dtd4.1.2 aan.

        # mkdir dtd3.1
        # mkdir dtd4.1
        # mkdir dtd4.1.2

    3. Ga naar de directory dtd3.1.

                # cd dtd3.1

    4. Decomprimeer het bestand DocBook SGML v3.1 in deze directory.

                # unzip /tmp/downloads/docbk31.zip

    5. Ga naar de directory dtd4.1.

                # cd ../dtd4.1

    6. Decomprimeer het bestand DocBook SGML v4.1 in deze directory.

                # unzip /tmp/downloads/docbk41.zip

    7. Ga naar de directory dtd4.1.2.

                # cd ../dtd4.1.2

    8. Decomprimeer het bestand DocBook XML v4.1.2 in deze directory.

                # unzip /tmp/downloads/docbk412.zip
     _________________________________________________________________

ISO-entiteiten installeren

   In deze sectie zullen we de ISO-entiteiten installeren die we
   downloadde vanaf de LDP-website.

   Als eerste installeren we de ISO-entiteiten voor de 3.1 SGML DTD

    1. Ga naar de directory /usr/local/dbtools/dtd3.1.

        # cd /usr/local/dbtools/dtd3.1

    2. Kopieer /tmp/download/entities.tar.gz naar deze directory.

        # cp /tmp/download/entities.tar.gz .

    3. Decomprimeer het bestand.

        # gzip -d entities.tar.gz

    4. Pak het archief uit.

        # tar -xvf entities.tar

   Vervolgens installeren we de ISO-entiteiten voor de 4.1 SGML DTD

    1. Ga naar de directory /usr/local/dbtools/dtd4.1.

        # cd /usr/local/dbtools/dtd4.1

    2. Kopieer /tmp/download/entities.tar.gz naar deze directory.

        # cp /tmp/download/entities.tar.gz .

    3. Decomprimeer het bestand.

        # gzip -d entities.tar.gz

    4. Pak het archief uit.

        # tar -xvf entities.tar
     _________________________________________________________________

Installeren van de LDP DSL

   Als laatste installeren we ldp.dsl.

    1. Ga naar de directory /tmp/download.

        # cd /tmp/download 

    2. Kopieer het bestand ldp.dsl naar de directory
       /usr/local/dbtools/docbook-dsssl/print/ldp.dsl.

        # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print/ldp.dsl

    3. >Kopieer het bestand ldp.dsl naar de directory
       /usr/local/dbtools/docbook-dsssl/html/ldp.dsl.

        # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl
     _________________________________________________________________

HTMLDOC installeren

   Deze stap is optioneel. Ze is alleen nodig als je PDF documenten wilt
   produceren.

   Keer terug naar de directory downloads
   # Ga naar de directory /tmp/download

   Pak de broncode voor HTMLDOC uit
        # gzip -d htmldoc-1.8.xx-source.tar.gz 
        # tar -xvf htmldoc-1.8.xx-source.tar 
        # cd htmldoc-1.8.xx-1

   Start configure om de installatielokatie te configureren
        # ./configure --prefix=/usr/local/dbtools/htmldoc
        # make

   Tijdens dit schrijven was HTMLDOC versie 1.8.20-1 beschikbaar. Deze
   versie had een klein probleem in de fonts Makefile. Het geeft een
   foutmelding tijdens het installeren van de fonts, omdat de juiste
   fonts niet beschikbaar waren op het systeem.

   Tijdens de uitvoering van make install krijg je de volgende
   foutmelding:
        # make install
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
/bin/cp: cannot stat `ZapfChancery.afm': No such file or directory
/bin/cp: cannot stat `ZapfChancery.pfa': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.afm': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.pfa': No such file or directory
make[1]: *** [install] Error 1

   Ter correctie van dit installatieprobleem bewerk je fonts/Makefile en
   plaats je een commentaarteken voor de regels met verwijzingen naar de
   ZapfChancery en ZapfDingbats fonts

   Voer dan de volgende installatie uit:

# make install
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
Installing in data...
Installing in doc...
Installing in htmldoc...
     _________________________________________________________________

Gebruik van OpenJade

   In deze sectie zullen we OpenJade gebruiken om SGML/XML documenten om
   te zetten in HTML, RTF en PDF.
     _________________________________________________________________

SGML verwerken

   Je kunt een SGML DocBook 3.1 voorbeeldbestand downloaden vanaf
   [30]http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml
     _________________________________________________________________

De omgevingsvariabele SGML_CATALOG_FILES instellen voor SGML

   De omgevingsvariabele SGML_CATALOG_FILES moet zo worden ingesteld dat
   het verwijst naar de van toepassing zijnde catalog bestanden. Gebruik
   de volgende opdracht om de variabele in te stellen:
# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/loca
l/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog
     _________________________________________________________________

SGML naar HTML

   Gebruik de volgende opdracht voor de conversie van SGML naar HTML:
# /usr/local/dbtools/openjade/bin/openjade -t sgml -d /usr/local/dbtools/docboo
k-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml 

   Voor het creëren van één geheel HTML-bestand:
# /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/db
tools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml 
     _________________________________________________________________

SGML naar RTF

   Gebruik de volgende opdracht om een SGML-bestand naar het RTF-formaat
   om te zetten:
# /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook
-dsssl/print/ldp.dsl#print DocBook-OpenJade-SGML-XML-HOWTO.sgml 
     _________________________________________________________________

XML verwerken

   Je kunt een voorbeeldbestand in DocBook 4.1.2 XML downloaden vanaf
   [31]http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.xml
     _________________________________________________________________

Instellen van de omgevingsvariabele SGML_CATALOG_FILES voor XML

   De variabele SGML_CATALOG_FILES moet zodanig worden ingesteld, dat het
   verwijst naar de juiste catalog bestanden. Gebruik de volgende
   opdracht om de variabele in te stellen:
# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/loca
l/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog
     _________________________________________________________________

XML naar HTML

   Gebruik de volgende opdracht voor de omzetting van XML naar HTML
# /usr/local/dbtools/openjade/bin/openjade -t xml -d /usr/local/dbtools/docbook
-dsssl/html/ldp.dsl#html /usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl Do
cBook-OpenJade-SGML-XML-HOWTO.xml
     _________________________________________________________________

XML naar RTF

   Gebruik de volgende opdracht voor de omzetting van XML naar HTML:
# /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook
-dsssl/print/ldp.dsl#print /usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl
DocBook-OpenJade-SGML-XML-HOWTO.xml
     _________________________________________________________________

HTML naar PDF (optioneel)

   Om HTML naar PDF om te zetten, moeten we gebruik maken van HTMLDOC.
   Zet het SGML-bestand als eerste om in een geheel HTML-uitvoerbestand:
# /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/db
tools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml 

   Voer dan HTMLDOC uit om PDF te produceren:
   # /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html
     _________________________________________________________________

DocBook 4.1.2 XML bekijken via een webbrowser

   Er zijn 3 manieren om DocBOok 4.1.2 XML vanuit een webserver te
   bekijken:

     * Voorverwerkt met OpenJade, XSLT
     * Via scripts - PHP, Perl, Python
     * Applicatieserver - Cocoon

   Het gebruik van een applicatieserver, zoals Cocoon is de beste optie.
   In deze sectie zullen we zien hoe we DocBook 4.1.2 XML bestanden met
   Cocoon+Tomcat kunnen tonen.
     _________________________________________________________________

Tomcat + Cocoon

   Tomcat is de Java Servlet Container. Kijk voor meer informatie op
   [32]http://jakarta.apache.org/tomcat/index.html

   Apache Cocoon is een XML publishing framework. Kijk voor meer
   informatie op [33]http://xml.apache.org/cocoon/index.html

   In deze HOWTO zal niet worden ingegaan op details nodig voor het
   instellen van Cocoon+Tomcat, aangezien dit reeds wordt uitgelegd op @
   [34]http://xml.apache.org/cocoon/installing/index.html. In instellen
   van Tomcat+Cocoon is niet moeilijk en het zou in minder dan 5 minuten
   moeten kunnen.

   Zodra je Cocoon + Tomcat werkend hebt, volg je de volgende secties om
   de inhoud van DocBook 4.1.2 XML in een browser te kunnen bekijken.
     _________________________________________________________________

XSL van Norman Walsh installeren

   In deze stap zullen we XSL van Norman Walsh installeren onder
   /usr/local/dbtools/.

   Ga naar de directory /tmp/downloadsen pak het archiefbestand
   docbook-xsl uit.
   # cd /tmp/downloads/

   # gzip -d docbook-xsl-1.53.0.tar.gz

   # tar -xvf docbook-xsl-1.53.0.tar

   Verplaats voor de installatie van docbook-xsl de bestanden naar de
   directory /usr/local/dbtools
   # mv docbook-xsl-1.53.0 /usr/local/dbtool/docbook-xsl

   Installeer dan de LDP XSL
     _________________________________________________________________

LDP XSL installeren

   Decomprimeer het bestand ldp-xs.zip en kopieer alle bestanden naar de
   directory /usr/local/dbtools/docbook-xsl/html.
   # cd /tmp/downloads

   # unzip ldp-xs.zip

   # mv ldp-html*.xsl /usr/local/dbtools/docbook-xsl/html

   Bewerk vervolgens het bestand
   /usr/local/dbtools/docbook-xsl/html/ldp-html.xsl om het pad voor het
   importbestand in te stellen.
   # vi /usr/local/dbtools/docbook-xsl/html/ldp-html.xsl

   wijzig:
   import href="/usr/share/sgml/docbook/docbook-xsl-1.44/html/docbook.xsl"

   in:
   import href="/usr/local/dbtools/docbook-xsl/html/docbook.xsl"
     _________________________________________________________________

Instellen van sitemap.xmap

   $COCOON_HOME verwijst naar de Cocoon Web Application Directory. Dit is
   de directory /usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/

   Maak een directory met de naam docbook aan onder $COCOON_HOME/mount.
   Hier zullen we alle DocBook XML 4.1.2 inhoud gaan plaatsen.
   # mkdir $COCOON_HOME/mount/docbook

   Maak een bestand sitemap.xmap aan in de directory
   $COCOON_HOME/mount/docbook met de volgende inhoud:
   # cd $COCOON_HOME/mount/docbook

   # vi sitemap.xmap

<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">

    <!-- gebruik de standaardcomponenten -->
    <map:components>
        <map:generators default="file"/>
        <map:transformers default="xslt"/>
        <map:readers default="resource"/>
        <map:serializers default="html"/>
        <map:selectors default="browser"/>
        <map:matchers default="wildcard"/>
        <map:transformers default="xslt"/>
    </map:components>

    <map:pipelines>
        <map:pipeline>

   <map:match pattern="">
    <map:generate src="samples.xml"/>
    <map:transform src="/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/mount/ed
itor/stylesheets/simple-page2html.xsl"/>
    <map:serialize/>
   </map:match>

   <!-- reageer op *.html verzoeken met
                 onze docs verwerkt door .xsl -->
            <map:match pattern="*.html">
                <map:generate src="{1}.xml"/>
                <map:transform src="/usr/local/dbtools/docbook-xsl/html/ldp-htm
l.xsl"/>
                <map:serialize type="html"/>
            </map:match>

            <!-- later, reageer op *.pdf verzoeken met
                 onze docs verwerkt door doc2pdf.xsl -->
            <map:match pattern="*.pdf">
                <map:generate src="{1}.xml"/>
                <map:transform src="/usr/local/dbtools/docbook-xsl/fo/docbook.x
sl"/>
                <map:serialize type="fo2pdf"/>
            </map:match>

            <map:match pattern="*.xml">
                <map:generate src="{1}.xml"/>
                <map:serialize type="xml"/>
            </map:match>


        </map:pipeline>
    </map:pipelines>
</map:sitemap>
     _________________________________________________________________

Inhoud van een DocBook 4.1.2 XML bestand bekijken vanuit een webbrowser

   Plaats een DocBook 4.1.2 XML-bestand in $COCOON_HOME/mount/docbook/

   Een voorbeeldbestand is beschikbaar vanaf
   [35]http://docbook.sc-icc.org/sample.xml

   Nu kun je het document benaderen vanuit een browser @
   http://localhost:8080/cocoon/mount/sample.html (HTML) of
   http://localhost:8080/cocoon/mount/sample.pdf (PDF)
     _________________________________________________________________

Verdere informatie

   In deze sectie staan een aantal verwijzingen naar gerelateerde bronnen
   op het internet.

   Als je aanbevelingen hebt voor extra bronnen in deze sectie, stuur me
   dan alsjeblieft een mail @ <[36] saqib@seagate.com>. Bedankt.
     _________________________________________________________________

Nieuwsgroepen

   Een aantal van belang zijnde nieuwsgroepen:

    1. comp.text.sgml (makkelijk toegankelijk vanaf
       [37]http://www.deja.com)
    2. comp.text.xml (makkelijk toegankelijk vanaf
       [38]http://www.deja.com)
    3. htmldoc.general (server - nttp://news.easysw.com)
     _________________________________________________________________

Mailinglijsten

   Hier zijn een aantal relevante mailinglijsten

    1. DocBook mailing list @ OASIS. Ga naar
       [39]http://www.oasis-open.org/committees/docbook/mailinglist/index
       .shtml voor meer info.
    2. DocBook mailing list @ TLDP. Ga naar
       [40]http://www.tldp.org/mailinfo.html voor meer info.
    3. xml-doc @ Yahoo Groups. Ga naar
       [41]http://groups.yahoo.com/group/xml-doc/ voor meer info.
     _________________________________________________________________

IRC

    1. DocBook IRC Channel. #docbook op irc://irc.openprojects.net
     _________________________________________________________________

Websites

    1. [42]http://www.oasis-open.org/ OASIS beheert diverse DocBook DTD's
    2. [43]http://docbook.org/wiki/moin.cgi/De DocBook Wiki
    3. [44]http://www.docbook.org/tdg/en/Online versie van DocBook: The
       Definitive Guide
    4. [45]http://www-106.ibm.com/developerworks/library/l-docbk.htmlA
       gentle guide to DocBook (zeer goede introductie).
    5. [46]http://www.tldp.org/LDP/LDP-Author-Guide/index.htmlHet Linux
       Documentatie Project (TLDP) Author Guide
    6. [47]http://www.tldp.org/authors/index.html#resourcesDocBook
       bronnen geleverd door de TLDP
     _________________________________________________________________

Commerciële tools

    1. DocPro van Command Prompt, INC.
       [48]http://www.commandprompt.com/entry.lxp?lxpe=2
    2. YAWC Pro van XML Workshop LTD. [49]http://www.yawcpro.com/. Kan
       worden gebruikt om MS Word documenten om te zetten in Simple
       DocBook XML.
    3. Logictran RTF Converter. [50]http://www.logictran.com/. Word/RTF
       naar HTML/XML
    4. MajiX - Word naar XML converter. [51]http://tetrasys.dhs.org/
    5. XMETAL van SoftQuad [52]http://www.softquad.com/

References

   1. mailto:saqib@seagate.com
   2. mailto:bokkie@nl.linux.org
   3. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#intro
   4. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#requirements
   5. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#inst-openjade
   6. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#AEN394
   7. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#AEN446
   8. file://localhost/tmp/DocBook-OpenJade-SGML-XML-HOWTO-NL/DocBook-OpenJade-SGML-XML-HOWTO-NL.html#AEN525
   9. http://www.gnu.org/copyleft/fdl.html
  10. mailto:gferg (at) hoop.timonium.sgi.com
  11. mailto:kristint (at) us.ibm.com
  12. mailto:luc@delouw.ch
  13. mailto:ldp@foolswisdom.org
  14. http://www.gnu.org/
  15. http://www.gnu.org/
  16. http://www.tldp.org/authors/index.html#resources
  17. http://openjade.sourceforge.net/
  18. http://www.tldp.org/authors/index.html#resources
  19. http://www.tldp.org/authors/tools/docbk41.zip
  20. http://www.tldp.org/authors/tools/docbk31.zip
  21. http://www.tldp.org/authors/tools/docbkx412.zip
  22. http://www.tldp.org/
  23. http://www.tldp.org/authors/tools/entities.tar.gz
  24. http://sourceforge.net/project/showfiles.php?group_id=21935
  25. http://www.tldp.org/
  26. http://www.tldp.org/authors/tools/ldp.dsl
  27. http://www.easysw.com/htmldoc/software.php
  28. http://sourceforge.net/projects/docbook/
  29. http://www.tldp.org/authors/tools/ldp-xsl.zip
  30. http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml
  31. http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.xml
  32. http://jakarta.apache.org/tomcat/index.html
  33. http://xml.apache.org/cocoon/index.html
  34. http://xml.apache.org/cocoon/installing/index.html
  35. http://docbook.sc-icc.org/sample.xml
  36. mailto: saqib@seagate.com
  37. http://www.deja.com/
  38. http://www.deja.com/
  39. http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml
  40. http://www.tldp.org/mailinfo.html
  41. http://groups.yahoo.com/group/xml-doc/
  42. http://www.oasis-open.org/
  43. http://docbook.org/wiki/moin.cgi/
  44. http://www.docbook.org/tdg/en/
  45. http://www-106.ibm.com/developerworks/library/l-docbk.html
  46. http://www.tldp.org/LDP/LDP-Author-Guide/index.html
  47. http://www.tldp.org/authors/index.html#resources
  48. http://www.commandprompt.com/entry.lxp?lxpe=2
  49. http://www.yawcpro.com/
  50. http://www.logictran.com/
  51. http://tetrasys.dhs.org/
  52. http://www.softquad.com/