hgbook

changeset 720:734111ce98ad

First literal translation of preface and a very tentative rough makefile.
author Giulio@puck
date Mon Jun 08 02:06:58 2009 +0200 (2009-06-08)
parents 5225ec140003
children 716f76ea4a34
files it/00book.xml it/Makefile it/book-shortcuts.xml it/ch00-preface.xml
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/it/00book.xml	Mon Jun 08 02:06:58 2009 +0200
     1.3 @@ -0,0 +1,112 @@
     1.4 +<?xml version="1.0" encoding="UTF-8"?>
     1.5 +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     1.6 + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
     1.7 +[
     1.8 +<!-- Below are references to files in this directory. -->
     1.9 +
    1.10 +<!-- Chapters. -->
    1.11 +
    1.12 +<!ENTITY ch00     SYSTEM "ch00-preface.xml">
    1.13 +<!--
    1.14 +<!ENTITY ch01     SYSTEM "ch01-intro.xml">
    1.15 +<!ENTITY ch02     SYSTEM "ch02-tour-basic.xml">
    1.16 +<!ENTITY ch03     SYSTEM "ch03-tour-merge.xml">
    1.17 +<!ENTITY ch04     SYSTEM "ch04-concepts.xml">
    1.18 +<!ENTITY ch05     SYSTEM "ch05-daily.xml">
    1.19 +<!ENTITY ch06     SYSTEM "ch06-collab.xml">
    1.20 +<!ENTITY ch07     SYSTEM "ch07-filenames.xml">
    1.21 +<!ENTITY ch08     SYSTEM "ch08-branch.xml">
    1.22 +<!ENTITY ch09     SYSTEM "ch09-undo.xml">
    1.23 +<!ENTITY ch10     SYSTEM "ch10-hook.xml">
    1.24 +<!ENTITY ch11     SYSTEM "ch11-template.xml">
    1.25 +<!ENTITY ch12     SYSTEM "ch12-mq.xml">
    1.26 +<!ENTITY ch13     SYSTEM "ch13-mq-collab.xml">
    1.27 +<!ENTITY ch14     SYSTEM "ch14-hgext.xml">
    1.28 +<!ENTITY appA     SYSTEM "appA-svn.xml">
    1.29 +<!ENTITY appB     SYSTEM "appB-mq-ref.xml">
    1.30 +<!ENTITY appC     SYSTEM "appC-srcinstall.xml">
    1.31 +<!ENTITY appD     SYSTEM "appD-license.xml">
    1.32 +-->
    1.33 +
    1.34 +<!-- Include our standard shortcuts. -->
    1.35 +
    1.36 +<!ENTITY % SHORTCUTS SYSTEM "book-shortcuts.xml">
    1.37 +%SHORTCUTS;
    1.38 +
    1.39 +<!-- Include automatically and manually generated code snippets. -->
    1.40 +<!--
    1.41 +<!ENTITY % AUTOSNIPPETS SYSTEM "examples/auto-snippets.xml">
    1.42 +%AUTOSNIPPETS;
    1.43 +-->
    1.44 +]>
    1.45 +
    1.46 +<book id="hg">
    1.47 +  <title>Mercurial: la guida definitiva</title>
    1.48 +  
    1.49 +  <!-- hg parents &#x2d;&#x2d;template '{node|short} ({date|shortdate})' 
    1.50 +  <subtitle>Compiled from 8a1d3f1aff17 (2009-03-10)</subtitle>
    1.51 +  -->
    1.52 +  <subtitle>Compiled from $rev_id$</subtitle>
    1.53 +  <bookinfo>
    1.54 +    <edition>1</edition>
    1.55 +    <isbn>9780596800673</isbn>
    1.56 +    <authorgroup>
    1.57 +      <author>
    1.58 +        <firstname>Bryan</firstname>
    1.59 +        <surname>O'Sullivan</surname>
    1.60 +      </author>
    1.61 +    </authorgroup>
    1.62 +
    1.63 +    <editor>
    1.64 +      <firstname>Mike</firstname>
    1.65 +      <surname>Loukides</surname>
    1.66 +    </editor>
    1.67 +
    1.68 +    <copyright>
    1.69 +      <year>2006</year>
    1.70 +      <year>2007</year>
    1.71 +      <year>2008</year>
    1.72 +      <year>2009</year>
    1.73 +      <holder>Bryan O'Sullivan</holder>
    1.74 +    </copyright>
    1.75 +  </bookinfo>
    1.76 +
    1.77 +  <!-- BEGIN ch00 -->
    1.78 +  &ch00;
    1.79 +  <!-- BEGIN ch01
    1.80 +  &ch01; -->
    1.81 +  <!-- BEGIN ch02
    1.82 +  &ch02; -->
    1.83 +  <!-- BEGIN ch03
    1.84 +  &ch03; -->
    1.85 +  <!-- BEGIN ch04
    1.86 +  &ch04; -->
    1.87 +  <!-- BEGIN ch05
    1.88 +  &ch05; -->
    1.89 +  <!-- BEGIN ch06
    1.90 +  &ch06; -->
    1.91 +  <!-- BEGIN ch07
    1.92 +  &ch07; -->
    1.93 +  <!-- BEGIN ch08
    1.94 +  &ch08; -->
    1.95 +  <!-- BEGIN ch09
    1.96 +  &ch09; -->
    1.97 +  <!-- BEGIN ch10
    1.98 +  &ch10; -->
    1.99 +  <!-- BEGIN ch11
   1.100 +  &ch11; -->
   1.101 +  <!-- BEGIN ch12
   1.102 +  &ch12; -->
   1.103 +  <!-- BEGIN ch13
   1.104 +  &ch13; -->
   1.105 +  <!-- BEGIN ch14
   1.106 +  &ch14; -->
   1.107 +  <!-- BEGIN appA
   1.108 +  &appA; -->
   1.109 +  <!-- BEGIN appB
   1.110 +  &appB; -->
   1.111 +  <!-- BEGIN appC
   1.112 +  &appC; -->
   1.113 +  <!-- BEGIN appD
   1.114 +  &appD; -->
   1.115 +</book>
     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/it/Makefile	Mon Jun 08 02:06:58 2009 +0200
     2.3 @@ -0,0 +1,28 @@
     2.4 +include Makefile.vars
     2.5 +
     2.6 +xml-src-files := \
     2.7 +	00book.xml \
     2.8 +	#app*.xml \
     2.9 +	ch*.xml
    2.10 +    
    2.11 +obj-web := html
    2.12 +
    2.13 +html: ${obj-web}/index.html
    2.14 +
    2.15 +#$(obj-web)/index.html: ../stylesheets/system-xsl .validated-00book.xml #../web/index-read.html.in
    2.16 +$(obj-web)/index.html: .validated-00book.xml
    2.17 +	xsltproc $(xsltproc-opts) -o $(obj-web)/x ../stylesheets/chunk-stylesheet.xsl 00book.xml
    2.18 +#	python ../web/texpand.py ../web/index-read.html.in html/read/index.html
    2.19 +#	for i in $(obj-web-read)/*.html; do \
    2.20 +#	  gzip -9 -c $$i > $$i.gz; \
    2.21 +#	done
    2.22 +
    2.23 +#../stylesheets/system-xsl: $(system-xsl-dir)
    2.24 +#	ln -s $< $@
    2.25 +
    2.26 +valid: .validated-00book.xml
    2.27 +
    2.28 +.validated-00book.xml: $(xml-src-files) #examples/.run
    2.29 +	xmllint $(xmllint-opts) $<
    2.30 +	touch $@
    2.31 +
     3.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.2 +++ b/it/book-shortcuts.xml	Mon Jun 08 02:06:58 2009 +0200
     3.3 @@ -0,0 +1,4 @@
     3.4 +<!-- Please keep the contents of this file sorted. -->
     3.5 +
     3.6 +<!ENTITY Egrave "&#200;">
     3.7 +<!ENTITY emdash "&#8212;">
     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/it/ch00-preface.xml	Mon Jun 08 02:06:58 2009 +0200
     4.3 @@ -0,0 +1,151 @@
     4.4 +<preface id="chap:preface">
     4.5 +  <?dbhtml filename="prefazione.html"?>
     4.6 +  <title>Prefazione</title>
     4.7 +
     4.8 +  <sect1>
     4.9 +    <title>Raccontare la tecnologia</title>
    4.10 +
    4.11 +    <para id="x_72e">Alcuni anni fa, quando volevo spiegare perché credevo che il controllo di revisione distribuito fosse importante, il campo era allora così nuovo che non esisteva quasi nessuna opera di letteratura pubblicata da dare come riferimento alle persone.</para>
    4.12 +
    4.13 +    <para id="x_72f">Sebbene a quel tempo spendessi un certo tempo lavorando agli interni di Mercurial stesso, mi volsi alla scrittura di questo libro perché sembrava il modo più efficace di aiutare il software a raggiungere un largo pubblico, insieme all'idea che il controllo di revisione dovesse essere distribuito per natura. Pubblico il libro online secondo i termini di una licenza liberale per la stessa ragione: per diffondere il messaggio.</para>
    4.14 +
    4.15 +    <para id="x_730">C'è un ritmo familiare in un buon libro di software che somiglia da vicino al racconto di una storia: che cos'è questa cosa? Perché ha importanza? Come mi aiuterà? Come la uso? In questo libro, provo a rispondere a queste domande per il controllo di revisione distribuito in generale e per Mercurial in particolare.</para>
    4.16 +  </sect1>
    4.17 +    
    4.18 +  <sect1>
    4.19 +    <title>Grazie per il vostro supporto a Mercurial</title>
    4.20 +
    4.21 +    <para id="x_731">Acquistando una copia di questo libro state supportando il continuo sviluppo e la libertà di Mercurial in particolare e del software free e open source in generale. O'Reilly Media e io stiamo donando le mie royalty sulle vendite di questo libro alla Software Freedom Conservancy (<ulink
    4.22 +	url="http://www.softwarefreedom.org/">http://www.softwarefreedom.org/</ulink>) che fornisce supporto in termini di personale e di assistenza legale a Mercurial e a un certo numero di altri progetti software open source importanti e meritevoli.</para>
    4.23 +  </sect1>
    4.24 +
    4.25 +  <sect1>
    4.26 +    <title>Ringraziamenti</title>
    4.27 +
    4.28 +    <para id="x_732">Questo libro non esisterebbe se non fosse per gli sforzi di Matt Mackall, l'autore e capo progetto di Mercurial. Centiania di collaboratori volontari lo assistono abilmente da tutto il mondo.</para>
    4.29 +
    4.30 +    <para id="x_733">I miei figli, Cian e Ruairi, si sono sempre fatti trovare pronti ad aiutarmi a rilassarmi con meravigliosi, avventati giochi da bambini. Vorrei anche ringraziare la mia ex moglie, Shannon, per il suo supporto.</para>
    4.31 +
    4.32 +    <para id="x_734">I miei colleghi e amici hanno fornito aiuto e supporto in innumerevoli modi. Questa lista di persone è necessariamente molto incompleta: Stephen Hahn, Karyn Ritter, Bonnie Corwin, James Vasile, Matt Norwood, Eben Moglen, Bradley Kuhn, Robert Walsh, Jeremy Fitzhardinge, Rachel Chalmers.</para>
    4.33 +
    4.34 +    <para id="x_735">Ho sviluppato questo libro pubblicamente, pubblicando sul sito web del libro le bozze dei capitoli mano a mano che li completavo. I lettori mi hanno poi sottoposto il loro giudizio usando una applicazione web che ho sviluppato. Al momento in cui ho finito il libro, più di 100 persone avevano spedito i loro commenti, un numero impressionante considerando che il sistema di commenti è stato attivo solo per circa due mesi verso la fine del processo di stesura.</para> 
    4.35 +
    4.36 +    <para id="x_736">Vorrei esprimere in particolare un riconoscimento alle seguenti persone, che tra loro hanno contribuito a più di un terzo del numero totale di commenti. Vorrei ringraziarli per la cura e lo sforzo che hanno impiegato nel fornire un giudizio così tanto dettagliato.</para> 
    4.37 +
    4.38 +    <para id="x_737">Martin Geisler, Damien Cassou, Alexey Bakhirkin, Till Plewe, Dan Himes, Paul Sargent, Gokberk Hamurcu, Matthijs van der Vleuten, Michael Chermside, John Mulligan, Jordi Fita, Jon Parise.</para>
    4.39 +
    4.40 +    <para id="x_738">Vorrei anche ringraziare le molte persone che mi hanno aiutato notando errori e fornendo utili suggerimenti attraverso tutto il libro.</para>
    4.41 +
    4.42 +    <para id="x_739">Jeremy W. Sherman, Brian Mearns, Vincent Furia, Iwan Luijks, Billy Edwards, Andreas Sliwka, Paweł Sołyga, Eric Hanchrow, Steve Nicolai, Michał Masłowski, Kevin Fitch, Johan Holmberg, Hal Wine, Volker Simonis, Thomas P Jakobsen, Ted Stresen-Reuter, Stephen Rasku, Raphael Das Gupta, Ned Batchelder, Lou Keeble, Li Linxiao, Kao Cardoso Félix, Joseph Wecker, Jon Prescot, Jon Maken, John Yeary, Jason Harris, Geoffrey Zheng, Fredrik Jonson, Ed Davies, David Zumbrunnen, David Mercer, David Cabana, Ben Karel, Alan Franzoni, Yousry Abdallah, Whitney Young, Vinay Sajip, Tom Towle, Tim Ottinger, Thomas Schraitle, Tero Saarni, Ted Mielczarek, Svetoslav Agafonkin, Shaun Rowland, Rocco Rutte, Polo-Francois Poli, Philip Jenvey, Petr Tesałék, Peter R. Annema, Paul Bonser, Olivier Scherler, Olivier Fournier, Nick Parker, Nick Fabry, Nicholas Guarracino, Mike Driscoll, Mike Coleman, Mietek Bák, Michael Maloney, László Nagy, Kent Johnson, Julio Nobrega, Jord Fita, Jonathan March, Jonas Nockert, Jim Tittsler, Jeduan Cornejo Legorreta, Jan Larres, James Murphy, Henri Wiechers, Hagen Möbius, Gábor Farkas, Fabien Engels, Evert Rol, Evan Willms, Eduardo Felipe Castegnaro, Dennis Decker Jensen, Deniz Dogan, David Smith, Daed Lee, Christine Slotty, Charles Merriam, Guillaume Catto, Brian Dorsey, Bob Nystrom, Benoit Boissinot, Avi Rosenschein, Andrew Watts, Andrew Donkin, Alexey Rodriguez, Ahmed Chaudhary.</para>
    4.43 +  </sect1>
    4.44 +
    4.45 +  <sect1>
    4.46 +    <title>Convenzioni usate in questo libro</title>
    4.47 +
    4.48 +    <para id="x_73a">In questo libro vengono usate le seguenti convenzioni tipografiche:</para>
    4.49 +
    4.50 +    <variablelist>
    4.51 +      <varlistentry>
    4.52 +        <term>Corsivo</term>
    4.53 +
    4.54 +        <listitem>
    4.55 +          <para id="x_73b">Indica nuovi termini, URL, indirizzi email, nomi di file ed estensioni di file.</para>
    4.56 +        </listitem>
    4.57 +      </varlistentry>
    4.58 +
    4.59 +      <varlistentry>
    4.60 +        <term><literal>Spaziatura fissa</literal></term>
    4.61 +
    4.62 +        <listitem>
    4.63 +          <para id="x_73c">Usato per i listati dei programmi, così come all'interno di paragrafi che fanno riferimento a elementi di programmazione come variabili o nomi di funzione, databse, tipi di dati, variabili d'ambiente, istruzioni e parole chiave.</para>
    4.64 +        </listitem>
    4.65 +      </varlistentry>
    4.66 +
    4.67 +      <varlistentry>
    4.68 +        <term><userinput>Spaziatura fissa in grassetto</userinput></term>
    4.69 +
    4.70 +        <listitem>
    4.71 +          <para id="x_73d">Mostra comandi o altro testo che dovrebbe essere digitato letteralmente dall'utente.</para>
    4.72 +        </listitem>
    4.73 +      </varlistentry>
    4.74 +
    4.75 +      <varlistentry>
    4.76 +        <term><replaceable>Spaziatura fissa in corsivo</replaceable></term>
    4.77 +
    4.78 +        <listitem>
    4.79 +          <para id="x_73e">Mostra testo che dovrebbe essere sostituito da valori forniti dall'utente oppure determinati dal contesto.</para>
    4.80 +        </listitem>
    4.81 +      </varlistentry>
    4.82 +    </variablelist>
    4.83 +
    4.84 +    <tip>
    4.85 +      <para id="x_73f">Questa icona indica un consiglio, suggerimento, o nota generale.</para>
    4.86 +    </tip>
    4.87 +
    4.88 +    <caution>
    4.89 +      <para id="x_740">Questa icona indica un avviso o avvertimento.</para>
    4.90 +    </caution>
    4.91 +  </sect1>
    4.92 +
    4.93 +  <sect1>
    4.94 +    <title>Usare gli esempi di codice</title>
    4.95 +
    4.96 +    <para id="x_741">Questo libro è qui per aiutarvi a fare il vostro lavoro. In generale, potete usare il codice in questo libro nei vostri programmi e nella vostra documentazione. Non è necessario che ci contattiate per chiedere il permesso, a meno che non stiate riproducendo una porzione significativa del codice. Per esempio, scrivere un programma che usa diversi frammenti di codice da questo libro non richiede un permesso. Vendere o distribuire un CD-ROM di esempi dai libri pubblicati da O'Reilly richiede un permesso. Rispondere a una domanda citando questo libro e riproducendo codice di esemio non richiede un permesso. Incorporare una quantità significativa di codice da questo libro nella documentazione di un vostro prodotto richiede un permesso.</para>
    4.97 +
    4.98 +    <para id="x_742">Apprezziamo, ma non richiediamo, l'attribuzione. Un'attribuzione di solito include il titolo, l'autore, l'editore e il codice ISBN. Per esempio: “<emphasis>Titolo del libro</emphasis> scritto da Qualche Autore. Copyright 2008 O’Reilly Media, Inc., 978-0-596-xxxx-x.”</para>
    4.99 +
   4.100 +    <para id="x_743">Se credete che il vostro utilizzo del codice di esempio ricada fuori dai confini dell'uso corretto o dei permessi dati sopra, sentitevi liberi di contattarci all'indirizzo email <email>permissions@oreilly.com</email>.</para>
   4.101 +  </sect1>
   4.102 +
   4.103 +  <sect1>
   4.104 +    <title>Safari® Books Online</title>
   4.105 +
   4.106 +    <note role="safarienabled">
   4.107 +      <para id="x_744">Quando vedete un'icona Safari® Books Online sulla copertina del vostro libro di tecnologia preferito, questo significa che quel libro è disponibile attraverso la libreria Safari di O'Reilly Network.</para>
   4.108 +    </note>
   4.109 +
   4.110 +    <para id="x_745">Safari offre una soluzione che è meglio degli e-book. &Egrave; una libreria virtuale che vi permette di effettuare facilmente ricerche su migliaia di libri di tecnologia, copiare e incollare gli esempi di codice, scaricare capitoli e trovare risposte veloci quando avete bisogno delle informazioni più accurate e recenti. Provatelo gratis all'indirizzo <ulink role="orm:hideurl:ital"
   4.111 +	url="http://my.safaribooksonline.com/?portal=oreilly">http://my.safaribooksonline.com</ulink>.</para>
   4.112 +  </sect1>
   4.113 +
   4.114 +  <sect1>
   4.115 +    <title>Come contattarci</title>
   4.116 +
   4.117 +    <para id="x_746">Per favore spedite commenti e domande riguardanti questo libro all'editore:</para>
   4.118 +
   4.119 +    <simplelist type="vert">
   4.120 +      <member>O’Reilly Media, Inc.</member>
   4.121 +
   4.122 +      <member>1005 Gravenstein Highway North</member>
   4.123 +
   4.124 +      <member>Sebastopol, CA 95472</member>
   4.125 +
   4.126 +      <member>800-998-9938 (negli Stati Uniti o in Canada)</member>
   4.127 +
   4.128 +      <member>707-829-0515 (internazionale o locale)</member>
   4.129 +
   4.130 +      <member>707 829-0104 (fax)</member>
   4.131 +    </simplelist>
   4.132 +
   4.133 +    <para id="x_747">Abbiamo una pagina web per questo libro, dove elenchiamo errata, esempi e ogni informazione aggiuntiva. Potete accedere questa pagina all'indirizzo:</para>
   4.134 +
   4.135 +    <simplelist type="vert">
   4.136 +      <member><ulink url="http://www.oreilly.com/catalog/&lt;catalog
   4.137 +	  page&gt;"></ulink></member>
   4.138 +    </simplelist>
   4.139 +
   4.140 +    <remark>Non dimenticarti di aggiornare anche l'attributo &lt;url&gt;.</remark>
   4.141 +
   4.142 +    <para id="x_748">Per commentare o chiedere domande tecniche su questo libro, spedite una email a:</para>
   4.143 +
   4.144 +    <simplelist type="vert">
   4.145 +      <member><email>bookquestions@oreilly.com</email></member>
   4.146 +    </simplelist>
   4.147 +
   4.148 +    <para id="x_749">Per maggiori informazioni sui nostri libri, sulle conferenze, sui Centri di Risorse, e su O'Reilly Network, visitate il nostro sito web all'indirizzo:</para>
   4.149 +
   4.150 +    <simplelist type="vert">
   4.151 +      <member><ulink url="http://www.oreilly.com"></ulink></member>
   4.152 +    </simplelist>
   4.153 +  </sect1>
   4.154 +</preface>