Merge remote-tracking branch 'origin/main' into feature/add-textlint-rule-prh

Author: 3w36zj6

.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
@@ -35,6 +37,8 @@ jobs:
     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,6 +52,8 @@ 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:
@@ -58,28 +64,3 @@ jobs:
         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/typst-docs-web
-    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

CONTRIBUTING.md

@@ -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`のコメントを編集してください。

crates/typst-library/src/html/mod.rs

@@ -17,21 +17,21 @@ pub fn module() -> Module {
     Module::new("html", html)
 }
 
-/// An HTML element that can contain Typst content.
+/// Typstのコンテンツを含むことができるHTML要素。
 ///
-/// Typst's HTML export automatically generates the appropriate tags for most
-/// elements. However, sometimes, it is desirable to retain more control. For
-/// example, when using Typst to generate your blog, you could use this function
-/// to wrap each article in an `<article>` tag.
+/// TypstのHTMLエクスポートは、ほとんどの要素に対して適切なタグを自動的に生成します。
+/// ただし、より細かく制御したい場合もあります。
+/// 例えば、Typstを使ってブログを生成する場合、
+/// この関数を用いると、それぞれの記事を`<article>`タグで囲めます。
 ///
-/// Typst is aware of what is valid HTML. A tag and its attributes must form
-/// syntactically valid HTML. Some tags, like `meta` do not accept content.
-/// Hence, you must not provide a body for them. We may add more checks in the
-/// future, so be sure that you are generating valid HTML when using this
-/// function.
+/// Typstは有効なHTMLが何であるかを認識しています。
+/// タグとその属性は、構文的に有効なHTMLを構成していなければなりません。
+/// `meta`のようないくつかのタグはコンテンツを受け付けません。
+/// したがって、それらに対して本文を提供してはいけません。
+/// 将来的に、この機能に対して更に多くのチェックを追加する可能性があるため、この関数を使用する際は有効なHTMLを生成していることを確認してください。
 ///
-/// Normally, Typst will generate `html`, `head`, and `body` tags for you. If
-/// you instead create them with this function, Typst will omit its own tags.
+/// 通常、Typstは`html`、`head`、および`body`タグを生成します。
+/// 代わりにこの関数でそれらを作成した場合、Typstは自身の生成するタグを省略します。
 ///
 /// ```typ
 /// #html.elem("div", attrs: (style: "background: aqua"))[
@@ -40,17 +40,17 @@ pub fn module() -> Module {
 /// ```
 #[elem(name = "elem")]
 pub struct HtmlElem {
-    /// The element's tag.
+    /// 要素のタグ。
     #[required]
     pub tag: HtmlTag,
 
-    /// The element's HTML attributes.
+    /// 要素のHTML属性。
     #[borrowed]
     pub attrs: HtmlAttrs,
 
-    /// The contents of the HTML element.
+    /// HTML要素の内容。
     ///
-    /// The body can be arbitrary Typst content.
+    /// 本文には任意のTypstコンテンツを指定できます。
     #[positional]
     #[borrowed]
     pub body: Option<Content>,
@@ -64,19 +64,18 @@ impl HtmlElem {
     }
 }
 
-/// An element that lays out its content as an inline SVG.
+/// コンテンツをインラインSVGとしてレイアウトする要素。
 ///
-/// Sometimes, converting Typst content to HTML is not desirable. This can be
-/// the case for plots and other content that relies on positioning and styling
-/// to convey its message.
+/// TypstのコンテンツにはHTMLへの変換が不適切なものがあります。
+/// グラフプロットや、意味を伝えるために位置決めやスタイルに依存するコンテンツが該当します。
 ///
-/// This function allows you to use the Typst layout engine that would also be
-/// used for PDF, SVG, and PNG export to render a part of your document exactly
-/// how it would appear when exported in one of these formats. It embeds the
-/// content as an inline SVG.
+/// この関数を使用すると、
+/// PDF、SVG、およびPNGエクスポートにも使用されるTypstレイアウトエンジンを使用して、
+/// 文書の一部を、これらの形式のいずれかでエクスポートした場合に表示されるのとまったく同じようにレンダリングできます。
+/// この関数はコンテンツをインラインSVGとして埋め込みます。
 #[elem]
 pub struct FrameElem {
-    /// The content that shall be laid out.
+    ///レイアウト対象のコンテンツ。
     #[positional]
     #[required]
     pub body: Content,

website/README.md

@@ -0,0 +1,15 @@
+# website metadata
+
+このディレクトリでは、ドキュメントのWebサイトの構築に必要なメタデータを管理しています。
+
+また、SSG（静的サイトジェネレーター）の本体は、Git submoduleとして別リポジトリの[typst-docs-web](https://github.com/typst-community/typst-docs-web)で管理されています。
+
+## Git submoduleの初期化について
+
+リポジトリを`git clone`する際に`--recursive`オプションを付けていない場合は、以下のコマンドでsubmoduleを初期化・更新できます。
+
+```sh
+git submodule update --init --recursive
+```
+
+これにより、`typst-docs-web`ディレクトリが正しく取得されます。

website/translation-status.json

@@ -162,8 +162,8 @@
 	"/docs/reference/pdf/": "translated",
 	"/docs/reference/pdf/embed/": "translated",
 	"/docs/reference/html/": "translated",
-	"/docs/reference/html/elem/": "untranslated",
-	"/docs/reference/html/frame/": "untranslated",
+	"/docs/reference/html/elem/": "translated",
+	"/docs/reference/html/frame/": "translated",
 	"/docs/reference/png/": "untranslated",
 	"/docs/reference/svg/": "untranslated",
 	"/docs/guides/": "translated",