Начните вносить вклад в Blockly

Blockly имеет открытый исходный код и в основном поддерживается небольшой командой. Мы приветствуем вклад разработчиков, не входящих в основную команду; у нас нет возможности создать каждую запрошенную функцию или исправить каждую обнаруженную ошибку без нашего сообщества. Этот раздел содержит общие руководства, которые могут быть вам полезны, особенно если вы новичок в разработке с открытым исходным кодом.

Информацию, касающуюся Blockly, которую вам следует прочитать перед тем, как внести свой вклад, см. в разделах «Вклад в ядро» и «Вклад в образцы» .

Какой репозиторий?

Репозиторий содержит все файлы одного проекта. Blockly имеет два репозитория: Blockly Core и Blockly-Samples.

Blockly core — это репозиторий библиотеки Blockly. Используйте этот репозиторий, если вы хотите внести изменения в основное поведение Blockly таким образом, чтобы оно распространялось на всех пользователей библиотеки.

Blockly Samples — это хранилище образцов, плагинов и лабораторий кода. Используйте этот репозиторий, если вы хотите создать или изменить плагин; написать кодовую лабораторию; или создать или изменить образец.

Шаг за шагом

Это общие шаги, которые вы будете выполнять каждый раз при внесении изменений.

1. Установите Git и Node, перейдя по ссылкам в разделе «Инструменты» .
2. Форкните и клонируйте репозиторий. На GitHub есть замечательное руководство по созданию форка репо . Чтобы применить его к блочному использованию, просто замените каждый экземпляр Octocat/Spoon-Knife на google/blockly или google/blockly-samples , в зависимости от того, в каком репозитории вы хотите работать.
3. Синхронизируйте свою вилку. GitHub также предоставляет руководство по синхронизации вилки .
4. Посмотрите основную ветку. В блочном ядре это ветка develop . В блочных образцах это master ветка.
5. Установите зависимости и инструменты сборки, запустив npm install в корневом каталоге.
6. Создайте новую ветку , запустив git checkout -b myBranchName в терминале. Название должно помочь вам запомнить, над чем вы работаете.
7. Внесите свои изменения.
8. Подтвердите свои изменения, следуя руководству для ядра или образцов .
9. Сохраните изменения с помощью git commit -am "fix: My commit message" . Узнайте больше о сообщениях о фиксации .
10. Отправьте свои изменения на GitHub с помощью git push origin myBranchName .
11. Откройте запрос на включение, когда ваш код будет готов. Член команды Blockly рассмотрит ваши изменения и объединит их в Blockly, если они будут одобрены. Для получения дополнительной информации см. Процесс проверки PR .