- rpgtkoolmv/corescript で開発されている、RPG ツクール MVのコアスクリプトのリファレンスを作る非公式プロジェクトです。
- コアスクリプトを JSDoc によりドキュメント生成したものを Markdown に変換したドキュメントを元に編集を行っていきます。
- このプロジェクトは始まったばかりです!ぜひ皆さんもご協力お願いします。
docs/jsdoc/を直接書き換える。- 相談が必要な内容の変更はブランチを分けて行い、切りのよいところで PullRequest を提出
- PullRequest が問題なければ、 master ブランチにマージを行う
- GitHub-Pages 上のリファレンスページに対応するようにリンクの連携を行ってください。
- GitHub-Pages での反映には数分〜数十分時間がかかることがあります。
- 編集後・マージ後は必ずコミットログを確認してください。:heavy_check_mark:のときは成功、:full_moon:は検証中、:x:のときは失敗です。失敗を直さないとずっと自動更新が止まり続ける可能性があります。
- 絶対に
git reset --hardしないでください。
- ジャイアントコミット(大きな変更を一気に行う)を避ける
- 相談事や不具合報告はすべてIssuesにスレ立てする
- 編集後、必ずコミットログと反映後のリファレンスページを確認して、問題がないことを確認する
- 大きな変更や一括変更を行う場合、ローカルに落として作業してブランチを分けてからプルリクを投げる。
- ブランチ名は
feature/YYYYMMDD-this-is-branch-nameに従う
- GitHub アカウントを作る
docs/jsdoc/から編集するファイルを選ぶ- 右上にある鉛筆マークをクリック
- エディタが開くので、編集作業を行う
- 編集が終わったら一番下にある
Commit changesを入力する
- 上から1つ目の小さい入力欄は
編集内容を1行で表し入力する - 上から2つ目の入力欄は
編集内容を詳しく説明し入力する(省略可) - チェックボックスは
Commit directly to the master branchを選ぶ
Commit changesを押して決定
- GitHub アカウントを作る
docs/jsdoc/から編集するファイルを選ぶ- 右上にある鉛筆マークをクリック
- エディタが開くので、編集作業を行う
- 編集が終わったら一番下にある
Commit changesを入力する
- 上から1つ目の小さい入力欄は
編集内容を1行で表し入力する - 上から2つ目の入力欄は
編集内容を詳しく説明し入力する(省略可) - チェックボックスは
Create a new branch for this commit and start a pull request.を選ぶ
Will be created asの横にある入力欄はデフォルトのままで OK
- できれば、
feature/20181104-update-XXXXのようにわかりやすいネーミングにするとより良い
Propose file changeを押して決定- プルリクエスト登録画面が開くので、タイトルの入力欄に相談内容のタイトル、大きな入力欄に相談内容の詳細を入力
Create pull requestをクリック- 管理者がマージするのを待つ
- GitHub アカウントを作り、Git をインストール
- コマンドプロンプトで
git clone https://github.com/katai5plate/RPGMV-CoreScript-Reference.git - コマンドプロンプトのカレントディレクトリにファイルがダウンロードされるので、そこで直接ファイルを編集する
- 編集を行う内容でブランチを作成する。
RPGMV-CoreScript-Referenceディレクトリをカレントディレクトリにして、コマンドプロンプトからgit checkout -b "feature/YYYYMMDD-ブランチ名"を入力。YYYYMMDDは 2018年11月04日 なら 20181104 というように書く。ブランチ名は英数とハイフン区切りで編集内容を短く書く。例:feature/20181104-update-XXXX-pages - 編集を開始し、一段落終わったらちょくちょくコミット作業を行う
RPGMV-CoreScript-Referenceディレクトリをカレントディレクトリにして、コマンドプロンプトからgit add -Aを入力。すると変更がターゲティングされる。- つぎに
git commit -m "コミット内容"を入力。コミット内容にここまでの変更内容を簡単に書く。
- 作業中のブランチでの編集を終わらせたら、コミット作業を終えて、
RPGMV-CoreScript-Referenceディレクトリをカレントディレクトリにしたコマンドプロンプトからgit push origin ブランチ名を入力。ブランチ名は3.で入力したものと同じ。例:git push origin feature/20181104-update-XXXX-pages - 成功したらここにアクセス
base:masterになっていることを確認し、compare:から自分のブランチを選ぶ。- プルリクエスト登録画面が開くので、タイトルの入力欄に相談内容のタイトル、大きな入力欄に相談内容の詳細を入力
Create pull requestをクリック- 管理者がマージするのを待つ