<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://docbook.org/xml/4.1.2/docbookx.dtd">
<!-- -->
<article lang="it">
  <articleinfo>
    <title>DocBook XML/SGML Processing Using OpenJade</title>
    <author>
      <firstname>Saqib</firstname>
      <surname>Ali</surname>
      <affiliation>
        <address> <email>saqib@seagate.com</email> </address>
      </affiliation>
    </author>
    <revhistory>
      <revision>
        <revnumber>v2.2.8</revnumber>
        <date>2003-07-16</date>
        <authorinitials>es</authorinitials>
        <revremark>Aggiunte informazioni sulla sincronizzazione di JRE con Cocoon.</revremark>
      </revision>
      <revision>
        <revnumber>v2.2.7</revnumber>
        <date>2003-07-09</date>
        <authorinitials>es</authorinitials>
        <revremark>Corretti collegamenti interrotti a LDP XSL e ad altri file specifici di LDP XSL. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2.6</revnumber>
        <date>2003-06-16</date>
        <authorinitials>sa</authorinitials>
        <revremark>Verificate le istruzioni con DocBook XSL 1.57. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2.5</revnumber>
        <date>2003-05-16</date>
        <authorinitials>sa</authorinitials>
        <revremark>Corretti i collegamenti interrotti nella sezione delle risorse esterne.</revremark>
      </revision>
      <revision>
        <revnumber>v2.2.4</revnumber>
        <date>2003-04-20</date>
        <authorinitials>sa</authorinitials>
        <revremark>Aggiornati i collegamenti al nuovo sito delle demo. Aggiunti nuovi collegamenti nella sezione delle risorse. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2.3</revnumber>
        <date>2002-11-22</date>
        <authorinitials>sa</authorinitials>
        <revremark>Inseriti i suggerimenti degli utenti. Aggiunti nuovi collegamenti nella sezione delle risorse. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2.2</revnumber>
        <date>2002-10-09</date>
        <authorinitials>as</authorinitials>
        <revremark>Con questo aggiornamento sono stati corretti alcuni ulteriori errori tipografici e rimossi alcuni spazi che rendevano sgradevole l'aspetto della conversione in HTML. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2.1</revnumber>
        <date>2002-10-09</date>
        <authorinitials>sa</authorinitials>
        <revremark>Corretta la URL ai file di esempio. </revremark>
      </revision>
      <revision>
        <revnumber>v2.2</revnumber>
        <date>2002-09-29</date>
        <authorinitials>as</authorinitials>
        <revremark>Piccole correzioni alla sezione su Cocoon.</revremark>
      </revision>
      <revision>
        <revnumber>v2.1</revnumber>
        <date>2002-09-15</date>
        <authorinitials>sa</authorinitials>
        <revremark>Piccole correzioni alla sezione su Cocoon.</revremark>
      </revision>
      <revision>
        <revnumber>v2.0</revnumber>
        <date>2002-09-10</date>
        <authorinitials>sa</authorinitials>
        <revremark>Aggiunta la sezione relativa all'utilizzo di Tomcat e Cocoon come server di contenuti per DocBook XML 4.1.2. </revremark>
      </revision>
      <revision>
        <revnumber>v1.5</revnumber>
        <date>2002-08-11</date>
        <authorinitials>sa</authorinitials>
        <revremark>Inserita la sezione su XML con il relativo file di esempio. </revremark>
      </revision>
      <revision>
        <revnumber>v1.4</revnumber>
        <date>2002-08-08</date>
        <authorinitials>sa</authorinitials>
        <revremark>Alcune importanti correzioni e modifiche suggerite da Lloyd D Budd. Grazie Lloyd. :) </revremark>
      </revision>
      <revision>
        <revnumber>v1.3</revnumber>
        <date>2002-08-02</date>
        <authorinitials>sa</authorinitials>
        <revremark>Aggiunta la sezione sulle "ulteriori informazioni". </revremark>
      </revision>
      <revision>
        <revnumber>v1.2</revnumber>
        <date>2002-07-23</date>
        <authorinitials>sa</authorinitials>
        <revremark> Aggiunta la sezione sulla conversione HTML -&gt; PDF utilizzando HTMLDOC. Grazie a Luc De Louw per il suggerimento. </revremark>
      </revision>
      <revision>
        <revnumber>v1.1</revnumber>
        <date>2002-07-19</date>
        <authorinitials>KET</authorinitials>
        <revremark> Corretti errori grammaticali, numerate le procedure. </revremark>
      </revision>
      <revision>
        <revnumber>v1.0</revnumber>
        <date>2002-06-29</date>
        <authorinitials>sa</authorinitials>
        <revremark>Primo rilascio pubblico. </revremark>
      </revision>
    </revhistory>
    <abstract>
      <para>Questo HOWTO spiega come configurare OpenJade per trattare documenti DocBook in SGML e XML.</para>
      <para>Traduzione a cura di Giuseppe Briotti, <email>g.briotti (at) mclink.it</email>. Revisione a cura
      di Beatrice Torracca.</para>
    </abstract>
  </articleinfo>
  <sect1 id="intro">
    <title>Introduzione</title>
    <para>Alcuni acronimi:</para>
    <orderedlist>
      <listitem>
        <para>SGML - Standard Generalized Markup Language</para>
      </listitem>
      <listitem>
        <para>XML - Extensible Markup Language</para>
      </listitem>
      <listitem>
        <para>RTF - Rich Text Format</para>
      </listitem>
      <listitem>
        <para>HTML - HyperText Markup Language</para>
      </listitem>
      <listitem>
        <para>PDF - Portable Document Format</para>
      </listitem>
    </orderedlist>
    <para> L'obiettivo di questo documento è di configurare OpenJade per convertire il formato di documenti DocBook, stilati in Standard Generalized Markup Language (SGML) 3.2 e 4.2 e in Extensible Markup Language (XML), nei formati HyperText Markup Language (HTML), Rich Text Format (RTF) e Portable Document Format (PDF).</para>
    <sect2 id="copyright">
      <title>Copyright e Licenza</title>
      <para> This document is Copyright 2001 by Saqib Ali. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is available at <ulink url="http://www.gnu.org/copyleft/fdl.html">http://www.gnu.org/copyleft/fdl.html</ulink>. </para>
      <para> Di seguito la traduzione del paragrafo precedente, con l'avvertenza che è il testo originale inglese che ha valore legale:</para>
      <para> Copyright 2001 by Saqib Ali. &Egrave; concesso il permesso di copiare, distribuire e/o modifcare questo documento nei termini della licenza GNU sulla libera documentazione, versione 1.1 o qualsiasi versione successiva pubblicata dalla Free Software Foundation; senza i vincoli sulle Sezioni Immodificabili, sulla Prima di copertina e sull'Ultima di copertina. Copia della licenza è disponibile sul sito <ulink url="http://www.gnu.org/copyleft/fdl.html">http://www.gnu.org/copyleft/fdl.html</ulink>. </para>
    </sect2>
    <sect2>
      <title>Ringraziamenti</title>
      <para>Tutte le lodi sono di <emphasis role="strong"><emphasis></emphasis>Allah</emphasis>, <emphasis role="strong">il Signore dei Mondi</emphasis>. Tutti i ringraziamenti vanno ad <emphasis role="strong">Allah</emphasis>. Qualunque errore in questo documento è una mia colpa.</para>
      <para>Inoltre, mi piacerebbe ringraziare le seguenti persone per i loro validi contributi a questo documento:</para>
      <orderedlist>
        <listitem>
          <para> Eric Safern <email>esafern (at) lrn.com</email> - per gli aggiornamenti relativi a Cocoon e JRE. <ulink url="http://www.timebytes.com/">http://www.timebytes.com/</ulink></para>
        </listitem>
        <listitem>
          <para>Greg Ferguson <email>gferg (at) hoop.timonium.sgi.com</email> - per le utili indicazioni/suggerimenti sulla mailing list di docbook.</para>
        </listitem>
        <listitem>
          <para>Kristin Thomas <email>kristint (at) us.ibm.com</email> - per la revisione iniziale di questo documento.</para>
        </listitem>
        <listitem>
          <para>Luc de Louw <email>luc (at) delouw.ch</email> - per i suggerimenti sulla sezione HTMLDOC (PDF -&gt; HTML).</para>
        </listitem>
        <listitem>
          <para>Lloyd D Budd <email>ldp (at) foolswisdom.org</email> - per i suggerimenti che hanno consentito di migliorare molte delle sezioni del documento.</para>
        </listitem>
        <listitem>
          <para>Andrew Shugg <email>andrew (at) neep.com.au</email> - per aver corretto gli errori nella versione 2.0 di questo documento. <ulink url="http://www.neep.com.au/">Neep Consulting</ulink></para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Cosa è DocBook?</title>
      <para> DocBook è una definizione di tipo di documento (Document Type Definition - DTD). Una DTD definisce la sintassi di un documento. DocBook descrive i tipi di struttura ed i formati da utilizzare nei documenti tecnici. &Egrave; comunemente utilizzato per la sua semplicità e completezza.</para>
      <para> Una DTD definisce la sintassi di un documento: è essenzialmente un "libro di regole" che descrive gli insiemi di tag ed attributi che saranno utilizzati nella definizione di specifici tipi di contenuto. Così DocBook è un "libro di regole" che viene utilizzato per scrivere documenti. Ogni tag utilizzato nella scrittura del documento, deve essere definito molto specificatamente e formalmente nel DTD. </para>
    </sect2>
    <sect2>
      <title>Cosa è un DSSSL?</title>
      <para>Un Document Style Semantics and Specification Language (DSSSL) definisce come convertire un documento scritto in Standard Generalized Markup Language (SGML) in un formato leggibile quale HTML, RTF e PDF.</para>
    </sect2>
    <sect2>
      <title>Cosa è necessario avere?</title>
      <para>Gli strumenti necessari a configurare OpenJade per convertire SGML e XML sono i seguenti:</para>
      <itemizedlist>
        <listitem>
          <para>OpenJade</para>
        </listitem>
        <listitem>
          <para>Le DTD di DocBook</para>
        </listitem>
        <listitem>
          <para>Le Entità ISO</para>
        </listitem>
        <listitem>
          <para>Il DSSSL di Norman Walsh</para>
        </listitem>
        <listitem>
          <para>Il DSL di LDP</para>
        </listitem>
        <listitem>
          <para>HTMLDOC (opzionale)</para>
        </listitem>
        <listitem>
          <para>Gli XSL di Norman Walsh (opzionali)</para>
        </listitem>
        <listitem>
          <para>Gli XSL di LDP (opzionali)</para>
        </listitem>
      </itemizedlist>
      <note>
        <title>Nota</title>
        <para>Tutti i pacchetti citati sono liberamente distribuiti e disponibili in rete. Il prossimo capitolo spiega come scaricare questi pacchetti.</para>
      </note>
    </sect2>
    <sect2>
      <title>Presupposti</title>
      <para>In questo documento si presume che il lettore abbia installato sul proprio sistema quanto segue: </para>
      <itemizedlist>
        <listitem>
          <para>gzip - disponibile su <ulink url="http://www.gnu.org/directory/">http://www.gnu.org/directory/</ulink></para>
        </listitem>
        <listitem>
          <para>gcc e GNU make - disponibili su <ulink url="http://www.gnu.org/directory/">http://www.gnu.org/directory/</ulink></para>
        </listitem>
        <listitem>
          <para>unzip - disponibile su <ulink url="http://www.info-zip.org/pub/infozip/">http://www.info-zip.org/pub/infozip/</ulink></para>
        </listitem>
        <listitem>
          <para>Strumenti standard Unix, quali: tar, mkdir, mv...</para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>
  <sect1 id="requirements">
    <title>Requisiti</title>
    <para>Si deve scaricare e compilare un solo pacchetto (OpenJade). Questo HOWTO illustrerà la procedura di compilazione, ma il lettore dovrebbe avere familiarità con l'installazione da codice sorgente. </para>
    <para>La maggior parte dei pacchetti necessari sono disponibili sul sito web <ulink url="http://www.tldp.org/authors/index.html#resources">The Linux Documentation Project (TLDP)</ulink>.</para>
    <sect2>
      <title>Pre-requisiti</title>
      <para> Creare una directory <filename class="directory">/tmp/downloads</filename>. Sarà utilizzata per archiviare il codice sorgente scaricato. </para>
    </sect2>
    <sect2>
      <title>OpenJade</title>
      <para>OpenJade sarà utilizzato per trattare documenti DocBook. OpenJade può essere scaricato da: <ulink url="http://openjade.sourceforge.net/">http://openjade.sourceforge.net/</ulink>. </para>
      <para>Al momento della stesura del presente documento, era disponibile la versione OpenJade 1.3.1. Il file da scaricare è openjade-1.3.x.tar.gz.</para>
    </sect2>
    <sect2>
      <title>Le DTD DocBook</title>
      <para>Tutte le DTD DocBook sono disponibili sul sito The Linux Documentation Project all'indirizzo <ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink>.</para>
      <para>Scaricare le seguenti DTD: <ulink url="http://www.tldp.org/authors/tools/docbk41.zip">DocBook SGML v4.1</ulink>, <ulink url="http://www.tldp.org/authors/tools/docbk31.zip">DocBook SGML v3.1</ulink> e <ulink url="http://www.tldp.org/authors/tools/docbkx412.zip">DocBook XML v4.1.2</ulink>. </para>
      <note>
        <title>Nota</title>
        <para>Scaricare tutti gli archivi zip.</para>
      </note>
    </sect2>
    <sect2>
      <title>Entità ISO</title>
      <para> Per comodità degli utenti, <ulink url="http://www.tldp.org">The Linux Documentation Project</ulink> ha compresso tutte le entità in un unico grande file tar, collocato all'indirizzo <ulink url="http://www.tldp.org/authors/tools/entities.tar.gz">http://www.tldp.org/authors/tools/entities.tar.gz</ulink>. Grazie al TLDP per questo. </para>
    </sect2>
    <sect2>
      <title>DSSSL di Norman Walsh</title>
      <para>Il DSSSL sviluppato da Norman Walsh può essere scaricato dal sito web del progetto DocBook: <ulink url="http://sourceforge.net/project/showfiles.php?group_id=21935">http://sourceforge.net/project/showfiles.php?group_id=21935</ulink>. </para>
      <para> Al momento della stesura del presente documento era disponibile il file docbook-dsssl-1.7.6. </para>
    </sect2>
    <sect2>
      <title>Fogli di stile DSL personalizzati da LDP</title>
      <para> LDP DSL è un foglio di stile personalizzato usato da <ulink url="http://www.tldp.org">The Linux Documentation Project (TLDP)</ulink>. &Egrave; una estensione del DSSSL di Norman Walsh. Sono state aggiunte cose come gli sfondi e gli Indici. Può essere scaricato da <ulink url="http://www.tldp.org/authors/tools/ldp.dsl">http://www.tldp.org/authors/tools/ldp.dsl</ulink>. </para>
      <para>Il file ldp.dsl richiede il DSSSL di Norman Walsh.</para>
    </sect2>
    <sect2>
      <title>HTMLDOC (Opzionale)</title>
      <para>HTMLDOC può essere utilizzato per convertire l'HTML in PDF. Se preferite produrre documenti in PDF, potrete scaricare HTMLDOC da <ulink url="http://www.easysw.com/htmldoc/software.php">http://www.easysw.com/htmldoc/software.php</ulink>.</para>
    </sect2>
    <sect2>
      <title>XSL di Norman Walsh (Opzionale)</title>
      <para>Questo non è necessario. Ma qualora si volesse utilizzare Tomcat + Cocoon come server di contenuti per documenti XML DocBook 4.1.2, saranno necessari i fogli di stile XML creati da Norman Walsh.</para>
      <para>I fogli di stile sono disponibili sul sito <ulink url="http://sourceforge.net/projects/docbook/">http://sourceforge.net/projects/docbook/</ulink>.</para>
      <para>Si può scaricare il pacchetto chiamato docbook-xsl.</para>
      <note>
        <title>Nota</title>
        <para>Recentemente è stata rilasciata la versione 1.57.0 del pacchetto. Quanto qui detto è stato verificato con l'ultima versione, apportando al testo le opportune modifiche. Chi dovesse incontrare ancora errori, è pregato di avvisarmi via e-mail all'indirizzo <email>saqib@seagate.com</email>.</para>
      </note>
    </sect2>
    <sect2>
      <title>XSL personalizzati da LDP (Opzionali)</title>
      <para>I fogli di stile personalizzati da LDP possono essere scaricati da <ulink url="http://my.core.com/~dhorton/docbook/tldp-xsl/">http://my.core.com/~dhorton/docbook/tldp-xsl/</ulink>.</para>
    </sect2>
  </sect1>
  <sect1 id="inst-openjade">
    <title>Installazione degli strumenti di elaborazione - OpenJade</title>
    <para>In questa sezione verrà spiegata l'installazione degli strumenti nelle directory appropriate. Tutti gli strumenti vanno posti nella directory <filename class="directory">/usr/local/dbtools/</filename>. Questa directory può essere creata con il seguente comando:</para>
    <screen><command># mkdir /usr/local/dbtools</command></screen>
    <sect2>
      <title>Installazione di OpenJade</title>
      <para>Questa operazione è la parte più facile, ma anche quella che richiede più tempo. Si rammenti che OpenJade richiede un lungo tempo di compilazione. Per installare OpenJade, si completino i seguenti passi:</para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/tmp/downloads</filename>. </para>
          <screen>
	<command># cd /tmp/downloads</command>
	</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file. </para>
          <screen>
	<command># gzip -d openjade-1.3.x.tar.gz</command>
	</screen>
        </listitem>
        <listitem>
          <para>Estrarre i file dall'archivio.</para>
          <screen>
	<command># tar -xvf openjade-1.3.x.tar</command>
	</screen>
        </listitem>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">openjade-1.3</filename>.</para>
          <screen>
	<command># cd openjade-1.3.x</command>
	</screen>
        </listitem>
        <listitem>
          <para>Eseguire il comando <command>./configure</command>.</para>
          <screen>
	<command># ./configure --prefix=/usr/local/dbtools/openjade</command>
	</screen>
        </listitem>
        <listitem>
          <para>Eseguire il comando <command>make</command>.</para>
          <screen>
	<command># make</command>
	</screen>
        </listitem>
        <listitem>
          <para>Eseguire il comando <command>make install</command>. Completato questo passo, i file binari di OpenJade saranno installati in <filename class="directory">/usr/local/dbtools/openjade</filename>.</para>
          <screen>
	<command># make install</command>
	</screen>
        </listitem>
        <listitem>
          <para>Copiare la directory <filename class="directory">dsssl</filename> da <filename class="directory">/tmp/downloads/openjade-1.3.x</filename> in <filename class="directory">/usr/local/dbtools/openjade</filename> </para>
          <screen>
	<command># cp -dpR dsssl /usr/local/dbtools/openjade/</command>
	</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installazione del DSSSL di Norman Walsh</title>
      <para> In questa fase si installerà il DSSSL di Norman Walsh in una collocazione appropriata. Il DSSSL non necessita di compilazione. </para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/tmp/downloads</filename>.</para>
          <screen>
	<command># cd /tmp/downloads</command>
	</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file.</para>
          <screen>
	<command># gzip -d docbook-dsssl-1.76.tar.gz</command>
	</screen>
        </listitem>
        <listitem>
          <para>Estrarre il file dall'archivio.</para>
          <screen>
	<command># tar -xvf docbook-dsssl-1.76.tar</command>
	</screen>
        </listitem>
        <listitem>
          <para>Spostare il file in <filename class="directory">/usr/local/dbtools/docbook-dsssl</filename>.</para>
          <screen>
	<command># mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl</command>
	</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installazione dei DTD di DocBook</title>
      <para>In questa sezione installeremo i DTD di DocBook. </para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/usr/local/dbtools</filename>.</para>
          <screen>
	<command># cd /usr/local/dbtools</command>
	</screen>
        </listitem>
        <listitem>
          <para>Creare tre nuove directory chiamate <filename class="directory">dtd3.1</filename>, <filename class="directory">dtd4.1</filename> e <filename class="directory">dtd4.1.2</filename>.</para>
          <screen>
	<command># mkdir dtd3.1</command>
	<command># mkdir dtd4.1</command>
	<command># mkdir dtd4.1.2</command>
	</screen>
        </listitem>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">dtd3.1</filename>.</para>
          <screen>
		<command># cd dtd3.1</command>
		</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file DocBook SGML v3.1 in questa directory.</para>
          <screen>
		<command># unzip /tmp/downloads/docbk31.zip</command>
		</screen>
        </listitem>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">dtd4.1</filename>.</para>
          <screen>
		<command># cd ../dtd4.1</command>
		</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file DocBook SGML v4.1 in questa directory.</para>
          <screen>
		<command># unzip /tmp/downloads/docbk41.zip</command>
		</screen>
        </listitem>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">dtd4.1.2</filename>.</para>
          <screen>
		<command># cd ../dtd4.1.2</command>
		</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file DocBook XML v4.1.2 in questa directory.</para>
          <screen>
		<command># unzip /tmp/downloads/docbk412.zip</command>
		</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installazione delle Entità ISO</title>
      <para>In questa sezione installeremo le entità ISO scaricate dal sito web di LDP.</para>
      <para>Per prime si installino le entità ISO per le DTD SGML, versione 3.1.</para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/usr/local/dbtools/dtd3.1</filename>.</para>
          <screen>
	<command># cd /usr/local/dbtools/dtd3.1</command>
	</screen>
        </listitem>
        <listitem>
          <para>Copiare il file <filename>/tmp/downloads/entities.tar.gz</filename> in questa directory.</para>
          <screen>
	<command># cp /tmp/downloads/entities.tar.gz .</command>
	</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file.</para>
          <screen>
	<command># gzip -d entities.tar.gz</command>
	</screen>
        </listitem>
        <listitem>
          <para>Estrarre i file dall'archivio.</para>
          <screen>
	<command># tar -xvf entities.tar</command>
	</screen>
        </listitem>
      </orderedlist>
      <para>Si installino ora le entità ISO per le DTD SGML, versione 4.1.</para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/usr/local/dbtools/dtd4.1</filename>.</para>
          <screen>
	<command># cd /usr/local/dbtools/dtd4.1</command>
	</screen>
        </listitem>
        <listitem>
          <para>Copiare il file <filename>/tmp/downloads/entities.tar.gz</filename> in questa directory.</para>
          <screen>
	<command># cp /tmp/downloads/entities.tar.gz .</command>
	</screen>
        </listitem>
        <listitem>
          <para>Decomprimere il file.</para>
          <screen>
	<command># gzip -d entities.tar.gz</command>
	</screen>
        </listitem>
        <listitem>
          <para>Estrarre i file dall'archivio.</para>
          <screen>
	<command># tar -xvf entities.tar</command>
	</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installazione del DSL di LDP</title>
      <para>Infine, si installino i fogli di stile personalizzati di LDP.</para>
      <orderedlist>
        <listitem>
          <para>Cambiare la directory corrente in <filename class="directory">/tmp/downloads</filename>.</para>
          <screen>
	<command># cd /tmp/downloads </command>
	</screen>
        </listitem>
        <listitem>
          <para>Copiare il file <filename>ldp.dsl</filename> nella directory <filename class="directory">/usr/local/dbtools/docbook-dsssl/print/ldp.dsl</filename>.</para>
          <screen>
	<command># cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print/ldp.dsl</command>
	</screen>
        </listitem>
        <listitem>
          <para>Copiare il file <filename>ldp.dsl</filename> nella directory <filename class="directory">/usr/local/dbtools/docbook-dsssl/html/ldp.dsl</filename>.</para>
          <screen>
	<command># cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl</command>
	</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installazione di HTMLDOC</title>
      <para>Questo passo è opzionale. &Egrave; richiesto solo se si vuole produrre documentazione PDF da documenti scritti in HTML.</para>
      <para>Ritornare alla directory di download.</para>
      <screen>
	<command># cd /tmp/downloads directory</command>
