<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="fr">
<id>https://ardo-docs.dev/fr/news/</id><title>Ardo News</title>
<link rel="self" href="https://ardo-docs.dev/fr/news/atom.xml"/><link href="https://ardo-docs.dev/fr/news/"/>
<updated>2026-11-01T22:02:42.000Z</updated>
<entry><id>urn:ardo:post:e26831f6-8a6f-45c9-9683-c51b25f88161</id><title>Ardo 6.1 : une place pour les actualités</title><link href="https://ardo-docs.dev/fr/news/ardo-6-1/"/><published>2026-11-01T22:02:42.000Z</published><updated>2026-11-01T22:02:42.000Z</updated><author><name>Sebastian Werner</name><uri>https://github.com/swernerx</uri></author><category term="Releases"/><content type="html">&lt;p&gt;Un projet a besoin d&amp;#39;un endroit pour expliquer ce qui vient de changer. Une
version mérite plus de contexte qu&amp;#39;une liste de commits, et une décision
technique peut être utile bien au-delà de sa pull request. Ardo 6.1 donne une
place à ces récits à côté de la documentation.&lt;/p&gt;
&lt;p&gt;Vous en lisez un en ce moment. Cette rubrique utilise la même fonction de
publication que tout projet Ardo : des articles écrits dans le dépôt et
compilés en pages statiques.&lt;/p&gt;
&lt;h2 id=&quot;des-articles-qui-restent-avec-le-projet&quot;&gt;Des articles qui restent avec le projet&lt;/h2&gt;
&lt;p&gt;Écrivez un article en Markdown ou MDX, puis indiquez dans le frontmatter son
titre, sa date de publication, un identifiant stable et ses auteurs. Ardo crée
sa page et un index chronologique. Les profils d&amp;#39;auteurs partagés regroupent
noms, portraits et liens ; un article peut créditer plusieurs personnes.&lt;/p&gt;
&lt;p&gt;Une publication commence par un répertoire source local et un registre d&amp;#39;auteurs :&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-ts&quot;&gt;import { defineArdoConfig } from &amp;quot;ardo/config&amp;quot;

