Aller au contenu principal

Versions Canary

Docusaurus a un système de versions canary.

It permits you to test new unreleased features as soon as the pull requests are merged.

It is a good way to give feedback to maintainers, ensuring the newly implemented feature works as intended.

remarque

Utiliser une version canary en production peut sembler risqué, mais en pratique, ce n'est pas le cas.

Une version canary passe tous les tests automatisés et est utilisée en production par le site Docusaurus lui-même.

attention

The canary version shown below may not be up-to-date. Please go to the npm page to find the actual version name.

Canary npm dist tag​

For any code-related commit on main, the continuous integration will publish a canary release under the @canary npm dist tag. Cela prend généralement jusqu'à 10 minutes.

You can see on npm the current dist tags:

  • latest: stable releases (Current: 3.9.2)
  • canary: canary releases (Exemple : 0.0.0-4922)
astuce

Make sure to use the latest canary release and check the publication date (sometimes the publish process fails).

remarque

Canary versions follow the naming convention 0.0.0-commitNumber.

Utilisation d'une version canary​

Take the latest version published under the canary npm dist tag (Exemple : 0.0.0-4922).

Use it for all the @docusaurus/* dependencies in your package.json:

-  "@docusaurus/core": "^3.9.2",
-  "@docusaurus/preset-classic": "^3.9.2",
+  "@docusaurus/core": "0.0.0-4922",
+  "@docusaurus/preset-classic": "0.0.0-4922",

Ensuite, réinstallez les dépendances et démarrez votre site :

npm install
npm start

You can also upgrade the @docusaurus/* packages with command line:

npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary
attention

Make sure to include all the @docusaurus/* packages.

For canary releases, prefer using an exact version instead of a semver range (avoid the ^ prefix).