[svnbook commit] r2890 - trunk/src/it

ilmatte noreply at red-bean.com
Wed Nov 28 07:26:05 CST 2007


Author: ilmatte
Date: Wed Nov 28 07:26:05 2007
New Revision: 2890

Log:
Added Matteo Tontini to 'SVN ITALIAN TEAM'
modified section 'VALIDAZIONE DEI SRC XML' -> 'Su Windows': added one more needed package
modified section 'Utilizzo di XSLT per trasformare il libro': fixed package name for libxslt
written section 'DAI SRC XML A PDF': written step by step instructions for Windows

Modified:
   trunk/src/it/Howto-translate.txt

Modified: trunk/src/it/Howto-translate.txt
==============================================================================
--- trunk/src/it/Howto-translate.txt	(original)
+++ trunk/src/it/Howto-translate.txt	Wed Nov 28 07:26:05 2007
@@ -100,7 +100,7 @@
 
 http://svn.red-bean.com/svnbook/trunk/src/it
 
-La stessa repository può essere comodamente esplorata/monitorate tramite il
+La stessa repository può essere comodamente esplorata/monitorata tramite il
 link:
 
 http://viewvc.red-bean.com/svnbook/trunk/src/it/
@@ -114,7 +114,7 @@
 --------------------------------------------------------------------------------
 In questa sezione saranno descritti i TOOL consigliati e le procedure da
 utilizzare per effettuare /validare la traduzione a seconda delle piattaforme
-che verranno Utilizzate.
+che verranno utilizzate.
 
 Client SVN
 ----------
@@ -175,7 +175,7 @@
 
 c:\user\prj\svn-book\DEV\src
 
-ed utilizzare il client command line 'svn'.
+e di utilizzare il client command line 'svn'.
 Nel caso di un client diverso (jsvn, tortoise svn) la procedura va adattata.
 
 I comandi da eseguire sono:
@@ -199,7 +199,7 @@
 
 - Prima di effettuare un commit, validarli (vedi sezione seguente)
 - Commit dei files
-Per verificare quali files necessitano commit è sufficente usare  il comando
+Per verificare quali files necessitano commit è sufficiente usare  il comando
 svn status
 
 Effettuare il commit dei src modificati tramite il comando:
@@ -246,6 +246,7 @@
     - make
     - libxml2
     - subversion
+	- diffutils
 
 Cosa fare:
 Effettuare il checkout di
@@ -260,12 +261,13 @@
 (*1) Per chi non fosse pratico di Cygwin: è una sorta di porting sotto Windows
 di un ambiente Unix/Linux. Si basa su un meccanismo di installazione molto
 particolare: collegandosi al sito cygwin è possibile selezionare i componenti
-che servono da una lista molto ampia. Nel nostro caso il set minimo per la sola
+che servono da una lista molto ampia. Nel nostro caso, il set minimo per la sola
 validazione, i componenti da selezionare sono:
 Devel->make
 Devel->libxml2
 Devel->Subversion (il primo della lista, basta solo il client command line)
 Shells->bash (in realtà è presente di default, non va selezionato)
+Utils->diffutils
 
 Nel caso non abbiate una connessione abbastanza veloce, oppue abbiate fretta,
 non esitate a scrivere presso la mail list svn-it chiedendo se qualche anima di
@@ -282,6 +284,19 @@
 l'utente Administrator.
 Se si usa un altro utente, ovviamente si deve cambiare la dir.
 
+In alternativa si può configurare Cygwin in modo da aprire la shell di comandi
+direttamente nella directory:
+
+c:\user\prj\svn-book\DEV\src\it
+
+invece che nella home dell'utente loggato.
+Per ottenere questo risultato basta aprire il file:
+
+C:\cygwin\home\Administrator\.bash_profile
+
+con un editor di testo ed aggiungere, in fondo, la riga:
+
+cd  c:\user\prj\svn-book\DEV\src\it (con il percorso eventualmente racchiuso tra virgolette)
 
 DAI SRC XML AD HTML
 --------------------------------------------------------------------------------
@@ -312,7 +327,7 @@
     http://sourceforge.net/project/showfiles.php?group_id=21935
 
 una volta scaricato, scompattare l'archivio e rinominarlo in src/tools/xsl
-I passi dovrebbe essere qualcosa come:
+I passi dovrebbero essere qualcosa come:
 
     $ cd src/tools
     $ tar zxvf docbook-xsl-X.YY.Z.tar.gz
@@ -333,7 +348,7 @@
     Per Windows
     -----------
     Usando cygwin, si può scaricare il pacchetto utilizzando il programma di
-    setup. Devel->libxslt
+    setup. Doc->libxslt
 
 
 Generazione delle pagine HTML
@@ -350,9 +365,109 @@
 
 DAI SRC XML A PDF
 --------------------------------------------------------------------------------
