Wiki
Le Wiki de Cube Conflict utilise DokuWiki avec la template Bootstrap3.
La syntaxe principale repose sur le format md grâce au plugin Commonmark.
L’objectif est de maintenir un wiki clair, structuré et cohérent pour tous les contributeurs.
Règles de formatage
- La langue principale du wiki est l’anglais. Toutes les nouvelles pages doivent être nommées en anglais.
- Pour les noms composés, utiliser des underscores
_afin de séparer les mots.
Exemple :my_new_page - Les images doivent également être nommées en anglais, avec des underscores si nécessaire.
Exemple :my_beautiful_picture.jpg - Respecter la mise en page existante afin de garantir une cohérence visuelle et structurelle.
- Conserver la même organisation pour les pages similaires.
Par exemple, les classes de joueurs suivent la structure suivante :
Infobox → Histoire → Gameplay → Combos → Easter eggs (si applicable).
La cohérence est plus importante que la créativité isolée. Un wiki efficace doit être prévisible.
Syntaxe de base
Le wiki utilise le format Markdown (md) via le plugin Commonmark.
Pour les bases du formatage (titres, listes, tableaux, liens, etc.), se référer à la documentation officielle Markdown.
Contenu en syntaxe DokuWiki
Certains éléments doivent impérativement utiliser la syntaxe DokuWiki native, notamment :
Pour empêcher Markdown d’interpréter ces blocs, utiliser un bloc indenté afin de forcer la syntaxe DokuWiki :
```dokuwiki **ce contenu** utilisera la syntaxe //dokuwiki// **et pas le** //markdown//. ```
Tout ce qui se trouve dans ce bloc sera interprété en DokuWiki et non en Markdown.
Traduction du wiki
Le wiki est multilingue grâce au plugin Translation.
- Pour créer une traduction d’une page, utiliser le namespace de langue correspondant.
Exemple :fr:my_pagesera la traduction française demy_page. - Les pages traduites sont liées automatiquement entre elles.
- Il est également possible de cliquer sur le lien “Traductions de cette page” afin d’accéder à la version disponible dans une autre langue.
Veiller à conserver la même structure et le même contenu entre les différentes langues.
Liens
Il est important de distinguer l’URL d’accès à une page et la syntaxe de lien interne utilisée dans un article.
Accès aux pages dans le navigateur
Une même page peut être accessible de plusieurs manières équivalentes dans la barre d’adresse du navigateur :
- wiki.cube-conflict.com/
fr:doc:wiki - wiki.cube-conflict.com/
fr/doc/wiki - wiki.cube-conflict.com/
doku.php?id=fr:doc:wiki
Ces différentes formes correspondent simplement à des variantes d’URL pour accéder à la page sur le site (exemple : accès direct via namespace ou via doku.php?id=).
Liens internes dans un article
Dans le contenu d’un article, les liens doivent être écrits en utilisant la syntaxe interne avec namespace, sans le préfixe de langue car les pages traduites sont liées automatiquement entre elles :
doc:wiki
C’est cette forme qui doit être utilisée pour créer des liens entre les pages du wiki.
Ne pas utiliser d’URL complètes dans les articles.
Toujours privilégier la syntaxe interne avec namespace afin de garantir la portabilité, la cohérence et la maintenabilité du wiki.
Plugins utilisés
Liste des principaux plugins installés :
- Commonmark : https://www.dokuwiki.org/plugin:commonmark
- FontSizeFixed : https://www.dokuwiki.org/plugin:fontsizefixed
- TOCSidebar : https://www.dokuwiki.org/plugin:tocsidebar
- Translation : https://www.dokuwiki.org/plugin:translation