Guide - Co-écriture

Comment créditer un co-auteur sur un article, un dossier spécial ou un policy brief, avec sa propre photo, son propre rôle et sa propre bio (pas seulement son nom cité en passant). S’applique aux trois formats du site : articles classiques (GUIDE-NOUVEL-ARTICLE.md), dossiers spéciaux (GUIDE-DOSSIERS-SPECIAUX.md) et policy briefs (GUIDE-POLICY-BRIEF.md).

1. Principe

Deux pièces séparées travaillent ensemble :

• authors: dans le front matter de l’article — la liste des noms, dans l’ordre où ils doivent apparaître.
• _data/collaborateurs.yml — la fiche de chaque co-auteur (photo, rôle, bio, réseaux), en dehors de vous.

Vous (site.author dans _config.yml) n’avez rien à ajouter nulle part : votre fiche existe déjà et sera reconnue automatiquement dès que votre nom apparaît dans authors:.

La mise en page (ligne de signature en haut d’article, puis un encadré bio par personne en bas d’article) est entièrement automatique une fois ces deux pièces renseignées — rien à toucher côté gabarit.

2. Ajouter un co-auteur à _data/collaborateurs.yml

Dupliquez un bloc :

- name: "Nom Prénom"
  role: "Fonction ou titre affiché sous le nom"
  bio: "Bio courte, 1 à 3 phrases."
  avatar: "/assets/images/collaborateurs/slug-de-la-personne.jpg"
  linkedin: "https://www.linkedin.com/in/..."
  instagram: ""
  facebook: ""
  whatsapp: ""
  email: ""

• name est la seule clé obligatoire. C’est aussi la clé de correspondance : le texte doit être rigoureusement identique à ce que vous écrirez dans authors: de l’article (mêmes accents, mêmes majuscules). Une différence, même minime, fait retomber la personne sur un simple nom sans photo ni bio.
• role, bio : omis, la section correspondante ne s’affiche simplement pas.
• avatar : déposez la photo dans assets/images/collaborateurs/ (dossier à créer au premier ajout). Même traitement d’affichage que votre propre photo — voir GUIDE-IMAGES-CANVA.md pour le cadrage d’un portrait (object-cover object-top, un cadrage carré ou portrait serré convient).
• linkedin / instagram / facebook / whatsapp / email : chacun optionnel, chacun affiche sa propre icône uniquement s’il est renseigné.

3. Créditer la personne dans l’article

Dans le front matter de l’article (_posts/*.md, quel que soit le format — layout: post, layout: dossier ou layout: policy-brief) :

authors:
  - "Tientcheu Nouake"
  - "Nom Prénom"

• Le premier nom qui correspond à site.author.name (vous) est automatiquement reconnu, même s’il n’est pas en tête de liste.
• Chaque autre nom est cherché dans _data/collaborateurs.yml. Trouvé : sa fiche complète s’affiche. Pas trouvé : seul le nom apparaît dans la signature, sans encadré bio propre (utile pour une mention rapide sans créer de fiche complète).
• Un seul auteur (vous) : omettez authors: entièrement, comme aujourd’hui — rien ne change dans ce cas.

Article classique (layout: post)

Avant ce guide, _layouts/post.html n’acceptait qu’un champ author: unique (chaîne de caractères) et l’encadré bio en bas de page ignorait même ce champ pour toujours afficher le vôtre. C’est corrigé : post.html accepte désormais authors: (liste) exactement comme les dossiers et les policy briefs. L’ancien champ author: (singulier) continue de fonctionner pour un article signé par quelqu’un d’autre que vous sans co-écriture — mais il ne fait toujours qu’afficher un nom : préférez authors: dès qu’il faut afficher une bio.

4. Ce qui s’affiche où

• Signature en haut d’article : tous les noms de authors:, séparés par « & ».
• En bas d’article : un encadré par personne (photo si avatar renseigné, rôle, bio, réseaux propres). Si deux auteurs ou plus, les encadrés se placent côte à côte sur grand écran.
• Cartes de la page (page d’accueil, listes, « Poursuivre la lecture ») : inchangées, elles n’affichent jamais la liste des auteurs, seulement la rubrique et la date.

5. Checklist

• Fiche ajoutée dans _data/collaborateurs.yml, avec un name identique au mot près à celui utilisé dans authors:
• Photo déposée dans assets/images/collaborateurs/ si une photo est fournie
• authors: renseigné dans le front matter de l’article, dans l’ordre d’affichage souhaité
• Aperçu de l’article vérifié : les deux encadrés bio s’affichent correctement en bas de page