</screen>
      <para>Estrarre dall'archivio il codice sorgente di HTMLDOC.</para>
      <screen>
	<command># gzip -d htmldoc-1.8.xx-source.tar.gz </command>
	<command># tar -xvf htmldoc-1.8.xx-source.tar </command>
	<command># cd htmldoc-1.8.xx-1</command>
</screen>
      <para>Lanciare il comando <command>configure</command> per impostare la posizione dell'installazione.</para>
      <screen>
	<command># ./configure --prefix=/usr/local/dbtools/htmldoc</command>
	<command># make</command>
</screen>
      <para>Al momento della stesura di questo documento era disponibile la versione 1.8.20-1 di HTMLDOC. Questa versione aveva un piccolo problema di font nel Makefile. Si dovrebbe presentare al momento di installare i font, poiché i font corretti non sono disponibili sul sistema.</para>
      <para>L'errore che si presenta al momento di lanciare il comando <command>make install</command> è questo:</para>
      <screen>
	<command># make install</command>
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

</screen>
      <para>Per correggere questo problema di installazione, si modifichi il file <filename>fonts/Makefile</filename>  commentando le righe che fanno riferimento ai font ZapfChancery e ZapfDingbats.</para>
      <para>Quindi si esegua l'installazione:</para>
      <screen>
