Merge branch 'main' into translation-text/lorem

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/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,
 }

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

@@ -6,18 +6,18 @@ use crate::engine::Engine;
 use crate::foundations::{func, scope, Str, Value};
 use crate::loading::{DataSource, Load, Readable};
 
-/// Reads structured data from a TOML file.
+/// TOMLファイルから構造化データを読み込む。
 ///
-/// The file must contain a valid TOML table. TOML tables will be converted into
-/// Typst dictionaries, and TOML arrays will be converted into Typst arrays.
-/// Strings, booleans and datetimes will be converted into the Typst equivalents
-/// and numbers will be converted to floats or integers depending on whether
-/// they are whole numbers.
+/// 読み込むファイルには有効なTOMLテーブルが含まれていなければなりません。
+/// TOMLテーブルはTypstの辞書に変換され、
+/// TOML配列はTypstの配列に変換されます。
+/// 文字列、ブール値、日時はTypstの対応する型に変換され、
+/// 数値は整数値であれば整数型に、そうでなければ浮動小数点数型に変換されます。
 ///
-/// The TOML file in the example consists of a table with the keys `title`,
-/// `version`, and `authors`.
+/// この例におけるTOMLファイルは、
+/// `title`、`version`、および`authors`のキーを持つテーブルで構成されています。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #let details = toml("details.toml")
 ///
@@ -29,7 +29,7 @@ use crate::loading::{DataSource, Load, Readable};
 #[func(scope, title = "TOML")]
 pub fn toml(
     engine: &mut Engine,
-    /// A [path]($syntax/#paths) to a TOML file or raw TOML bytes.
+    /// TOMLファイルの[パス]($syntax/#paths)、または生のTOMLバイト列。
     source: Spanned<DataSource>,
 ) -> SourceResult<Value> {
     let data = source.load(engine.world)?;
@@ -41,23 +41,23 @@ pub fn toml(
 
 #[scope]
 impl toml {
-    /// Reads structured data from a TOML string/bytes.
+    /// TOMLの文字列やバイト列から構造化データを読み込む。
     #[func(title = "Decode TOML")]
-    #[deprecated = "`toml.decode` is deprecated, directly pass bytes to `toml` instead"]
+    #[deprecated = "`toml.decode`は非推奨です。代わりにバイト列を直接`toml`に渡してください。"]
     pub fn decode(
         engine: &mut Engine,
-        /// TOML data.
+        /// TOMLデータ。
         data: Spanned<Readable>,
     ) -> SourceResult<Value> {
         toml(engine, data.map(Readable::into_source))
     }
 
-    /// Encodes structured data into a TOML string.
+    /// 構造化データをTOML文字列にエンコードする。
     #[func(title = "Encode TOML")]
     pub fn encode(
-        /// Value to be encoded.
+        /// エンコード対象の値。
         value: Spanned<Value>,
-        /// Whether to pretty-print the resulting TOML.
+        /// TOMLを整形表示するかどうか。
         #[named]
         #[default(true)]
         pretty: bool,

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

@@ -124,14 +124,12 @@ pub struct LimitsElem {
     pub inline: bool,
 }
 
-/// Stretches a glyph.
+/// 字形を伸縮します。
 ///
-/// This function can also be used to automatically stretch the base of an
-/// attachment, so that it fits the top and bottom attachments.
+/// この関数は、上部及び下部アタッチメントがフィットするように、自動的にアタッチメントのベースを伸縮させることにも使えます。
 ///
-/// Note that only some glyphs can be stretched, and which ones can depend on
-/// the math font being used. However, most math fonts are the same in this
-/// regard.
+/// 伸縮可能な字形は限られており、どの字形が伸縮可能かは使用する数式フォントに依存することに注意してください。
+/// ただし、この点に関して多くの数式フォントで違いはありません。
 ///
 /// ```example
 /// $ H stretch(=)^"define" U + p V $
@@ -141,12 +139,11 @@ pub struct LimitsElem {
 /// ```
 #[elem(Mathy)]
 pub struct StretchElem {
-    /// The glyph to stretch.
+    /// 伸縮させる字形。
     #[required]
     pub body: Content,
 
-    /// The size to stretch to, relative to the maximum size of the glyph and
-    /// its attachments.
+    /// 字形およびそのアタッチメントを基準とした伸縮の大きさ。
     #[resolve]
     #[default(Rel::one())]
     pub size: Rel<Length>,

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

@@ -28,20 +28,20 @@ pub struct FracElem {
     pub denom: Content,
 }
 
-/// A binomial expression.
+/// 二項係数。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// $ binom(n, k) $
 /// $ binom(n, k_1, k_2, k_3, ..., k_m) $
 /// ```
 #[elem(title = "Binomial", Mathy)]
 pub struct BinomElem {
-    /// The binomial's upper index.
+    /// 二項係数の上側の数。
     #[required]
     pub upper: Content,
 
-    /// The binomial's lower index.
+    /// 二項係数の下側の数。
     #[required]
     #[variadic]
     #[parse(

crates/typst-library/src/model/list.rs

@@ -16,7 +16,7 @@ use crate::text::TextElem;
 /// 各項目の先頭にマーカーを付け、
 /// 一連の項目を縦に並べて表示します。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// Normal list.
 /// - Text