discord-bugcenter / tags

This is the repository with the list of visible tags using the /tag command.
https://discord.gg/K92q4dPYtX
Apache License 2.0
0 stars 0 forks source link

Tags

La principale source des tags disponibles sur Help Center.

Un "tag" est une ressource décrivant un message et son contenu, permettant aux membres de Bug Center de rapidement pouvoir envoyer des messages d'informations.

Contribution

Structure du projet

Le projet est structuré selon certains critères, permettant de pouvoir facilement récupérer les données utilisées pour un Bot.

Chaque tag correspond à un fichier TOML situé dans un sous-dossier de src. Chaque sous-dossier de src correspond à une "catégorie", un moyen de classifier indirectement les tags.

Ainsi, src/foo/bar.toml correspond au fichier source d'un tag nommé "bar", de la catégorie "foo".

Comprendre le schéma d'un tag

Un tag est un fichier TOML, un langage simple et puissant permettant la création de données rapidement.

Le schéma même d'un tag est décrit par le fichier schema.json à la racine du projet. Ce fichier JSON est la seule source de vérité du schéma d'un tag.

Le fichier schéma suit le standard JSON Schema, permettant à différents outils de proposer de l'autocomplétion et de la validation à partir du contenu du schéma.

Un tag est constitué de cinq propriétés :

Par défaut, seul name et description sont requis.

Par exemple :

name = "hello_world"
description = "Un tag d'exemple!"
content = """
Contenu du message
sur
plusieurs lignes.
"""

Ajouter/Modifier un tag

Pour ajouter ou modifier un tag, vous devez d'abord créer un fork de ce repo Git, et le clone. Après cela, il vous suffira de créer un fichier TOML dans un sous-dossier (une catégorie) de src si vous souhaitez ajouter un tag, sinon il vous suffira de modifier le fichier existant correspondant.

Une fois l'ajout terminé, vous pouvez commit et ouvrir une Merge Request sur ce repo.