Merge branch 'main' into translate-math/styles

Author: 3w36zj6

CONTRIBUTING.md

@@ -1,7 +1,7 @@
 # 貢献ガイドライン
 
 > [!NOTE]
-> 当プロジェクトの[README](./README.md)や「[はじめに：Typst Japan Communityより](https://typst-jp.github.io/docs/)」、[Typst公式](https://typst.app/)の[ライセンス](https://github.com/typst/typst/blob/main/LICENSE)や[コントリビューション・ガイド](https://github.com/typst/typst/blob/main/CONTRIBUTING.md)も併せてご参照ください。
+> 当プロジェクトの[README](./README.md)や「[はじめに：Typst Japanese Communityより](https://typst-jp.github.io/docs/)」、[Typst公式](https://typst.app/)の[ライセンス](https://github.com/typst/typst/blob/main/LICENSE)や[コントリビューション・ガイド](https://github.com/typst/typst/blob/main/CONTRIBUTING.md)も併せてご参照ください。
 
 Typst日本語ドキュメント翻訳プロジェクトにご興味をお持ちいただき、どうもありがとうございます。
 

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

@@ -7,13 +7,12 @@ use crate::layout::{
     Abs, Alignment, Angle, BlockElem, HAlignment, Length, Ratio, Rel, VAlignment,
 };
 
-/// Moves content without affecting layout.
+/// レイアウトに影響を与えないコンテンツの移動。
 ///
-/// The `move` function allows you to move content while the layout still 'sees'
-/// it at the original positions. Containers will still be sized as if the
-/// content was not moved.
+/// `move`関数を用いると、コンテンツの元々の位置をレイアウトに「認識」させながら、そのコンテンツを移動させることができます。
+/// コンテナの大きさは、コンテンツが移動されていないかのように決定されます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #rect(inset: 0pt, move(
 ///   dx: 6pt, dy: 6pt,
@@ -27,13 +26,13 @@ use crate::layout::{
 /// ```
 #[elem(Show)]
 pub struct MoveElem {
-    /// The horizontal displacement of the content.
+    /// コンテンツの水平方向の変位。
     pub dx: Rel<Length>,
 
-    /// The vertical displacement of the content.
+    /// コンテンツの垂直方向の変位。
     pub dy: Rel<Length>,
 
-    /// The content to move.
+    /// 移動させたいコンテンツ。
     #[required]
     pub body: Content,
 }
@@ -46,12 +45,12 @@ impl Show for Packed<MoveElem> {
     }
 }
 
-/// Rotates content without affecting layout.
+/// レイアウトに影響を与えないコンテンツの回転。
 ///
-/// Rotates an element by a given angle. The layout will act as if the element
-/// was not rotated unless you specify `{reflow: true}`.
+/// 要素を指定された角度だけ回転させます。
+/// `{reflow: true}`を指定しない限り、レイアウトは、その要素が回転していないかのように振る舞います。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #stack(
 ///   dir: ltr,
@@ -62,7 +61,7 @@ impl Show for Packed<MoveElem> {
 /// ```
 #[elem(Show)]
 pub struct RotateElem {
-    /// The amount of rotation.
+    /// 回転させる量。
     ///
     /// ```example
     /// #rotate(-1.571rad)[Space!]
@@ -71,11 +70,9 @@ pub struct RotateElem {
     #[positional]
     pub angle: Angle,
 
-    /// The origin of the rotation.
+    /// 回転の中心点。
     ///
-    /// If, for instance, you wanted the bottom left corner of the rotated
-    /// element to stay aligned with the baseline, you would set it to `bottom +
-    /// left` instead.
+    /// 例えば、回転した要素の左下隅をベースラインに揃えたままにしたい場合、代わりに`bottom + left`を指定します。
     ///
     /// ```example
     /// #set text(spacing: 8pt)
@@ -90,19 +87,18 @@ pub struct RotateElem {
     #[default(HAlignment::Center + VAlignment::Horizon)]
     pub origin: Alignment,
 
-    /// Whether the rotation impacts the layout.
+    /// 回転がレイアウトに影響を与えるかどうか。
     ///
-    /// If set to `{false}`, the rotated content will retain the bounding box of
-    /// the original content. If set to `{true}`, the bounding box will take the
-    /// rotation of the content into account and adjust the layout accordingly.
+    /// `{false}`に設定された場合、回転したコンテンツは元々のコンテンツのバウンディングボックスに留まります。
+    /// `{true}`に設定された場合、バウンディングボックスはコンテンツの回転を考慮してレイアウトを調整します。
     ///
     /// ```example
     /// Hello #rotate(90deg, reflow: true)[World]!
     /// ```
     #[default(false)]
     pub reflow: bool,
 
-    /// The content to rotate.
+    /// 回転させるコンテンツ。
     #[required]
     pub body: Content,
 }
@@ -115,44 +111,43 @@ impl Show for Packed<RotateElem> {
     }
 }
 
-/// Scales content without affecting layout.
+/// レイアウトに影響を与えないコンテンツの拡大縮小。
 ///
-/// Lets you mirror content by specifying a negative scale on a single axis.
+/// 単一の軸で負のスケールを指定することで、コンテンツを反転表示できます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #set align(center)
 /// #scale(x: -100%)[This is mirrored.]
 /// #scale(x: -100%, reflow: true)[This is mirrored.]
 /// ```
 #[elem(Show)]
 pub struct ScaleElem {
-    /// The scaling factor for both axes, as a positional argument. This is just
-    /// an optional shorthand notation for setting `x` and `y` to the same
-    /// value.
+    /// 位置引数として両方の軸の拡大縮小率を設定します。
+    /// これは`x`と`y`を同じ値で設定する省略記法です。
     #[external]
     #[positional]
     #[default(Smart::Custom(ScaleAmount::Ratio(Ratio::one())))]
     pub factor: Smart<ScaleAmount>,
 
-    /// The horizontal scaling factor.
+    /// 水平方向の拡大縮小率。
     ///
-    /// The body will be mirrored horizontally if the parameter is negative.
+    /// 負の値が指定された場合は本文が水平方向に反転します。
     #[parse(
         let all = args.find()?;
         args.named("x")?.or(all)
     )]
     #[default(Smart::Custom(ScaleAmount::Ratio(Ratio::one())))]
     pub x: Smart<ScaleAmount>,
 
-    /// The vertical scaling factor.
+    /// 垂直方向の拡大縮小率。
     ///
-    /// The body will be mirrored vertically if the parameter is negative.
+    /// 負の値が指定された場合は本文が垂直方向に反転します。
     #[parse(args.named("y")?.or(all))]
     #[default(Smart::Custom(ScaleAmount::Ratio(Ratio::one())))]
     pub y: Smart<ScaleAmount>,
 
-    /// The origin of the transformation.
+    /// 変換の原点。
     ///
     /// ```example
     /// A#box(scale(75%)[A])A \
@@ -162,19 +157,18 @@ pub struct ScaleElem {
     #[default(HAlignment::Center + VAlignment::Horizon)]
     pub origin: Alignment,
 
-    /// Whether the scaling impacts the layout.
+    /// 拡大縮小がレイアウトに影響を与えるかどうか。
     ///
-    /// If set to `{false}`, the scaled content will be allowed to overlap
-    /// other content. If set to `{true}`, it will compute the new size of
-    /// the scaled content and adjust the layout accordingly.
+    /// `{false}`の場合、拡大縮小したコンテンツが他のコンテンツと重なることを許可します。
+    /// `{true}`の場合、拡大縮小したコンテンツの新しい大きさを計算し、それに応じてレイアウトを調整します。
     ///
     /// ```example
     /// Hello #scale(x: 20%, y: 40%, reflow: true)[World]!
     /// ```
     #[default(false)]
     pub reflow: bool,
 
-    /// The content to scale.
+    /// 拡大縮小するコンテンツ。
     #[required]
     pub body: Content,
 }
@@ -204,20 +198,20 @@ cast! {
     length: Length => ScaleAmount::Length(length),
 }
 
-/// Skews content.
+/// コンテンツのスキュー変形。
 ///
-/// Skews an element in horizontal and/or vertical direction. The layout will
-/// act as if the element was not skewed unless you specify `{reflow: true}`.
+/// 水平方向または垂直方向、あるいは両方向に要素をスキュー（シアー）変形します。
+/// `{reflow: true}`を指定しない限り、レイアウトは要素がスキュー変形を受けていないかのように振る舞います。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #skew(ax: -12deg)[
 ///   This is some fake italic text.
 /// ]
 /// ```
 #[elem(Show)]
 pub struct SkewElem {
-    /// The horizontal skewing angle.
+    /// 水平方向のスキュー角。
     ///
     /// ```example
     /// #skew(ax: 30deg)[Skewed]
@@ -226,7 +220,7 @@ pub struct SkewElem {
     #[default(Angle::zero())]
     pub ax: Angle,
 
-    /// The vertical skewing angle.
+    /// 垂直方向のスキュー角。
     ///
     /// ```example
     /// #skew(ay: 30deg)[Skewed]
@@ -235,9 +229,9 @@ pub struct SkewElem {
     #[default(Angle::zero())]
     pub ay: Angle,
 
-    /// The origin of the skew transformation.
+    /// スキュー変形の原点。
     ///
-    /// The origin will stay fixed during the operation.
+    /// 操作中は原点が固定されます。
     ///
     /// ```example
     /// X #box(skew(ax: -30deg, origin: center + horizon)[X]) X \
@@ -248,19 +242,18 @@ pub struct SkewElem {
     #[default(HAlignment::Center + VAlignment::Horizon)]
     pub origin: Alignment,
 
-    /// Whether the skew transformation impacts the layout.
+    /// スキュー変形がレイアウトに影響を与えるかどうか。
     ///
-    /// If set to `{false}`, the skewed content will retain the bounding box of
-    /// the original content. If set to `{true}`, the bounding box will take the
-    /// transformation of the content into account and adjust the layout accordingly.
+    /// `{false}`の場合、スキュー変形されたコンテンツは元々のコンテンツのバウンディングボックスに留まります。
+    /// `{true}`の場合、バウンディングボックスはコンテンツの変形を考慮してレイアウトを調整します。
     ///
     /// ```example
     /// Hello #skew(ay: 30deg, reflow: true, "World")!
     /// ```
     #[default(false)]
     pub reflow: bool,
 
-    /// The content to skew.
+    /// スキュー変形するコンテンツ。
     #[required]
     pub body: Content,
 }

crates/typst-library/src/loading/cbor.rs

@@ -6,21 +6,21 @@ use crate::engine::Engine;
 use crate::foundations::{func, scope, Bytes, Value};
 use crate::loading::{DataSource, Load};
 
-/// Reads structured data from a CBOR file.
+/// CBORファイルから構造化データを読み込む。
 ///
-/// The file must contain a valid CBOR serialization. Mappings will be
-/// converted into Typst dictionaries, and sequences will be converted into
-/// Typst arrays. Strings and booleans will be converted into the Typst
-/// equivalents, null-values (`null`, `~` or empty ``) will be converted into
-/// `{none}`, and numbers will be converted to floats or integers depending on
-/// whether they are whole numbers.
+/// 読み込むファイルには有効なCBORによるシリアル化データが含まれていなければなりません。
+/// マッピングはTypstの辞書に変換され、シーケンスはTypstの配列に変換されます。
+/// 文字列やブール値はTypstの対応する型に変換され、
+/// ヌル値（`null`、`~`、または空の``）は`{none}`に、
+/// 数値は整数値であれば整数型に、
+/// そうでなければ浮動小数点数型に変換されます。
 ///
-/// Be aware that integers larger than 2<sup>63</sup>-1 will be converted to
-/// floating point numbers, which may result in an approximative value.
+/// 2<sup>63</sup>-1より大きな整数は浮動小数点数に変換されるため、
+/// 近似値になる可能性があることに留意してください。
 #[func(scope, title = "CBOR")]
 pub fn cbor(
     engine: &mut Engine,
-    /// A [path]($syntax/#paths) to a CBOR file or raw CBOR bytes.
+    /// CBORファイルの[パス]($syntax/#paths)、または生のCBORバイト列。
     source: Spanned<DataSource>,
 ) -> SourceResult<Value> {
     let data = source.load(engine.world)?;
@@ -31,21 +31,21 @@ pub fn cbor(
 
 #[scope]
 impl cbor {
-    /// Reads structured data from CBOR bytes.
+    /// CBORバイト列から構造化データを読み込む。
     #[func(title = "Decode CBOR")]
-    #[deprecated = "`cbor.decode` is deprecated, directly pass bytes to `cbor` instead"]
+    #[deprecated = "`cbor.decode`は非推奨です。代わりにバイト列を直接`cbor`に渡してください。"]
     pub fn decode(
         engine: &mut Engine,
-        /// CBOR data.
+        /// CBORデータ。
         data: Spanned<Bytes>,
     ) -> SourceResult<Value> {
         cbor(engine, data.map(DataSource::Bytes))
     }
 
-    /// Encode structured data into CBOR bytes.
+    /// 構造化データをCBORバイト列にエンコードする。
     #[func(title = "Encode CBOR")]
     pub fn encode(
-        /// Value to be encoded.
+        /// エンコード対象の値。
         value: Spanned<Value>,
     ) -> SourceResult<Bytes> {
         let Spanned { v: value, span } = value;

crates/typst-library/src/loading/csv.rs

@@ -26,7 +26,7 @@ use crate::loading::{DataSource, Load, Readable};
 #[func(scope, title = "CSV")]
 pub fn csv(
     engine: &mut Engine,
-    /// CSVファイルへの[パス]($syntax/#paths)、または生のCSVバイト列。
+    /// CSVファイルの[パス]($syntax/#paths)、または生のCSVバイト列。
     source: Spanned<DataSource>,
     /// CSVファイルの列を区切る区切り文字。
     /// 単一のASCII文字でなければなりません。

crates/typst-library/src/loading/json.rs

@@ -11,7 +11,7 @@ use crate::loading::{DataSource, Load, Readable};
 /// 読み込むファイルにはオブジェクトや配列などの有効なJSON値が含まれていなければなりません。
 /// JSONオブジェクトはTypstの辞書に変換され、
 /// JSON配列はTypstの配列に変換されます。
-/// 文字列やブール値はTypstの対応する値に変換され、`null`は`{none}`に、
+/// 文字列やブール値はTypstの対応する型に変換され、`null`は`{none}`に、
 /// 数値は整数値であれば整数型に、
 /// そうでなければ浮動小数点数型に変換されます。
 ///
@@ -51,7 +51,7 @@ use crate::loading::{DataSource, Load, Readable};
 #[func(scope, title = "JSON")]
 pub fn json(
     engine: &mut Engine,
-    /// JSONファイルへの[パス]($syntax/#paths)、または生のJSONバイト列。
+    /// JSONファイルの[パス]($syntax/#paths)、または生のJSONバイト列。
     source: Spanned<DataSource>,
 ) -> SourceResult<Value> {
     let data = source.load(engine.world)?;

crates/typst-library/src/loading/read.rs

@@ -7,13 +7,13 @@ use crate::foundations::{func, Cast};
 use crate::loading::Readable;
 use crate::World;
 
-/// Reads plain text or data from a file.
+/// ファイルからプレーンテキストやデータを読み込む。
 ///
-/// By default, the file will be read as UTF-8 and returned as a [string]($str).
+/// デフォルトでは、ファイルはUTF-8として読み込まれ、[文字列]($str)として返されます。
 ///
-/// If you specify `{encoding: none}`, this returns raw [bytes] instead.
+/// `{encoding: none}`を指定した場合、この関数は代わりに生の[bytes]を返します。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// An example for a HTML file: \
 /// #let text = read("example.html")
@@ -25,13 +25,13 @@ use crate::World;
 #[func]
 pub fn read(
     engine: &mut Engine,
-    /// Path to a file.
+    /// ファイルのパス。
     ///
-    /// For more details, see the [Paths section]($syntax/#paths).
+    /// 詳細については、[パスのセクション]($syntax/#paths)を参照してください。
     path: Spanned<EcoString>,
-    /// The encoding to read the file with.
+    /// ファイルを読み込む際に使用するエンコーディング。
     ///
-    /// If set to `{none}`, this function returns raw bytes.
+    /// `{none}`に設定すると、この関数は生のバイトを返します。
     #[named]
     #[default(Some(Encoding::Utf8))]
     encoding: Option<Encoding>,
@@ -47,9 +47,9 @@ pub fn read(
     })
 }
 
-/// An encoding of a file.
+/// ファイルのエンコーディング。
 #[derive(Debug, Copy, Clone, Eq, PartialEq, Hash, Cast)]
 pub enum Encoding {
-    /// The Unicode UTF-8 encoding.
+    /// Unicode UTF-8エンコーディング。
     Utf8,
 }