Aller au contenu

Version imprimable multipages. .

Retour à la version par défaut.

Tutoriel

Apprendre le projet en réalisant une petite modification complète.

Suivez une tâche de bout en bout plutôt qu’une suite de faits isolés.

1 - Réaliser votre première modification

Effectuer une petite modification et la vérifier localement.

Ce tutoriel modèle une tâche complète : préparer, modifier, vérifier et relire.

Partir d’un état connu

git status --short
git switch -c docs/first-change

Modifier une seule chose

Changez une chaîne visible ou une petite valeur de configuration. La première tâche doit rester assez ciblée pour que son résultat soit évident.

Vérifier

Exécutez le contrôle pertinent le plus petit, puis ouvrez la surface modifiée et inspectez-la vous-même.

2 - Ajouter une page de documentation

Créer une page, la placer dans la barre latérale et la relier.

Dans OINK, l’arborescence du contenu devient la barre latérale. Un nouveau fichier Markdown crée une nouvelle page.

Créer le fichier

---
title: Nouvelle capacité
description: Ce que fait cette capacité.
weight: 30
---

Expliquez la capacité ici.

Enregistrez-le sous content/docs/reference/new-capability.md.

Ajouter les traductions

Créez new-capability.zh.md et new-capability.fr.md à côté. Gardez les identifiants explicites des titres alignés entre les langues.

Prévisualiser

Lancez hugo server, ouvrez la nouvelle page et utilisez le sélecteur de langue pour vérifier chaque traduction.