Guide auteur

Créez votre livre-jeu en utilisant git. Votre histoire est un repo.

1. Préparez le README

Le README.md contient les métadonnées de votre livre. C'est la première chose que l'app lit pour construire la fiche.

README.md

# Mon Livre Aventure

Un développeur découvre un message caché dans un vieux repo abandonné. Le commit date de 2035.

**Auteur** : Votre Nom
**Langue** : fr
**Classification** : 12+
**Tags** : aventure, sci-fi, mystère

Le titre est extrait du premier #, le synopsis du premier paragraphe. Les champs **Auteur**, **Langue**, **Classification** et **Tags** sont lus automatiquement par l'admin.

2. Ajoutez une couverture

Placez un fichier cover.jpg ou cover.png à la racine du repo. Format portrait recommandé. Si absent, le logo Git Hero sera affiché en placeholder.

$ git add README.md cover.jpg
$ git commit -m "init: book metadata"

3. Écrivez l'histoire en commits

Chaque commit est un fragment narratif. Utilisez --allow-empty — aucun fichier, seul le message compte.

bash

# Le texte peut faire 1 à 2 paragraphes
$ git commit --allow-empty -m "Le terminal s'allume dans le noir.

Il est 2h47 du matin. Tu es resté pour finir un merge qui refusait de passer."

$ git commit --allow-empty -m "Un commit apparaît dans le log. Tu n'as rien poussé.

Le SHA commence par sept zéros. Statistiquement impossible."

4. Créez les embranchements

Les branches git sont les chemins narratifs. Le nom de la branche est affiché au lecteur — choisissez-le avec soin.

# Créez un choix depuis un point de l'histoire
$ git checkout -b feature/investigate
$ git commit --allow-empty -m "Tu ouvres Google Maps..."

# Revenez au point de choix pour une autre branche
$ git checkout main
$ git checkout -b hotfix/delete-evidence
$ git commit --allow-empty -m "Tu supprimes le repo local..."

feature/*

Exploration, enquête, chemin secondaire

hotfix/*

Urgence, danger, action rapide

fix/*

Réparation, retour en arrière, correction

main

Le chemin principal de l'histoire

5. Règles importantes

→ Toute branche sans commit suivant est détectée comme une fin.
→ Ne jamais réécrire l'historique après publication (rebase, push --force). Les SHA sont la clé de progression.
→ Un livre peut être prolongé après publication : nouveaux commits, nouvelles branches. L'histoire se prolonge, elle ne s'efface pas.
→ Le premier commit doit être init: book metadata avec le README et la cover.