Aller au contenu

Choisir les destinations d'un article et prévisualiser son rendu web

Vous êtes auteur·ice sur Kirexo et vous voulez choisir vers quels canaux un article sera diffusé et prévisualiser à quoi il ressemblera sur votre site web avant de publier. Cette recette couvre les deux gestes, qui se font depuis l'éditeur d'article, dans le même bloc « Destinations ».

Prérequis

  • Être connecté·e à votre espace utilisateur. Si ce n'est pas le cas, commencez par vous connecter.
  • Avoir un article ouvert dans l'éditeur (/u/articles/{id}/edition). Pour créer et rédiger un article, voir Écrire, enregistrer et publier un article.
  • Avoir au moins un plugin de diffusion activé sur votre compte. Un plugin non activé n'apparaît pas dans les destinations.

Choisir les destinations de publication

Dans la barre d'outils en haut de l'éditeur (à côté du bouton « Aperçu »), un bloc « Destinations » présente une carte par canal de diffusion activé sur votre compte. Aujourd'hui, le seul canal disponible est Web ; d'autres (RSS, Mastodon, API…) apparaîtront à mesure que leurs plugins arrivent, chacun dans sa propre carte, empilée sous la précédente.

Chaque carte réunit deux éléments qui vont ensemble :

  • un interrupteur (switch) qui active ou désactive ce canal comme destination de l'article ;
  • un bouton d'aperçu propre au canal (voir Prévisualiser l'article).

À propos de l'interrupteur :

  • Il porte le nom du canal (par exemple Web) et une pastille de couleur propre à ce canal.
  • Activer l'interrupteur ajoute ce canal aux destinations de l'article ; le désactiver le retire.
  • La sélection est enregistrée automatiquement dès que vous basculez un interrupteur : il n'y a aucun bouton à valider.
  • L'interrupteur est utilisable au clavier (Tab pour l'atteindre, Espace pour le basculer) et son état activé/désactivé est annoncé par les lecteurs d'écran.

Par défaut : publier partout

Sur un article neuf, toutes les destinations sont activées : Kirexo publie « partout », c'est-à-dire vers tous les plugins activés sur votre compte. Vous n'avez rien à faire si ce comportement vous convient.

Désactivez uniquement les canaux vers lesquels vous ne voulez pas diffuser cet article en particulier. Votre choix est propre à cet article et n'affecte pas les autres.

Règle : au moins une destination

Un article doit toujours garder au moins une destination activée. Quand il ne reste plus qu'un seul interrupteur activé, il ne peut plus être désactivé : l'action est sans effet et l'interrupteur reste activé. Pour retirer ce dernier canal, activez-en d'abord un autre.

Le cadenas « activé et utilisé »

Un petit cadenas (🔒) peut apparaître à côté d'un canal. Il signale que ce plugin est activé et déjà utilisé sur votre compte. C'est une indication informative : elle ne bloque pas l'interrupteur, vous restez libre d'activer ou désactiver ce canal pour l'article courant (dans la limite de la règle « au moins une destination »).

Aucune destination proposée

Si le bloc affiche « Aucune destination active : activez un plugin dans vos réglages. », c'est qu'aucun canal de diffusion n'est activé sur votre compte. Activez un plugin dans vos réglages pour voir apparaître sa carte.

Prévisualiser l'article sur son site web

L'aperçu ne vit plus dans un bouton isolé de la barre d'outils : il est regroupé avec l'interrupteur, dans la carte de la destination concernée. Pour le canal Web, ce bouton s'appelle « Aperçu Web ».

Le bouton d'aperçu n'est actif que si la destination est activée.

  • Quand l'interrupteur Web est activé, « Aperçu Web » est cliquable : il ouvre dans un nouvel onglet le rendu de votre article tel qu'il apparaîtrait sur le site du carnet de cet article. L'aperçu se fait toujours dans le site du carnet de l'article, jamais dans le site d'un autre de vos carnets.
  • Quand l'interrupteur Web est désactivé, « Aperçu Web » est grisé et non cliquable. Réactivez la destination Web pour le rendre disponible.

Une fois « Aperçu Web » cliqué :

  1. Un nouvel onglet s'ouvre avec l'article dans le thème appliqué au site de son carnet : le même en-tête, le même pied de page et le même style, exactement comme un lecteur les verrait. Changer de thème change donc aussi l'aperçu — voir Choisir l'apparence de son site.
  2. Le contenu affiché est celui de votre travail en cours — pas nécessairement la version publiée. Un bandeau rappelle qu'il s'agit d'un aperçu d'une révision de travail, non publiée.

L'aperçu ne publie rien

Ouvrir un aperçu ne publie ni ne modifie l'article. C'est une simple visualisation. Comme votre contenu est enregistré automatiquement au fil de la frappe, l'aperçu reflète votre dernier état enregistré.

Différence avec le bouton « Aperçu »

Le bouton « Aperçu » (dans la barre d'outils) bascule la zone d'écriture vers le rendu du markdown dans l'éditeur (même onglet), sans le décor du site. Le bouton « Aperçu Web » (dans la carte de destination) montre l'article dans la mise en page complète de votre site, dans un onglet séparé.

Chaque canal apporte son propre aperçu

Le bouton d'aperçu n'est pas propre au Web : c'est chaque plugin qui décide s'il sait prévisualiser un article, et à quoi ressemble ce rendu. Quand un futur canal (RSS, Mastodon…) saura se prévisualiser, sa carte affichera son propre bouton d'aperçu, avec la même règle « actif seulement si la destination est activée ». Le pourquoi de ce mécanisme est décrit dans Comment un plugin s'intègre à l'éditeur : destinations et aperçu.

Si le plugin web n'est pas activé

Le rendu sur site web dépend du plugin web. Si vous n'avez pas encore activé ce plugin, sa carte n'apparaît pas dans les destinations. Une fois le plugin activé dans vos réglages, sa carte — et son bouton « Aperçu Web » — deviennent disponibles.

Si le carnet de l'article n'a pas encore de site

L'aperçu web se fait dans le site du carnet de l'article. Tant que ce carnet n'a aucun domaine rattaché, il n'a pas encore de site : l'aperçu affiche alors un écran d'indisponibilité au lieu du rendu. Rattachez d'abord un domaine au carnet pour lui créer un site — voir Configurer le site web d'un carnet. L'article apparaîtra sur ce site dès qu'il sera publié vers le web.

Voir aussi