Merge branch 'main' into translate-layout/grid

Author: ultimatile

.github/workflows/website.yml

@@ -15,6 +15,8 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          submodules: recursive
       - uses: jdx/mise-action@13abe502c30c1559a5c37dff303831bab82c9402 # v2.2.3
       - uses: Swatinem/rust-cache@9d47c6ad4b02e050fd481d890b2ea34778fd09d6 # v2.7.8
       - run: mise run generate-docs
@@ -23,18 +25,20 @@ jobs:
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
           name: build-artifacts
-          path: website/dist
+          path: website/typst-docs-web/dist
       - name: Deploy
         if: github.ref == 'refs/heads/main'
         uses: JamesIves/github-pages-deploy-action@6c2d9db40f9296374acc17b90404b6e8864128c8 # v4.7.3
         with:
-          folder: website/dist # The folder the action should deploy.
+          folder: website/typst-docs-web/dist # The folder the action should deploy.
 
   textlint-md:
     runs-on: ubuntu-24.04
     steps:
       - name: Checkout the repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          submodules: recursive
       - name: Setup tools
         uses: jdx/mise-action@13abe502c30c1559a5c37dff303831bab82c9402 # v2.2.3
       - name: Install dependencies
@@ -48,38 +52,15 @@ jobs:
     steps:
       - name: Checkout the repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          submodules: recursive
       - name: Download build artifacts
         uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
         with:
           name: build-artifacts
-          path: website/dist
+          path: website/typst-docs-web/dist
       - uses: jdx/mise-action@13abe502c30c1559a5c37dff303831bab82c9402 # v2.2.3
       - name: Install dependencies
         run: bun install --frozen-lockfile
       - name: Lint HTML using textlint
         run: bun run --bun textlint-html
-
-  website-ci:
-    runs-on: ubuntu-24.04
-    defaults:
-      run:
-        working-directory: ./website
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - task: biome
-            name: "Run Biome CI"
-            command: "bun biome ci ."
-          - task: vitest
-            name: "Run test runner"
-            command: "bun run test"
-    steps:
-      - name: Checkout the repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-      - name: Setup tools
-        uses: jdx/mise-action@13abe502c30c1559a5c37dff303831bab82c9402 # v2.2.3
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-      - name: ${{ matrix.name }}
-        run: ${{ matrix.command }}

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "website/typst-docs-web"]
+	path = website/typst-docs-web
+	url = ../../typst-community/typst-docs-web.git

.mise.toml

@@ -1,3 +1,3 @@
 # hayagrivaのsrc/csl/archive.rsで管理されている参考文献フォーマット
-website/dist/docs/reference/model/bibliography/index.html
-website/dist/docs/reference/model/cite/index.html
+website/typst-docs-web/dist/reference/model/bibliography/index.html
+website/typst-docs-web/dist/reference/model/cite/index.html

.textlintignore

@@ -5,11 +5,29 @@ module.exports = {
   plugins: ["html"],
   filters: {
     comments: true,
+    allowlist: {
+      allow: ["/<(code|pre)[^>]*>[\\s\\S]*?</(code|pre)>/"],
+    },
   },
   rules: {
     "preset-jtf-style": {
+      // デフォルトで無効のため
+      "2.1.5.カタカナ": true,
+      // デフォルトで無効のため
+      "2.1.6.カタカナの長音": true,
+      // デフォルトで無効のため
+      "2.2.1.ひらがなと漢字の使い分け": true,
       // 階層構造を表現する記号としての>の使用例があるため
       "4.3.7.山かっこ<>": false,
     },
+    prh: {
+      rulePaths: ["./prh.yaml"],
+      checkLink: false,
+      checkBlockQuote: false,
+      checkEmphasis: true,
+      checkHeader: true,
+      checkParagraph: true,
+      checkCodeComment: [],
+    },
   },
 };

.textlintrc.js

@@ -16,7 +16,7 @@ Typst日本語ドキュメント翻訳プロジェクトにご興味をお持ち
 > [!WARNING]
 > ここに記載されている内容は改訂中です。現在の手順は最新の[Pull Request](https://github.com/typst-jp/docs/pulls?q=sort%3Aupdated-desc+is%3Apr+is%3Aopen)を参照してください。
 
-1. このGitHubリポジトリをフォークします。
+1. このGitHubリポジトリをフォークします。Git submoduleを含むため、リポジトリを`git clone`する際に`--recursive`オプションを付けてください。
 2. ドキュメントの実体は、主にMarkdownファイルおよびコンパイラのソースコード内のコメントの2種類から構成されています。それぞれ、下記の注意書きに従って翻訳作業をお願いします。
     - `./crates/typst-library/src/`内の`.rs`ファイル群は、Typstのコンパイラのソースコードです。ソースコード内に含まれている、**既存のコメントを直接書き換えて翻訳してください**。
         - 例1：[Reference > Foundations](https://typst.app/docs/reference/foundations/)を翻訳する際は、`./crates/typst-library/src/foundations/mod.rs`のコメントを編集してください。
@@ -86,7 +86,7 @@ mise run textlint-md    # Markdownファイルを翻訳した場合
 miseが導入されている環境で初めて当プロジェクトのルートディレクトリに移動すると、以下のように構成ファイルを信頼することを求められます。
 
 ```plaintext
-mise ERROR Config file /path/to/typst-jp.github.io/.mise.toml is not trusted.
+mise ERROR Config file /path/to/typst-jp.github.io/mise.toml is not trusted.
 Trust it with `mise trust`.
 mise ERROR Run with --verbose or MISE_VERBOSE=1 for more information
 ```