Blockly はオープンソースであり、主に小規模なチームによってメンテナンスされています。コアチーム以外のデベロッパーからの貢献を歓迎します。コミュニティなしでは、リクエストされたすべての機能の構築や、報告されたすべてのバグの修正は不可能です。このセクションには、特にオープンソース開発の初心者の方に役立つ一般的なガイドが含まれています。
投稿を行う前に読むべき Blockly 固有の情報については、コアへの投稿とサンプルへの投稿のセクションをご覧ください。
どのリポジトリですか？
リポジトリには、単一のプロジェクトのすべてのファイルが含まれています。Blockly には、blockly core と blockly-samples の 2 つのリポジトリがあります。
Blockly コアは、Blockly ライブラリのリポジトリです。ライブラリのすべてのユーザーに適用される方法で Blockly のコア動作を変更する場合は、このリポジトリを使用します。
Blockly サンプルは、サンプル、プラグイン、コードラボのリポジトリです。プラグインの作成や変更、Codelab の作成、サンプルの作成や変更を行う場合は、このリポジトリを使用します。
詳細な手順
変更を行うたびに、次の一般的な手順に沿って操作します。
- ツール セクションのリンクに沿って、Git と Node をインストールします。
- リポジトリをフォークしてクローンを作成します。GitHub には、リポジトリのフォークに関する優れたチュートリアルがあります。Blockly に適用するには、作業するリポジトリに応じて、octocat/Spoon-Knife のすべてのインスタンスを RaspberryPiFoundation/blockly または RaspberryPiFoundation/blockly-samples に置き換えます。
- フォークを同期します。GitHub には、フォークを同期するチュートリアルもあります。
- メインブランチをチェックアウトします。blockly core では、これは
developブランチです。blockly-samples では、これはmasterブランチです。 - ルート ディレクトリで
npm installを実行して、依存関係とビルドツールをインストールします。 - ターミナルで
git checkout -b myBranchNameを実行して、新しいブランチを作成します。名前は、作業内容を思い出すのに役立つものにしてください。 - 変更を加えます。
- 変更を検証します。コアまたはサンプルのガイドに沿って検証します。
git commit -am "fix: My commit message"を使用して変更を保存します。コミット メッセージの詳細git push origin myBranchNameを使用して、変更を GitHub に push します。- コードの準備ができたら、プルリクエストを開きます。Blockly チームのメンバーが変更内容を確認し、承認された場合は Blockly にマージします。詳細については、PR 審査プロセスをご覧ください。