Ajouter un évènement sur Plan ₿ Academy

Loïc MorelLoïc Morel
7 sept. 2024
7 sept. 2024
La mission de Plan ₿ Academy est de mettre à disposition des ressources pédagogiques de premier plan sur Bitcoin, et ce, dans un maximum de langues. L'intégralité des contenus publiés sur le site est open source et hébergée sur GitHub, ce qui offre la possibilité à quiconque de participer à l'enrichissement de la plateforme.
Vous souhaitez ajouter une conférence Bitcoin sur le site de Plan ₿ Academy et donner de la visibilité à votre évènement, mais vous ne savez pas comment faire ? Ce tutoriel est fait pour vous !
En revanche, si vous souhaitez ajouter les replays d'une conférence qui s'est déjà déroulée, je vous conseille de lire cet autre tutoriel dans lequel on vous explique comment ajouter une nouvelle ressource sur le site.
  • Tout d'abord, il vous faut avoir un compte sur GitHub. Si vous ne savez pas comment créer un compte, nous avons fait un tutoriel détaillé pour vous accompagner.
  • Cliquez en haut à droite sur le bouton Add file, puis sur Create new file :
  • Si vous n'avez encore jamais contribué sur les contenus de Plan ₿ Academy, vous allez devoir créer votre fork du dépôt original. Faire un fork d'un dépôt consiste à créer une copie de ce dépôt sur votre propre compte GitHub, ce qui vous permet de travailler sur le projet sans affecter le dépôt original. Cliquez sur le bouton Fork this repository :
  • Vous arrivez ensuite sur la page d'édition de GitHub :
  • Créez un dossier pour votre conférence. Pour ce faire, dans la case Name your file..., notez le nom de votre conférence en minuscules avec des tirets à la place des espaces. Par exemple, si votre conférence s'appelle "Paris Bitcoin Conférence", vous devez noter paris-bitcoin-conference. Ajoutez également l'année de votre conférence, par exemple : paris-bitcoin-conference-2024 :
  • Pour valider la création du dossier, il suffit d'ajouter un slash à la suite de votre nom dans la même case, par exemple : paris-bitcoin-conference-2024/. Le fait d'ajouter un slash permet de créer automatiquement un dossier plutôt qu'un fichier :
  • Dans ce dossier, vous allez créer un premier fichier YAML nommé events.yml :
  • Remplissez ce fichier avec les informations relatives à votre conférence à l'aide de ce modèle :
