/progit2-it

Primary LanguageCSSOtherNOASSERTION

Pro Git, Seconda Edizione, Italiano

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.

Contribuire

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

Come generare il libro

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.

Versione italiana

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.

Flusso di lavoro

  1. Clona il repository italiano e fai le tue modifiche.

  2. 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.

  3. Se possibile, crea branch tematici. Se fai una singola modifica potrebbe non essere necessario.

  4. Quando le tue modifiche sono pronte per essere condivise, apri una Pull Request, per integrare il tuo lavoro con quello generale.

Qualche consiglio