Skip to main content

Guide de saisie des fiches RG3E dans BookStack

Guide de saisie des fiches RG3E dans BookStack

À destination des rédacteurs — versioncomment courte,écrire sansdans HTMLBookStack pour que les exports fonctionnent


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 niveauxNiveaux de titres (pas le gras)

C'est la règle la plus importante.

Danslabarre
d'outils, À faire❌ À éviter
Sélectionner le titre → choisir Titre 2 / Titre 3 / Titre 4 dansutilisez le menu déroulant Écrireà gauche pour choisir le niveau — ne mettez jamais du texte et le mettre en gras pour imiter un titretitre.

oulesniveaux
Style BookStackRôleExemple
En-tête largeTitre de la fiche (1 seul)"Modes d'alimentation"
GarderEn-tête une hiérarchie logique (H2 → H3 → H4)moyen SauterSection desprincipale niveauxnumérotée "1. mélangerIntroduction"
Petite en-têteSous-section"1.1 Le secteur"
En-tête minusculeSous-sous-section (rare)"1.2.1 Pile non rechargeable"
ParagrapheCorps de texte normaltout le contenu courant

Structure attendue pour une fiche :

H2En-tête large  — Titre de la fiche
  (ex:En-tête "Fiche informative – Modes d'alimentation")
  H3moyen  — 1. Introduction
  H3En-tête moyen  — 2. Première partie
    H4Petite en-tête  — 2.1 Sous-section
  H3En-tête moyen  — 3. Deuxième partie

3.2. Listes

Utiliser les listesboutons (pas les tiretsliste à puces et liste numérotée de la main)barre d'outils. Ne pas taper ,  ou 1. manuellement.

  • Liste à puces = énumération sans ordre
  • Liste numérotée = étapes d'un processus (surtout fiches opérationnelles)

3. Encadrés colorés

Via le menu Légendes dans la barre d'outils. Chaque couleur a un sens précis :

listenumérotée barred'outils
✅ À faireEncadré ❌ À éviterUsage
BoutonInformation liste(bleu)Définition, rappel de contexte, référence à pucesune ounorme
Succès (vert)Bonne pratique, REX positif, point fort à retenir
Avertissement (orange)Limite, condition d'application, point de lavigilance
Danger (rouge) TaperErreur fréquente, oucontre-indication,  ou 1.piège à la mainéviter

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 fiche dans 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 :

TagValeurExemple
typeinformative ou operationnelletype = informative
phasenuméro de phase concernéephase = 4
bloccode du bloc fonctionnelbloc = alimentation
statutbrouillon, revue, validéstatut = brouillon
redacteurnom de votre sociétéredacteur = CATIE

Ces tags permettent de retrouver et d'exporter toutes les fiches d'une phase ou d'un bloc en un clic.


6. Pour les tableauxTableaux

Les tableaux sont bienvenus pour présenter des comparaisons ou des données structurées.

  • UtilisezUtiliser 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Éviter les fusions de cellules complexes — préférezpréférer plusieurs tableaux simples
  • Ne pas coller des tableaux depuis Excel ou Word (voir section suivante)

5. Contenu depuis Word ou Excel : demander à Claude

Ne pas coller directement depuis Word ou Excel. Un copier-coller direct importe du formatage invisible qui pollue les exports.

La bonne méthode : collez votre contenu Word directement dans le chat Claude (projet Teams RG3E) et demandez :

"nettoie ce contenu pour BookStack RG3E"

Claude vous retournera :

  1. Le HTML propre à coller dans l'éditeur code <> de BookStack
  2. Un rapport si des modifications visibles ont été faites (tableaux restructurés, sections supprimées…)
  3. Un accompagnement pour les tags — Claude identifie ce qu'il peut et pose les questions pour le reste

Vous pouvez aussi envoyer un fichier Word directement à Claude, le résultat est le même.


6. Tags de la page

En bas de l'éditeur, zone Tags. Claude vous guidera pour les remplir après le nettoyage. Pour chaque tag, cliquez + Ajouter un tag, saisissez le nom dans le premier champ et la valeur dans le second.

Référentiel des tags :

Type_Fiche — valeur unique obligatoire : Informative ou Opérationnelle

Cible — une ou plusieurs valeurs séparées par , sans espace Valeurs : Chef produit, Chef de projet, Architecte, Coordinateur éco-conception, Concepteur HW, Concepteur SW, Concepteur Méca, Direction, Marketing, Achats, Production Exemple : Architecte,Concepteur HW

Gains_environnementaux — valeur unique : Faibles, Modérés ou Forts

Mise_en_place — valeur unique : Simple, Modérée ou Complexe

Secteur — une ou plusieurs valeurs séparées par , sans espace Valeurs actuelles : Automobile, Défense, Biens de consommation, Tous secteurs Exemple : Automobile,Défense

Etape_projet — valeur unique : Amont, Architecture ou Conception


7. Notes de travail et brouillons

Les notes, questions en attente et brouillons intermédiaires ne doivent pas rester dans la page finale.

  • Utiliser les Commentaires BookStack (icône bulle en haut à droite) pour les remarques aux relecteurs
  • Pour un brouillon en cours, créer une page séparée préfixée [BROUILLON] dans le même chapitre
  • Ne pas laisser de sections ZOLD, >>> Atelier ou QUESTIONS / REMARQUES dans le contenu publié

Récapitulatif rapide

statut
ActionSituation ConsigneAction
CollerNouveau du textecontenu Ctrl+Shift+VSaisir (sansdirectement misedans BookStack en forme)WYSIWYG
Contenu depuis Word / ExcelColler dans Claude → "nettoie ce contenu pour BookStack RG3E"
Titres Menu déroulant → TitreEn-tête 2large / 3moyen / 4petite
Listes Boutons liste de la barre d'outils
NotesEncadrés / brouillonscolorés PageMenu séparéeLégendes ou Commentaireschoisir BookStackla couleur selon le sens
Tags ÀClaude remplirvous avantguide deaprès passerle ennettoyage
Notes / brouillonsCommentaires BookStack ou page revue[BROUILLON]
Couleurs /et polices custom À éviter — le thème s'en charge

EnFiches casspécimen de douteréférence sur: la structure d'une fiche, référez-vous aux fiches spécimen dans les livreslivre "Spécimen fiche informative" et· livre "Spécimen fiche opérationnelle".