Guide de style du wiki
Ce guide fixe les règles éditoriales du wiki HeavenCube. Son objectif est de produire des pages naturelles en français, faciles à parcourir et fiables pour les nouveaux joueurs.
Principes essentiels
- Expliquez une fonctionnalité avant de donner ses commandes.
- Définissez chaque terme technique lors de sa première utilisation.
- Utilisez des phrases courtes et adressez-vous directement au joueur.
- Ne confirmez jamais une mécanique propre au serveur sans source.
- Utilisez les accents, les apostrophes et la ponctuation françaises.
Structure recommandée
Une page de fonctionnalité peut contenir :
- une introduction qui répond à « à quoi cela sert-il ? » ;
- des prérequis utiles ;
- le moyen d’accéder à la fonctionnalité ;
- un guide étape par étape ;
- les commandes confirmées ou les champs à renseigner ;
- un exemple concret ;
- les erreurs fréquentes ;
- des conseils et questions fréquentes ;
- des pages associées et des backlinks.
Ne créez pas une section vide uniquement pour respecter ce modèle.
Informations inconnues
Utilisez un champ en majuscules qui décrit exactement la donnée attendue :
[COMMANDE DU MENU DES MÉTIERS]
[PRIX DE CRÉATION D’UN PWARP]
[NOMBRE MAXIMAL DE PROTECTIONS]
[DÉLAI HABITUEL DE RÉPONSE DU SUPPORT]Dans le texte visible, regroupez les incertitudes dans un seul avertissement :
!!!warning Information à confirmer
Cette partie sera complétée dès que les informations exactes du serveur auront été vérifiées.
!!!Composants Retype
!!!warning Titre clair
Expliquez ce qui manque et qui doit le confirmer.
!!!+++ Édition Java
Étapes pour Java.
+++ Édition Bedrock
Étapes pour Bedrock.+++ Carte
```md
[!card layout="compact" title="Rejoindre" text="Préparer Minecraft." icon="sign-in"](../rejoindre.md)[!button text="Rejoindre HeavenCube" icon="sign-in"](../rejoindre.md)Images
Ne générez pas d’image pour remplir un espace. Utilisez un commentaire éditorial lorsque le propriétaire doit fournir une capture :
<!--
IMAGE À AJOUTER
Sujet : menu réel des protections de terrain avec les permissions visibles
Fichier recommandé : assets/images/menu-protections.webp
Dimensions recommandées : 1000 × 1000 px
Format recommandé : WebP
Texte alternatif : Menu des permissions d’une protection de terrain
-->
<!--  -->Dimensions recommandées
Arborescence éditoriale
/
├─ README.md
├─ rejoindre.md
├─ premiers-pas.md
├─ reglements.md
├─ survie/
│ ├─ README.md
│ └─ [pages des fonctionnalités]
├─ creatif/
│ └─ README.md
├─ utilitaire/
│ ├─ README.md
│ └─ [pages d’aide]
└─ contributeurs/
├─ README.md
└─ [guides de contribution]Vérifications
Questions fréquentes
Les noms de fichiers doivent-ils contenir des accents ?
Non. Les noms peuvent rester en minuscules, sans espace ni accent, afin de conserver des URL simples. Les textes visibles doivent toutefois être écrits en français correct.
Peut-on publier une commande avec la mention « à confirmer » ?
Non. Remplacez-la par un champ précis comme [COMMANDE DE RETOUR AU POINT D’ACCUEIL] jusqu’à sa validation.
Comment nommer une image ?
Utilisez un nom descriptif comme menu-quetes.webp ou zone-accueil.webp.