Nouvelle page
Guide de saisie des fiches RG3E dans BookStack
À destination des rédacteurs — version courte, sans HTML
Pourquoi ces consignes ?
BookStack est l'outil d'édition des fiches RG3E. Le contenu que vous saisissez sera :
- exporté en PDF pour diffusion
- lu par des outils automatiques (dont l'IA) pour synthèses, recherches, rapports
Pour que ces exports fonctionnent bien, le contenu doit être structuré, pas seulement mis en forme.
1. Ne pas coller depuis Word directement
Problème : coller depuis Word importe du formatage invisible qui pollue les exports.
Solution : utilisez le bouton "Coller sans mise en forme" dans la barre d'outils BookStack (icône presse-papier avec un T), ou le raccourci Ctrl+Shift+V.
Vous pouvez ensuite remettre en forme dans BookStack avec les outils de la barre.
2. Utiliser les niveaux de titres (pas le gras)
C'est la règle la plus importante.
| ✅ À faire | ❌ À éviter |
|---|---|
| Sélectionner le titre → choisir Titre 2 / Titre 3 / Titre 4 dans le menu déroulant | Écrire du texte et le mettre en gras pour imiter un titre |
| Garder une hiérarchie logique (H2 → H3 → H4) | Sauter des niveaux ou mélanger les niveaux |
Structure attendue pour une fiche :
H2 — Titre de la fiche (ex: "Fiche informative – Modes d'alimentation")
H3 — 1. Introduction
H3 — 2. Première partie
H4 — 2.1 Sous-section
H3 — 3. Deuxième partie
3. Utiliser les listes (pas les tirets à la main)
| ✅ À faire | ❌ À éviter |
|---|---|
| Bouton liste à puces ou liste numérotée de la barre d'outils | Taper – ou • ou 1. à la main |
4. Séparer contenu final et notes de travail
Les commentaires, questions en attente et brouillons intermédiaires ne doivent pas rester dans la page finale.
Deux options :
- Utilisez les Commentaires BookStack (icône bulle en haut à droite) pour les remarques adressées aux relecteurs
- Créez une page séparée
[BROUILLON] Titre de fichedans le même chapitre
Ne laissez pas de sections nommées ZOLD, >>> Atelier, QUESTIONS / REMARQUES dans le contenu publié.
5. Remplir les Tags de la page
C'est la seule action "technique" demandée — elle prend 30 secondes.
En bas de l'éditeur, dans la zone "Tags", ajoutez :
| Tag | Valeur | Exemple |
|---|---|---|
type |
informative ou operationnelle |
type = informative |
phase |
numéro de phase concernée | phase = 4 |
bloc |
code du bloc fonctionnel | bloc = alimentation |
statut |
brouillon, revue, validé |
statut = brouillon |
redacteur |
nom de votre société | redacteur = CATIE |
6. Pour les tableaux
Les tableaux sont bienvenus pour présenter des comparaisons ou des données structurées.
- Utilisez l'outil tableau de la barre (icône grille)
- Évitez les tableaux collés depuis Excel ou Word (même problème que §1)
- Évitez les fusions de cellules complexes — préférez plusieurs tableaux simples
Récapitulatif rapide
| Action | Consigne |
|---|---|
| Coller du texte | Ctrl+Shift+V (sans mise en forme) |
| Titres | Menu déroulant → Titre 2 / 3 / 4 |
| Listes | Boutons liste de la barre d'outils |
| Notes / brouillons | Page séparée ou Commentaires BookStack |
| Tags | À remplir avant de passer en statut revue |
| Couleurs / polices custom | À éviter — le thème s'en charge |
En cas de doute sur la structure d'une fiche, référez-vous aux fiches spécimen dans les livres "Spécimen fiche informative" et "Spécimen fiche opérationnelle".