Blockly имеет открытый исходный код и в основном поддерживается небольшой командой. Мы приветствуем вклад разработчиков, не входящих в основную команду; у нас нет возможности создать каждую запрошенную функцию или исправить каждую обнаруженную ошибку без нашего сообщества. Этот раздел содержит общие руководства, которые могут быть вам полезны, особенно если вы новичок в разработке с открытым исходным кодом.
Информацию, относящуюся к Blockly, которую вы должны прочитать, прежде чем вносить свой вклад, см. в разделах Contributing to Core и Contributing to Samples .
Какой репозиторий?
Репозиторий содержит все файлы для одного проекта. Blockly имеет два репозитория: blockly core и blockly-samples.
Blockly core — это репозиторий для библиотеки Blockly. Используйте этот репозиторий, если вы хотите внести изменения в основное поведение Blockly таким образом, чтобы они применялись ко всем пользователям библиотеки.
Образцы Blockly — это репозиторий для образцов, плагинов и лабораторий кода. Используйте этот репозиторий, если хотите создать или изменить плагин; написать кодлаб; или создать или изменить образец.
Шаг за шагом
Это общие шаги, которые вы будете выполнять каждый раз, когда будете вносить изменения.
- Установите Git и Node по ссылкам в разделе « Инструменты ».
- Разветвите и клонируйте репозиторий. На GitHub есть замечательный туториал по разветвлению репо . Чтобы применить его к blockly, просто замените каждый экземпляр octocat/Spoon-Knife на google/blockly или google/blockly-samples , в зависимости от того, с каким репозиторием вы хотите работать.
- Синхронизируйте свою вилку. GitHub также предоставляет руководство по синхронизации форка .
- Посмотрите основную ветку. В блочном ядре это ветка
develop
. В блочных образцах этоmaster
ветка. - Установите зависимости и инструменты сборки, запустив
npm install
в корневом каталоге. - Создайте новую ветку , запустив
git checkout -b myBranchName
в терминале. Название должно помочь вам вспомнить, над чем вы работаете. - Внесите свои изменения.
- Подтвердите свои изменения, следуя руководству для ядра или образцов .
- Сохраните изменения с помощью
git commit -am "fix: My commit message"
. Подробнее о сообщениях фиксации . - Отправьте свои изменения на GitHub с помощью
git push origin myBranchName
. - Откройте запрос на извлечение, когда ваш код будет готов. Член команды Blockly рассмотрит ваши изменения и объединит их с Blockly, если они будут одобрены. Для получения дополнительной информации см. Процесс проверки PR .
Blockly имеет открытый исходный код и в основном поддерживается небольшой командой. Мы приветствуем вклад разработчиков, не входящих в основную команду; у нас нет возможности создать каждую запрошенную функцию или исправить каждую обнаруженную ошибку без нашего сообщества. Этот раздел содержит общие руководства, которые могут быть вам полезны, особенно если вы новичок в разработке с открытым исходным кодом.
Информацию, относящуюся к Blockly, которую вы должны прочитать, прежде чем вносить свой вклад, см. в разделах Contributing to Core и Contributing to Samples .
Какой репозиторий?
Репозиторий содержит все файлы для одного проекта. Blockly имеет два репозитория: blockly core и blockly-samples.
Blockly core — это репозиторий для библиотеки Blockly. Используйте этот репозиторий, если вы хотите внести изменения в основное поведение Blockly таким образом, чтобы они применялись ко всем пользователям библиотеки.
Образцы Blockly — это репозиторий для образцов, плагинов и лабораторий кода. Используйте этот репозиторий, если хотите создать или изменить плагин; написать кодлаб; или создать или изменить образец.
Шаг за шагом
Это общие шаги, которые вы будете выполнять каждый раз, когда будете вносить изменения.
- Установите Git и Node по ссылкам в разделе « Инструменты ».
- Разветвите и клонируйте репозиторий. На GitHub есть замечательный туториал по разветвлению репо . Чтобы применить его к blockly, просто замените каждый экземпляр octocat/Spoon-Knife на google/blockly или google/blockly-samples , в зависимости от того, с каким репозиторием вы хотите работать.
- Синхронизируйте свою вилку. GitHub также предоставляет руководство по синхронизации форка .
- Посмотрите основную ветку. В блочном ядре это ветка
develop
. В блочных образцах этоmaster
ветка. - Установите зависимости и инструменты сборки, запустив
npm install
в корневом каталоге. - Создайте новую ветку , запустив
git checkout -b myBranchName
в терминале. Название должно помочь вам вспомнить, над чем вы работаете. - Внесите свои изменения.
- Подтвердите свои изменения, следуя руководству для ядра или образцов .
- Сохраните изменения с помощью
git commit -am "fix: My commit message"
. Подробнее о сообщениях фиксации . - Отправьте свои изменения на GitHub с помощью
git push origin myBranchName
. - Откройте запрос на извлечение, когда ваш код будет готов. Член команды Blockly рассмотрит ваши изменения и объединит их с Blockly, если они будут одобрены. Для получения дополнительной информации см. Процесс проверки PR .