-...da completare (benvenuti i contributi di qualche anima volenterosa:-)
-
-
+Per Windows (mediante Cygwin)
+-----------------------------
+1)	Prima di tutto occorre assicurarsi che lo script:
+ 
+	c:\user\prj\svn-book\DEV\src\it\tools\bin\run-fop.sh
+	
+	sia salvato in un formato riconoscibile dalla shell bash di Cygwin.
+	Quindi, se avete effettuato il checkout della cartella 'tools' mediante un client svn per Windows 
+	(es.: TortoiseSVN), è necessario modificare lo script in modo che il carattere 'carriage return'
+	utilizzato sia unix-like.
+	In caso contrario si otterrebbero errori del tipo: "/r command not found" quando si tentasse di generare
+	il file pdf.
+	a) 	Dato che si sta per modificare un file sotto versionamento è consigliabile effettuare un export della
+		cartella 'tools' e sostituirla a quella versionata nella posizione:
+		
+		c:/user/prj/svn-book/DEV/src/it/tools
+		
+		In tal modo si evita di committare per sbaglio modifiche alla cartella tools.
+	b)	A questo punto basta utilizzare la utility dos2unix già presente nell'installazione di Cygwin fatta al punto
+		precedente (v. VALIDAZIONE DEI SRC XML).
+		Il comando da lanciare è: 
+	
+		$ cd src/tools/bin
+		$ dos2unix -U run-fop.sh
+		
+2)	All'indirizzo: http://xmlgraphics.apache.org/fop/ potete trovare Apache FOP (Formatting Objects Processor),
+	il software necessario per produrre il file pdf a partire dai source xml.
+	La procedura seguente spiegherà come fare funzionare la versione 0.20.5, 
+	che è la stessa utilizzata per le nightly builds, e non la più aggiornata (ad oggi la 0.94).
+	Scaricare la versione per windows all'indirizzo:
+
+    http://archive.apache.org/dist/xmlgraphics/fop/binaries/fop-0.20.5-bin.zip
+
+	una volta scaricato, scompattare l'archivio e rinominarlo in src/tools/fop
+	Il processo di build si aspetta di trovarlo in quella posizione.
+	
+	Per permettere alla shell di eseguire lo script src/tools/fop/fop.sh occorre aggiungere alla variabile
+	d'ambiente di windows: PATH il percorso:
+	
+	c:/user/prj/svn-book/DEV/src/it/tools/fop
+
+3)	Per il funzionamento della versione 0.20.5 di fop è necessario installare una versione un po' vecchia del
+	java runtime environment, contenuta nel pacchetto: j2sdk-1.4.2, reperibile all'indirizzo:
+	
+	http://java.sun.com/j2se/1.4.2/download.html
+	
+	alla voce "J2SE v 1.4.2_16  SDK".
+	
+	Una volta installata è necessario creare altre due variabili d'ambiente di windows:
+	
+	JAVA_HOME: contenente il path alla directory di installazione 'C:\j2sdk1.4.2_16'
+	LOCALCLASSPATH: contenente il path 'C:\j2sdk1.4.2_16\bin'
+
+4)	Bisogna quindi procurarsi la class library: jimi.
+	Effettuare il download dello zip all'indirizzo: 
+	
+	http://java.sun.com/products/jimi/
+	
+	Scompattarlo e copiare l'archivio: Jimi\examples\AppletDemo\JimiProClasses.jar
+	in c:/user/prj/svn-book/DEV/src/it/tools/fop/lib/JimiProClasses.jar
+
+	Aggiungere alla variabile d'ambiente: LOCALCLASSPATH, il percorso:
+	
+	c:/user/prj/svn-book/DEV/src/it/tools/fop/lib/JimiProClasses.jar
+	
+5)	Durante il processo di build viene generato un file intermedio: svn-book.fo in src/it/book.
+	Quando FOP si trova a processare file '.fo' troppo grandi si possono avere errori di memoria insufficiente,
+	con messaggi del tipo:
+	
+	Exception in thread "main" java.lang.OutOfMemoryError
+	
+	Per ovviare a questo problema posizionarsi nella root dell'utente Cygwin:
+	
+	$ cd ~
+	
+	e creare il file .foprc che verrà processato da FOP:
+	
+	$ cat > ~/.foprc << "EOF"
+	> FOP_OPTS="-Xmx500m"
+	> EOF
+	
+	dove il valore assegnato alla variabile FOP_OPTS prevede al posto di 500 la quantità di ram (in Megabyte)
+	disponibile	sul vostro pc, secondo la sintassi: "-Xmx[RAM_Installed]m".
+	
+6)	Infine posizionarsi nella directory src/it e lanciare il comando:
+	
+	$ make pdf
+	
+	La console produrrà innumerevoli righe di output, tra cui numerosi errori del tipo:
+	
+	[ERROR] property - "background-position-horizontal" is not implemented yet.
+	(dovuti all'utilizzo della versione 0.20.5)
+	
+	e warning del tipo:
+	[INFO] area contents overflows area in line
+	
+	Nonostante ciò verrà prodotto il file src/it/svn-book.pdf.
+	
+	NOTA:
+	L'elenco degli errori e dei warning visualizzati a console durante la generazione è praticamente identico
+	a quello riportato nei log relativi alle nigthly build (v. NIGHTLY BUILDS)
+	
+	
 DAI SRC XML A CHM
 --------------------------------------------------------------------------------
 ...da completare (benvenuti i contributi di qualche anima volenterosa:-)




More information about the svnbook-dev mailing list