<command># make install</command>
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...

</screen>
    </sect2>
  </sect1>
  <sect1>
    <title>Utilizzo di OpenJade</title>
    <para>In questa sezione si utilizzerà OpenJade per convertire documenti dal formato DocBook SGML/XML nei formati HTML, RTF e PDF.</para>
    <sect2>
      <title>Trasformazione da SGML</title>
      <sect3>
        <title>Impostare la variabile di ambiente SGML_CATALOG_FILES per l'SGML</title>
        <para>La variabile SGML_CATALOG_FILES deve essere impostata per puntare ai file di catalogo appropriati. Per impostare la variabile, si utilizzi il seguente comando per la shell Bourne:</para>
        <screen>
<command># export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
        <para>Con la shell C si utilizzi invece:</para>
        <screen>
<command># setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
      </sect3>
      <sect3>
        <title>Da SGML a HTML</title>
        <para>Per convertire documenti da SGML a HTML, si usi il seguente comando: </para>
        <screen>
<command># /usr/local/dbtools/openjade/bin/openjade -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
	<para>(NdT. In questo ed in altri esempi seguenti, si utilizza come file da trasformare il sorgente del presente documento)</para>
	<para>Per creare in uscita un file <emphasis>non-chunked</emphasis> (tutto in una pagina):</para>
        <screen>
