From 6ea80069252dd2881c7a0fb01278a6f8a984aa30 Mon Sep 17 00:00:00 2001 From: Lucas Date: Wed, 31 Dec 2025 14:24:55 +0100 Subject: [PATCH 1/8] =?UTF-8?q?Am=C3=A9lioration=20Variables?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3.autres/6.variables.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index bd262ddd7..8300af7af 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -8,6 +8,8 @@ updatedAt: '2025-10-23' ## Syntaxe générale +Les variables s'utilisent toujours entre accolades `{}` et suivent l'une des structures suivantes : + - `{variable}` : Variable simple - `{variable:paramètres}` : Variable avec paramètres - `{variable?modifieur}` : Variable avec modificateur From 5a7d7ae32cbfbf8ffe3d5320896caa35b4e1be0f Mon Sep 17 00:00:00 2001 From: Lucas Date: Wed, 31 Dec 2025 14:26:54 +0100 Subject: [PATCH 2/8] =?UTF-8?q?Ajout=20Exemples=20syntaxe=20g=C3=A9n=C3=A9?= =?UTF-8?q?rale?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3.autres/6.variables.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index 8300af7af..c2e134f4f 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -15,6 +15,12 @@ Les variables s'utilisent toujours entre accolades `{}` et suivent l'une des str - `{variable?modifieur}` : Variable avec modificateur - `{variable:paramètres?modifieur}` : Variable avec paramètres et modificateur +**Exemple :** + +- `{user.username}` +- `{user.created_at:format=DD/MM/YYYY}` +- `{level.rank?ordinal}` + ## Paramètres Les paramètres permettent d'affiner le comportement d'une variable en lui transmettant des informations complémentaires. Ils s'ajoutent après le nom de la variable, chacun étant précédé du symbole deux-points `:`. From c09857c626c5904a2f95384593b3b1a20dac5b7c Mon Sep 17 00:00:00 2001 From: Lucas Date: Wed, 31 Dec 2025 14:49:26 +0100 Subject: [PATCH 3/8] =?UTF-8?q?Ajout=20Param=C3=A8tres=20Variables=20+=20C?= =?UTF-8?q?ontexte?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3.autres/6.variables.md | 98 +++++++++++++++++++++++++++--------- 1 file changed, 73 insertions(+), 25 deletions(-) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index c2e134f4f..886661ee1 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -32,6 +32,61 @@ Chaque paramètre suit la structure `nom=valeur`. Lorsque vous souhaitez utilise - `{level.rank:user_id=123456789012345678}` - `{user.created_at:user_id=123456789012345678:format=DD MMMM YYYY}` +## Paramètres communs + +Cette section regroupe les paramètres utilisés par plusieurs variables. Lorsqu'un paramètre est mentionné plus loin sans explication détaillée, référez-vous à cette section. + +### user_id + +Identifiant Discord d'un utilisateur ciblé par la variable. + +- **Type :** ID Discord +- **Obligatoire :** Selon la variable + +### role_id + +Identifiant Discord d'un rôle. + +- **Type :** ID Discord +- **Obligatoire :** Pour les variables liées aux rôles + +::hint{ type="warning" } + Ce paramètre est obligatoire pour toutes les variables de rôle. +:: + +### channel_id + +Identifiant Discord d'un salon. + +- **Type :** ID Discord +- **Obligatoire :** selon la variable + +### format + +Définit le format d'affichage des dates et heures. + +- **Valeur par défaut :** `L` (date) ou `LT` (heure) + +- **Valeurs acceptées :** + + - `relative` → affichage relatif (ex : il y a 2 heures) + + - `format personnalisé` (ex : DD/MM/YYYY, HH:mm) + + ::hint{ type="info" } + La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. + :: + +### separator + +Caractère(s) utilisés pour séparer plusieurs valeurs. + +- **Valeur par défaut :** `, ` + +### style + +Style d'affichage du timestamp. Vous pouvez retrouver la liste complète sur la [documentation](https://discord.com/developers/docs/reference#message-formatting-timestamp-styles) de Discord. + ## Modificateurs Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajoutent après le nom de la variable ou après le ou les paramètres, précédés du symbole point d'interrogation `?`. @@ -66,8 +121,10 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{user.joined_at}` | Date d'arrivée sur le serveur | 11/03/2018 | **Paramètres :** -- `user_id` : Identifiant d'un utilisateur. -- `format` : Format d'affichage de la date (par défaut : `L`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY`. +- `user_id` +- `format` + +Les paramètres listés dans les sections suivantes sont détaillés dans la section [Paramètres communs](#paramètres-communs). ### Serveur @@ -87,7 +144,7 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{server.created_at}` | Date de création du serveur | 10/03/2018 | **Paramètres :** -- `format` : Format d'affichage de la date (par défaut : `L`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY`. +- `format` ### Salon @@ -103,8 +160,8 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{channel.parent.created_at}` | Date de création parent | 16/04/2020 | **Paramètres :** -- `channel_id` : Identifiant d'un salon. -- `format` : Format d'affichage de la date (par défaut : `L`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY`. +- `channel_id` +- `format` ### Rôle @@ -119,12 +176,8 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{role.created_at}` | Date de création | 12/04/2020 | **Paramètres :** -- `role_id` : Identifiant d'un rôle. -- `format` : Format d'affichage de la date (par défaut : `L`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY`. - -::hint{ type="warning" } - Le paramètre `role_id` est obligatoire. -:: +- `role_id` +- `format` ### Temporalité @@ -134,11 +187,9 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{time}` | Heure actuelle | 11:01 | | `{timestamp}` | Timestamp Discord | 1495962098 | -**Paramètres (date et time) :** -- `format` : Format d'affichage de la date ou de l'heure (par défaut : `L` ou `LT`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY` ou `hh:mm a`. La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. - -**Paramètres (timestamp) :** -- `style` : Style d'affichage du timestamp. Vous pouvez retrouver la liste complète sur la [documentation](https://discord.com/developers/docs/reference#message-formatting-timestamp-styles) de Discord. +**Paramètres :** +- `format` (date et time) +- `style` (timestamp) ## Variables par modules @@ -157,7 +208,7 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{money.to_position:position=N}` | Argent nécessaire pour atteindre la position N dans le classement | 1 200 | **Paramètres :** -- `user_id` : Identifiant d'un utilisateur. +- `user_id` ### Niveaux @@ -179,7 +230,7 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{xp.to_position:position=N}` | Expérience nécessaire pour atteindre la position N dans le classement | 5,000 | **Paramètres :** -- `user_id` : Identifiant d'un utilisateur. +- `user_id` ### Récompenses de niveaux @@ -225,7 +276,7 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{age}` | Âge de l'utilisateur | 25 ans | **Paramètres :** -- `user_id` : Identifiant d'un utilisateur. +- `user_id` ::hint{ type="info" } Les variables d'[économie](#economie) et de [niveaux](#niveaux) sont aussi disponibles dans les commandes personnalisées. @@ -326,12 +377,9 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo | `{stream.start_at}` | Date de début | il y a 2 heures | | `{stream.tags}` | Tags du live | français, développement | -**Paramètres (start_at) :** -- `format` : Format d'affichage de la date ou de l'heure (par défaut : `relative`). Accepte `relative` pour un affichage relatif (ex : "il y a 2 heures") ou un format personnalisé comme `DD/MM/YYYY` ou `hh:mm a`. La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. - -**Paramètres (tags) :** - -- `separator` : Caractères de séparation des différents tags du stream (par défaut : `, `) +**Paramètres :** +- `format` +- `separator` ### Reddit From 2776e73c0990f0c523b07b2a4802efb7990e8881 Mon Sep 17 00:00:00 2001 From: Lucas Date: Wed, 31 Dec 2025 15:28:32 +0100 Subject: [PATCH 4/8] Exemple format --- docs/3.autres/6.variables.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index 886661ee1..f815f8412 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -73,6 +73,11 @@ Définit le format d'affichage des dates et heures. - `format personnalisé` (ex : DD/MM/YYYY, HH:mm) +| Variable | Exemple format | Exemple réponse | +|----------|----------------|-----------------| +| stream.start_at | Le stream débutera le `{stream.start_at: format = DD/MM/YYYY}`. | Le stream débutera le 31/12/2025. +| date | Il est `{date: format = DD/MM/YYYY, HH:mm}`. | Il est . | + ::hint{ type="info" } La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. :: From 1b69b8ed09486d71b6ac96ab54e6224cd3574aef Mon Sep 17 00:00:00 2001 From: Lucas Date: Thu, 1 Jan 2026 20:52:28 +0100 Subject: [PATCH 5/8] Correction exemples de Variables --- docs/3.autres/6.variables.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index f815f8412..ce16dd4e2 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -75,8 +75,8 @@ Définit le format d'affichage des dates et heures. | Variable | Exemple format | Exemple réponse | |----------|----------------|-----------------| -| stream.start_at | Le stream débutera le `{stream.start_at: format = DD/MM/YYYY}`. | Le stream débutera le 31/12/2025. -| date | Il est `{date: format = DD/MM/YYYY, HH:mm}`. | Il est . | +| stream.start_at | Le stream débutera le `{stream.start_at:format=DD/MM/YYYY}`. | Le stream débutera le 31/12/2025. +| date | Il est `{date:format=DD/MM/YYYY,HH:mm}`. | Il est . | ::hint{ type="info" } La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. From b3b7967c31b1a06ba0968e397c1410faae4b9b7d Mon Sep 17 00:00:00 2001 From: Lucas Date: Fri, 2 Jan 2026 23:25:48 +0100 Subject: [PATCH 6/8] =?UTF-8?q?Am=C3=A9lioration=20lisibilit=C3=A9=20Forma?= =?UTF-8?q?t?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3.autres/6.variables.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index ce16dd4e2..af547da18 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -71,17 +71,17 @@ Définit le format d'affichage des dates et heures. - `relative` → affichage relatif (ex : il y a 2 heures) - - `format personnalisé` (ex : DD/MM/YYYY, HH:mm) + - format personnalisé (ex : DD/MM/YYYY, HH:mm) + + ::hint{ type="info" } + La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. + :: | Variable | Exemple format | Exemple réponse | |----------|----------------|-----------------| | stream.start_at | Le stream débutera le `{stream.start_at:format=DD/MM/YYYY}`. | Le stream débutera le 31/12/2025. | date | Il est `{date:format=DD/MM/YYYY,HH:mm}`. | Il est . | - ::hint{ type="info" } - La liste des différents formats est disponible sur la [documentation](https://day.js.org/docs/en/display/format) de la bibliothèque **dayjs**. - :: - ### separator Caractère(s) utilisés pour séparer plusieurs valeurs. From b98d5999cd2f85279aeb87316b341f7aaf5421c7 Mon Sep 17 00:00:00 2001 From: Lucas Date: Fri, 2 Jan 2026 23:31:21 +0100 Subject: [PATCH 7/8] =?UTF-8?q?Ajout=20d=C3=A9tails=20param=C3=A8tres?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3.autres/6.variables.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index af547da18..8e2e3b50a 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -129,7 +129,9 @@ Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajo - `user_id` - `format` -Les paramètres listés dans les sections suivantes sont détaillés dans la section [Paramètres communs](#paramètres-communs). +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: ### Serveur @@ -151,6 +153,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec **Paramètres :** - `format` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Salon | Variable | Description | Exemple | @@ -168,6 +174,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec - `channel_id` - `format` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Rôle | Variable | Description | Exemple | @@ -184,6 +194,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec - `role_id` - `format` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Temporalité | Variable | Description | Exemple | @@ -196,6 +210,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec - `format` (date et time) - `style` (timestamp) +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ## Variables par modules ### Économie @@ -215,6 +233,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec **Paramètres :** - `user_id` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Niveaux | Variable | Description | Exemple | @@ -237,6 +259,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec **Paramètres :** - `user_id` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Récompenses de niveaux | Variable | Description | Exemple | @@ -283,6 +309,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec **Paramètres :** - `user_id` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ::hint{ type="info" } Les variables d'[économie](#economie) et de [niveaux](#niveaux) sont aussi disponibles dans les commandes personnalisées. :: @@ -386,6 +416,10 @@ Les paramètres listés dans les sections suivantes sont détaillés dans la sec - `format` - `separator` +::hint{ type="info" } + Pour le détail des paramètres, [`cliquez ici`](#paramètres-communs). +:: + ### Reddit | Variable | Description | Exemple | From 587431cd97ce36637c8908dcce9a3c492998882d Mon Sep 17 00:00:00 2001 From: Lucas Date: Sat, 10 Jan 2026 13:18:02 +0100 Subject: [PATCH 8/8] Ajout Card Timestamps --- docs/3.autres/6.variables.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/3.autres/6.variables.md b/docs/3.autres/6.variables.md index 8e2e3b50a..b369b7687 100644 --- a/docs/3.autres/6.variables.md +++ b/docs/3.autres/6.variables.md @@ -90,7 +90,16 @@ Caractère(s) utilisés pour séparer plusieurs valeurs. ### style -Style d'affichage du timestamp. Vous pouvez retrouver la liste complète sur la [documentation](https://discord.com/developers/docs/reference#message-formatting-timestamp-styles) de Discord. +::card +--- +title: Timestamps +icon: material-symbols:schedule +to: /docs/autres/timestamps#paramètre-style +target: _blank +color: '#D1D5DB' +--- + Découvrez les différents paramètres de styles +:: ## Modificateurs