From bf95fd78b5a79df5971193a6929297859d907759 Mon Sep 17 00:00:00 2001 From: tsuna-can-se <61451753+tsuna-can-se@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:15:12 +0900 Subject: [PATCH 1/4] =?UTF-8?q?cspell=E3=81=AE=E9=87=8D=E8=A4=87=E3=81=97?= =?UTF-8?q?=E3=81=9F=E8=A8=98=E8=BF=B0=E3=82=92=E5=89=8A=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- documents/README.md | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/documents/README.md b/documents/README.md index fcfc45a08..b61c1bd3a 100644 --- a/documents/README.md +++ b/documents/README.md @@ -239,14 +239,7 @@ CSpell の拡張機能をインストールしていると、 [問題] ウィン この拡張機能は、英単語のスペルミスを検出するために導入するものであり、コメントの多くはスペルミスに起因しています。 必ず対応するようにしてください。 -複合語や技術用語は、辞書登録しないと誤検知されることがあります。 -[cspell.json] ファイルの `words` に単語を登録するようにしてください。 - -コード内や設定ファイル内の文字など、単語登録することが望ましくないと考える場合は、以下の記事を参照して、各ページで抑制してください。 -CSpell が実行されないようにするのではなく、そのページ内で使用する抑制しても良い単語を、ページの先頭に記述する方式で抑制しましょう。 -このページの上部にも設定してあります。 - - +詳細は「[用語集の整理](#用語集の整理)」を参照してください。 #### textlint @@ -285,7 +278,8 @@ CSpell の拡張機能をインストールしていると、 [問題] ウィン 以下を参照して、ページ内に `cspell:ignore` を追加して、警告を除外する用語を追加してください。 設定はページ最上部に記述します。 - + - + - ### 各ページの title/description の設定 From 70ab5917be041fd8d4a59693de8e20ec0a47cf0e Mon Sep 17 00:00:00 2001 From: tsuna-can-se <61451753+tsuna-can-se@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:16:18 +0900 Subject: [PATCH 2/4] =?UTF-8?q?=E5=B8=B8=E6=99=82=E5=8F=82=E7=85=A7?= =?UTF-8?q?=E3=81=99=E3=82=8B=E9=83=A8=E5=88=86=E3=81=8C=E5=89=8D=E5=8D=8A?= =?UTF-8?q?=E3=81=AB=E6=9D=A5=E3=82=8B=E3=82=88=E3=81=86=E6=A7=8B=E6=88=90?= =?UTF-8?q?=E3=82=92=E5=A4=89=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- documents/README.md | 161 ++++++++++++++++++++++---------------------- 1 file changed, 82 insertions(+), 79 deletions(-) diff --git a/documents/README.md b/documents/README.md index b61c1bd3a..d181fab86 100644 --- a/documents/README.md +++ b/documents/README.md @@ -58,85 +58,8 @@ documents フォルダー配下のフォルダー、ファイルの配置は以 ## ドキュメント作成手順 -### ドキュメント作成環境の構築 - -#### Visual Studio Code のインストール - -ドキュメント作成のエディターとして、 Visual Studio Code を利用します。 -以下のサイトから最新版の Visual Studio Code をインストールします。 - - - -#### Visual Studio Code の拡張機能のインストール - -Visual Studio Code の [ファイル] メニューから [ワークスペースを開く] を選択します。 -クローンしたフォルダー内にある maia.code-workspace ファイルを選択して開きます。 - -はじめてワークスペースを開いたとき、以下のようなダイアログが表示されるので、 [インストール] ボタンを押下します。 - -![このリポジトリにお勧めの拡張機能をインストールしますか](readme-images/install-vscode-extensions.png) - -このダイアログ経由でインストールしなかった場合は、 [拡張機能] メニューから [推奨] のグループを開いて、以下の拡張機能をインストールします。 - -- [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) -- [Draw.io integration](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) -- [Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one) -- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) -- [vscode-textlint](https://marketplace.visualstudio.com/items?itemName=taichi.vscode-textlint) - -![拡張機能メニュー](readme-images/recommend-vscode-extensions.png) - -AlesInfiny Maia OSS Edition のリポジトリは Github-flow で開発します。 -Visual Studio Code 上で Pull Request を発行する際には、以下の拡張機能をインストールします。 - -- [Github Pull Requests](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) - -また、必要に応じて以下の拡張機能をインストールします。 - -- [Japanese Language Pack for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-ja) -- [Markdown Preview Mermaid Support](https://marketplace.visualstudio.com/items?itemName=bierner.markdown-mermaid) -- [Table Formatter](https://marketplace.visualstudio.com/items?itemName=shuworks.vscode-table-formatter) - -#### Node.js のインストール - -以下のサイトから安定版の Node.js インストーラーをダウンロードし、インストールしてください。 - - - -#### Node モジュールのインストール - -本リポジトリでは textlint を使用して、校正を自動化します。 -以下のコマンドを実行して、 textlint の実行に必要な Node モジュールをインストールしてください。 -モジュールの更新も同じコマンドで実行できます。 - -```plane -npm ci -``` - -#### Pythonのインストール - -以下のサイトから、 Windows 用の最新版 Python をインストールします。 -インストール時に [Add Python 3.x to PATH] へチェックを入れてからインストールしてください。 - - - -コマンドプロンプトを管理者権限で起動します。 -以下のコマンドを実行して pip を更新します。 - -```plain -pip install --upgrade pip -``` - -#### Python モジュールのインストール - -本リポジトリでは、 yamllint を使用して、 YAML ファイルの Lint を自動化します。 -また、 Mkdocs を用いて、マークダウンから Web サイトを生成します。 -以下のコマンドを実行して、必要なモジュールを一括でインストールします。 -モジュールの更新も同じコマンドで実行できます。 - -```plain -pip install -r requirements.txt -``` +最初に「[ドキュメント作成環境の構築](#ドキュメント作成環境の構築)」に従って、ドキュメント作成環境を構築してください。 +ドキュメントの作成にあたり、以下の手順、規則に従って作成してください。 ### ドキュメントの作成 @@ -391,4 +314,84 @@ Pull Request を発行すると、ドキュメントの体裁をチェックす ![ワークフローでエラーが発生した場合の詳細画面](readme-images/github-lint-error-results.png) +## ドキュメント作成環境の構築 + +### Visual Studio Code のインストール + +ドキュメント作成のエディターとして、 Visual Studio Code を利用します。 +以下のサイトから最新版の Visual Studio Code をインストールします。 + + + +### Visual Studio Code の拡張機能のインストール + +Visual Studio Code の [ファイル] メニューから [ワークスペースを開く] を選択します。 +クローンしたフォルダー内にある maia.code-workspace ファイルを選択して開きます。 + +はじめてワークスペースを開いたとき、以下のようなダイアログが表示されるので、 [インストール] ボタンを押下します。 + +![このリポジトリにお勧めの拡張機能をインストールしますか](readme-images/install-vscode-extensions.png) + +このダイアログ経由でインストールしなかった場合は、 [拡張機能] メニューから [推奨] のグループを開いて、以下の拡張機能をインストールします。 + +- [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) +- [Draw.io integration](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) +- [Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one) +- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) +- [vscode-textlint](https://marketplace.visualstudio.com/items?itemName=taichi.vscode-textlint) + +![拡張機能メニュー](readme-images/recommend-vscode-extensions.png) + +AlesInfiny Maia OSS Edition のリポジトリは Github-flow で開発します。 +Visual Studio Code 上で Pull Request を発行する際には、以下の拡張機能をインストールします。 + +- [Github Pull Requests](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) + +また、必要に応じて以下の拡張機能をインストールします。 + +- [Japanese Language Pack for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-ja) +- [Markdown Preview Mermaid Support](https://marketplace.visualstudio.com/items?itemName=bierner.markdown-mermaid) +- [Table Formatter](https://marketplace.visualstudio.com/items?itemName=shuworks.vscode-table-formatter) + +### Node.js のインストール + +以下のサイトから安定版の Node.js インストーラーをダウンロードし、インストールしてください。 + + + +### Node モジュールのインストール + +本リポジトリでは textlint を使用して、校正を自動化します。 +以下のコマンドを実行して、 textlint の実行に必要な Node モジュールをインストールしてください。 +モジュールの更新も同じコマンドで実行できます。 + +```plane +npm ci +``` + +### Pythonのインストール + +以下のサイトから、 Windows 用の最新版 Python をインストールします。 +インストール時に [Add Python 3.x to PATH] へチェックを入れてからインストールしてください。 + + + +コマンドプロンプトを管理者権限で起動します。 +以下のコマンドを実行して pip を更新します。 + +```plain +pip install --upgrade pip +``` + +### Python モジュールのインストール + +本リポジトリでは、 yamllint を使用して、 YAML ファイルの Lint を自動化します。 +また、 Mkdocs を用いて、マークダウンから Web サイトを生成します。 +以下のコマンドを実行して、必要なモジュールを一括でインストールします。 +モジュールの更新も同じコマンドで実行できます。 + +```plain +pip install -r requirements.txt +``` + From d4ab05d7745bf93690d60ec2502c20aac14ba64d Mon Sep 17 00:00:00 2001 From: tsuna-can-se <61451753+tsuna-can-se@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:16:44 +0900 Subject: [PATCH 3/4] =?UTF-8?q?=E3=83=89=E3=82=AD=E3=83=A5=E3=83=A1?= =?UTF-8?q?=E3=83=B3=E3=83=88=E4=BD=9C=E6=88=90=E3=81=AB=E4=B8=8D=E8=A6=81?= =?UTF-8?q?=E3=81=AA=E6=8B=A1=E5=BC=B5=E6=A9=9F=E8=83=BD=E3=82=92=E5=89=8A?= =?UTF-8?q?=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- documents/README.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/documents/README.md b/documents/README.md index d181fab86..8a28eb8c6 100644 --- a/documents/README.md +++ b/documents/README.md @@ -342,11 +342,6 @@ Visual Studio Code の [ファイル] メニューから [ワークスペース ![拡張機能メニュー](readme-images/recommend-vscode-extensions.png) -AlesInfiny Maia OSS Edition のリポジトリは Github-flow で開発します。 -Visual Studio Code 上で Pull Request を発行する際には、以下の拡張機能をインストールします。 - -- [Github Pull Requests](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) - また、必要に応じて以下の拡張機能をインストールします。 - [Japanese Language Pack for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-ja) From 85886267ee3f88cf7f28cd14d07eeeb3a0f615c4 Mon Sep 17 00:00:00 2001 From: tsuna-can-se <61451753+tsuna-can-se@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:17:43 +0900 Subject: [PATCH 4/4] =?UTF-8?q?cspell=20ignore=E3=81=8B=E3=82=89=E6=9C=AA?= =?UTF-8?q?=E4=BD=BF=E7=94=A8=E3=81=AE=E7=94=A8=E8=AA=9E=E3=82=92=E5=89=8A?= =?UTF-8?q?=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- documents/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/README.md b/documents/README.md index 8a28eb8c6..4b14761f1 100644 --- a/documents/README.md +++ b/documents/README.md @@ -1,6 +1,6 @@ - + # AlesInfiny Maia OSS Edition ドキュメントについて ## 本番環境