Blockly est une solution Open Source principalement gérée par une petite équipe. Nous apprécions les contributions des développeurs qui ne font pas partie de l'équipe principale. Nous n'avons aucun moyen de concevoir toutes les fonctionnalités demandées ni de corriger les bugs signalés sans notre communauté. Cette section contient des guides généraux qui peuvent vous être utiles, en particulier si vous débutez dans le développement Open Source.
Pour obtenir des informations spécifiques à Blockly que vous devez lire avant d'effectuer une contribution, consultez les sections Contribuer à l'essentiel et Contribuer aux exemples.
Quel dépôt ?
Un dépôt contient tous les fichiers d'un seul projet. Blockly possède deux dépôts : "blockly core" et "blockly-samples".
Blockly Core est le dépôt de la bibliothèque Blockly. Utilisez ce dépôt si vous souhaitez modifier le comportement de Blockly principal afin qu'il s'applique à tous les utilisateurs de la bibliothèque.
Les exemples Blockly sont le dépôt des exemples, des plug-ins et des ateliers de programmation. Utilisez ce dépôt si vous souhaitez créer ou modifier un plug-in, écrire un atelier de programmation, ou créer ou modifier un exemple.
Procédure détaillée
Voici la procédure générale à suivre chaque fois que vous apportez une modification.
- Installez Git et Node en suivant les liens de la section Outils.
- Dupliquez et clonez le dépôt. GitHub propose un tutoriel merveilleux sur la duplication d'un dépôt. Pour l'appliquer à "blockblock", il vous suffit de remplacer chaque instance de octocat/Spoon-Knife par google/blockly ou google/blockly-samples, selon le dépôt dans lequel vous souhaitez travailler.
- Synchronisez votre fourchette. GitHub propose également un tutoriel sur la synchronisation d'une fourchette.
- Découvrez la branche principale. En cœur de bloc, il s'agit de la branche
develop. Dans les exemples de blocs, il s'agit de la branchemaster. - Installez les dépendances et créez des outils en exécutant
npm installdans le répertoire racine. - Créez une branche en exécutant
git checkout -b myBranchNamedans un terminal. Le nom doit vous aider à vous souvenir de ce sur quoi vous travaillez. - Apportez vos modifications.
- Validez vos modifications en suivant le guide des échantillons principaux ou des exemples.
- Enregistrez les modifications avec
git commit -am "fix: My commit message". En savoir plus sur les messages de commit - Transférez vos modifications vers GitHub à l'aide de
git push origin myBranchName. - Ouvrez une demande d'extraction lorsque votre code est prêt. Un membre de l'équipe Blockly examinera vos modifications et les fusionnera dans Blockly si elles sont approuvées. Pour en savoir plus, consultez la page Processus d'examen des relations publiques.