# Générateur de livre au format orgmode ou makdown
Ce générateur permet de créer des dossiers dédiés à la rédaction de livres et vise une utilisation avec votre éditeur favori de simples fichiers textes au format orgmode ou markdown. Vos écrits, vos données dans un format simple et libre.
Il vous permet de structurer votre récit en plusieurs documents, et de récolter des informations sur votre rédaction avec quelques scripts python.
Les fichiers orgmode générés disposent d'un identifiant unique généré aléatoirement afin d'être utilisable avec org-roam et d'autres gestionnaires de wiki personnel.

## Prérequis:
- bash
- python
- pandoc
- matplotlib (pour les diagrammes de gantt)

sudo apt install python pandoc python-pip
pip install matplotlib

## Démarrer
Après avoir installé les dépendances, vous pouvez générer un dossier de nouveau livre. Attention, la génération d'un dossier supprime celui qui existait précédemment.
Celui ci contiendra différents fichiers orgmode ou markdown avec une copie des scripts présents ici afin de pouvoir rendre le travail sur le livre transportable.

`bash generate_book.sh le_nom_du_livre`

Et hop, vous obtenez un sous dossier `le_nom_du_livre` qui contient de quoi faire avancer votre histoire.
# À quoi servent les différents fichiers
## Livre
C'est ici que votre récit se déroule.
Afin d'avoir une structure qui aura visuellement du sens pour l'autrice du livre, seuls les titres ayant un tag :title: seront rendus lors de l'export. Cela permet de sectionner les étapes de l'histoire sans afficher ces titres de sections dans le livre final.
Votre livre peut contenir des médias, nous vous invitons à les placer dans le dossier "assets".
Le dossier "inspirations" est destiné à avoir des images, des médias, des documents divers, une bibliographie, c'est toujours utile de référencer ses inspirations pour clarifier ce que l'on aimerait raconter. 
## Personnages
## Intrigues
Les intrigues sont des arcs narratifs qui peuvent se superposer dans votre histoire.
Pour avoir cette vision des superpositions, le script `make_intrigues_to_csv.py` liste les entêtes et recherche si elles contiennent deux nombres séparés par un tiret.
Par exemple :
** l'intrigue bidule chose 4-9

Indique que l'on souhaite que cette intrigue débute dans la partie 4 et se termine dans la partie 9.
Sans information de numérotation, on part du principe qu'une intrigue dure 1 partie de l'histoire, dans l'ordre des intrigues.
Pour rester simples, ce générateur ne propose pas de drag and drop pour modifier ces informations. Les contributions au code pour simplifier cela sont bienvenues ;)

## Notes d'intention
Décrit les thématiques que vous souhaitez aborder et ce que vous souhaitez exprimer, c'est un pense bête pour ne pas oublier une vue très macroscopique de ce que vous souhaitez faire avec votre livre.

# Les scripts
Permettent de transformer votre livre en produit distribuable: ebook, html, pdf, mais aussi d'avoir une meilleure vue sur votre livre avec un tableau listant automatiquement les occurences de vos personnages trouvés dans chaque chapitre ainsi qu'un diagramme montrant les superpositions d'intrigues. Voir pour cela les descriptions dans `À quoi servent les différents fichiers`

### Conversion du livre
`python render_ebook.py`

### Statistiques
`bash up_infos.sh`

# Développement en cours
## Objectifs de rédaction en nombre de mots plus fins.
Par défaut, le script déterminant la tenue des objectifs de rédaction se base sur une valeur fixe pour tous les chapitres.
Vous pouvez modifier cet objectif dans `stats_chapitres.py` puis lancer la mise à jour des informations statistiques.
## Génération d'intrigues calibrées
Un script permettant de générer une suite d'intrigues découpées selon des objectifs de rédaction est prévu.
Il permettra de définir un nombre de chapitres, scènes et séquences avec une seule commande.

# Licence
AGPLv3+

# Contacts:
contact+book_generator@cipherbliss.com
@tykayn@mastodon.cipherbliss.com