Introduction au tutoriel
Découvrons Docusaurus en moins de 5 minutes.
Pour commencer
Commencez par créer un nouveau site.
Ou essayez Docusaurus immédiatement avec docusaurus.new.
Ce dont vous aurez besoin
- Node.js version 18.0 ou supérieure :
- Lors de l'installation de Node.js, il est recommandé de cocher toutes les cases relatives aux dépendances.
Générer un nouveau site
Générez un nouveau site Docusaurus à l'aide du modèle classique.
Le modèle classique sera automatiquement ajouté à votre projet après avoir exécuté la commande :
npm init docusaurus@latest my-website classic
Vous pouvez saisir cette commande dans l'invite de commande, Powershell, Terminal ou tout autre terminal intégré à votre éditeur de code.
La commande installe également toutes les dépendances nécessaires à l'exécution de Docusaurus.
Démarrez votre site
Exécutez le serveur de développement :
cd my-website
npm run start
La commande cd modifie le répertoire dans lequel vous travaillez. Pour travailler avec votre site Docusaurus nouvellement créé, vous devez naviguer jusqu'à celui-ci dans le terminal.
La commande npm run start construit votre site web localement et le diffuse via un serveur de développement, prêt à être consulté à l'adresse http://localhost:3000/.
Ouvrez docs/intro.md (cette page) et modifiez quelques lignes : le site se recharge automatiquement et affiche vos modifications.