docs: update CONTRIBUTING.md #35

Merged
Anri merged 12 commits from contributing-update into main 2022-07-25 00:51:02 +02:00
Showing only changes of commit fddaf86789 - Show all commits

View file

@ -13,6 +13,7 @@ une [Pull Request](https://git.kennel.ml/ConfrerieDuKassoulait/Botanique/pulls).
- [Langues](#langues) - [Langues](#langues)
- [Ajouter une langue](#ajouter-une-langue) - [Ajouter une langue](#ajouter-une-langue)
- [Mettre à jour une langue](#mettre-à-jour-une-langue) - [Mettre à jour une langue](#mettre-à-jour-une-langue)
- [Projet](#projet)
- [Ajouter une commande](#ajouter-une-commande) - [Ajouter une commande](#ajouter-une-commande)
- [Ajouter un évènement](#ajouter-un-évènement) - [Ajouter un évènement](#ajouter-un-évènement)
- [Modifier du code](#modifier-du-code) - [Modifier du code](#modifier-du-code)
@ -24,12 +25,12 @@ Si tu as besoin d'aide, tu peux poser ta question sur
le [Discord](https://discord.gg/Z5ePxH4). le [Discord](https://discord.gg/Z5ePxH4).
## Langues ## Langues
La langue par défaut est définie dans [`src/utils/client.ts`](src/utils/client.ts) La langue par défaut est définie dans
dans `client.config.default_lang`. [`src/utils/client.ts`](src/utils/client.ts) dans `client.config.default_lang`.
La langue par défaut fait office de solution de secours dans le cas où une traduction La langue par défaut fait office de solution de secours dans le cas où une
est incomplète. On part donc du postulat que la langue par défaut contient toujours traduction est incomplète. On part donc du postulat que la langue par défaut
toutes les chaînes de caractère dont le bot a besoin. contient toujours toutes les chaînes de caractère dont le bot a besoin.
### Ajouter une langue ### Ajouter une langue
@ -51,6 +52,23 @@ doit être nommé `langue.json` avec `langue` suivant
> Pensez à vérifier si de nouvelles valeurs n'ont pas été ajouté dans > Pensez à vérifier si de nouvelles valeurs n'ont pas été ajouté dans
le fichier langue par défaut, [cf. au dessus](#langues). le fichier langue par défaut, [cf. au dessus](#langues).
## Projet
Le code se trouve dans le dosier [src/](./src/). Dans ce dossier il y a :
- [commands/](./src/commands/) qui contient toutes les commandes, rangés par
catégories
- [events/](./src/events/) qui contient tous les évènements, rangés par
catégories
- [locales/](./src/locales/) qui contient tous les fichiers de langue
- [modules/](./src/modules/) qui contient les extensions utilisé,
par exemple, pour utiliser la fonction `capitalize()` d'un string, il faut
importer le fichier `string.ts` qui se trouve dans le dossier
- [utils/](./src/utils/) qui contient toutes les fonctions utilitaires, rangés
par fichiers
Les dossiers [commands/](./src/commands/) et [events/](./src/events/)
contiennent chaquin un fichier `loader.js` qui charge respectivement
les commandes et les évènements dans le bot.
## Ajouter une commande ## Ajouter une commande
Pour ajouter une commande au bot, créez un fichier `nom-de-la-commande.ts` dans Pour ajouter une commande au bot, créez un fichier `nom-de-la-commande.ts` dans
un sous dossier de [`src/commands/`](./src/commands/). Vous pouvez créer une un sous dossier de [`src/commands/`](./src/commands/). Vous pouvez créer une
@ -98,9 +116,10 @@ la commande et `NOM` le nom de votre commande.
le nom de la commande et `DESCRIPTION` la description de votre commande. le nom de la commande et `DESCRIPTION` la description de votre commande.
## Ajouter un évènement ## Ajouter un évènement
Pour ajouter le support d'un évènement au bot, créez un fichier `nom-evenement.ts` dans Pour ajouter le support d'un évènement au bot, créez un fichier
un sous dossier de [`src/events/`](./src/events/). Vous pouvez créer une `nom-evenement.ts` dans un sous dossier de [`src/events/`](./src/events/). Vous
nouvelle catégorie si votre commande n'entre dans aucune qui existe déjà. pouvez créer une nouvelle catégorie si votre commande n'entre dans aucune qui
existe déjà.
Vous pouvez préciser que l'évènement ne sera déclenché qu'une seule fois avec Vous pouvez préciser que l'évènement ne sera déclenché qu'une seule fois avec
```typescript ```typescript
@ -108,7 +127,8 @@ export const once = true;
``` ```
De préférence, merci de mettre un lien en commentaire vers la documentation De préférence, merci de mettre un lien en commentaire vers la documentation
de discord.js de l'évènement ([exemple ici pour l'évènement `ready`](./src/events/client/ready.ts#L3)) de discord.js de l'évènement
([exemple ici pour l'évènement `ready`](./src/events/client/ready.ts#L3))
## Modifier du code ## Modifier du code
Quand vous modifiez quelque chose, pensez à mettre-à-jour les langues. Si vous Quand vous modifiez quelque chose, pensez à mettre-à-jour les langues. Si vous