start_date: end_date: address_line_1: address_line_2: address_line_3: name: project: type: conference book_online: false book_in_person: false price_dollars: 0 description: language: - links: website: replay_url: live_url : tags: -
Par exemple, votre fichier YAML pourrait ressembler à celui-ci :
start_date: 2024-08-15 end_date: 2024-08-18 address_line_1: Paris, France address_line_2: address_line_3: name: Paris Bitcoin Conférence 2024 project: Paris Bitcoin Conférence type: conference book_online: false book_in_person: false price_dollars: 0 description: The largest Bitcoin conference in France with over 8,000 participants each year! language: - fr - en - es - it links: website: https://paris.bitcoin.fr/conference replay_url: live_url : tags: - Bitcoiner - General - International
Si vous n'avez pas encore d'identifiant "project" pour votre organisation, vous pouvez l'ajouter en suivant cet autre tutoriel.
  • Une fois vos modifications sur ce fichier terminées, enregistrez-les en cliquant sur le bouton Commit changes... :
  • Ajoutez un titre pour vos modifications, ainsi qu'une courte description :
  • Cliquez sur le bouton vert Propose changes :
  • Vous arrivez ensuite sur une page qui résume tous vos changements :
  • Cliquez sur votre image de profil GitHub en haut à droite, puis sur Your Repositories :
  • Sélectionnez votre fork du dépôt de Plan ₿ Academy :
  • Vous devriez voir apparaître sur le haut de la fenêtre une notification avec votre nouvelle branche. Elle s'appelle sûrement patch-1. Cliquez dessus :
  • Vous êtes maintenant sur votre branche de travail :
  • Retournez dans le dossier resources/conference/ et sélectionnez le dossier de votre conférence que vous venez de créer dans le commit précédent :
  • Dans le dossier de votre conférence, cliquez sur le bouton Add file, puis sur Create new file :
  • Nommez ce nouveau dossier assets et confirmez sa création en mettant un slash / à la fin :
  • Dans ce dossier assets, créez un fichier nommé .gitkeep :
  • Cliquez sur le bouton Commit changes... :
  • Laissez le titre du commit par défaut, et vérifiez bien que la case Commit directly to the patch-1 branch est cochée, puis cliquez sur Commit changes :
  • Retournez dans le dossier assets :
  • Cliquez sur le bouton Add file, puis sur Upload files :
  • Une nouvelle page va s'ouvrir. Glissez et déposez dans la zone une image représentant votre conférence, qui sera affichée sur le site de Plan ₿ Academy :
  • Ça peut être le logo, une miniature ou encore une affiche :
  • Une fois l'image chargée, vérifiez que la case Commit directly to the patch-1 branch est cochée, puis cliquez sur Commit changes :
  • Attention, votre image doit s'appeler thumbnail et doit être au format .webp. Le nom complet du fichier devrait donc être : thumbnail.webp :
  • Retournez dans votre dossier assets et cliquez sur le fichier intermédiaire .gitkeep :
  • Une fois sur le fichier, cliquez sur les 3 petits points en haut à droite, puis sur Delete file :
  • Vérifiez que vous êtes toujours sur la même branche de travail, puis cliquez sur le bouton Commit changes... :
  • Ajoutez un titre et une description à votre commit, puis cliquez sur Commit changes :
  • Revenez à la racine de votre dépôt :
  • Vous devriez voir apparaître un message vous indiquant que votre branche a subi des modifications. Cliquez sur le bouton Compare & pull request :
  • Ajoutez un titre clair et une description sur votre PR :
  • Cliquez sur le bouton Create pull request :
Félicitations ! Votre PR a bien été créée. Un administrateur va maintenant la vérifier et, si tout est conforme, l'intégrer au dépôt principal de Plan ₿ Academy. Vous devriez voir votre évènement apparaître sur le site web quelques jours plus tard.
Pensez bien à suivre le progrès de votre PR. Il est possible qu'un administrateur y laisse un commentaire pour demander des informations supplémentaires. Tant que votre PR n'est pas validée, vous pouvez la consulter dans l'onglet Pull requests sur le dépôt GitHub de Plan ₿ Academy :
Merci beaucoup pour votre précieuse contribution ! :)
Cela a-t-il bien fonctionné pour vous ?
2
0

Auteur

Ce tutoriel a été écrit par Loïc Morel

Vous pouvez dire merci en donnant un pourboire au professeur.

Crédits

Ce tutoriel a été relu par Asi0Flammeus & ProfScofield21

2/3Statut de relecture

Même si cette page est dans sa langue d'origine, une relecture humaine est toujours nécessaire pour garantir son exactitude.

Progress: 2/3Asi0FlammeusProfScofield210 sats
*Les récompenses peuvent varier en fonction du taux de change $

Chaque élément de contenu sur la plateforme est le produit d'un effort collaboratif : chaque leçon, traduction et révision est rendue possible grâce au travail des contributeurs. C'est pour cette raison que nous sommes toujours à la recherche de correcteurs qui peuvent examiner notre contenu dans un grand nombre de langues. Si vous souhaitez participer au processus de relecture, veuillez nous rejoindre dans notre groupe Telegram et consulter notre tutoriel. Nous vous rappelons que ce contenu est open-source - sous licence CC BY-SA - et peut donc être partagé et utilisé librement, à condition que la source originale soit reconnue.