Guide - Policy brief

Format court, orienté décision : synthèse en une lecture, recommandations numérotées, pensé pour l’export PDF. Distinct des dossiers spéciaux (GUIDE-DOSSIERS-SPECIAUX.md), qui restent le format long à sources croisées : le brief n’a délibérément ni hero sombre, ni couverture photo, ni sommaire. Sa page est construite comme un document de décision (masthead clair, fiche technique en aside, sections numérotées) et non comme un article de magazine. Complète GUIDE-NOUVEL-ARTICLE.md (que ce guide ne remplace pas : un policy brief reste un article _posts/*.md normal, juste avec un gabarit différent).

1. Principe : un policy brief reste un article

Comme un dossier, un policy brief est un fichier _posts/AAAA-MM-JJ-slug.md ordinaire. Il apparaît automatiquement partout où un article apparaît déjà (recherche, flux RSS, sitemap, page «Toutes les analyses») — rien à reconstruire. Seul le gabarit change, via layout: policy-brief.

2. Front matter d’un policy brief

---
layout: policy-brief
type: policy-brief
title: "Titre du brief"
description: "Résumé d'une phrase."
date: 2026-08-10 09:00:00 +0100
category: politique-economique
pilier: dev-finance                   # voir _data/piliers.yml — obligatoire, comme pour un dossier
synthese: "2-3 phrases : ce qu'il faut retenir en une lecture, avant tout détail."
recommandations:
  - "Première recommandation, formulée comme une action concrète et actionnable."
  - "Deuxième recommandation."
image: /assets/images/articles/mon-brief.webp        # lu pour le partage social (og:image) uniquement, jamais affiché sur la page
image_alt: "Description factuelle de l'image."
authors:                              # optionnel — omettre pour un seul auteur (site.author.name)
  - "Tientcheu Nouake"
dossier_associe: /articles/slug-du-dossier-complet/   # optionnel, voir §2bis
---

type: policy-brief sert de filtre pour la page hub (policy-briefs.html) et pour la section «Poursuivre la lecture» en fin de page.
pilier : même liste que pour un dossier (4 slugs de _data/piliers.yml) : détermine la couleur d’accent de toute la page (bandeau de tête, fiche technique, synthèse, badges de recommandation).
synthese : 2-3 phrases affichées dans un bandeau plein en tête de corps, avant le texte de l’article. C’est ce qu’un décideur pressé doit pouvoir lire en 10 secondes. Sans ce champ, le bandeau n’apparaît simplement pas.
recommandations : liste de chaînes, chacune devient une carte numérotée dans la section «Recommandations» en fin de page. Formulez chaque item comme une action («Réviser…», «Créer…», «Conditionner…»), pas comme un constat.
image / cover_image : lus uniquement pour l’aperçu de partage social (og:image, déjà géré par _includes/head.html), jamais affichés en grand sur la page elle-même — contrairement à un dossier. Inutile de soigner un cadrage 16:9 pour un policy brief.
authors : tableau, pour la co-écriture — pour qu’un co-auteur affiche sa propre photo et sa propre bio, voir GUIDE-COECRITURE.md.
Tous les autres champs (keywords, excerpt…) suivent exactement les mêmes règles qu’un article normal — voir GUIDE-NOUVEL-ARTICLE.md et GUIDE-IMAGES-CANVA.md.

Ce qu’un policy brief n’a pas, contrairement à un dossier

Pas de hero sombre ni de couverture photo en bandeau : la page s’ouvre sur un masthead clair (encre sur papier) avec une fiche technique en aside, pas sur un visuel plein écran.
Pas de sommaire auto-généré (rail sticky / tiroir mobile) : un brief est court, un sommaire n’a pas de sens.
Pas de updates: / journal des mises à jour : un brief documente un état à un instant donné, il n’est pas pensé pour évoluer dans le temps comme un dossier.

2bis. Lien optionnel vers un dossier complet

Un policy brief peut exister seul, ou accompagner un dossier spécial qui traite le même sujet en profondeur. Pour signaler ce lien :

Dans le brief, dossier_associe: /articles/slug-du-dossier/ affiche un bandeau «Aller plus loin» vers le dossier complet, en fin de corps.
Dans le dossier correspondant, ajoutez symétriquement brief_associe: /articles/slug-du-brief/ dans son front matter (voir GUIDE-DOSSIERS-SPECIAUX.md §2) pour afficher un bandeau «Version courte» équivalent.

Les deux champs sont indépendants et optionnels : un dossier n’a pas forcément de version courte, un brief n’a pas forcément de dossier associé.

3. Mettre en valeur un graphique ou un chiffre-clé dans le corps

Les mêmes gabarits que pour un dossier fonctionnent tels quels dans le corps d’un policy brief (voir GUIDE-DOSSIERS-SPECIAUX.md §4 et §4bis) :

<div class="dossier-graph">
  <div class="dossier-graph-scroll">
    <!-- votre graphique : embed Flourish, tableau large, image -->
  </div>
  <p class="dossier-graph-caption">Source : ..., année.</p>
</div>

<div class="dossier-callout">
  <p class="dossier-callout-label">Chiffre clé</p>
  <p class="dossier-callout-metric">68 985</p>
  <p>Description du chiffre.</p>
</div>

4. La page hub (`/policy-briefs/`)

Liste tous les articles avec type: policy-brief sous forme de registre filtrable par pilier (pastilles cliquables, pas de carrousel). Rien à maintenir à la main : un nouveau brief y apparaît automatiquement dès sa publication. Accessible depuis le menu déroulant «Formats spéciaux» du header (regroupé avec «Dossiers spéciaux») et depuis le pied de page.

5. Export PDF

Même bouton «Exporter en PDF» que les dossiers, même choix technique : window.print() natif, piloté par une feuille @media print, pas de librairie JS. Pour un policy brief, c’est l’usage central plutôt qu’un bonus — vérifiez avant publication que la synthèse et les recommandations s’impriment proprement (aperçu avant impression du navigateur).

6. Checklist

layout: policy-brief et type: policy-brief dans le front matter
pilier: renseigné avec un slug valide de _data/piliers.yml
synthese: renseignée — 2-3 phrases, lisibles seules, sans le reste de l’article
recommandations: renseignée — chaque item formulé comme une action concrète
authors: renseigné si co-écriture, sinon omis
dossier_associe: renseigné si un dossier complet existe sur le même sujet, sinon omis
Aperçu avant impression vérifié (bouton «Exporter en PDF»)