Skip to main content

Guide de saisie des fiches RG3E dans BookStack

Guide
de

Ce saisieguide desexplique comment structurer et mettre en forme les fiches RG3E dans BookStack

À destination des rédacteurs — comment écrire dans BookStack pour que les exports PDF et les traitements automatiques fonctionnent correctement.

Pourquoi1. cesTitre consigneset ?structure de la fiche

BookStackLe esttitre l'outilde d'éditionla desfiche fichesse RG3E.saisit dans le champ Titre en haut de la page — pas dans le corps du contenu.

Le contenu quecommence vous saisissez sera :

  • exporté en PDF pour diffusion
  • ludirectement par desla outilspremière automatiquessection. (dontLes l'IA) pour synthèses, recherches, rapports

Pour que ces exports fonctionnent bien, le contenu doit être structuré, pas seulement mis en forme.

1. Niveauxniveaux de titres

C'estdisponibles la règle la plus importante. Dans la barre d'outils, utilisezdans le menu déroulant àde gauchela pourbarre choisird'outils lesont niveau — ne mettez jamais du texte en gras pour imiter un titre.:

—
Style BookStack RôleNiveau ExempleRôle
En-tête largemoyen Titre de la fiche (1 seul)"Modes d'alimentation"
En-tête moyenH2 Section principale numérotée ex. "1. Introduction"
Petite en-tête Sous-sectionH3 Sous-section — ex. "1.1 Le secteur"
En-tête minuscule H4Sous-sous-section (rare) "1.2.1 Pile non rechargeable"
Paragraphe— Corps de texte normal tout le contenu courant

Ne jamais utiliser le gras pour imiter un titre — utiliser le menu déroulant.

Structure attendue pour une fiche :

En-tête large  —[Champ Titre de la fichepage]

  En-tête moyen (H2)    — 1. Introduction
  En-tête moyen (H2)    — 2. Première partie
    Petite en-tête (H3) — 2.1 Sous-section
  En-tête moyen (H2)    — 3. Deuxième partie

2. Mise en forme du texte

Tous les boutons de la barre d'outils ne se valent pas pour les exports. Voici ce qui est conservé ou perdu :

Conservé dans tous les exports :

  • Gras (bouton B) — pour les termes importants
  • Italique (bouton I) — pour les citations courtes, les termes techniques
  • Barré (dans le menu ...) — pour les valeurs obsolètes
  • Liens hypertexte (bouton chaîne) — sélectionner le texte, cliquer le bouton, saisir l'URL

Perdu lors des exports automatiques :

  • Souligné (bouton U) — perdu
  • Couleur du texte (bouton A couleur) — perdu
  • Surlignage (bouton stylo) — perdu
  • Alignement centré / droite / justifié — perdu, le texte revient aligné à gauche

Si vous utilisez la couleur ou le surlignage pour signaler quelque chose d'important, reformulez avec du gras ou une citation >.

3. Listes

Utiliser les boutons liste à puces et liste numérotée de la 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 :

EncadréUsage
Information (bleu)Définition, rappel de contexte, référence à une norme
Succès (vert)Bonne pratique, REX positif, point fort à retenir
Avertissement (orange)Limite, condition d'application, point de vigilance
Danger (rouge)Erreur fréquente, contre-indication, piège à éviter

4. Tableaux

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

  • Utiliser l'outil tableau de la barre (icône grille)
    • . Les tableaux sont conservés dans tous les exports.

    • Éviter les fusions de cellules complexes — préférer plusieurs tableaux simples
    • Ne pas coller des tableaux depuis Excel ou Word (voir section suivante)6)

    5. Images

    Cliquer le bouton image dans la barre d'outils pour uploader un fichier ou choisir dans la galerie.

    Vous pouvez redimensionner visuellement l'image en faisant glisser ses poignées dans l'éditeur. Cette taille ne sera pas conservée lors des exports automatiques — l'image s'affichera à sa taille originale. Pour un rendu maîtrisé, redimensionnez l'image avant de l'uploader.

    6. Contenu depuis Word ou Excel : demander à Claude

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

    La bonne méthode : collezCollez 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…)effectué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.Claude.

    6.7. Tags de la page

    En bas de l'éditeur, zone Tags. Claude vous guidera pour les remplir après le nettoyage. Pour chaque tag,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.8. 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,brouillon, 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

    WYSIWYG après le nettoyageou
    SituationÉlément ActionExport
    NouveauTitre contenude la fiche SaisirChamp directementTitre dansde BookStackla enpage —
    ContenuTitres depuisde sectionMenu déroulant → En-tête moyen / petite / minuscule✅
    Gras, italique, barréBoutons B / I / ...✅
    Lien hypertexteSélectionner → bouton chaîne → URL✅
    ListesBoutons liste✅
    TableauBouton tableau✅ (sans fusion)
    ImageBouton image✅ (taille originale)
    SoulignéBouton U❌ perdu
    Couleur texte / surlignageBoutons A / stylo❌ perdu
    Alignement / justificationBoutons ≡❌ perdu
    Word / Excel Coller dans Claude → "nettoie ce contenu pour BookStack RG3E"
    TitresMenu déroulant → En-tête large / moyen / petite
    ListesBoutons liste de la barre d'outils
    Encadrés colorésMenu Légendes → choisir la couleur selon le sens—
    Tags Claude vous guide —
    Notes / brouillonsBrouillons Commentaires BookStack ou pagePage [BROUILLON]
    Couleurs et polices customCommentaires À éviter — le thème s'en charge

    Fiches spécimen de référence : livre "Spécimen fiche informative" · livre "Spécimen fiche opérationnelle"

Back to top