Contribuer au wiki

Le wiki est fait de simples fichiers texte rangés sur GitHub. Chaque modification enregistrée met le site à jour tout seul en une à deux minutes.

Modifier une page existante

1. En bas de la page, cliquez sur « Modifier cette page ».
2. GitHub ouvre le fichier dans son éditeur. Connectez-vous si besoin. Il faut avoir été ajouté au dépôt par l’équipe.
3. Faites vos changements, puis cliquez sur « Commit changes » en décrivant ce que vous avez modifié.

Créer une nouvelle page

Les pages sont dans le dossier src/content/docs/wiki/. Sur GitHub, ouvrez ce dossier (ou un sous-dossier comme monde/), puis Add file → Create new file. Nommez le fichier en minuscules, sans espaces ni accents, par exemple la-cite-du-port.md.

Commencez le fichier par cet en-tête :

---
title: La cité du port
description: Une phrase qui résume la page.
---

Le texte de la page commence ici.

Une page placée dans monde/nations/, monde/regions/ ou monde/conflits/ apparaît automatiquement dans la sous-section correspondante du menu. Le plus simple est de copier une page modèle existante et de la modifier.

Créer une sous-section

Une sous-section du menu correspond à un dossier. Pour en ajouter une (par exemple « Religions ») :

1. Créez une page dans un nouveau dossier, par exemple src/content/docs/wiki/monde/religions/culte-du-feu.md. Sur GitHub, taper religions/ dans le nom du fichier crée le dossier.
2. Dans astro.config.mjs, ajoutez une ligne sous les autres sous-sections :

section('Religions', 'wiki/monde/religions'),

Les pages du dossier sont triées par ordre alphabétique. Pour imposer un ordre, ajoutez sidebar: puis order: 1 (2, 3…) dans l’en-tête de chaque page.

Ajouter une infobox

L’encadré d’informations à droite des pages (nations, régions, conflits) s’écrit dans l’en-tête, sous infobox:. Chaque section contient des lignes Nom du champ: valeur, dans l’ordre où vous voulez les voir :

---
title: Royaume du Nord
infobox:
  image: /emblemes/royaume-du-nord.svg
  legende: Blason du royaume
  sections:
    Administration:
      Capitale: "[Hautegarde](/wiki/monde/villes/hautegarde/)"
      Religions:
        - Culte du feu
        - Ancienne foi
    Histoire:
      _intro: Liste non exhaustive
      _dates:
        - "An 12 : fondation."
---

• Une valeur sous forme de liste (lignes qui commencent par -) s’affiche à puces.
• Un champ dont le nom commence par _ s’affiche sur toute la largeur, sans libellé.
• Les liens s’écrivent [texte](/wiki/chemin/de-la-page/). Mettez la valeur entre guillemets dès qu’elle contient : ou [.
• Les images se rangent dans le dossier public/ : public/emblemes/x.svg s’écrit /emblemes/x.svg.

L’indentation compte : utilisez des espaces (deux par niveau), jamais de tabulations. Si une infobox est mal écrite, le site refuse de se construire et GitHub indique la ligne fautive dans l’onglet Actions.

Écrire en Markdown

Pour obtenir	Écrivez
Un titre de section	## Mon titre
Du gras	**gras**
De l’italique	*italique*
Une liste	- un élément sur chaque ligne
Un lien vers une page voisine	[texte](../nom-de-la-page/)
Une image	

Pour un encadré d’avertissement :

:::caution[Attention]
Ce passage est encore en discussion.
:::

Ajouter un lieu sur la carte

Les lieux sont dans src/data/lieux.json. Ajoutez une entrée avec ses coordonnées en jeu (touche F3) :

{ "nom": "La cité du port", "x": -1650, "z": 1200, "description": "Capitale marchande.", "page": "/wiki/monde/la-cite-du-port/" }

Remplacer la carte d’exemple

La carte actuelle est un continent d’exemple. Pour mettre la vraie :

1. Générez l’aperçu atmos_map.png avec l’outil de la carte (wp_to_amap.py).
2. Lancez python tools/prepare_map.py atmos_map.png. Le script l’enregistre au bon format dans public/carte/.
3. Lancez python tools/make_contours.py atmos_map.png pour redessiner le continent de la page d’accueil.