# Wiki

The Cube Conflict Wiki uses [DokuWiki](https://www.dokuwiki.org/dokuwiki) with the [Bootstrap3 template](https://www.dokuwiki.org/template:bootstrap3).  

The **main syntax relies on the `md` format** thanks to the [Commonmark plugin](https://www.dokuwiki.org/plugin:commonmark).

The goal is to maintain a clear, structured, and consistent wiki for all contributors.

## Formatting Rules

  * The main language of the wiki is English. All new pages must be named in English.
  * For compound names, use underscores `_` to separate words.  
    Example: `my_new_page`
  * Images should also be named in English, using underscores if necessary.  
    Example: `my_beautiful_picture.jpg`
  * Follow the existing layout to ensure visual and structural consistency.
  * Keep the same organization for similar pages.  
    For example, player classes follow this structure:  
    **Infobox → Lore → Gameplay → Combos → Easter eggs** (if applicable).

Consistency is more important than isolated creativity. An effective wiki must be predictable.

## Basic Syntax

The wiki uses **Markdown (`md`)** via the [Commonmark plugin](https://www.dokuwiki.org/plugin:commonmark).

For basic formatting (headings, lists, tables, links, etc.), refer to the [official Markdown documentation](https://www.markdownguide.org/basic-syntax/).

## DokuWiki Syntax Content

Some elements must **strictly use native DokuWiki syntax**, including:

  * [Infoboxes](https://github.com/Kanaru92/DokuWiki-InfoBox/)
  * [Tags](https://www.dokuwiki.org/plugin:tag)

To prevent Markdown from parsing these blocks, use an indented block to enforce DokuWiki syntax:

    ```dokuwiki
    **this content** will use //dokuwiki// syntax **and not** //markdown//.
    ```

Everything inside this block will be interpreted in DokuWiki, not Markdown.

## Wiki Translation

The wiki is multilingual thanks to the [Translation plugin](https://www.dokuwiki.org/plugin:translation).

  * To create a translation of a page, use the corresponding language namespace.  
    Example: `fr:my_page` will be the French translation of `my_page`.
  * Translated pages are automatically linked to each other.
  * You can also click the **"Translations of this page"** link to access the version available in another language.

Ensure that the structure and content remain consistent across languages.

## Links

It is important to distinguish between **the URL used to access a page** and **the internal link syntax used inside an article**.

### Accessing pages via the browser

A single page can be accessed in multiple equ
ivalent ways in the browser's address bar:

  * wiki.cube-conflict.com/`doc:wiki`
  * wiki.cube-conflict.com/`doc/wiki`
  * wiki.cube-conflict.com/`doku.php?id=doc:wiki`

These different forms are just URL variants to reach the page on the site (for example: direct access via namespace or via `doku.php?id=`).

### Internal links within an article

Inside article content, links should be written using **internal namespace
 syntax only**:

  * `doc:wiki`

This is the correct form to create links between wiki pages.

Do **not** use full URLs inside articles.  
Always prefer the internal namespace syntax to ensure portability, consistency, and maintainability of the wiki.

## Installed Plugins

List of main installed plugins:
  * 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