<command># /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
      </sect3>
      <sect3>
        <title>Da SGML a RTF</title>
        <para>Per convertire documenti da SGML a RTF, si usi il seguente comando: </para>
        <screen>
<command># /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
      </sect3>
    </sect2>
    <sect2>
      <title>Trasformazione da XML</title>
      <para>&Egrave; possibile scaricare un file di esempio in XML DocBook 4.1.2 da <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</ulink>.</para>
      <sect3>
        <title>Impostare la variabile di ambiente SGML_CATALOG_FILES per XML</title>
        <para>La variabile SGML_CATALOG_FILES deve essere impostata per puntare ai file di catalogo appropriati. Per impostare la variabile, si utilizzi il seguente comando per la shell Bourne:</para>
        <screen>
<command># export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
        <para>Con la shell C si utilizzi invece:</para>
        <screen>
<command># setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
      </sect3>
      <sect3>
        <title>Da XML a HTML</title>
        <para>Per convertire documenti da XML a HTML, si usi il seguente comando:</para>
        <screen>
<command># /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 DocBook-OpenJade-SGML-XML-HOWTO.xml</command>
</screen>
      </sect3>
      <sect3>
        <title>Da XML a RTF</title>
        <para>Per convertire documenti da XML a RTF, si usi il seguente comando:</para>
        <screen>
