Merge remote-tracking branch 'origin/main' into translation-in-single-file

Author: 3w36zj6

.gitignore

@@ -27,6 +27,6 @@ package-lock.json
 /result
 .direnv/
 
-# Documentation
-/assets/docs
-/assets/docs.json
+# Generated documentation
+/assets
+/docs.json

.mise.toml

@@ -9,14 +9,11 @@ yes = true
 idiomatic_version_file_enable_tools = []
 
 [tasks.generate-docs]
-run = "cargo test --package typst-docs --lib -- tests::test_docs --exact --nocapture"
+run = "cargo run --package typst-docs -- --assets-dir assets --out-file docs.json --base /docs/"
 
 [tasks.generate-web]
 depends = ["install-website"]
-run = [
-    "bun install --frozen-lockfile",
-    "bun run build",
-]
+run = ["bun run build"]
 dir = "./website"
 
 [tasks.generate]

crates/typst-library/src/foundations/cast.rs

@@ -478,25 +478,25 @@ cast! {
         MathClass::Vary => "vary",
         MathClass::Special => "special",
     }),
-    /// The default class for non-special things.
+    /// 特別でない要素のデフォルトクラス。
     "normal" => MathClass::Normal,
-    /// Punctuation, e.g. a comma.
+    /// カンマなどの句読点。
     "punctuation" => MathClass::Punctuation,
-    /// An opening delimiter, e.g. `(`.
+    /// `(`などの開き区切り文字。
     "opening" => MathClass::Opening,
-    /// A closing delimiter, e.g. `)`.
+    /// `)`などの閉じ区切り文字。
     "closing" => MathClass::Closing,
-    /// A delimiter that is the same on both sides, e.g. `|`.
+    /// `|`などの両側が同じ区切り文字。
     "fence" => MathClass::Fence,
-    /// A large operator like `sum`.
+    /// `sum`のような大型演算子。
     "large" => MathClass::Large,
-    /// A relation like `=` or `prec`.
+    /// `=`や`prec`のような関係記号。
     "relation" => MathClass::Relation,
-    /// A unary operator like `not`.
+    /// `not`のような単項演算子。
     "unary" => MathClass::Unary,
-    /// A binary operator like `times`.
+    /// `times`のような二項演算子。
     "binary" => MathClass::Binary,
-    /// An operator that can be both unary or binary like `+`.
+    /// `+`のような単項にも二項にもなる演算子。
     "vary" => MathClass::Vary,
 }
 

crates/typst-library/src/layout/page.rs

@@ -175,7 +175,7 @@ pub struct PageElem {
     /// 印刷規模が大きい場合は、このプロパティを設定せず、あらかじめ染色された用紙を調達したほうが環境にも優しくコスト削減もできるでしょう。
     ///
     /// `{none}`に設定すると背景は透明になります。
-    /// ビューワーではPDFのページに（通常は白色の）背景があるように見えますが、実際は透明であることに注意してください（印刷時には背景に色が使用されません）。
+    /// ビューアーではPDFのページに（通常は白色の）背景があるように見えますが、実際は透明であることに注意してください（印刷時には背景に色が使用されません）。
     ///
     /// デフォルト値の`{auto}`は、PDF出力の場合は`{none}`となり、PNGおよびSVG出力の場合は`{white}`になります。
     ///

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

@@ -119,15 +119,13 @@ impl AlignPointElem {
     }
 }
 
-/// Forced use of a certain math class.
+/// 特定の数式クラスを強制的に適用。
 ///
-/// This is useful to treat certain symbols as if they were of a different
-/// class, e.g. to make a symbol behave like a relation. The class of a symbol
-/// defines the way it is laid out, including spacing around it, and how its
-/// scripts are attached by default. Note that the latter can always be
-/// overridden using [`{limits}`](math.limits) and [`{scripts}`](math.scripts).
+/// これは、特定の記号を異なるクラスのように扱うのに便利です。例えば、ある記号を関係のように振る舞わせることができます。
+/// 記号のクラスは、レイアウトのされ方、周囲の空白の入れ方、添え字がデフォルトでどのように取り付けられるかを定義します。
+/// 添え字の取り付け方は[`{limits}`](math.limits)や[`{scripts}`](math.scripts)を使って常に上書きできることに注意してください。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #let loves = math.class(
 ///   "relation",
@@ -138,11 +136,11 @@ impl AlignPointElem {
 /// ```
 #[elem(Mathy)]
 pub struct ClassElem {
-    /// The class to apply to the content.
+    /// コンテンツに適用するクラス。
     #[required]
     pub class: MathClass,
 
-    /// The content to which the class is applied.
+    /// クラスを適用するコンテンツ。
     #[required]
     pub body: Content,
 }

crates/typst-library/src/math/style.rs

@@ -1,81 +1,79 @@
 use crate::foundations::{func, Cast, Content, Smart};
 use crate::math::EquationElem;
 
-/// Bold font style in math.
+/// 数式中の太字フォントスタイル。
 ///
 /// ```example
 /// $ bold(A) := B^+ $
 /// ```
 #[func(keywords = ["mathbf"])]
 pub fn bold(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_bold(true))
 }
 
-/// Upright (non-italic) font style in math.
+/// 数式中の立体（非斜体）フォントスタイル。
 ///
 /// ```example
 /// $ upright(A) != A $
 /// ```
 #[func(keywords = ["mathup"])]
 pub fn upright(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_italic(Smart::Custom(false)))
 }
 
-/// Italic font style in math.
+/// 数式中の斜体フォントスタイル。
 ///
-/// For roman letters and greek lowercase letters, this is already the default.
+/// これがローマ字とギリシャ文字の小文字のデフォルトです。
 #[func(keywords = ["mathit"])]
 pub fn italic(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_italic(Smart::Custom(true)))
 }
 
-/// Serif (roman) font style in math.
+/// 数式中のセリフ（ローマン）フォントスタイル。
 ///
-/// This is already the default.
+/// これがデフォルトです。
 #[func(keywords = ["mathrm"])]
 pub fn serif(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Serif))
 }
 
-/// Sans-serif font style in math.
+/// 数式中のサンセリフフォントスタイル。
 ///
 /// ```example
 /// $ sans(A B C) $
 /// ```
 #[func(title = "Sans Serif", keywords = ["mathsf"])]
 pub fn sans(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Sans))
 }
 
-/// Calligraphic font style in math.
+/// 数式中のカリグラフィーフォントスタイル。
 ///
 /// ```example
 /// Let $cal(P)$ be the set of ...
 /// ```
 ///
-/// This corresponds both to LaTeX's `\mathcal` and `\mathscr` as both of these
-/// styles share the same Unicode codepoints. Switching between the styles is
-/// thus only possible if supported by the font via
-/// [font features]($text.features).
+/// このスタイルはLaTeXの`\mathcal`と`\mathscr`の両方に対応します。
+/// これは両スタイルが同じUnicodeのコードポイントを共有しているためです。
+/// このため、スタイル間の切り替えは[フォントフィーチャー]($text.features)を用いてサポートされているフォントでのみ可能です。
 ///
-/// For the default math font, the roundhand style is available through the
-/// `ss01` feature. Therefore, you could define your own version of `\mathscr`
-/// like this:
+/// デフォルトの数式フォントでは、ラウンドハンドスタイル（丸みを帯びた筆記体）が`ss01`フィーチャーとして利用可能です。
+/// したがって、以下のように独自の`\mathscr`が定義できます。
 ///
 /// ```example
 /// #let scr(it) = text(
@@ -86,46 +84,44 @@ pub fn sans(
 /// We establish $cal(P) != scr(P)$.
 /// ```
 ///
-/// (The box is not conceptually necessary, but unfortunately currently needed
-/// due to limitations in Typst's text style handling in math.)
+/// （ボックスは概念的には不要ですが、現在のTypstの数式テキストスタイル処理の制約により必要です）
 #[func(title = "Calligraphic", keywords = ["mathcal", "mathscr"])]
 pub fn cal(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Cal))
 }
 
-/// Fraktur font style in math.
+/// 数式中のフラクトゥールフォントスタイル。
 ///
 /// ```example
 /// $ frak(P) $
 /// ```
 #[func(title = "Fraktur", keywords = ["mathfrak"])]
 pub fn frak(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Frak))
 }
 
-/// Monospace font style in math.
+/// 数式中の等幅フォントスタイル。
 ///
 /// ```example
 /// $ mono(x + y = z) $
 /// ```
 #[func(title = "Monospace", keywords = ["mathtt"])]
 pub fn mono(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Mono))
 }
 
-/// Blackboard bold (double-struck) font style in math.
+/// 数式中の黒板太字（double-struck）フォントスタイル。
 ///
-/// For uppercase latin letters, blackboard bold is additionally available
-/// through [symbols]($category/symbols/sym) of the form `NN` and `RR`.
+/// 大文字のラテン文字では、黒板太字は、[symbols]($category/symbols/sym)にあるように、`NN`や`RR`のような形式でも使用できます。
 ///
 /// ```example
 /// $ bb(b) $
@@ -134,7 +130,7 @@ pub fn mono(
 /// ```
 #[func(title = "Blackboard Bold", keywords = ["mathbb"])]
 pub fn bb(
-    /// The content to style.
+    /// スタイルを適用するコンテンツ。
     body: Content,
 ) -> Content {
     body.styled(EquationElem::set_variant(MathVariant::Bb))