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.

• 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.

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.

Certains éléments doivent impérativement utiliser la syntaxe DokuWiki native, notamment :

• Les infobox
• Les tags

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.

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_page sera la traduction française de my_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.

Il est important de distinguer l’URL d’accès à une page et la syntaxe de lien interne utilisée dans un article.

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=).

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.

Liste des principaux plugins installés :

• Commonmark : https://www.dokuwiki.org/plugin:commonmark
• FontSizeFixed : https://www.dokuwiki.org/plugin:fontsizefixed
• Note : https://www.dokuwiki.org/plugin:note
• InfoBox : https://github.com/Kanaru92/DokuWiki-InfoBox/
• Tag : https://www.dokuwiki.org/plugin:tag
• Move : https://www.dokuwiki.org/plugin:move
• TOCSidebar : https://www.dokuwiki.org/plugin:tocsidebar
• Translation : https://www.dokuwiki.org/plugin:translation