Skip to content

Latest commit

 

History

History
54 lines (36 loc) · 2.21 KB

CONTRIBUTING.md

File metadata and controls

54 lines (36 loc) · 2.21 KB

コントリビュートガイド

主な流れ

  1. 自分の GitHub アカウントに Fork する
  2. git clone を実行し, 自分のローカルにリポジトリをクローンする
  3. git checkout -b <branch-name> を実行し, 新しいブランチを作成する
  4. 編集する
  5. git commit -am "<コミット内容> を実行し, コミットする (コンベンショナルコミットは推奨していませんが, ある程度わかりやすいコミットメッセージでコミットしてください.)
  6. git push
  7. GiganticMinecraft/CommandReference に対してプルリクエストを送る
  8. レビューを受ける
  9. マージされる
  10. cmd.seichi.click にデプロイされる
    • デプロイは自動で行われます.

マージするには GiganticMinecraft 運営チームメンバーによるレビューが少なくとも1人必要です.

開発方法

mdbook のインストール方法

CommandReference は mdbook を使用して制作しているため, ブラウザでのプレビューを確認するには mdbook をインストールする必要があります.

cargo install mdbook

Rust をインストールしていない場合はバイナリを直接インストールすることもできます.

ただしリファレンスの実体は Markdown のため, 必ずしもブラウザのプレビューを確認する必要はありません. これは Optional です.

プラグイン

mdbook にはプラグイン機能があり, このリポジトリでは以下のプラグインを使用しています.

mdbook-alertscargo でインストールできます

cargo install mdbook-alerts mdbook-pagetoc

プレビュー表示する

以下のコマンドでローカル上の CommandReference をプレビュー表示できます.

localhost:3000 に公開されますのでブラウザでアクセスしてください.

mdbook serve