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

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

Информацию, относящуюся к Blockly, которую вы должны прочитать, прежде чем вносить свой вклад, см. в разделах Contributing to Core и Contributing to Samples .

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

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

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

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

Шаг за шагом

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

  1. Установите Git и Node по ссылкам в разделе « Инструменты ».
  2. Разветвите и клонируйте репозиторий. На GitHub есть замечательный туториал по разветвлению репо . Чтобы применить его к blockly, просто замените каждый экземпляр 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 .
,

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

Информацию, относящуюся к Blockly, которую вы должны прочитать, прежде чем вносить свой вклад, см. в разделах Contributing to Core и Contributing to Samples .

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

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

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

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

Шаг за шагом

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

  1. Установите Git и Node по ссылкам в разделе « Инструменты ».
  2. Разветвите и клонируйте репозиторий. На GitHub есть замечательный туториал по разветвлению репо . Чтобы применить его к blockly, просто замените каждый экземпляр 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 .