Publish the Site
{.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 par exemple Netlify, Amazon S3, etc.
Mettre le site en ligne
Tuez d'abord le serveur web en appuyant sur Cmd + C ou Ctrl + C selon votre système d'exploitation.
Dans website/siteConfig.js
, remplissez les champs suivants :
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 répertoire
website
, exécuteznpm run build
ouyarn build
. Cela va générer un dossierbuild
dans le dossierwebsite
contenant les fichiers.html
de toute votre documentation et d'autres pages incluses danspages
. Assurez-vous que le répertoirebuild
est là avant d'exécuter l'étape suivante.Remplacez
<GIT_USER>
par votre nom d'utilisateur GitHub et exécutez la commande suivante.$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages
Le code construit sera poussé dans la branche gh-pages
de votre dépôt.
- Allez sur
https://USERNAME.github.io/docusaurus-tutorial/
et regardez votre site en action !
Notez que lorsque vous exécutez à nouveau
npm run start
, labaseUrl
fera désormais partie du chemin.