Git non e solo per il codice

Git traccia qualsiasi file di testo: Markdown, AsciiDoc, LaTeX, prosa semplice.

Glossario di traduzione

• Repository = una cartella sotto controllo di versione.
• Commit = uno snapshot salvato delle modifiche.
• Branch = una bozza parallela.
• Merge = combinare un branch nella bozza principale.
• Pull request = "per favore revisiona e accetta queste modifiche".

Un workflow semplice

git init my-book
cd my-book
echo "# Chapter 1" > chapter-1.md
git add chapter-1.md
git commit -m "Add chapter 1 outline"

git commit -am "Expand chapter 1 introduction"

Usare una GUI

• GitHub Desktop.
• Sublime Merge.
• Tower.
• VS Code.

I formati testo vincono

pandoc -o book.pdf chapter-*.md

Una frase per riga

Una convenzione comune nella scrittura tecnica: terminare ogni frase con un newline.

Branch per le bozze

git checkout -b draft-second-edition
git checkout main
git merge draft-second-edition

Collaborare con editor

Un editor puo fare fork del manoscritto, modificare su un branch e aprire una pull request.

Backup gratuiti

Pushare a un repo privato GitHub o GitLab e si ha un backup off-site.

Cose da ignorare

# .gitignore
*.pdf
*.docx
.DS_Store
.vscode/
_build/