Modèle:Roadmap/doc - Historique des versions

Hiob : lien

2026-02-21T07:46:37Z

lien

← Version précédente		Version du 21 février 2026 à 07:46
Ligne 3 :		Ligne 3 :
	== Utilisation ==		== Utilisation ==

	Le ~~module~~ est appelé via le '''[[Modèle:Roadmap]]''' :		Le [[Module:Roadmap]] est appelé via le '''[[Modèle:Roadmap]]''' :

	<syntaxhighlight lang="wikitext">		<syntaxhighlight lang="wikitext">

Hiob : séparateur

2026-02-20T23:16:09Z

séparateur

← Version précédente		Version du 20 février 2026 à 23:16
Ligne 11 :		Ligne 11 :
	\| contenu =		\| contenu =
	@section ⚔️ Gameplay		@section ⚔️ Gameplay
	item \| done \| Système de classes \| desc=Guerrier, mage et assassin \| tag=gameplay \| date=Jan 2025		item ;; done ;; Système de classes ;; desc=Guerrier, mage et assassin ;; tag=gameplay ;; date=Jan 2025
	item \| inprogress \| Économie de base \| desc=Monnaies, marchands, échanges \| tag=gameplay \| date=Fév 2025		item ;; inprogress ;; Économie de base ;; desc=Monnaies, marchands, échanges ;; tag=gameplay ;; date=Fév 2025
	item \| planned \| Guildes et alliances \| desc=Création, membres, guerres \| tag=gameplay		item ;; planned ;; Guildes et alliances ;; desc=Création, membres, guerres ;; tag=gameplay
	item \| idea \| Arène JcJ saisonnière \| desc=Tournois avec classement ELO \| tag=gameplay,event		item ;; idea ;; Arène JcJ saisonnière ;; desc=Tournois avec classement ELO ;; tag=gameplay,event

	@section 🗺️ Contenu & Monde		@section 🗺️ Contenu & Monde
	item \| done \| Carte principale Zone 1 \| tag=contenu \| date=Jan 2025		item ;; done ;; Carte principale Zone 1 ;; tag=contenu ;; date=Jan 2025
	item \| inprogress \| Zone 2 — Les Marécages \| tag=contenu		item ;; inprogress ;; Zone 2 — Les Marécages ;; tag=contenu
	item \| cancelled \| Zone aquatique \| desc=Reporté indéfiniment \| tag=contenu		item ;; cancelled ;; Zone aquatique ;; desc=Reporté indéfiniment ;; tag=contenu

	@section 🛠️ Technique & Wiki		@section 🛠️ Technique & Wiki
	item \| done \| Mise en place du wiki \| tag=wiki \| date=2025		item ;; done ;; Mise en place du wiki ;; tag=wiki ;; date=2025
	item \| inprogress \| Module Roadmap Lua \| tag=wiki		item ;; inprogress ;; Module Roadmap Lua ;; tag=wiki
	item \| planned \| Bot Discord ↔ Wiki \| desc=Synchronisation automatique \| tag=technique,discord		item ;; planned ;; Bot Discord ↔ Wiki ;; desc=Synchronisation automatique ;; tag=technique,discord
	}}		}}
	</syntaxhighlight>		</syntaxhighlight>

	== Syntaxe ==		== Syntaxe ==

			=== Séparateur ===

			{{Note\|type=warning\|text=Le séparateur entre les champs d'un item est <code>;;</code> (double point-virgule), '''pas''' le caractère <code>{{!}}</code>. En effet, le pipe <code>{{!}}</code> est interprété par MediaWiki comme séparateur de paramètre du modèle, ce qui tronque le contenu avant que le module Lua ne le reçoive.}}

	=== Paramètres du modèle ===		=== Paramètres du modèle ===
Ligne 67 :		Ligne 71 :

	<syntaxhighlight lang="text">		<syntaxhighlight lang="text">
	item \| statut \| Titre de l'item \| option1=valeur \| option2=valeur		item ;; statut ;; Titre de l'item ;; option1=valeur ;; option2=valeur
			</syntaxhighlight>

			Exemple concret :

			<syntaxhighlight lang="text">
			item ;; done ;; Système de classes ;; desc=Guerrier, mage et assassin ;; tag=gameplay ;; date=Jan 2025
	</syntaxhighlight>		</syntaxhighlight>

Ligne 154 :		Ligne 164 :
	@section Ma section		@section Ma section
	-- TODO: ajouter plus d'items ici		-- TODO: ajouter plus d'items ici
	item \| done \| Mon item		item ;; done ;; Mon item
	</syntaxhighlight>		</syntaxhighlight>

Ligne 167 :		Ligne 177 :
	\| titre = Mon Projet		\| titre = Mon Projet
	\| contenu =		\| contenu =
	item \| done \| Étape 1		item ;; done ;; Étape 1
	item \| inprogress \| Étape 2		item ;; inprogress ;; Étape 2
	item \| planned \| Étape 3		item ;; planned ;; Étape 3
	}}		}}
	</syntaxhighlight>		</syntaxhighlight>
Ligne 181 :		Ligne 191 :
	\| legende = non		\| legende = non
	\| contenu =		\| contenu =
	item \| done \| Correction bug #42 \| date=15 Jan		item ;; done ;; Correction bug #42 ;; date=15 Jan
	item \| done \| Nouvelle interface \| date=20 Jan		item ;; done ;; Nouvelle interface ;; date=20 Jan
	}}		}}
	</syntaxhighlight>		</syntaxhighlight>
Ligne 193 :		Ligne 203 :
	{{#invoke:Roadmap\|item\|done\|Ma fonctionnalité\|desc=Terminée hier\|tag=gameplay}}		{{#invoke:Roadmap\|item\|done\|Ma fonctionnalité\|desc=Terminée hier\|tag=gameplay}}
	</syntaxhighlight>		</syntaxhighlight>

			{{Note\|text=La fonction <code>item</code> inline utilise les pipes classiques <code>{{!}}</code> car les paramètres sont passés directement à <code>#invoke</code>, pas dans un champ <code>contenu</code>.}}

	== Structure des fichiers ==		== Structure des fichiers ==
Ligne 224 :		Ligne 236 :
	{\| class="wikitable"		{\| class="wikitable"
	! Problème !! Cause probable !! Solution		! Problème !! Cause probable !! Solution
			\|-
			\| Aucun item affiché \|\| Utilisation de <code>{{!}}</code> au lieu de <code>;;</code> comme séparateur \|\| Remplacer tous les <code>{{!}}</code> par <code>;;</code> dans le contenu
	\|-		\|-
	\| Pas de couleurs \|\| TemplateStyles non chargé \|\| Vérifier que <code><templatestyles src="Roadmap/styles.css" /></code> est dans le Modèle:Roadmap		\| Pas de couleurs \|\| TemplateStyles non chargé \|\| Vérifier que <code><templatestyles src="Roadmap/styles.css" /></code> est dans le Modèle:Roadmap
	\|-		\|-
	\| Item affiché comme texte brut \|\| Syntaxe incorrecte \|\| Vérifier le format <code>item ~~{{!}}~~ statut ~~{{!}}~~ titre</code>		\| Item affiché comme texte brut \|\| Syntaxe incorrecte \|\| Vérifier le format <code>item ;; statut ;; titre</code>
	\|-		\|-
	\| Statut non reconnu \|\| Faute de frappe \|\| Le module affiche <code>planned</code> par défaut		\| Statut non reconnu \|\| Faute de frappe \|\| Le module affiche <code>planned</code> par défaut

Hiob : Page créée avec « Ce modèle génère une '''roadmap visuelle''' pour suivre les fonctionnalités, mises à jour et projets. Il s'intègre au design du skin Citizen et respecte automatiquement les modes clair et sombre. == Utilisation == Le module est appelé via le '''Modèle:Roadmap''' : {{Roadmap | titre = Roadmap — Serveur Nefald | subtitle = Estimations mises à jour en juin 2025 | contenu = @section ⚔️ Gamepl... »

2026-02-20T22:35:29Z

Page créée avec « Ce modèle génère une '''roadmap visuelle''' pour suivre les fonctionnalités, mises à jour et projets. Il s'intègre au design du skin Citizen et respecte automatiquement les modes clair et sombre. == Utilisation == Le module est appelé via le '''Modèle:Roadmap''' : <syntaxhighlight lang="wikitext"> {{Roadmap | titre = Roadmap — Serveur Nefald | subtitle = Estimations mises à jour en juin 2025 | contenu = @section ⚔️ Gamepl... »

Nouvelle page

Ce modèle génère une '''roadmap visuelle''' pour suivre les fonctionnalités, mises à jour et projets. Il s'intègre au design du skin [[mw:Skin:Citizen|Citizen]] et respecte automatiquement les modes clair et sombre.

== Utilisation ==

Le module est appelé via le '''[[Modèle:Roadmap]]''' :

<syntaxhighlight lang="wikitext">
{{Roadmap
| titre = Roadmap — Serveur Nefald
| subtitle = Estimations mises à jour en juin 2025
| contenu =
@section ⚔️ Gameplay
item | done | Système de classes | desc=Guerrier, mage et assassin | tag=gameplay | date=Jan 2025
item | inprogress | Économie de base | desc=Monnaies, marchands, échanges | tag=gameplay | date=Fév 2025
item | planned | Guildes et alliances | desc=Création, membres, guerres | tag=gameplay
item | idea | Arène JcJ saisonnière | desc=Tournois avec classement ELO | tag=gameplay,event

@section 🗺️ Contenu & Monde
item | done | Carte principale Zone 1 | tag=contenu | date=Jan 2025
item | inprogress | Zone 2 — Les Marécages | tag=contenu
item | cancelled | Zone aquatique | desc=Reporté indéfiniment | tag=contenu

@section 🛠️ Technique & Wiki
item | done | Mise en place du wiki | tag=wiki | date=2025
item | inprogress | Module Roadmap Lua | tag=wiki
item | planned | Bot Discord ↔ Wiki | desc=Synchronisation automatique | tag=technique,discord
}}
</syntaxhighlight>

== Syntaxe ==

=== Paramètres du modèle ===

{| class="wikitable"
! Paramètre !! Obligatoire !! Description !! Valeur par défaut
|-
| <code>titre</code> || Non || Titre affiché en en-tête de la roadmap || <code>Roadmap</code>
|-
| <code>subtitle</code> || Non || Sous-titre affiché sous le titre || ''aucun''
|-
| <code>contenu</code> || '''Oui''' || Contenu de la roadmap (sections et items) || ''vide''
|-
| <code>stats</code> || Non || Afficher les statistiques. Mettre <code>non</code> pour masquer || ''oui''
|-
| <code>legende</code> || Non || Afficher la légende. Mettre <code>non</code> pour masquer || ''oui''
|}

=== Sections ===

Les sections regroupent les items par catégorie. Syntaxe :

<syntaxhighlight lang="text">
@section Titre de la section
</syntaxhighlight>

Vous pouvez utiliser des émojis dans le titre :

<syntaxhighlight lang="text">
@section ⚔️ Gameplay
@section 🗺️ Contenu & Monde
@section 🛠️ Technique
</syntaxhighlight>

=== Items ===

Chaque item représente une fonctionnalité ou une tâche. Syntaxe :

<syntaxhighlight lang="text">
item | statut | Titre de l'item | option1=valeur | option2=valeur
</syntaxhighlight>

==== Statuts disponibles ====

{| class="wikitable"
! Statut !! Icône !! Description !! Compté dans la progression
|-
| <code>done</code> || ✓ || Terminé, déployé || {{Oui}}
|-
| <code>inprogress</code> || ◉ || En cours de développement || {{Non}}
|-
| <code>planned</code> || ○ || Planifié, pas encore commencé || {{Non}}
|-
| <code>idea</code> || ✦ || Idée, à l'étude || {{Non}}
|-
| <code>cancelled</code> || ✕ || Annulé, abandonné || {{Non}} (ignoré du total)
|}

{{Note|text=Les items avec le statut <code>cancelled</code> sont exclus du calcul de la barre de progression.}}

==== Options des items ====

{| class="wikitable"
! Option !! Description !! Exemple
|-
| <code>desc</code> || Description courte sous le titre || <code>desc=Prévu pour 8 joueurs</code>
|-
| <code>tag</code> || Tags de catégorisation (séparés par des virgules) || <code>tag=gameplay,event</code>
|-
| <code>date</code> || Date ou période || <code>date=Jan 2025</code>
|-
| <code>lien</code> || Lien wiki vers une page de détail || <code>lien=Système de classes</code>
|}

== Tags disponibles ==

Les tags suivants ont un style coloré prédéfini :

{| class="wikitable"
! Tag !! Aperçu !! Usage recommandé
|-
| <code>gameplay</code> || {{Couleur|vert|gameplay}} || Mécaniques de jeu
|-
| <code>technique</code> || {{Couleur|bleu|technique}} || Infrastructure, serveur
|-
| <code>contenu</code> || {{Couleur|jaune|contenu}} || Maps, zones, monde
|-
| <code>interface</code> || {{Couleur|rouge|interface}} || UI/UX
|-
| <code>event</code> || {{Couleur|violet|event}} || Événements
|-
| <code>wiki</code> || {{Couleur|turquoise|wiki}} || Pages wiki, documentation
|-
| <code>discord</code> || {{Couleur|indigo|discord}} || Intégration Discord
|}

{{Note|text=Tout tag non listé ci-dessus s'affichera avec un style neutre par défaut (fond gris).}}

== Fonctionnalités automatiques ==

=== Barre de progression ===

La barre se calcule automatiquement :

<syntaxhighlight lang="text">
Progression = items "done" / (total items - items "cancelled") × 100
</syntaxhighlight>

Les items <code>cancelled</code> sont '''exclus''' du calcul pour ne pas fausser le pourcentage.

=== Statistiques ===

Le compteur en haut affiche automatiquement le nombre d'items par statut. Seuls les statuts ayant au moins un item sont affichés.

=== Légende ===

La légende en bas rappelle la signification de chaque icône/couleur.

== Commentaires ==

Vous pouvez ajouter des commentaires dans le contenu avec <code>--</code> en début de ligne :

<syntaxhighlight lang="text">
-- Ceci est un commentaire, il sera ignoré
@section Ma section
-- TODO: ajouter plus d'items ici
item | done | Mon item
</syntaxhighlight>

Les lignes vides sont également ignorées.

== Exemples ==

=== Roadmap minimale ===

<syntaxhighlight lang="wikitext">
{{Roadmap
| titre = Mon Projet
| contenu =
item | done | Étape 1
item | inprogress | Étape 2
item | planned | Étape 3
}}
</syntaxhighlight>

=== Sans statistiques ni légende ===

<syntaxhighlight lang="wikitext">
{{Roadmap
| titre = Changelog
| stats = non
| legende = non
| contenu =
item | done | Correction bug #42 | date=15 Jan
item | done | Nouvelle interface | date=20 Jan
}}
</syntaxhighlight>

=== Item inline (hors roadmap) ===

Vous pouvez afficher un item seul n'importe où avec :

<syntaxhighlight lang="wikitext">
{{#invoke:Roadmap|item|done|Ma fonctionnalité|desc=Terminée hier|tag=gameplay}}
</syntaxhighlight>

== Structure des fichiers ==

{| class="wikitable"
! Page !! Rôle
|-
| [[Module:Roadmap]] || Code Lua principal
|-
| [[Modèle:Roadmap]] || Modèle d'appel
|-
| [[Modèle:Roadmap/doc]] || Cette documentation
|-
| [[Modèle:Roadmap/styles.css]] || Feuille de style (TemplateStyles)
|}

== Compatibilité ==

{| class="wikitable"
! Composant !! Version
|-
| MediaWiki || 1.43+
|-
| Skin || Citizen (dark/light mode automatique)
|-
| Extensions requises || [[mw:Extension:Scribunto|Scribunto]], [[mw:Extension:TemplateStyles|TemplateStyles]]
|}

== Dépannage ==

{| class="wikitable"
! Problème !! Cause probable !! Solution
|-
| Pas de couleurs || TemplateStyles non chargé || Vérifier que <code><templatestyles src="Roadmap/styles.css" /></code> est dans le Modèle:Roadmap
|-
| Item affiché comme texte brut || Syntaxe incorrecte || Vérifier le format <code>item {{!}} statut {{!}} titre</code>
|-
| Statut non reconnu || Faute de frappe || Le module affiche <code>planned</code> par défaut
|-
| Tag sans couleur || Tag non prédéfini || Ajouter le style dans <code>Modèle:Roadmap/styles.css</code>
|-
| Dark mode non respecté || CSS avec couleurs fixes || Utiliser <code>var(--color-surface-*)</code> pour les surfaces
|}

== Ajouter un nouveau tag ==

# Choisir un nom en minuscules sans espaces (ex: <code>pvp</code>)
# Ajouter dans [[Modèle:Roadmap/styles.css]] :

<syntaxhighlight lang="css">
.roadmap-tag-pvp {
background: #fce4ec;
color: #880e4f;
}
</syntaxhighlight>

<ol start="3">
<li>Utiliser dans un item : <code>tag=pvp</code></li>
</ol>

== Ajouter un nouveau statut ==

La modification de statuts nécessite l'édition de [[Module:Roadmap]]. Dans la table <code>CONFIG.statuts</code>, ajouter :

<syntaxhighlight lang="lua">
monstatut = {
label = "Mon Statut",
icon = "★",
order = 6,
},
</syntaxhighlight>

Puis ajouter les styles CSS correspondants (<code>.roadmap-badge-monstatut</code>, <code>.roadmap-stat-monstatut</code>, <code>.roadmap-item.roadmap-monstatut</code>).

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Roadmap/doc - Historique des versions

Hiob : lien

Hiob : séparateur

Hiob : lien

Hiob : séparateur