DOCUMENTATION

GUIDE DES GABARITS_

Comment fabriquer un gabarit Word (template) sans écrire une ligne de code : tu dessines ton CV dans Word, et tu indiques simplement, avec des balises, où doit apparaître chaque information.

1 · LE PRINCIPE

L'IA lit le CV d'origine et range toutes les informations dans une fiche normalisée (le « JSON canonique »). Ton gabarit Word n'est qu'une maquette avec des trous : chaque trou est une balise entre doubles accolades, qui sera remplacée par l'information correspondante.

Exemple : si tu écris {{ identite.prenom }} dans ton document, le prénom du consultant apparaîtra à cet endroit. Tout le reste (police, couleurs, logo, mise en page, en-tête, pied de page) est de la mise en forme Word normale, tu la gardes telle quelle.

2 · LES 6 BALISES À CONNAÎTRE

Tu n'as besoin que de ces six cas. Clique sur un exemple pour le copier, puis colle-le dans Word.

A · Afficher une information

{{ identite.prenom }}

Affiche le champ. Si l'information n'existe pas dans le CV, rien ne s'affiche (jamais de « None » ni de « null »).

B · Mettre en majuscules (ou en minuscules)

{{ identite.nom | upper }}

{{ identite.titre | lower }}

Les données sont stockées avec leur casse naturelle (« Dossounou »). C'est le gabarit qui décide de la mettre en | upper (MAJUSCULES) ou | lower (minuscules). Le trait vertical | s'obtient avec AltGr + 6.

C · Afficher une liste sur une seule ligne

{{ identite.domaines | join(', ') }}

{{ identite.fonctions | join(' – ') | upper }}

Beaucoup de champs sont des listes (domaines, fonctions, tâches…). join('…') les met bout à bout, avec le séparateur de ton choix entre les guillemets : virgule, tiret, barre verticale…

D · Afficher seulement si l'information existe

{% if identite.disponibilite %}Disponibilité : {{ identite.disponibilite }}{% endif %}

Tout ce qui est entre {% if … %} et {% endif %} n'apparaît que si le champ est rempli. Indispensable pour les libellés (« Disponibilité : », « Mobilité : »…) qui ne doivent pas rester seuls quand la donnée est absente.

E · Répéter une ligne de tableau (une ligne par élément)

C'est la méthode la plus simple pour les expériences, formations, certifications, langues. Dans un tableau Word, prévois trois lignes :

Les lignes 1 et 3 disparaissent à la génération : seules les lignes « de contenu » restent, une par élément. La lettre f est le nom que tu donnes à « l'élément en cours » : tu peux choisir n'importe quelle lettre ou mot, mais il faut utiliser le même partout entre le for et le endfor.

F · Répéter un paragraphe (hors tableau)

{%p for r in m.responsabilites %}
{{ r }}
{%p endfor %}

Chaque balise {%p …%} doit être seule dans son propre paragraphe. Pour obtenir des puces, mets simplement le paragraphe central ({{ r }}) en liste à puces dans Word.

Bonus · Boucle dans une boucle

Une expérience contient elle-même des listes (tâches, environnement…). Tu les répètes à l'intérieur de la boucle des expériences :

{%p for m in experiences %}
{{ m.poste }} – {{ m.entreprise }} ({{ m.periode.annees }})
{%p for r in m.responsabilites %}
{{ r }}
{%p endfor %}
{%p endfor %}

Bonus · Ne reprendre que les N dernières expériences

La variable missions_recentes contient les 4 expériences les plus récentes. Elle s'utilise comme experiences, mais pour un tableau « missions récentes » en première page.

{{ missions_recentes | map(attribute='poste') | unique | join(' – ') | upper }}

Ci-dessus : la liste des postes des missions récentes, sans doublon, sur une ligne.

3 · LISTE DES CHAMPS DISPONIBLES

Voici tout ce que ton gabarit peut afficher. Clique sur un nom de champ pour copier la balise toute prête. Le type te dit comment l'utiliser :

• TEXTE une valeur simple → {{ champ }}
• NOMBRE un nombre → {{ champ }}
• LISTE DE TEXTES plusieurs valeurs → | join(', ') ou une boucle (cas F)
• LISTE plusieurs éléments, chacun avec ses propres champs → une boucle (cas E ou F)
• AUTO calculé automatiquement, tu n'as rien à fournir

4 · EXEMPLE COMPLET

Voici à quoi ressemble le haut d'un gabarit dans Word. À gauche ce que tu tapes, à droite ce qui sort.

5 · ERREURS FRÉQUENTES

• La balise s'affiche telle quelle dans le CV final. Word a coupé la balise en plusieurs morceaux de mise en forme. Retape-la d'un seul trait, sans changer de police, de gras ou de couleur au milieu. Si le problème persiste : sélectionne la balise entière, applique « Effacer la mise en forme », retape-la, puis mets en forme l'ensemble.
• Les guillemets sont « courbes ». Word transforme parfois ' en ’ et " en “ ”, ce qui casse la balise. Utilise de préférence le bouton COPIER de ce guide, ou désactive la correction automatique (Options → Vérification → Options de correction automatique → « Remplacer les guillemets droits »).
• Une faute de frappe dans un nom de champ. identite.prenom fonctionne, identité.prénom ou identite.Prenom non : pas d'accent, pas de majuscule. Le champ inconnu s'affichera simplement vide.
• Un {% for %} sans {% endfor %} (ou un {% if %} sans {% endif %}). Chaque ouverture doit avoir sa fermeture, sinon la génération échoue.
• Balise {%p …%} ou {%tr …%} avec autre chose dans le même paragraphe / la même ligne. Ces balises de bloc doivent être seules : rien d'autre dans leur paragraphe ou dans leur ligne de tableau.
• Mauvaise lettre dans une boucle. Si tu écris {%tr for f in formations %}, il faut ensuite {{ f.diplome }}, pas {{ m.diplome }}.
• Un libellé qui reste seul. « Téléphone : » sans numéro : entoure le libellé et la valeur d'un {% if contact.telephone %}…{% endif %} (cas D).

6 · LIVRER LE GABARIT

1. Enregistre ton fichier au format .docx, avec un nom du type « Template - Format 3.docx ». Le nom (sans « Template - ») devient le nom affiché dans la liste « Gabarit ».
2. Si tu as le rôle administrateur, ouvre la page Gabarits et dépose le fichier : il est testé (balises, noms de champs) puis ajouté à la liste. Sinon, transmets-le à un administrateur.
3. Teste-le avec un CV réel : transforme un CV, choisis ton gabarit, télécharge le .docx et vérifie qu'aucune balise {{ }} ou {% %} n'est restée visible.