export default defineArdoConfig({
  title: &amp;quot;My project&amp;quot;,
  siteUrl: &amp;quot;https://example.com&amp;quot;,
  publication: {
    from: &amp;quot;posts&amp;quot;,
    authors: { team: { name: &amp;quot;Project team&amp;quot; } },
  },
})
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Les lecteurs peuvent s&amp;#39;abonner par Atom ou RSS et recevoir l&amp;#39;article portable
complet. Lorsqu&amp;#39;un composant MDX demande une explication hors du site, une
version Markdown explicite rend le flux utile. Les brouillons et les articles
futurs restent exclus du résultat publié. Un article programmé devient
admissible lors d&amp;#39;une compilation effectuée à partir de sa date de publication.&lt;/p&gt;
&lt;h2 id=&quot;des-images-préparées-à-partir-des-originaux-locaux&quot;&gt;Des images préparées à partir des originaux locaux&lt;/h2&gt;
&lt;p&gt;Les images sources peuvent rester à côté de l&amp;#39;article. Ardo génère plusieurs
résolutions AVIF et un JPEG de secours, d&amp;#39;une largeur maximale de 1280 pixels.
Les fichiers générés appartiennent à la compilation ; le dépôt garde les
originaux.&lt;/p&gt;
&lt;p&gt;Une image conserve sa composition sans indication de cadrage. Des zones
centrales et préférées facultatives permettent de préparer des cadrages 16:10
et 4:3 en préservant le sujet. Les préréglages de présentation choisissent le
cadrage avec les conditions média de &lt;code&gt;picture&lt;/code&gt;, puis &lt;code&gt;srcset&lt;/code&gt; permet au
navigateur de sélectionner la résolution. Le traitement est local, avec Sharp
et libvips.&lt;/p&gt;
&lt;h2 id=&quot;des-versions-réservées-aux-pages-qui-en-ont-besoin&quot;&gt;Des versions réservées aux pages qui en ont besoin&lt;/h2&gt;
&lt;p&gt;L&amp;#39;adresse d&amp;#39;un article de version doit rester stable lorsque la documentation
passe à la version majeure suivante. Il en va de même pour la page d&amp;#39;accueil.&lt;/p&gt;
&lt;p&gt;Avec &lt;code&gt;versioning.directories&lt;/code&gt;, un projet sélectionne des dossiers complets de
documentation, comme &lt;code&gt;guide&lt;/code&gt; et &lt;code&gt;api-reference&lt;/code&gt;. Leurs pages conservent un
préfixe de version ; tout le reste reste indépendant de la version de la
documentation. Les sites existants gardent leur comportement jusqu&amp;#39;à
l&amp;#39;activation de cette option. Ce site l&amp;#39;utilise désormais pour séparer son
accueil, ses actualités, ses guides et sa référence API.&lt;/p&gt;
&lt;p&gt;La version ajoute aussi les vérifications de mise à jour dans la CLI et des
rapports d&amp;#39;utilisation facultatifs. Ces rapports nécessitent un consentement
explicite et sont distincts des vérifications de mise à jour. Les commandes
&lt;code&gt;ardo telemetry&lt;/code&gt; permettent de les consulter et de les gérer.&lt;/p&gt;
&lt;p&gt;Le &lt;a href=&quot;https://ardo-docs.dev/v6/fr/guide/publications/&quot;&gt;guide des publications&lt;/a&gt; explique les auteurs, les
images, les flux, la localisation et la configuration. Les métadonnées suivent
les noms de Standard.site lorsque cela s&amp;#39;applique ; la publication vers un
compte AT Protocol reste à venir. Les
&lt;a href=&quot;https://github.com/sebastian-software/ardo/releases/tag/ardo-v6.1.0&quot;&gt;notes de v6.1&lt;/a&gt;
contiennent la liste complète des changements.&lt;/p&gt;
</content></entry>
<entry><id>urn:ardo:post:b84b6328-070e-46de-97d6-7edcc1000d60</id><title>Ardo 6 : une documentation React servie en HTML</title><link href="https://ardo-docs.dev/fr/news/ardo-6/"/><published>2026-10-29T21:10:31.000Z</published><updated>2026-10-29T21:10:31.000Z</updated><author><name>Sebastian Werner</name><uri>https://github.com/swernerx</uri></author><category term="Releases"/><content type="html">&lt;p&gt;Ardo 6 change la façon dont une documentation arrive jusqu&amp;#39;à ses lecteurs.
Chaque page est construite comme un document HTML complet. Les guides, la
référence API et les données de recherche sont préparés avant le déploiement.
Le résultat peut être servi par un hébergement statique.&lt;/p&gt;
&lt;p&gt;Pour les auteurs, le point de départ reste familier : écrire en Markdown ou
MDX, intégrer des composants React et conserver le site à côté du code qu&amp;#39;il
explique. Cette version rend ce parcours plus direct.&lt;/p&gt;
&lt;h2 id=&quot;un-document-à-chaque-requête&quot;&gt;Un document à chaque requête&lt;/h2&gt;
&lt;p&gt;Ardo 6 retire React Router de l&amp;#39;architecture du site. Suivre un lien charge un
nouveau document. Son HTML contient déjà le contenu demandé, y compris le code
coloré et les descriptions d&amp;#39;API générées. React continue de faire fonctionner
les exemples interactifs et les commandes du site après l&amp;#39;hydratation.&lt;/p&gt;
&lt;p&gt;La configuration du projet évolue aussi. Ardo gère des versions compatibles de
React, React DOM et Vite. Un projet de documentation utilise les points
d&amp;#39;entrée React et la configuration JSX d&amp;#39;Ardo, avec moins de dépendances de
framework à coordonner lui-même.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://ardo-docs.dev/assets/posts/4a68e74e8668f3c03b5f.jpg&quot; alt=&quot;Un guide Ardo avec sa navigation par sections, sa table des matières et un exemple de configuration coloré.&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;des-outils-natifs-pour-la-préparation&quot;&gt;Des outils natifs pour la préparation&lt;/h2&gt;
&lt;p&gt;Ferromark compile Markdown et MDX en modules React. Ferriki colore les blocs de
code pendant la compilation et prépare les couleurs des thèmes clair et
sombre. Ces deux tâches sont terminées avant l&amp;#39;arrivée du lecteur.&lt;/p&gt;
&lt;p&gt;La référence API a elle aussi changé. Ardo lit les exports TypeScript avec le
compilateur TypeScript natif et construit lui-même la référence, remplaçant
l&amp;#39;intégration TypeDoc. Les composants et leurs props sont réunis ; signatures,
paramètres et commentaires deviennent des pages consultables dans la recherche.
Cette version utilise une nightly TypeScript 7 figée pour cette analyse.&lt;/p&gt;
&lt;p&gt;Le &lt;a href=&quot;https://github.com/sebastian-software/ardo/blob/ardo-v6.0.0/docs/reports/2026-10-29-release-benchmark.md&quot;&gt;rapport de benchmark de la version&lt;/a&gt;
décrit les tâches mesurées, la machine et les limites des temps publiés.&lt;/p&gt;
&lt;h2 id=&quot;la-structure-du-site-est-aussi-en-react&quot;&gt;La structure du site est aussi en React&lt;/h2&gt;
&lt;p&gt;En-têtes, barres latérales et pieds de page peuvent être composés comme enfants
de &lt;code&gt;ArdoRoot&lt;/code&gt;. Le thème, le logo et l&amp;#39;icône sont passés en JSX. L&amp;#39;apparence et la
mise en page se trouvent ainsi là où les développeurs React travaillent déjà
avec leurs composants.&lt;/p&gt;
&lt;p&gt;La lecture bénéficie également de nombreuses améliorations : les résultats de
recherche affichent des extraits, l&amp;#39;en-tête étroit laisse plus de place au
contenu et la compilation vérifie les liens internes et les fragments dans le
HTML produit. Les guides d&amp;#39;Ardo sont désormais disponibles en anglais,
allemand, français et espagnol, avec Palamedes pour gérer les traductions à
partir d&amp;#39;une source anglaise commune.&lt;/p&gt;
&lt;h2 id=&quot;migrer-un-site-existant-vers-v6&quot;&gt;Migrer un site existant vers v6&lt;/h2&gt;
&lt;p&gt;Il s&amp;#39;agit d&amp;#39;une version majeure. Les fichiers d&amp;#39;entrée et la configuration du
routeur disparaissent, la génération native des API remplace la configuration
TypeDoc et les paramètres de thème passent dans &lt;code&gt;ArdoRoot&lt;/code&gt;. Node.js 22.22 ou
une version plus récente est nécessaire.&lt;/p&gt;
&lt;p&gt;Le &lt;a href=&quot;https://ardo-docs.dev/v6/fr/guide/releases/upgrade-to-v6/&quot;&gt;guide de migration vers v6&lt;/a&gt; détaille ces
changements. Pour un nouveau site, commencez par
&lt;a href=&quot;https://ardo-docs.dev/v6/fr/guide/getting-started/&quot;&gt;Premiers pas&lt;/a&gt;. Les
&lt;a href=&quot;https://github.com/sebastian-software/ardo/releases/tag/ardo-v6.0.0&quot;&gt;notes complètes de v6.0&lt;/a&gt;
présentent chaque changement et chaque suppression.&lt;/p&gt;
</content></entry>
</feed>
