Corrections chapitre 1

[DrOwlFR]

Barré : fautes
Italique : simple modification pour rendre plus sympa à lire la phrase, ou modif facultative

1. En tête

Dans ce premier chapitre nous allons déja déjà mettre en place notre environement environnement de développement, nous allons installer les outils nécessaires pour le développement de notre bot (→ "développer notre bot" (pour éviter la redondance de "développement")) ainci ainsi que le créer et l'inviter sur notre serveur.

2. Avant de commencer

• Ce tutoriel s'adresse à toutes les personnes qui ont déja déjà quelques bases avec le javascript.

• Tout au long de ce tutoriel**,** je vais vous montrer des exemples de code, vous pourrez les retrouver sur le github de ce tutoriel. Le github contient dans chaque dossiers dossier le code source de chaque chapitre, alors si vous ne comprenez pas quelque chose n'hésitez pas à aller y faire un tour.

3. Mise en place de l'environnement
   a. Installation de l'IDE

L'ide est un logiciel qui va nous permettre d'écrire des lignes de code. Il en existe différents et il faut choisir celui qui vous convient le mieux. Certains sont payants mais dans ce tutoriel j'utiliserai Visual Studio Code. Vous allez donc pouvoir installer le logiciel depuis le site web code.visualstudio.com. Le bouton d'installation se situe en haut a à droite de l'écran. Ensuite c'est une installation classique, une fois finie vous pouvez le lancer pour vérifier que tous c'est s'est bien passé puis passer a à l'étape suivante.

 b. Installation de Nodejs

Nodejs est ce que l'on appel appelle un runetime runtime ?, c'est lui qui va traduire votre code en un langage que la machine pourra comprendre. Vous allez donc pouvoir installer node depuis leur site web officiel nodejs.org. Au milieu**,** de l'écran vous pourrez voir 2 boutons d'installation. Choisissez la version LTS (Long Term Support) qui correspond à la version stable du logiciel (assurez vous assurez-vous que c'est au moins 16.6.x). Ensuite vous procéderez a à l'installation, cela peut prendre quelques minutes, si vous appercevez apercevrez des fenêtres apparaitre apparaître ne les fermez pas à la main. Attendez que elles qu'elles se ferment toutes seules. Une fois l'installation finie, vérifiez que tout c'est bien passé en ouvrant un terminal (si vous ne savez pas ce que c'est tapez "powershell" dans la recherche des applications) et tapez "node -v" dans le terminal. Vous devriez voir la version de Nodejs que vous avez installé. Si vous avez une erreur**,** assurez**-**vous de bien fermer le terminal puis de le réouvrir rouvrir.

4. Création du bot

[...] si nécésaire nécessaire connectez vous avec votre compte discord. Vous devriz devriez arriver sur une page comme celle-ci :

Une fois sur cette page vous allez voir un bouton "Nouvelle Application" en haut a à droite qui vous permettra de créer votre bot. Choissisez Choisissez un nom qui vous plait et appoyez appuyez sur le bouton "Créer". Vous devriez arriver sur une page comme celle-ci :

Une fois sur cette page vous allez pouvoir changer l'avatar, la description et le nom du bot. Vous pouvez également ajouter des "tags" mais nous aurons l'occasions d'en reparler plus tard. Une fois vos modifications faites, sur le côté gauche allez dans l'onglet "Bot" et cliquez sur le bouton "Créer le bot". Vous devriez voir apparaitre apparaître une page comme celle-ci :

Cliquez sur "Oui" pour confirmer la création de votre bot (avant nous étions sur l'application et une application n'est pas forcément un bot). Vous devriez voir apparaitre apparaître une page comme celle-ci :

En dessendant descendant un peu, vous pouvez appercevoir apercevoir le titre "Intentions de passerelle privilégiée" ("Privileged Gateway Intents" en anglais) avec 3 sous-titres en dessous ("PRESENCE INTENT", "SERVER MEMBERS INTENT", "MESSAGE CONTENT INTENT") en dessous vous trouverez des boutons a à cocher, il faut tous les activer. Je ne vais pas expliquer ici ce que sont les "gateway intents" car nous aurons l'occasion d'en parler dans les prochains chapitres. A À côté de l'avatar de votre bot vous pouvez voir le token avec un bouton "Copier". Gardez bien ca ça en tete tête nous en aurons besoins dans le prochain chapitre.

Et voila ! Notre bot vient d'être crée créé avec toutes les options nécéssaires nécessaires.

5. Invitation du bot

Dans cette section j'admets (peut-être plutôt "je pars du principe", même si j'admets est correct dans ce cas, c'est pas courant) que vous avez déja déjà créer créé votre serveur discord. Si vous ne savez pas comment faire je vous laisse conculter consulter ce lien.

Sur la page du panel de gstion gestion de votre bot [...]

Sur le tableau "Scopes" il faut séléctionner sélectionner "bot" et "application.commands" comme ci-dessous :

Notez que a ce moment vous pouvez également séléctionner sélectionner les permissions qui seront demandées lors de l'invitation du bot. Même si ce n'est pas une bonne chose , pour les besoins du tutoriel je vais demander la permission "Administrateur" comme ca ça nous n'aurons jamais de problème avec les permissions.

[...] Vous serez invité a à valider un captcha puis le bot sera sur votre serveur. Une fois cela fait le bot devrait apparaitre dans la liste des membres du serveur avec le statut "offline". Comme sur l'image ci-dessous :

[Smaug6739]

Normalement le premier chapitre a été corrigé dans ce commit : c363beb mais je relirai une autre fois dans la soirée pour etre sur de ne rien avoir oublié. Merci !

[DrOwlFR]

Aaarf je viens d'en trouver une autre que j'ai oublié :

1. Création du bot

Nous allons commencer par créer notre bot sur le site des développeurs discord. Pour cela ouvrez le lien vers le portail des développeurs dirrectement directement dans le navigateur, si nécessaire connectez vous avec votre compte discord. Vous devriz arriver sur une page comme celle-ci :

Et juste un petit oubli de correction ici : 😋

Dans cette section je pars du principe que vous avez déjà créer créé votre serveur discord. Si vous ne savez pas comment faire je vous laisse consulter ce lien.