<command># /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</command>
</screen>
      </sect3>
    </sect2>
    <sect2>
      <title>Da HTML a PDF (opzionale)</title>
      <para> Per conversioni da HTML a PDF si dovrà usare HTMLDOC. Occorre prima creare un file HTML <emphasis>non-chunked</emphasis> dall'SGML:</para>
      <screen>
<command># /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
      <para>Quindi si esegua HTMLDOC per produrre il file PDF.</para>
      <screen>
<command># /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html</command>
</screen>
    </sect2>
  </sect1>
  <sect1>
    <title>Server per XML DocBook 4.1.2</title>
    <para>Ci sono tre modi per utilizzare l'XML DocBook 4.1.2 su un server web:</para>
    <itemizedlist>
      <listitem>
        <para>Pre-processando i documenti da riga di comando - Open Jade, XSLT</para>
      </listitem>
      <listitem>
        <para>Utilizzando degli script - PHP, Perl, Python</para>
      </listitem>
      <listitem>
        <para>Con un server per applicazioni - Tomcat + Cocoon</para>
      </listitem>
    </itemizedlist>
    <para>Usare un server per applicazioni come Cocoon è la scelta migliore.</para>
    <note>
      <title>Cocoon in azione</title>
      <para>Per vedere un esempio di web server su cui girano Tomcat + Cocoon che agiscono da server di contenuti per XML DocBook 4.1.2, si può visitare il sito <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/">http://www.xml-dev.com:8080/cocoon/mount/docbook/</ulink>.</para>
    </note>
    <para> In questa sezione vedremo l'utilizzo di Tomcat + Cocoon come server di contenuti per documenti XML DocBook 4.1.2.</para>
    <sect2>
      <title>Tomcat + Cocoon</title>
      <para>Tomcat è il <emphasis>Java Servlet Container</emphasis>. Per ulteriori informazioni si visiti il sito <ulink url="http://jakarta.apache.org/tomcat/index.html">http://jakarta.apache.org/tomcat/index.html</ulink>.</para>
      <para>Apache Cocoon è un ambiente per la pubblicazione di documenti XML. Per ulteriori informazioni si visiti il sito <ulink url="http://xml.apache.org/cocoon/index.html">http://xml.apache.org/cocoon/index.html</ulink>.</para>
      <para>Questo HOWTO non entrerà nei dettagli sulla configurazione di Tomcat + Cocoon, poiché questa problematica è illustrata in <ulink url="http://xml.apache.org/cocoon/installing/index.html">http://xml.apache.org/cocoon/installing/index.html</ulink>. Configurare Tomcat + Cocoon è una facile procedura, che dovrebbe richiedere meno di cinque minuti.</para>
      <para>Una volta che si abbiano Cocoon + Tomcat configurati ed operativi, si passi alla sezione seguente, relativa al server di documenti XML DocBook 4.1.2.</para>
      <note><para>Un importante avviso: gli utenti del settore hanno riscontrato problemi di compatibilità utilizzando i fogli di stile DocBook con alcune versioni del parser XML Xalan. Xalan è il parser fornito col JRE (<emphasis>Java Runtime Environment</emphasis>) di Sun, ed è quindi quello utilizzato in maniera predefinita. </para></note>
      <para><emphasis>Ci si assicuri, come minimo, di utilizzare l'ultima versione di JRE di Sun (al momento della stesura di questo documento è la 1.4.2).</emphasis></para>
      <para>Si consideri anche l'opportunità di aggiornare il parser Xalan all'ultima versione. Al momento, con l'ultima JRE di Sun, la 1.4.2, è fornito Xalan 2.4.1, mentre lo stesso Xalan è giunto alla versione 2.5.1.</para>
      <para>Per controllare la versione di Xalan installata, si esegua:</para>
