Git n'est pas que pour le code

Git suit n'importe quel fichier texte : Markdown, AsciiDoc, LaTeX, prose simple. Écrivains, équipes de documentation et universitaires utilisent Git pour les mêmes raisons que les développeurs.

Glossaire de traduction

• Repository = un dossier sous contrôle de version.
• Commit = un instantané sauvegardé.
• Branch = un brouillon parallèle.
• Merge = combiner une branche au brouillon principal.
• Pull request = "veuillez relire et accepter ces changements".

Un workflow simple

git init my-book
cd my-book
echo "# Chapitre 1" > chapter-1.md
git add chapter-1.md
git commit -m "Ajouter le plan du chapitre 1"
git commit -am "Étendre l'introduction du chapitre 1"

Utiliser une GUI

• GitHub Desktop - le plus simple, gratuit.
• Sublime Merge - poli, rapide.
• Tower - payant, très accessible.
• VS Code - le panneau Source Control gère 90 % des cas.

Les formats texte plain gagnent

pandoc -o book.pdf chapter-*.md

Une phrase par ligne

Terminez chaque phrase par une nouvelle ligne. Cela produit des diffs minimaux.

Branches pour brouillons

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

Choses à ignorer

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