<!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, initial-scale=1.0"/><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.7"/><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>
function createToggler(togglerSelector, targetSelector, className) {
var toggler = document.querySelector(togglerSelector);
var target = document.querySelector(targetSelector);
if (!toggler) {
return;
}
toggler.onclick = function(event) {
event.preventDefault();
target.classList.toggle(className);
};
}
});
</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>
<pre><codeclass="hljs css language-sh">npm run examples versions
</code></pre>
<p>That command generates a <code>versions.json</code> file, which will be used to list down all the versions of docs in the project.</p>
<p>Ensuite, vous exécutez une commande avec la version que vous voulez créer, comme <code>1.0.0</code>.</p>
<pre><codeclass="hljs css language-sh">npm run version 1.0.0
</code></pre>
<p>That command preserves a copy of all documents currently in the <code>docs</code> directory and makes them available as documentation for version 1.0.0. The <code>docs</code> directory is copied to the <code>website/versioned_docs/version-1.0.0</code> directory.</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>
<spanclass="hljs-deletion">- Vérifiez la [documentation](https://docusaurus.io) pour savoir comment utiliser Docusaurus.</span>
<spanclass="hljs-addition">+ Ceci est la dernière version de la documentation.</span>
## Lorem
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies.
</code></pre>
<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>. Now you can see the line change to "This is the latest version of the docs." Note that the version beside the title changes to "next" when you open that 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>
<pre><codeclass="hljs css language-sh">npm run version 1.0.1
</code></pre>
<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>Go ahead and <ahref="https://v1.docusaurus.io/docs/en/next/tutorial-publish-site">publish</a> your versioned site with the <code>publish-gh-pages</code> script!</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. Check out the <ahref="https://v1.docusaurus.io/docs/en/next/versioning">Guides</a> section for more.</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="