<screen><command> # java org.apache.xalan.xslt.EnvironmentCheck</command></screen>
      <para>Per ulteriori informazioni, si visiti il sito <ulink url="http://xml.apache.org/xalan-j/faq.html">http://xml.apache.org/xalan-j/faq.html</ulink>.</para>
    </sect2>
    <sect2>
      <title>Installazione dei fogli di stile XSL di Norman Walsh</title>
      <para>In questa fase verranno installati i fogli di stile XSL di Norman Walsh nella directory <filename class="directory">/usr/local/dbtools/</filename>.</para>
      <para>Cambiare la directory corrente in <filename class="directory">/tmp/downloads</filename> e decomprimere il file docbook-xsl.</para>
      <screen><command># cd /tmp/downloads/</command></screen>
      <screen><command># gzip -d docbook-xsl-1.53.0.tar.gz</command></screen>
      <screen><command># tar -xvf docbook-xsl-1.53.0.tar</command></screen>
      <para>Per installare docbook-xsl, occorre spostare i file in <filename class="directory">/usr/local/dbtools</filename>.</para>
      <screen><command># mv docbook-xsl-1.53.0 /usr/local/dbtool/docbook-xsl</command></screen>
      <para>Quindi si installino gli XSL di LDP.</para>
    </sect2>
    <sect2>
      <title>Installazione dei fogli di stile XSL di LDP</title>
      <para>Decomprimere il file <filename>tldp-xsl-xxxxx.tar.gz</filename> e copiare tutti i file nella directory <filename class="directory">/usr/local/dbtools/docbook-xsl/html</filename>.</para>
      <screen><command># cd /tmp/downloads</command></screen>
      <screen><command># gzip tldp-xsl-xxxxx.tar.gz</command></screen>
      <screen><command># tar -xvf tldp-xsl-xxxxx.tar</command></screen>
      <screen><command># mv tldp-html*.xsl /usr/local/dbtools/docbook-xsl/html</command></screen>
    </sect2>
    <sect2>
      <title>Configurazione di sitemap.xmap</title>
      <para>$COCOON_HOME punta alla directory delle applicazioni web di Cocoon (Cocoon Web Application Directory). Questa directory è solitamente <filename class="directory">/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/</filename>.</para>
      <para>Si crei una directory dal nome <filename class="directory">docbook</filename> all'interno di <filename class="directory">$COCOON_HOME/mount</filename>. Qui è dove si collocheranno tutti i propri documenti XML DocBook 4.1.2.</para>
      <screen><command># mkdir $COCOON_HOME/mount/docbook</command></screen>
      <para>Creare un file dal nome sitemap.xmap nella directory <filename class="directory">$COCOON_HOME/mount/docbook</filename> con il seguente contenuto:</para>
      <screen><command># cd $COCOON_HOME/mount/docbook</command></screen>
      <screen><command># vi sitemap.xmap</command></screen>
      <screen>
&lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;

    &lt;!-- usare i componenti convenzionali --&gt;
    &lt;map:components&gt;
        &lt;map:generators default="file"/&gt;
        &lt;map:transformers default="xslt"/&gt;
        &lt;map:readers default="resource"/&gt;
        &lt;map:serializers default="html"/&gt;
        &lt;map:selectors default="browser"/&gt;
        &lt;map:matchers default="wildcard"/&gt;
        &lt;map:transformers default="xslt"/&gt;
    &lt;/map:components&gt;

    &lt;map:pipelines&gt;
        &lt;map:pipeline&gt;

   &lt;map:match pattern=""&gt;
    &lt;map:generate src="samples.xml"/&gt;
    &lt;map:transform src="/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/mount/editor/stylesheets/simple-page2html.xsl"/&gt;
    &lt;map:serialize/&gt;
   &lt;/map:match&gt;

            &lt;!-- rispondere alle richeste *.html con
                 i propri documenti processati da .xsl --&gt;
            &lt;map:match pattern="*.html"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:transform src="/usr/local/dbtools/docbook-xsl/html/tldp-html.xsl"/&gt;
                &lt;map:serialize type="html"/&gt;
            &lt;/map:match&gt;

            &lt;!-- successivamente, rispondere a richieste *.pdf con
                 i propri documenti processati da doc2pdf.xsl --&gt;
            &lt;map:match pattern="*.pdf"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:transform src="/usr/local/dbtools/docbook-xsl/fo/docbook.xsl"/&gt;
                &lt;map:serialize type="fo2pdf"/&gt;
            &lt;/map:match&gt;

            &lt;map:match pattern="*.xml"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:serialize type="xml"/&gt;
            &lt;/map:match&gt;


        &lt;/map:pipeline&gt;
    &lt;/map:pipelines&gt;
