Écrire, enregistrer et publier un article¶
Vous êtes auteur·ice sur Kirexo et vous voulez rédiger un article, le voir enregistré au fil de la frappe, puis le publier, le dépublier, le mettre à la corbeille ou le restaurer. Cette recette couvre tout le parcours d'écriture depuis le navigateur.
Prérequis¶
- Être connecté·e à votre espace utilisateur. Si ce n'est pas le cas, commencez par vous connecter.
- L'écriture et la publication se font toujours depuis l'espace utilisateur (
/u), jamais depuis l'administration : l'admin gère les comptes, pas le contenu.
Créer un article¶
- Depuis l'accueil de votre espace utilisateur (
/u), cliquez sur le bouton « Écrire » d'un carnet. - Un brouillon vide est créé immédiatement et vous êtes redirigé·e vers l'éditeur (
/u/articles/{id}/edition).
L'article démarre au statut Brouillon et porte le titre provisoire « Article sans titre » tant que vous n'avez rien saisi. Le titre se déduit ensuite automatiquement de votre contenu (voir Le titre se déduit du contenu).
L'éditeur markdown¶
L'éditeur s'appuie sur Milkdown : vous écrivez du markdown, mais le rendu est mis en forme en direct (WYSIWYG). Une toolbar surplombe la zone de saisie ; elle est entièrement opérable au clavier (focusable, navigable au Tab) et chaque bouton de marque reflète l'état actif via aria-pressed :
| Bouton | Effet |
|---|---|
| B (Gras) | Met le texte sélectionné en gras |
| I (Italique) | Met le texte sélectionné en italique |
| H (Titre) | Transforme le bloc courant en titre (niveau 2) |
| • Liste | Liste à puces |
| 1. Liste | Liste numérotée |
| ❝ Citation | Bloc de citation |
| S (Barré) | Met le texte sélectionné en barré |
| </> (Code) | Code inline sur la sélection |
| ↗ (Lien) | Pose un lien : l'URL est demandée dans une invite |
| — (Filet horizontal) | Insère un filet horizontal (séparateur) |
Formats volontairement limités
L'éditeur n'autorise que ces dix formats : gras, italique, barré, code inline, lien, titre, liste à puces, liste numérotée, citation, filet horizontal. Il n'y a pas de tableaux, d'images, de blocs de code, de formules LaTeX ni d'assistance IA dans l'éditeur — l'écriture reste centrée sur le texte.
La bulle de mise en forme sur sélection¶
Quand vous sélectionnez du texte, une petite bulle apparaît au-dessus de la sélection avec les marques applicables en place : Gras, Italique, Barré, Code et Lien. C'est un raccourci vers les mêmes actions que la toolbar, sans remonter le curseur. La bulle ne s'affiche que sur une sélection de texte non vide ; elle disparaît dès que la sélection est levée.
Le collage¶
Au collage, le HTML est converti en markdown assaini ; Ctrl+Shift+V colle en texte brut. Les images collées sont ignorées (la gestion des médias n'est pas couverte par cette étape).
La poignée de bloc¶
À gauche de chaque bloc, dans la gouttière, une poignée façon Obsidian s'aligne automatiquement sur le bloc où clignote le curseur (et non sous la souris). Elle suit le curseur tant que l'éditeur a le focus. Elle porte deux commandes :
- « + » — insérer un bloc : ouvre une petite pop-in proposant les blocs autorisés : Titre, Liste à puces, Liste numérotée, Citation, Filet horizontal. Choisissez un type pour l'appliquer au bloc courant. Un clic en dehors de la pop-in la referme.
- « ⠿ » — réordonner par glisser-déposer : attrapez cette poignée et faites glisser le bloc vers le haut ou le bas. Pendant le déplacement, une ligne d'insertion indique où le bloc atterrira ; relâchez pour valider. Une fois déposé, le curseur repart sur le bloc déplacé.
Cliquer dans la marge¶
Un clic dans la marge ou la zone vide du canevas (à gauche, à droite ou sous le texte) place le curseur sur la ligne la plus proche du point cliqué. Inutile de viser précisément le texte pour reprendre l'écriture.
Prévisualiser le rendu¶
Le bouton « Aperçu » (en haut, à côté des actions) bascule la zone d'écriture vers un rendu HTML du markdown, identique à ce que verront vos lecteurs : c'est le rendu serveur assaini (même moteur que la version publiée). Le bouton devient alors « Écrire » ; cliquez-le pour revenir à la saisie. L'aperçu ne modifie rien : il n'enregistre pas et ne publie pas.
Le titre se déduit du contenu¶
Vous n'avez pas de champ titre séparé : le titre est dérivé automatiquement de la première ligne de votre contenu à chaque enregistrement. Commencez votre article par un titre de niveau 1 (# Mon titre) ou une première phrase claire : c'est elle qui devient le titre de l'article.
L'enregistrement automatique (autosave)¶
Vous n'avez aucun bouton « Enregistrer » à actionner pour le contenu : l'éditeur enregistre tout seul.
- L'enregistrement se déclenche ~1,5 seconde après votre dernière frappe (le délai est réarmé à chaque touche) et aussi quand l'éditeur perd le focus (blur).
- Une zone de statut sous l'éditeur (annoncée aux lecteurs d'écran via
aria-live) affiche l'état en cours :
| Message | Signification |
|---|---|
| Enregistrement… | La sauvegarde est en cours d'envoi. |
| Enregistré il y a … | Le contenu de travail est à jour côté serveur ; l'horodatage est affiché en temps relatif (« à l'instant », « il y a 3 min », « il y a 2 h », ou la date au-delà d'un jour) et se rafraîchit tout seul. |
| Échec — nouvelle tentative… | L'envoi a échoué ; Kirexo retente automatiquement, avec un délai croissant, jusqu'à réussir. |
| Hors-ligne — sera enregistré | Vous êtes déconnecté·e du réseau ; la sauvegarde est mise en attente. |
Ce que l'autosave enregistre
L'autosave ne modifie que le contenu de travail de l'article — jamais la version publiée visible par vos lecteurs. Pour comprendre cette distinction, voir Contenu de travail, contenu publié et corbeille.
Nombre de mots et temps de lecture¶
Un pied de page sous l'éditeur affiche en continu le nombre de mots de votre contenu et un temps de lecture estimé (environ 200 mots/minute, au minimum « ~1 min »). Ces indicateurs se mettent à jour à la frappe.
Reprendre après une coupure réseau¶
Si vous perdez la connexion en cours d'écriture :
- Continuez à écrire normalement : la zone de statut affiche « Hors-ligne — sera enregistré ».
- Kirexo conserve votre dernière version (les versions intermédiaires périmées sont écartées — seul le dernier état compte).
- Dès que la connexion revient, la sauvegarde est rejouée automatiquement et le statut repasse à « Enregistré ». Vous n'avez rien à faire.
Éditer depuis plusieurs onglets¶
Vous pouvez ouvrir le même article dans plusieurs onglets (ou sur plusieurs appareils) : Kirexo synchronise le contenu en temps réel.
- Quand un onglet enregistre, les autres onglets ouverts sur le même article reçoivent la mise à jour et reflètent le nouveau contenu.
- L'onglet où vous êtes en train de taper (celui qui a le focus) n'est pas écrasé : seuls les onglets inactifs se mettent à jour.
Cette synchronisation passe par un canal privé propre à votre article ; le détail technique est décrit dans Contenu de travail, contenu publié et corbeille.
La synchro ne bloque jamais la sauvegarde
La mise à jour des autres onglets est best-effort : si le service de synchronisation est momentanément indisponible, votre sauvegarde aboutit quand même — seul le rafraîchissement en direct des autres onglets est différé.
Publier l'article¶
Sur un brouillon (ou un article dépublié), cliquez sur « Publier ».
- L'article passe au statut Publié et une version figée de votre contenu (une révision) est créée : c'est elle que verront vos lecteurs.
- Vous pouvez continuer à modifier le contenu de travail sans impacter la version publiée.
Publier des modifications (republier)¶
Une fois l'article publié, si vous continuez à l'éditer, le bouton « Publier les modifications » apparaît. Cliquez dessus pour figer une nouvelle révision à partir de votre contenu de travail courant — la date de première publication reste inchangée.
Dépublier l'article¶
Sur un article publié, le formulaire « Dépublier » est disponible. Une URL de redirection est obligatoire : c'est l'adresse vers laquelle seront renvoyés les visiteurs qui tenteraient d'accéder à l'article retiré.
- Renseignez l'URL de redirection (interne ou externe).
- Cliquez sur « Dépublier ».
Si vous laissez le champ vide, la dépublication est refusée et un message vous le signale : aucune dépublication n'a lieu tant qu'une cible de redirection n'est pas fournie.
Mettre à la corbeille et restaurer¶
- Mettre à la corbeille : le bouton « Mettre à la corbeille » retire l'article (il passe au statut Corbeille) et vous ramène à votre dashboard. À partir de ce moment, un compte à rebours de 30 jours démarre.
- Restaurer : depuis un article en corbeille, le bouton « Restaurer » le ramène au statut Brouillon et arrête le compte à rebours.
Purge automatique à 30 jours
Un article resté en corbeille plus de 30 jours est définitivement supprimé (lui et tout son historique de publication), automatiquement, une fois par jour. Restaurez-le avant ce délai si vous voulez le conserver. Le mécanisme est détaillé dans Contenu de travail, contenu publié et corbeille ; la commande qui l'exécute est documentée dans la Référence de app:articles:purge-trashed.
Voir aussi¶
- Contenu de travail, contenu publié et corbeille — pourquoi l'éditeur distingue contenu de travail et révisions publiées, et comment fonctionne la synchronisation temps réel.
- Commande
app:articles:purge-trashed— la purge automatique de la corbeille, exécutable aussi à la main. - Se connecter à Kirexo — accéder à votre espace utilisateur.