book-generator-orgmode/dashboard_instructions.md

65 lines
2.5 KiB
Markdown
Raw Normal View History

2025-08-30 18:20:50 +02:00
# Tableau de Bord du Livre
Ce document explique comment utiliser le tableau de bord pour visualiser les données de votre livre.
## Génération du Tableau de Bord
Pour générer le tableau de bord, exécutez le script `generate_dashboard.py` :
```bash
./generate_dashboard.py
```
Le script va créer un fichier HTML et les ressources associées dans le dossier `build/`.
## Visualisation du Tableau de Bord
Ouvrez le fichier `build/dashboard.html` dans votre navigateur web pour visualiser le tableau de bord.
## Fonctionnalités du Tableau de Bord
Le tableau de bord comprend plusieurs visualisations interactives :
### 1. Statistiques Générales
Affiche un résumé des statistiques clés de votre livre :
- Nombre total de mots
- Nombre de chapitres
- Nombre de personnages
- Nombre d'intrigues
### 2. Progression de l'Écriture
Un graphique interactif montrant l'évolution du nombre de mots et de chapitres au fil du temps.
### 3. Réseau des Personnages
Un graphique de réseau interactif montrant les relations entre les personnages de votre livre.
- Les personnages sont représentés par des nœuds
- Les liens entre les nœuds indiquent que les personnages apparaissent ensemble dans un ou plusieurs chapitres
- L'épaisseur des liens représente la fréquence des interactions
- **Interaction** : Vous pouvez cliquer et faire glisser les nœuds pour réorganiser le graphique
### 4. Chronologie des Intrigues
Un diagramme de Gantt montrant la chronologie des différentes intrigues de votre livre.
- L'axe horizontal représente la progression temporelle
- Chaque barre représente une intrigue
- **Interaction** : Passez la souris sur une intrigue pour voir plus de détails
## Mise à Jour des Données
Le tableau de bord utilise les fichiers de données suivants :
- `suivi_livre.csv` : Données de progression de l'écriture
- `occurrences_personnages.csv` : Données sur les apparitions des personnages
- `intrigues.csv` : Données sur les intrigues
Pour mettre à jour le tableau de bord avec les dernières données, il suffit de réexécuter le script `generate_dashboard.py`.
## Personnalisation
Si vous souhaitez personnaliser l'apparence ou le comportement du tableau de bord, vous pouvez modifier les fichiers suivants :
- `build/static/css/dashboard.css` : Style du tableau de bord
- `build/static/js/network-graph.js` : Comportement du graphique de réseau
- `build/static/js/progress-chart.js` : Comportement du graphique de progression
- `build/static/js/plot-timeline.js` : Comportement du diagramme des intrigues