&lt;/map:sitemap&gt;
</screen>
    </sect2>
    <sect2>
      <title>Accedere a contenuti XML DocBook 4.1.2 da un browser web</title>
      <para>Collocare un file XML DocBook 4.1.2 nella directory <filename class="directory">$COCOON_HOME/mount/docbook/</filename>.</para>
      <para>Un file di esempio è disponibile sul sito <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</ulink>.</para>
      <para>Ora è possibile accedere al documento, utilizzando un browser, all'indirizzo http://localhost:8080/cocoon/mount/sample.html (HTML) o http://localhost:8080/cocoon/mount/sample.pdf (PDF).</para>
    </sect2>
  </sect1>
  <sect1>
    <title>Ulteriori informazioni</title>
    <para>Questa sezione contiene alcuni link a risorse correlate disponibili su Internet.</para>
    <para>Chi volesse suggerire ulteriori risorse, può inviarmi le informazioni per email all'indirizzo <email>saqib@seagate.com</email>. Grazie.</para>
    <sect2>
      <title>News group</title>
      <para>Alcuni news group di interesse sono:</para>
      <orderedlist>
        <listitem>
          <para>comp.text.sgml (facilemente accessibile da <ulink url="http://groups.google.com/groups?group=comp.text.sgml">Google! Groups</ulink>)</para>
        </listitem>
        <listitem>
          <para>comp.text.xml (facilemente accessibile da <ulink url="http://groups.google.com/groups?group=comp.text.xml">Google! Groups</ulink>)</para>
        </listitem>
        <listitem>
          <para>htmldoc.general (il server è <ulink url="nttp://news.easysw.com">news.easysw.com</ulink>)</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Mailing List</title>
      <para>Di seguito alcune mailing list pertinenti.</para>
      <orderedlist>
        <listitem>
          <para>DocBook mailing list presso OASIS. Visitare il sito <ulink url="http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml"> http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml</ulink> per ulteriori informazioni.</para>
        </listitem>
        <listitem>
          <para>DocBook mailing list presso TLDP. Visitare il sito <ulink url="http://www.tldp.org/mailinfo.html">http://www.tldp.org/mailinfo.html</ulink> per ulteriori informazioni.</para>
        </listitem>
        <listitem>
          <para>xml-doc presso Yahoo Groups. Visitare il sito <ulink url="http://groups.yahoo.com/group/xml-doc/">http://groups.yahoo.com/group/xml-doc/</ulink> per ulteriori informazioni.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>IRC</title>
      <orderedlist>
        <listitem>
          <para>DocBook IRC Channel. #docbook su <ulink url="irc://irc.openprojects.net">irc://irc.openprojects.net</ulink></para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Siti web</title>
      <orderedlist>
        <listitem>
          <para><ulink url="http://www.oasis-open.org/">http://www.oasis-open.org/</ulink> OASIS gestisce diversi DTD per DocBook</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.xml-dev.com/blog/">http://www.xml-dev.com/blog/</ulink> XML / XHTML WebLog</para>
        </listitem>
        <listitem>
          <para><ulink url="http://docbook.org/wiki/moin.cgi/">http://docbook.org/wiki/moin.cgi/</ulink> The DocBook Wiki</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.docbook.org/tdg/en/">http://www.docbook.org/tdg/en/</ulink> Versione in linea di "DocBook: The Definitive Guide"</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.bureau-cornavin.com/opensource/crash-course/index.html">http://www.bureau-cornavin.com/opensource/crash-course/index.html</ulink> Writing Documentation Using DocBook: A Crash Course</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www-106.ibm.com/developerworks/library/l-docbk.html">http://www-106.ibm.com/developerworks/library/l-docbk.html</ulink> A gentle guide to DocBook (ottimo documento introduttivo).</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/index.html">http://www.tldp.org/LDP/LDP-Author-Guide/index.html</ulink> La guida per gli autori del Linux Documentation Project (TLDP).</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink> Risorse per DocBook fornite dal TLDP.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.tldp.org/HOWTO/DocBook-Demystification-HOWTO/">http://www.tldp.org/HOWTO/DocBook-Demystification-HOWTO/</ulink> Il "DocBook Demystification HOWTO" di Eric Raymond.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/">http://www.xml-dev.com:8080/cocoon/mount/docbook/</ulink> Sito di esempio per la configurazione di Tomcat + Cocoon + DocBook.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Applicazioni per la scrittura e la modellazione in XML</title>
      <note>
        <title>Nota</title>
        <para> <emphasis role="strong">Una completa lista di editor per XML può essere trovato sul sito <ulink url="http://www.xml-dev.com/blog/#19">http://www.xml-dev.com/blog/#19</ulink></emphasis>.</para>
      </note>
      <orderedlist>
        <listitem>
          <para>eXchaNGeR - Il browser (ed editor) XML <ulink url="http://xngr.org/">http://xngr.org/</ulink>.</para>
        </listitem>
        <listitem>
          <para>XERLIN - Applicazione per la modellazione XML <ulink url="http://www.xerlin.org/">http://www.xerlin.org/</ulink>.</para>
        </listitem>
        <listitem>
          <para>DocPro di Command Prompt, INC. <ulink url="http://www.commandprompt.com/entry.lxp?lxpe=2">http://www.commandprompt.com/entry.lxp?lxpe=2</ulink>.</para>
        </listitem>
        <listitem>
          <para>YAWC Pro di XML Workshop LTD. <ulink url="http://www.yawcpro.com/">http://www.yawcpro.com/</ulink>. Può essere utilizzato per convertire documenti dal formato MS Word nel formato Simple DocBook XML. </para>
        </listitem>
        <listitem>
          <para>Logictran - Convertitore RTF. <ulink url="http://www.logictran.com/">http://www.logictran.com/</ulink>. Da Word/RTF a HTML/XML.</para>
        </listitem>
        <listitem>
          <para>MajiX - Convertitore da Word a XML. <ulink url="http://tetrasys.dhs.org/">http://tetrasys.dhs.org/</ulink>.</para>
        </listitem>
        <listitem>
          <para>XMETAL di SoftQuad <ulink url="http://www.softquad.com/">http://www.softquad.com/</ulink>.</para>
        </listitem>
        <listitem>
          <para>Tagless Editor di i4i (non è supportato il DTD DocBook) <ulink url="http://www.i4i.com/">http://www.i4i.com/</ulink>.</para>
        </listitem>
        <listitem>
          <para>XML Editor di XMLmind <ulink url="http://www.xmlmind.com/xmleditor/">http://www.xmlmind.com/xmleditor/</ulink>.</para>
        </listitem>
        <listitem>
          <para>upCast e downCast di Inifinity Loop <ulink url="http://www.infinity-loop.de/en/products.html">http://www.infinity-loop.de/en/products.html</ulink>.</para>
        </listitem>
        <listitem>
          <para>W2XML di DocSoft <ulink url="http://www.docsoft.com/w2xmlv2.htm">http://www.docsoft.com/w2xmlv2.htm</ulink>.</para>
        </listitem>
        <listitem>
          <para>XMLWrite di Wattle Software <ulink url="http://xmlwriter.net/">http://xmlwriter.net/</ulink>.</para>
        </listitem>
        <listitem>
          <para>oXygen XML Editor - Basato su Java <ulink url="http://www.oxygenxml.com/">http://www.oxygenxml.com/</ulink>.</para>
        </listitem>
        <listitem>
          <para>Xeena di IBM <ulink url="http://www.alphaworks.ibm.com/tech/xeena">http://www.alphaworks.ibm.com/tech/xeena</ulink>.</para>
        </listitem>
        <listitem>
          <para>Excosoft Client XML<ulink url="http://www.excosoft.se/eweb/site/exc_pd.html">http://www.excosoft.se/eweb/site/exc_pd.html</ulink>.</para>
        </listitem>
        <listitem>
          <para>Timelux Xpress <ulink url="http://www.timelux.lu/html/Xpress2001.html">http://www.timelux.lu/html/Xpress2001.html</ulink>.</para>
        </listitem>
        <listitem>
          <para>Morphon <ulink url="http://www.morphon.com/">http://www.morphon.com/</ulink>.</para>
        </listitem>
        <listitem>
          <para>Conglomerate <ulink url="http://conglomerate.org/">http://conglomerate.org/</ulink>.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
</article>
