クイックプルリクエスト
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues
Seeed Studio ファイルへの貢献をご検討いただきありがとうございます!
この簡潔な貢献プロセスは、ローカルでウェブサイトをデプロイする必要なく、迅速にファイルをプルリクエスト(PR)できるようにするものです。変更やページの追加をローカルで確認したい場合は、こちらをクリックしてください。
オールインワンコード
Markdown ファイルと画像のみを追加する場合:
Seeed Studio Wiki Platform の GitHub リポジトリにアクセスし、
wiki-documents
リポジトリを自分のアカウントにfork
してください。以下のコードを一括でコピーしてコマンドを実行します(
{your repo}
を自分のフォークしたリポジトリに置き換えてください):
例えば、私の GitHub ユーザー名が MatthewJeffson
の場合、最初のコマンドは次のようになります:git clone --no-checkout --depth 1 https://github.com/MatthewJeffson/wiki-documents.git
git clone --no-checkout --depth 1 https://github.com/{your repo}/wiki-documents.git
cd wiki-documents
git sparse-checkout init --cone
git sparse-checkout set sidebars.js docs
git switch docusaurus-version
git pull origin docusaurus-version
PC 上に "wiki-documents" というフォルダが作成されます。
- すべてのファイル(Markdown ファイルと画像)を "Contributor_Files" フォルダに保存してください:
- 以下のコマンドを実行して、すべてのファイルを GitHub にプッシュします:
git add .
git commit -m "Add new document"
git push origin docusaurus-version
- 自分のリポジトリで "Pull Request" をクリックすれば完了です。
自動チェック付きのステップバイステップ手順
上記の手順を詳しく説明し、自動チェックコードを紹介します。
まず、以下のコマンドを使用してリポジトリをクローンします:
git clone --no-checkout --depth 1 https://github.com/Seeed-Studio/wiki-documents.git
ここでは、以下のオプションを使用しています:
--no-checkout
: ファイルをチェックアウトせずにリポジトリのメタデータのみを取得します。これによりクローン処理が高速化されます。--depth 1
: 最新のコミットとメタデータのみをクローンし、履歴全体を取得しません。これによりダウンロードするデータ量がさらに削減されます。
クローン後、リポジトリのディレクトリに移動します:
cd wiki-documents
次に、Git のスパースチェックアウト機能を有効にします:
git sparse-checkout init --cone
スパースチェックアウトを使用すると、リポジトリ全体ではなく一部のファイルのみをチェックアウトできます。
--cone
オプションは、より柔軟なパスマッチングをサポートするコーンモードを有効にします。スパースチェックアウトのルールを設定します:
git sparse-checkout set sidebars.js docs
このコマンドは、
sidebars.js
ファイルとdocs
ディレクトリのみをチェックアウトするように Git に指示します。sidebars.js
は Docusaurus の設定ファイルであり、docs
ディレクトリにはすべての Markdown ドキュメントが含まれています。スパースチェックアウトのルールを設定した後、
docusaurus-version
ブランチに切り替えます:git switch docusaurus-version
このステップは、ドキュメントがこのブランチで開発および管理されているため必要です。
ターゲットブランチに切り替えた後、設定されたファイルとディレクトリをプルします:
git pull origin docusaurus-version
このコマンドは、リモートリポジトリの
docusaurus-version
ブランチから最新のsidebars.js
とdocs
をプルします。これで、コントリビューターは
docs
ディレクトリに新しい Markdown ファイルを追加し、sidebars.js
ファイルを編集して新しいドキュメントのパスを追加できます。新しいドキュメントを追加した後、Lint Markdown ツールを使用して新しいファイルの構文をチェックします:
npm install -g @lint-md/cli
npx @lint-md/cli docs/new-file.md新しいファイルに構文エラーや規約違反がある場合、Lint Markdown がプロンプトを表示します。コントリビューターは、エラーメッセージがなくなるまでプロンプトに基づいて修正を行うことができます。
一部の一般的な構文エラーを自動的に修正したい場合は、
--fix
オプションを使用します:npx @lint-md/cli docs/new-file.md --fix
このコマンドは、中国語と英語の間のスペース不足や、誤った省略記号の使用など、一般的なフォーマットの問題を自動的に修正します。
最後に、すべての修正が完了したら、変更をコミットしてリモートリポジトリにプッシュします:
git add .
git commit -m "Add new document"
git push origin docusaurus-versionこれで、新しいドキュメントがリモートリポジトリの
docusaurus-version
ブランチに正常に追加されます。
ステップ 8 と 9 で Lint Markdown ツールを使用することで、新しく追加されたドキュメントが規約に準拠していることを確認し、ドキュメント全体の品質と一貫性を向上させることができます。
この簡潔な貢献プロセスとスパースチェックアウトおよび Lint Markdown の使用により、コントリビューターのワークフローが最適化され、より効率的で使いやすくなります。