Publish the Site · Docusaurus

Docusaurus Facebook {.docImage}

Ensuite, nous allons apprendre à publier le site sur le WWW pour que tout le monde puisse y naviguer ! Dans le cadre du tutoriel, nous utiliserons les pages GitHub pour héberger notre site Web. Mais vous pouvez utiliser n'importe quel service d'hébergement de fichiers statique que vous voulez, comme Netlify, Amazon S3, etc.

Mettre le site en ligne

Modifiez le fichier docusaurus-tutorial/website/siteConfig.js et remplissez les valeurs suivantes :

const siteConfig = { ... url: 'https://USERNAME.github.io', // Remplacez USERNAME avec votre nom d'utilisateur GitHub. baseUrl: '/docusaurus-tutorial/', // Le nom de votre projet GitHub. projectName: 'docusaurus-tutorial', // Le nom de votre projet GitHub. Identique au précédent. organizationName: 'USERNAME' // Votre nom d'utilisateur GitHub. ... }

Dans le Terminal ou Git Bash, tuez le serveur web en appuyant sur Cmd+C ou Ctrl+C.
Dans le répertoire website, exécutez npm run build ou yarn build. La commande génère un répertoire build dans le répertoire website contenant des fichiers HTML (et d'autres types de fichiers) pour toutes vos documentations et autres pages. Assurez-vous que le répertoire docusaurus-tutorial/website/build est créé avec succès avant d'exécuter l'étape suivante.
Remplacez USERNAME par votre nom d'utilisateur GitHub et exécutez la commande suivante.

GIT_USER=USERNAME CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages # SSH
# ou
GIT_USER=USERNAME CURRENT_BRANCH=master npm run publish-gh-pages # HTTPS

Les fichiers HTML (et d'autres types de fichiers) sont poussés dans la branche gh-pages de votre dépôt : https://github.com/USERNAME/docusaurus-tutorial.

Allez sur https://USERNAME.github.io/docusaurus-tutorial/ et regardez votre site en action !

Notez que lorsque vous exécutez à nouveau npm run start, la baseUrl fera désormais partie du chemin.