docs: textlintの説明を追加

.vscode/tasks.json

@@ -12,21 +12,21 @@
       }
     },
     {
-      "label": "textlint-md",
+      "label": "textlint-html",
       "type": "shell",
-      "command": "mise run textlint-md",
+      "command": "mise run textlint-html",
       "problemMatcher": []
     },
     {
-      "label": "textlint-md:fix",
+      "label": "textlint-md",
       "type": "shell",
-      "command": "mise run textlint-md:fix",
+      "command": "mise run textlint-md",
       "problemMatcher": []
     },
     {
-      "label": "textlint-html",
+      "label": "textlint-md:fix",
       "type": "shell",
-      "command": "mise run textlint-html",
+      "command": "mise run textlint-md-fix",
       "problemMatcher": []
     }
   ]

CONTRIBUTING.md

@@ -35,7 +35,7 @@ Typst日本語ドキュメント翻訳プロジェクトにご興味をお持ち
 
 [`./website/`のREADME](https://github.com/typst-jp/typst-jp.github.io/blob/main/website/README.md)を参照してください。
 
-### ローカル環境でWebページを生成する
+### ローカル環境でWebページを生成
 
 当プロジェクトの開発ツールおよびコマンドは[mise](https://mise.jdx.dev/)で一元管理しています。導入していない場合は、[Getting Started | mise-en-place](https://mise.jdx.dev/getting-started.html)に従ってインストールしてください。
 
@@ -69,6 +69,13 @@ Webサイトをローカルサーバーでプレビューするには、以下
 mise run preview
 ```
 
+体裁を確認するには、以下のコマンドを実行します。
+
+```sh
+mise run textlint-html  # Rustソースコードを翻訳した場合
+mise run textlint-md    # Markdownファイルを翻訳した場合
+```
+
 #### miseによる開発環境のセットアップ
 
 > [!NOTE]
@@ -94,7 +101,7 @@ mise trust
 mise install
 ```
 
-#### TypstのソースコードからドキュメントデータのJSONファイルを生成する
+#### TypstのソースコードからドキュメントデータのJSONファイルを生成
 
 ドキュメントデータのJSONファイルは、typst-docsによりTypstのソースコード内のコメントおよび`docs/`にあるMarkdownファイル群から生成されます。
 
@@ -104,7 +111,7 @@ mise install
 mise run generate-docs
 ```
 
-#### ドキュメントデータのJSONファイルからWebサイトを生成する
+#### ドキュメントデータのJSONファイルからWebサイトを生成
 
 Webサイトの生成にはNode.jsとViteとHonoを使用しています。また、パッケージ管理にBunを使用しています。
 
@@ -120,14 +127,40 @@ mise run generate-web
 mise run preview
 ```
 
-#### Webサイトの生成までを一括で行う
+#### Webサイトの生成までを一括実行
 
 `mise run generate`を実行すると、`generate-docs`および`generate-web`を一括で実行します。
 
 ```sh
 mise run generate
 ```
 
+#### 文章校正
+
+[翻訳ガイドライン](./TRANSLATING_GUIDELINES.md)に沿った体裁となっているかを確認するためのtextlintを用意しております。
+`mise run textlint-html`を実行すると、生成されたWebサイトのHTMLコードをtextlintします。
+
+```sh
+mise run textlint-html
+```
+
+現状Rustコードを直接textlintできません。
+そのため、textlintの警告が出た該当箇所のRustコードを手動で修正して、再度`mise run generate`を実行してください。
+textlintの警告内容が不適当であると思われる場合にはIssueやPull Requestにてご報告お願いいたします。
+
+Markdownファイルを翻訳した場合には、`mise run textlint-md`を実行します。
+
+```sh
+mise run textlint-md
+```
+
+直接textlintするMarkdownファイルに関しては、`mise run textlint-md-fix`を実行することで、自動修正も可能です。
+ファイルを上書きするため、Gitで現状を記録した状態で実施することを推奨します。
+
+```sh
+mise run textlint-md-fix
+```
+
 #### Dev Containerによる開発環境のセットアップ
 
 Dockerコンテナー上に上記と同一の環境を構築して作業することも可能です。
@@ -139,8 +172,8 @@ Visual Studio Codeにおける操作フロー例は以下の通りです。
 2. Webサーバーが起動したらブラウザで http://localhost:5173 にアクセスします。
 3. 翻訳したファイルの変更を反映させるためにはCtrl+Shift+Bで再ビルドしてください。
 4. 体裁を確認したい場合、Ctrl+Shift+Pを押してから`> Tasks: Run task`を実行し以下のいずれかを選択します。
-    - `textlint-md` : Markdownファイルを翻訳した場合
     - `textlint-html` : Rustソースコードを翻訳した場合
+    - `textlint-md` : Markdownファイルを翻訳した場合
 5. 自動修正を実施したい場合も同様に以下から選択します。
     - `textlint-md:fix` : Markdownファイルを自動修正します。
     - Rustコードの自動修正は対応していなため、該当箇所を手動で修正してください。