Export Word¶
La même note, avec le même filtre de confidentialité, peut sortir en document Word (.docx) au lieu d'un PDF. Deux possibilités :
- Sans modèle Word, le document est mis en page comme le PDF : même page de garde, mêmes bandeaux d'en-tête et de pied de page, page de références, rappel TLP et sommaire, aux couleurs du modèle — ou avec son papier à en-tête et le logo de la note.
- Avec votre propre modèle Word (
.dotxou.docx), le plugin le remplit : sa page de garde, ses en-têtes, ses pieds de page, son thème et ses styles restent tels quels, et le rapport va là où vous avez écrit{{content}}.
Vérifié dans Word et LibreOffice
L'export Word est vérifié dans Microsoft Word, et chaque build ouvre ses documents d'exemple dans LibreOffice (voir plus bas). Si un document s'ouvre mal, ouvrez une issue avec la note et, si possible, le modèle Word.
Exporter¶
| Comment | Ce que ça fait |
|---|---|
| Commande Exporter en document Word | Exporte la note active |
| Commande Exporter en document Word avec un profil… | Exporte une version : la complète, ou un profil comme Client (voir Export confidentiel) |
| Clic droit sur une note → Exporter en document Word | Exporte cette note |
Le fichier va là où irait le PDF : même dossier, même nom, avec l'extension .docx. Le choix du modèle et les profils fonctionnent comme pour le PDF.
Word demande de mettre à jour les champs
À l'ouverture, Word demande « Ce document contient des champs qui peuvent faire référence à d'autres fichiers. Voulez-vous mettre à jour les champs dans ce document ? » Répondez Oui : Word ajoute alors les numéros de page au sommaire et numérote les légendes. Les entrées et leurs liens sont déjà là, donc un lecteur qui répond non a quand même un sommaire qui fonctionne.
Utiliser votre propre modèle Word¶
-
Ouvrez le modèle de votre entreprise dans Word et écrivez des marqueurs là où vont les valeurs de la note — sur la page de garde, dans les en-têtes et les pieds de page, dans un tableau :
Marqueur Remplacé par {{title}}Le titlede la note{{subtitle}}subtitle{{acronym}}acronym{{client}}client{{author}}author{{version}},{{date}},{{status}}La dernière ligne de versions(la date est celle du jour par défaut){{tlp}}Le marquage TLP, en gras, dans sa couleur ( TLP:AMBER){{toc}}Un sommaire Word, seul dans son paragraphe {{versions}}Toutes les lignes de versions(version, date, état) en tableau, seul dans son paragraphe{{contacts}}Tous les contacts(nom, fonction, courriel) en tableau, seul dans son paragraphe{{recipients}}Tous les recipients(nom, société ou fonction, courriel) en tableau, seul dans son paragraphe{{content}}Le rapport, seul dans son paragraphe -
Enregistrez-le en
.dotxou.docxdans le coffre. Les fichiers avec macros (.dotm,.docm) sont refusés. - Dans Réglages → Report Exporter, ouvrez le modèle du plugin à utiliser, puis Export Word → Modèle Word → Choisir….
Les marqueurs gardent la mise en forme du texte qu'ils remplacent. Word coupe parfois un marqueur en plusieurs morceaux après une correction orthographique ou un changement de mise en forme ; le plugin le retrouve quand même. Un marqueur écrit dans la note elle-même reste tel quel.
Sans paragraphe {{content}}, le rapport est ajouté à la fin du modèle, et une notification le signale.
Les tableaux de {{versions}}, {{contacts}} et {{recipients}} prennent leurs titres de colonnes dans les Libellés des sections fixes du modèle du plugin, et le style Word choisi pour Tableaux dans le tableau Styles Word (Table Grid par défaut) ; leur ligne d'en-tête se répète à chaque page. Quand la liste est vide dans la note, le paragraphe du marqueur est supprimé.
Conseils pour un modèle qui marche bien¶
- Numérotez les titres dans le modèle, ou pas du tout. Quand les styles Titre 1, Titre 2… du modèle sont numérotés par Word (une liste à plusieurs niveaux liée à ces styles), le plugin laisse la numérotation à Word. Sinon, il écrit la numérotation du modèle du plugin (
A.,1.…) en texte, comme dans le PDF. - Mettez la page de garde en premier et
{{content}}sur une page à part. Donnez au paragraphe de{{content}}l'option Saut de page avant, ou placez un saut de page juste au-dessus, pour que le rapport commence sur une nouvelle page. Le Saut de page avant fonctionne aussi sur les paragraphes de{{toc}},{{versions}},{{contacts}}et{{recipients}}. - Utilisez une première page différente (Mise en page → Première page différente) pour une page de garde sans l'en-tête courant.
- Nommez vos styles comme vous voulez. Un style personnalisé comme Corps de rapport est proposé dans le tableau Styles Word des réglages, où vous y associez le Texte courant.
- Le format et l'orientation viennent du modèle. Tableaux, images et colonnes prennent la largeur de sa zone de texte, en portrait comme en paysage.
- Les notes de bas de page déjà présentes dans le modèle sont conservées ; celles de la note viennent après.
Modèles d'exemple¶
Trois modèles sous licence libre, écrits dans Word et utilisés par le banc d'essai, sont dans le dossier templates/word du dépôt. Téléchargez-en un dans votre coffre pour partir de là :
| Modèle | Ce qu'il montre |
|---|---|
consulting-report.dotx |
Page de garde avec tous les marqueurs, {{toc}} sur sa propre page, titres numérotés par Word (1., 1.1.), en-tête courant à partir de la deuxième page, TLP et numéro de page en pied de page |
memo.dotx |
Sans page de garde : marqueurs dans un tableau en haut, un style Corps de rapport à choisir dans les réglages |
landscape-brief.dotx |
A4 paysage, marges étroites, une note de bas de page qui lui est propre |
Styles¶
Chaque élément de la note prend un style Word, retrouvé dans le modèle par son nom interne — le même dans toutes les langues, donc un modèle enregistré par un Word français (Titre 1) fonctionne comme un anglais (Heading 1) :
| Élément | Style par défaut |
|---|---|
| Texte courant | Normal |
| Titres 1 à 6 | Titre 1 … Titre 6 |
| Éléments de liste | Paragraphe de liste |
| Légendes | Légende |
| Blocs de code | HTML préformaté |
| Code dans le texte | Code HTML |
| Liens | Lien hypertexte |
| Tableaux | Grille du tableau |
| Notes de bas de page, appels de note | Note de bas de page, Appel de note de bas de page |
| Sommaire | En-tête de table des matières, TM 1 … TM 6 |
Le tableau Styles Word des réglages fait pointer n'importe quel élément vers un autre style du modèle — par exemple le texte courant vers votre style Corps de texte. Un style absent du modèle est ajouté au document, d'après les couleurs et les polices du modèle du plugin.
Ce qui est rendu¶
| Dans la note | Dans Word |
|---|---|
| Titres | Les styles de titre du modèle, numérotés par le modèle ou comme dans le PDF (A., 1.…), avec un signet pour le sommaire |
Gras, italique, barré, code dans le texte, <br> |
Mise en forme directe et style de code |
| Liens | De vrais liens hypertexte Word |
| Listes à puces, numérotées et de tâches | Numérotation Word ; cases ☐ et ☑ |
| Tableaux | Le style de tableau, avec la ligne d'en-tête répétée sur chaque page |
| Images | Incorporées, à la largeur demandée |
*Figure 1 : …*, Tableau 2 : … |
Des légendes Word : le numéro est un champ de séquence, donc Insérer une table des illustrations les liste et les renumérote quand on en ajoute une. Fig. compte avec les figures |
texte[^1], [^1]: note, texte^[note en ligne] |
De vraies notes de bas de page Word, en bas de la page qui les cite ; une note citée deux fois garde le même numéro |
Colonnes (````col, > [!col]) |
Côte à côte dans un tableau sans bordure, chacune à la largeur de sa part flexGrow, avec sa bordure et son alignement ; une rangée de colonnes n'est pas coupée entre deux pages |
| Blocs de code | Le style de code : police à chasse fixe, fond grisé, espaces et tabulations conservés |
| Callouts | Un encadré teinté avec une barre de leur couleur, leur icône et un titre coloré |
| Schémas Mermaid | Dessinés par Obsidian, incorporés en images vectorielles, avec une image pour les anciennes versions de Word |
\pagebreak, --- |
Sauts de page et filets |
| Passages restreints | Signalés et surlignés dans la version complète, retirés des autres — comme dans le PDF |
LibreOffice et Google Docs¶
L'export Word est écrit pour Microsoft Word et vérifié dans Word. Chaque build ouvre aussi chaque document d'exemple dans LibreOffice et l'imprime en PDF : un fichier que LibreOffice ne sait pas ouvrir ne peut pas sortir. Le rendu peut tout de même différer de celui de Word :
- Si le sommaire n'a pas de numéros de page, ou si les légendes gardent le numéro écrit dans la note, mettez à jour les champs : Outils → Actualiser → Tout actualiser dans LibreOffice.
- Les polices que le modèle demande mais que l'ordinateur n'a pas sont remplacées par les plus proches de LibreOffice, ce qui peut changer les retours à la ligne.
Google Docs n'est pas testé. Si vous l'utilisez, dites-nous dans les issues ce qui marche et ce qui ne marche pas.
Vérifié en CI¶
Chaque build produit des documents d'exemple — générés, avec papier à en-tête, à partir des notes d'exemple, d'un modèle Word, et de chacun des trois modèles d'exemple — puis :
- les vérifie avec le validateur Open XML de Microsoft : une modification qui ferait dire à Word qu'il a trouvé du « contenu illisible » ne peut pas sortir ;
- les ouvre dans LibreOffice.
Les tests de confidentialité vérifient aussi le fichier Word : aucun texte restreint — notes de bas de page comprises — n'arrive dans un .docx client.