[svnbook commit] r2259 - trunk/src/it

[zup]

Author: zup
Date: Wed Jun 28 11:47:23 2006
New Revision: 2259

Modified:
   trunk/src/it/How-to-translate.txt

Log:
- Updated ch02 status 
- Added very first instruction about XML to HTML transform

Modified: trunk/src/it/How-to-translate.txt
==============================================================================
--- trunk/src/it/How-to-translate.txt	(original)
+++ trunk/src/it/How-to-translate.txt	Wed Jun 28 11:47:23 2006
@@ -1,4 +1,4 @@
--*- coding: utf-8; -*-
+-*- coding: utf-8; -*-
 $Id$
 --------------------------------------------------------------------------------
 Manutentore di questo file: nebiac alias federico.nebiacolombo at softeco.it
@@ -30,7 +30,7 @@
              [??????]                        [??-??-2006] [NA]  da  <sect2 id="svn.basic.in-action.track-repos"> fino a fine capitolo
 Ch03 - 36pg  [Miky]+[nebiac] per verifica    [23-06-2006] [TIP] ad inizio fino a <sect2 id="svn.tour.revs.dates"> esclusa
              [basetta]+[ender] x verifica    [??-??-2006] [VIP] fino a   <sect1 id="svn.tour.cycle"> esclusa
-             [?????]                         [??-??-2006] [NA]  da <sect1 id="svn.tour.cycle"> fino alla fine del capitolo
+             [zup]                           [03-07-2006] [TIP] da <sect1 id="svn.tour.cycle"> fino alla fine del capitolo
 Ch04 - 34pg  [NA]
 Ch05 - 46pg  [NA]
 Ch06 - 50pg  [NA]
@@ -223,7 +223,56 @@
 
 Dai SRC XML ad HTML
 --------------------------------------------------------------------------------
-...da completare (benvenuti i contributi di qualche anima volenterosa:-)
+
+Premessa:
+-------------
+Il libro di Subverion è scritto usando DocBook Lite, una versione semplificata di DocBook.
+DocBook è una collezione di DTD e schemi XML che definiscono la struttura di un documento (una specie di HTML, più ricco e più adatto alla definizione di libri).
+I file XML che compongono questo libro su Subversion rispettano i DTD definiti da DocBook Lite; nel nostro caso si torvano in src/tools/dtd/ e vengono usati per la validazione quando eseguiamo il comando make valid.
+
+Recuperare i file XSLT:
+-----------------------
+Un grande vantaggio che deriva dall'adozione di DocBook è la grande disponibilità di fogli di stile XSL in grado di trasformare i file XML in diversi formati e con diversi layout. 
+Quindi per generare le pagine HTML o i file .fo e quindi i documenti PDF partendo dai file XML del libro è necessario avere i fogli di stile per DocBook.
+
+"DocBook Open Repository" su Sourceforge rende disponibile una grande collezione di XSL specifici per DocBook.
+Scaricare l'ultimo pacchetto 'docbook-xsl' dall'indirizzo 
+
+	http://sourceforge.net/project/showfiles.php?group_id=21935
+
+una volta scaricato, scompattare l'archvio e rinominarlo in src/tools/xsl 
+I passi dovrebbe essere qualcosa come:
+      $ cd src/tools
+      $ tar zxvf docbook-xsl-X.YY.Z.tar.gz
+      $ mv docbook-xsl-X.YY.Z xsl
+
+Il processo di build si aspetta di trovare i fogli di stile in src/tools/xsl/
+
+
+Utilizzo di XSLT per trasformare il libro
+------------------------------------------
+XSLT applica un foglio di stile .xsl a un file .xml e produce un nuovo documento a markup.
+Recuperare libxslt, una libreria C per XSLT, 
+ 
+ Per Linux
+ -------------
+ Scaricare da http://xmlsoft.org/XSLT/
+
+ Per Windows
+ -------------
+ Usando cygwin, si può scaricare il pacchetto utilizzando il programma di setup. 
+ Devel->libxslt
+
+
+Generazione delle pagine HTML
+------------------------------
+ Dalla directory src/it lanciare il comando
+
+        $ make all-html
+
+Ciò produrrà una versione del libro su una singola pagina HTML in book/svn-book.html e una versione multipagina in book/html-chunk/.
+Nota che è un processo piuttosto pesante e può impiegare parecchi minuti.
+         
 
 Dai SRC XML ad PDF
 --------------------------------------------------------------------------------