Benvenuto alla seconda edizione del manuale Pro Git.
La versione online di questo libro la trovi all’indirizzo http://git-scm.com/book
Come per la prima edizione, anche la seconda edizione di Pro Git è rilasciata open source con licenza Creative Commons.
Un paio di cose sono cambiate da quando la prima edizione fu resa open source. La prima è stato passare da Markdown al meraviglioso Asciidoc, come formato del testo del libro. Siamo anche passati ad usare la piattaforma Atlas della O’Reilly’s per la generazione continua del libro. In questo modo i formati di libro più diffusi sono disponibili in tutte le lingue.
Abbiamo anche deciso di mantenere le varie traduzioni in repository separati, piuttosto che in sottocartelle della versione inglese. Guarda la sezione Traduzioni per maggiori informazioni.
Per segnalare e correggere errori o nuovi contenuti alla versione originale (in inglese) è necessario aprire una richiesta di "Pull" su GitHub. È comunque una buona prassi, prima di iniziare a fare qualcosa, aprire una nuova issue per accettarti che il tuo lavoro verrà accettato.
Correzioni e chiarimenti verranno accettati se i manutentori riconosceranno che migliorano il contenuto. Puoi aprire una issue così che possano capire il problema e se sia necessario risolverlo.
Per maggiori informazioni fai riferimento al repository in inglese
Ci sono due modi per generare e-book da questo codice.
Quello più semplice è lasciarlo fare a noi. Un robot verifica tutte le nuove modifiche e automaticamente produce un libro disponibile per tutti.
Puoi trovare la traduzione in italiano su http://daftano.github.io/progit-it. Ci stiamo ancora lavorando, quindi non troverai subito tutto il testo in italiano, ma poco a poco lo completeremo.
Quella originale, in inglese è invece su http://git-scm.com/book e maggiori informazioni sulle traduzioni disponibili le trovi su https://progit.org.
L’altro modo per generare un e-book è di farlo manualmente con Asciidoctor. Se esegui i comandi seguenti dovresti ottenere file HTML, Epub, Mobi e PDF:
$ bundle install $ bundle exec rake book:build Converting to HTML... -- HTML output at progit.html Converting to EPub... -- Epub output at progit.epub Converting to Mobi (kf8)... -- Mobi output at progit.mobi Converting to PDF... -- PDF output at progit.pdf
Questi comandi usano i progetti asciidoctor, asciidoctor-pdf e asciidoctor-epub.
Se vuoi contribuire alla traduzione italiana qui di seguito trovi i passi da seguire:
Segui il gruppo dei traduttori italiani di Pro Git, facci sapere che vuoi contribuire alla traduzione italiana e, possibilmente, presentati.
-
Clona il repository italiano e fai le tue modifiche.
-
Scrivi sul gruppo chiedendo come puoi contribuire o proponendo di prendere in carico qualcosa. Questo per evitare che più persone lavorino alla stessa cosa, e ritrovarci quindi con lavori duplicati.
-
Se possibile, crea branch tematici. Se fai una singola modifica potrebbe non essere necessario.
-
Quando le tue modifiche sono pronte per essere condivise, apri una Pull Request, per integrare il tuo lavoro con quello generale.
-
Usa un italiano corretto, semplice e corrente.
-
Se hai dubbi su una traduzione, scrivi nel gruppo per chiedere chiarimenti o fai riferimento a una di queste risorse: