<!DOCTYPE html><htmllang="fr"><head><metacharSet="utf-8"/><metahttp-equiv="X-UA-Compatible"content="IE=edge"/><title>Add Versions · Docusaurus</title><metaname="viewport"content="width=device-width"/><metaname="generator"content="Docusaurus"/><metaname="description"content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus &mdash; la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente pour la version actuelle d'un outil et à masquer la documentation non publiée aux utilisateurs, ce qui réduit la confusion. La documentation pour les anciennes versions est également conservée et accessible aux utilisateurs des anciennes versions d'un outil, même lorsque la dernière documentation est modifiée."/><metaname="docsearch:version"content="1.14.6"/><metaname="docsearch:language"content="fr"/><metaproperty="og:title"content="Add Versions · Docusaurus"/><metaproperty="og:type"content="website"/><metaproperty="og:url"content="https://docusaurus.io/"/><metaproperty="og:description"content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus &mdash; la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente pour la version actuelle d'un outil et à masquer la documentation non publiée aux utilisateurs, ce qui réduit la confusion. La documentation pour les anciennes versions est également conservée et accessible aux utilisateurs des anciennes versions d'un outil, même lorsque la dernière documentation est modifiée."/><metaproperty="og:image"content="https://docusaurus.io/img/docusaurus.png"/><metaname="twitter:card"content="summary"/><metaname="twitter:image"content="https://docusaurus.io/img/docusaurus.png"/><linkrel="shortcut icon"href="/img/docusaurus.ico"/><linkrel="stylesheet"href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><linkrel="stylesheet"href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><linkrel="alternate"type="application/atom+xml"href="https://docusaurus.io/blog/atom.xml"title="Docusaurus Blog ATOM Feed"/><linkrel="alternate"type="application/rss+xml"href="https://docusaurus.io/blog/feed.xml"title="Docusaurus Blog RSS Feed"/><script>
</script></nav></div><divclass="container mainContainer docsContainer"><divclass="wrapper"><divclass="post"><headerclass="postHeader"><aclass="edit-page-link button"href="https://crowdin.com/project/docusaurus/fr"target="_blank"rel="noreferrer noopener">Translate</a><h1id="__docusaurus"class="postHeaderTitle">Add Versions</h1></header><article><div><span><p>Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus — la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente pour la version actuelle d'un outil et à masquer la documentation non publiée aux utilisateurs, ce qui réduit la confusion. La documentation pour les anciennes versions est également conservée et accessible aux utilisateurs des anciennes versions d'un outil, même lorsque la dernière documentation est modifiée.</p>
<p>Supposons que vous soyez satisfait de l'état actuel de la documentation et que vous vouliez la geler comme la documentation v1.0.0. Tout d'abord, vous <code>cd</code> dans le répertoire <code>website</code> et exécutez la commande suivante.</p>
<p>Cette commande préserve une copie de tous les documents actuellement dans le répertoire <code>docs</code> et les rend disponibles en tant que documentation pour la version 1.0.0. Le répertoire <code>docs</code> est copié dans le répertoire <code>website/versioned_docs/version-1.0.0</code>.</p>
<p>Tapez <code>npm start</code> et vous verrez la version à côté du titre. Version 1.0.0, qui est le numéro de votre version actuelle, apparaît à l'URL <ahref="http://localhost:3000/docusaurus-tutorial/docs/doc1">http://localhost:3000/docusaurus-tutorial/docs/doc1</a>.</p>
<p>Testons comment le versionnage fonctionne réellement. Ouvrez <code>docs/doc1.md</code> et changez la première ligne du corps :</p>
<p>Si vous allez sur <ahref="http://localhost:3000/docusaurus-tutorial/docs/doc1">http://localhost:3000/docusaurus-tutorial/docs/doc1</a> dans votre navigateur, vous vous rendez compte qu'il affiche toujours la ligne avant le changement. C'est parce que la version que vous regardez est la version 1.0.0, qui a déjà été figée dans le temps. Le document que vous avez modifié fait partie de la prochaine version.</p>
<p>La dernière version des documents est consultable en ajoutant <code>next</code> à l'URL : <ahref="http://localhost:3000/docusaurus-tutorial/docs/next/doc1">http://localhost:3000/docusaurus-tutorial/docs/next/doc1</a>. Maintenant vous pouvez voir le changement de ligne à "Ceci est la dernière version de la documentation." Notez que la version à côté du titre passe à "next" lorsque vous ouvrez cette URL.</p>
<p>Cliquez sur la version pour ouvrir la page des versions, qui a été créée à l'adresse <ahref="http://localhost:3000/docusaurus-tutorial/versions">http://localhost:3000/docusaurus-tutorial/versions</a> avec une liste des versions de la documentation. Vous voyez que <code>1.0.0</code> et <code>master</code> y sont listées et qu'elles sont liées aux versions respectives de la documentation.</p>
<p>Les documents de master du répertoire <code>docs</code> sont devenus la version next lorsque le répertoire <code>website/versioned_docs/version-1.0.0</code> a été créé pour la version 1.0.0.</p>
<p>Supposons que la documentation ait été modifiée et qu'elle ait besoin d'une mise à jour. Vous pouvez publier une autre version, comme la <code>1.0.1</code>.</p>
<p>La version 1.0.0 reste disponible en version antérieure. Vous pouvez le voir en ajoutant <code>1.0.0</code> à l'URL, <ahref="http://localhost:3000/docusaurus-tutorial/docs/1.0.0/doc1">http://localhost:3000/docusaurus-tutorial/docs/1.0.0/doc1</a>. Un lien vers la version 1.0.0 apparaît également sur la page des versions.</p>
<p>Allez-y et <ahref="https://docusaurus.io/docs/en/next/tutorial-publish-site">publiez</a> votre site versionné avec le script <code>publish-gh-pages</code> !</p>
<p>C'est fini, Mesdames Messieurs ! Dans ce court tutoriel, vous avez pu constater à quel point il est facile de créer un site Web de documentation à partir de zéro et de créer des versions. Il y a bien d'autres choses que vous pouvez faire avec Docusaurus, comme ajouter un blog, rechercher et traduire. Consultez la section <ahref="https://docusaurus.io/docs/en/next/versioning">Guide</a> pour en savoir plus.</p>
</span></div></article></div><divclass="docs-prevnext"><aclass="docs-prev button"href="/docs/fr/tutorial-publish-site"><spanclass="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><navclass="onPageNav"><ulclass="toc-headings"><li><ahref="#libérer-une-version">Libérer une version</a><ulclass="toc-headings"><li><ahref="#version-actuelle">Version actuelle</a></li><li><ahref="#prochaine-version">Prochaine version</a></li><li><ahref="#versions-antérieures">Versions antérieures</a></li></ul></li><li><ahref="#récapitulatif">Récapitulatif</a></li></ul></nav></div><footerclass="nav-footer"id="footer"><sectionclass="sitemap"><ahref="/"class="nav-home"><imgsrc="/img/docusaurus_monochrome.svg"alt="Docusaurus"width="66"height="58"/></a><divclass="footerSection"><h5>Docs</h5><ahref="
