Skip to main content

Guide de saisie des fiches RG3E dans BookStack

Ce guide explique comment structurer et mettre en forme les fiches RG3E dans BookStack pour que les exports PDF et les traitements automatiques fonctionnent correctement.

1. Titre et structure de la fiche

Le titre de la fiche se saisit dans le champ Titre en haut de la page — pas dans le corps du contenu.

Le contenu commence directement par la première section. Les niveaux de titres disponibles dans le menu déroulant de la barre d'outils sont :

Style BookStack Niveau Rôle
En-tête moyen H2 Section principale — ex. "1. Introduction"
Petite en-tête H3 Sous-section — ex. "1.1 Le secteur"
En-tête minuscule H4 Sous-sous-section (rare)
Paragraphe — Corps de texte normal

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

Structure attendue :

[Champ Titre de la page]

  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)

4. Tableaux

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

  • Éviter les fusions de cellules — préférer plusieurs tableaux simples
  • Ne pas coller depuis Excel ou Word (voir section 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 — le formatage invisible pollue les exports.

Collez votre contenu 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 des modifications visibles effectuées
  3. Un accompagnement pour les tags

Vous pouvez aussi envoyer un fichier Word directement à Claude.

7. Tags de la page

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

Type_Fiche — Informative ou Opérationnelle

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

Gains_environnementaux — Faibles, Modérés ou Forts

Mise_en_place — Simple, Modérée ou Complexe

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

Etape_projet — Amont, Architecture ou Conception

8. Notes de travail et brouillons

  • Utiliser les Commentaires BookStack (icône bulle en haut à droite) pour les remarques aux relecteurs
  • Pour un 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

Élément Action Export
Titre de la fiche Champ Titre de la page —
Titres de section Menu déroulant → En-tête moyen / petite / minuscule ✅
Gras, italique, barré Boutons B / I / ... ✅
Lien hypertexte Sélectionner → bouton chaîne → URL ✅
Listes Boutons liste ✅
Tableau Bouton tableau ✅ (sans fusion)
Image Bouton image ✅ (taille originale)
Souligné Bouton U ❌ perdu
Couleur texte / surlignage Boutons A / stylo ❌ perdu
Alignement / justification Boutons ≡ ❌ perdu
Word / Excel Claude → "nettoie ce contenu pour BookStack RG3E" —
Tags Claude vous guide —
Brouillons Page [BROUILLON] ou Commentaires —

Fiches spécimen : livre "Spécimen fiche informative" · livre "Spécimen fiche opérationnelle"

No comments to display

Back to top