[svnbook commit] r2259 - trunk/src/it
zup
noreply at red-bean.com
Wed Jun 28 11:47:24 CDT 2006
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
--------------------------------------------------------------------------------
More information about the svnbook-dev
mailing list