Merge branch 'main' into translate-layout/ratio

Author: 3w36zj6

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

@@ -2,27 +2,20 @@ use crate::foundations::{elem, scope, Cast, Content, Packed, Smart};
 use crate::introspection::{Locatable, Unqueriable};
 use crate::layout::{Alignment, Em, Length, Rel};
 
-/// Places content relatively to its parent container.
+/// 親コンテナに対して相対的なコンテンツの配置。
 ///
-/// Placed content can be either overlaid (the default) or floating. Overlaid
-/// content is aligned with the parent container according to the given
-/// [`alignment`]($place.alignment), and shown over any other content added so
-/// far in the container. Floating content is placed at the top or bottom of
-/// the container, displacing other content down or up respectively. In both
-/// cases, the content position can be adjusted with [`dx`]($place.dx) and
-/// [`dy`]($place.dy) offsets without affecting the layout.
+/// コンテンツはオーバーレイ（デフォルト）またはフロートのいずれかで配置できます。
+/// オーバーレイのコンテンツは、指定された[`alignment`]($place.alignment)に従って親コンテナに合わせて配置され、これまでに追加された他のコンテンツの上に表示されます。
+/// フロートのコンテンツは、親コンテナの上部または下部に配置され、他のコンテンツを下または上にそれぞれずらします。
+/// 両方の場合で、コンテンツの位置は[`dx`]($place.dx)および[`dy`]($place.dy)オフセットを用いてレイアウトに影響を与えることなく調整可能です。
 ///
-/// The parent can be any container such as a [`block`], [`box`],
-/// [`rect`], etc. A top level `place` call will place content directly
-/// in the text area of the current page. This can be used for absolute
-/// positioning on the page: with a `top + left`
-/// [`alignment`]($place.alignment), the offsets `dx` and `dy` will set the
-/// position of the element's top left corner relatively to the top left corner
-/// of the text area. For absolute positioning on the full page including
-/// margins, you can use `place` in [`page.foreground`]($page.foreground) or
-/// [`page.background`]($page.background).
+/// [`block`]、[`box`]、[`rect`]などの任意のコンテナが親になることができます。
+/// トップレベルの`place`の呼び出しは現在のページのテキスト領域に直接コンテンツを配置します。
+/// これはページ上の絶対位置指定に使用できます。
+/// `top + left` [`alignment`]($place.alignment)と組み合わせると、`dx`および`dy`オフセットはテキスト領域の左上隅を基準として要素の左上隅の位置を設定します。
+/// マージンを含めたページ全体における絶対位置指定は、[`page.foreground`]か[`page.background`]中で`place`を使うと可能です。
 ///
-/// # Examples
+/// # 例
 /// ```example
 /// #set page(height: 120pt)
 /// Hello, world!
@@ -40,17 +33,14 @@ use crate::layout::{Alignment, Em, Length, Rel};
 /// )
 /// ```
 ///
-/// # Effect on the position of other elements { #effect-on-other-elements }
-/// Overlaid elements don't take space in the flow of content, but a `place`
-/// call inserts an invisible block-level element in the flow. This can
-/// affect the layout by breaking the current paragraph. To avoid this,
-/// you can wrap the `place` call in a [`box`] when the call is made
-/// in the middle of a paragraph. The alignment and offsets will then be
-/// relative to this zero-size box. To make sure it doesn't interfere with
-/// spacing, the box should be attached to a word using a word joiner.
+/// # 他の要素の位置に対する影響 { #effect-on-other-elements }
+/// 要素のオーバーレイはコンテンツの流れの中にスペースを取りませんが、`place`の呼び出しは、流れの中にブロックレベルの不可視要素を挿入します。
+/// これは現在の段落を中断することでレイアウトに影響を与える可能性があります。
+/// これを避けるために、段落の途中で`place`を呼び出す場合には、それを[`box`]でラップするとよいでしょう。
+/// このとき、配置とオフセットは、この大きさを持たないボックスを基準にしたものになります。
+/// 間隔に影響しないように、ワードジョイナーを使用してボックスを単語に結合してください。
 ///
-/// For example, the following defines a function for attaching an annotation
-/// to the following word:
+/// 例えば、以下は直後の単語に注釈を付与する関数を定義しています。
 ///
 /// ```example
 /// >>> #set page(height: 70pt)
@@ -64,32 +54,26 @@ use crate::layout::{Alignment, Em, Length, Rel};
 /// square in my text.
 /// ```
 ///
-/// The zero-width weak spacing serves to discard spaces between the function
-/// call and the next word.
+/// ゼロ幅の弱い空白は、関数呼び出しと次の単語との間の空白を削除する役割を果たします。
 #[elem(scope, Locatable, Unqueriable)]
 pub struct PlaceElem {
-    /// Relative to which position in the parent container to place the content.
+    /// コンテンツを配置する基準となる親コンテナ内の位置。
     ///
-    /// - If `float` is `{false}`, then this can be any alignment other than `{auto}`.
-    /// - If `float` is `{true}`, then this must be `{auto}`, `{top}`, or `{bottom}`.
+    /// - `float`が`{false}`の場合、`{auto}`以外の任意のalignmentを指定できます。
+    /// - `float`が`{true}`の場合、`{auto}`、`{top}`あるいは`{bottom}`のいずれかを指定しなければなりません。
     ///
-    /// When `float` is `{false}` and no vertical alignment is specified, the
-    /// content is placed at the current position on the vertical axis.
+    /// `float`が`{false}`で、かつvertical alignmentが指定されていなければ、コンテンツは垂直方向の軸上の現在の位置に配置されます。
     #[positional]
     #[default(Smart::Custom(Alignment::START))]
     pub alignment: Smart<Alignment>,
 
-    /// Relative to which containing scope something is placed.
+    /// 何かを配置するときの基準となる包含スコープ。
     ///
-    /// The parent scope is primarily used with figures and, for
-    /// this reason, the figure function has a mirrored [`scope`
-    /// parameter]($figure.scope). Nonetheless, it can also be more generally
-    /// useful to break out of the columns. A typical example would be to
-    /// [create a single-column title section]($guides/page-setup-guide/#columns)
-    /// in a two-column document.
+    /// 親スコープは主に図表に使用されるため、figure関数にはそれを反映した[`scope`パラメーター]($figure.scope)が用意されています。
+    /// しかしながら、段組を中断することは、より一般的な場合に有用であることもあります。
+    /// 典型的な例は2段組の文書で1段組のタイトル節を作成することでしょう。
     ///
-    /// Note that parent-scoped placement is currently only supported if `float`
-    /// is `{true}`. This may change in the future.
+    /// 現在、親スコープでの配置は`float`が`{true}`の場合のみサポートされています。 この挙動は将来変更される可能性があります。
     ///
     /// ```example
     /// #set page(height: 150pt, columns: 2)
@@ -104,12 +88,11 @@ pub struct PlaceElem {
     /// ```
     pub scope: PlacementScope,
 
-    /// Whether the placed element has floating layout.
+    /// 要素をフロートレイアウトで配置するかどうか。
     ///
-    /// Floating elements are positioned at the top or bottom of the parent
-    /// container, displacing in-flow content. They are always placed in the
-    /// in-flow order relative to each other, as well as before any content
-    /// following a later [`place.flush`] element.
+    /// フロートの要素は流れの中にあるコンテンツをずらして親コンテナの上部または下部に位置取ります。
+    ///
+    /// それらは常に互いのフロー内での順序を保ち、後続の[`place.flush`]要素に続くコンテンツより前に配置されます。
     ///
     /// ```example
     /// #set page(height: 150pt)
@@ -129,15 +112,15 @@ pub struct PlaceElem {
     /// ```
     pub float: bool,
 
-    /// The spacing between the placed element and other elements in a floating
-    /// layout.
+    /// フロートレイアウトでの配置された要素と他の要素との間隔。
     ///
-    /// Has no effect if `float` is `{false}`.
+    /// `float`が`{false}`の場合は影響がありません。
+
     #[default(Em::new(1.5).into())]
     #[resolve]
     pub clearance: Length,
 
-    /// The horizontal displacement of the placed content.
+    /// 配置したコンテンツの水平方向の変位。
     ///
     /// ```example
     /// #set page(height: 100pt)
@@ -147,19 +130,17 @@ pub struct PlaceElem {
     /// }
     /// ```
     ///
-    /// This does not affect the layout of in-flow content.
-    /// In other words, the placed content is treated as if it
-    /// were wrapped in a [`move`] element.
+    /// これは流れの中のコンテンツのレイアウトには影響しません。
+    /// 言い換えると、配置されたコンテンツは[`move`]要素にラップされたかのように扱われます。
     pub dx: Rel<Length>,
 
-    /// The vertical displacement of the placed content.
+    /// 配置したコンテンツの垂直方向の変位。
     ///
-    /// This does not affect the layout of in-flow content.
-    /// In other words, the placed content is treated as if it
-    /// were wrapped in a [`move`] element.
+    /// これは流れの中のコンテンツのレイアウトには影響しません。
+    /// 言い換えると、配置されたコンテンツは[`move`]要素にラップされたかのように扱われます。
     pub dy: Rel<Length>,
 
-    /// The content to place.
+    /// 配置するコンテンツ。
     #[required]
     pub body: Content,
 }
@@ -184,11 +165,9 @@ pub enum PlacementScope {
     Parent,
 }
 
-/// Asks the layout algorithm to place pending floating elements before
-/// continuing with the content.
+/// コンテンツの続行前に保留中のフロート要素を配置するようレイアウトアルゴリズムに指示。
 ///
-/// This is useful for preventing floating figures from spilling
-/// into the next section.
+/// これは、次のセクションにフロートの図表が流れ込むのを防ぐのに便利です。
 ///
 /// ```example
 /// >>> #set page(height: 160pt, width: 150pt)

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

@@ -3,17 +3,15 @@ use crate::engine::Engine;
 use crate::foundations::{elem, Content, NativeElement, Packed, Show, StyleChain};
 use crate::layout::{BlockElem, Length};
 
-/// Repeats content to the available space.
+/// 利用可能なスペースでのコンテンツの繰り返し。
 ///
-/// This can be useful when implementing a custom index, reference, or outline.
+/// これは独自の索引、参考文献、目次を作成する際に便利です。
 ///
-/// Space may be inserted between the instances of the body parameter, so be
-/// sure to adjust the [`justify`]($repeat.justify) parameter accordingly.
+/// bodyパラメーターの実体の間に空白が挿入される可能性があるため、[`justify`]($repeat.justify)パラメーターを正しく調整しているか確かめてください。
 ///
-/// Errors if there are no bounds on the available space, as it would create
-/// infinite content.
+/// 利用可能なスペースに上限がない場合は、コンテンツを無限に生成してしまうためエラーになります。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// Sign on the dotted line:
 /// #box(width: 1fr, repeat[.])
@@ -26,16 +24,15 @@ use crate::layout::{BlockElem, Length};
 /// ```
 #[elem(Show)]
 pub struct RepeatElem {
-    /// The content to repeat.
+    /// 繰り返すコンテンツ。
     #[required]
     pub body: Content,
 
-    /// The gap between each instance of the body.
+    /// 本文の実体間の間隔。
     #[default]
     pub gap: Length,
 
-    /// Whether to increase the gap between instances to completely fill the
-    /// available space.
+    /// 利用可能なスペースを完全に埋めるために、実体間の間隔を大きくするかどうか。
     #[default(true)]
     pub justify: bool,
 }

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

@@ -3,50 +3,41 @@ use typst_utils::Numeric;
 use crate::foundations::{cast, elem, Content};
 use crate::layout::{Abs, Em, Fr, Length, Ratio, Rel};
 
-/// Inserts horizontal spacing into a paragraph.
+/// パラグラフに水平方向の間隔を挿入。
 ///
-/// The spacing can be absolute, relative, or fractional. In the last case, the
-/// remaining space on the line is distributed among all fractional spacings
-/// according to their relative fractions.
+/// 間隔の大きさは絶対的な値、相対的な値、または比率で指定できます。
+/// 比率指定の場合は、比率指定されたそれぞれの間隔に、行の残りの間隔がその相対比率に応じて配分されます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// First #h(1cm) Second \
 /// First #h(30%) Second
 /// ```
 ///
-/// # Fractional spacing
-/// With fractional spacing, you can align things within a line without forcing
-/// a paragraph break (like [`align`] would). Each fractionally sized element
-/// gets space based on the ratio of its fraction to the sum of all fractions.
+/// # 比率指定の間隔
+/// 比率指定の間隔を用いると、（[`align`]のように）段落区切りを強制することなく行内の配置が可能です。
+/// 要素の大きさが比率で指定された場合、それぞれの要素には、比率の総和に対する自身の比率の割合に応じた間隔が割り当てられます。
 ///
 /// ```example
 /// First #h(1fr) Second \
 /// First #h(1fr) Second #h(1fr) Third \
 /// First #h(2fr) Second #h(1fr) Third
 /// ```
 ///
-/// # Mathematical Spacing { #math-spacing }
-/// In [mathematical formulas]($category/math), you can additionally use these
-/// constants to add spacing between elements: `thin` (1/6 em), `med` (2/9 em),
-/// `thick` (5/18 em), `quad` (1 em), `wide` (2 em).
+/// # 数式用の間隔 { #math-spacing }
+/// [数式]($category/math)中では、要素間に間隔を挿入するための定数として、`thin`（1/6 em）、`med`（2/9 em）、`thick`（5/18 em）、`quad`（1 em）および`wide`（2 em）も利用可能です。
 #[elem(title = "Spacing (H)")]
 pub struct HElem {
-    /// How much spacing to insert.
+    /// 挿入する間隔の大きさ。
     #[required]
     pub amount: Spacing,
 
-    /// If `{true}`, the spacing collapses at the start or end of a paragraph.
-    /// Moreover, from multiple adjacent weak spacings all but the largest one
-    /// collapse.
+    /// `{true}`の場合、段落の始まりと終わりの空白は削除されます。
+    /// さらに、弱い間隔が隣接していると最大のもの以外は削除されます。
     ///
-    /// Weak spacing in markup also causes all adjacent markup spaces to be
-    /// removed, regardless of the amount of spacing inserted. To force a space
-    /// next to weak spacing, you can explicitly write `[#" "]` (for a normal
-    /// space) or `[~]` (for a non-breaking space). The latter can be useful to
-    /// create a construct that always attaches to the preceding word with one
-    /// non-breaking space, independently of whether a markup space existed in
-    /// front or not.
+    /// マークアップ中に弱い間隔があると、挿入された間隔の総量によらず、全ての隣接するマークアップの間隔が削除されます。
+    /// 明示的に（通常の間隔の場合は）`[#" "]`と書くか、（改行しない間隔の場合は）`[~]`と書くことで弱い間隔の隣に間隔を強制することができます。
+    /// 後者は、マークアップで直前に間隔があったかどうかに関係なく、直前の単語に改行しない間隔を常に1つ追加する構造を作成する際に便利かもしれません。
     ///
     /// ```example
     /// #h(1cm, weak: true)
@@ -72,13 +63,12 @@ impl HElem {
     }
 }
 
-/// Inserts vertical spacing into a flow of blocks.
+/// ブロックの流れに垂直方向の間隔を挿入。
 ///
-/// The spacing can be absolute, relative, or fractional. In the last case,
-/// the remaining space on the page is distributed among all fractional spacings
-/// according to their relative fractions.
+/// 間隔の大きさは絶対的な値、相対的な値、または比率で指定できます。
+/// 比率指定の場合は、比率指定されたそれぞれの間隔に、ページの残りの間隔がその相対比率に応じて配分されます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #grid(
 ///   rows: 3cm,
@@ -94,14 +84,13 @@ impl HElem {
 /// ```
 #[elem(title = "Spacing (V)")]
 pub struct VElem {
-    /// How much spacing to insert.
+    /// 挿入する間隔の大きさ。
     #[required]
     pub amount: Spacing,
 
-    /// If `{true}`, the spacing collapses at the start or end of a flow.
-    /// Moreover, from multiple adjacent weak spacings all but the largest one
-    /// collapse. Weak spacings will always collapse adjacent paragraph spacing,
-    /// even if the paragraph spacing is larger.
+    /// `{true}`の場合、流れの始まりと終わりの空白は削除されます。
+    /// さらに、弱い間隔が隣接していると最大のもの以外は削除されます。
+    /// たとえ段落間隔の方が大きかったとしても、弱い間隔に隣接する段落間隔は常に削除されます。
     ///
     /// ```example
     /// The following theorem is

website/translation-status.json

@@ -119,15 +119,15 @@
 	"/docs/reference/layout/pad/": "translated",
 	"/docs/reference/layout/page/": "untranslated",
 	"/docs/reference/layout/pagebreak/": "untranslated",
-	"/docs/reference/layout/place/": "untranslated",
+	"/docs/reference/layout/place/": "translated",
 	"/docs/reference/layout/ratio/": "translated",
 	"/docs/reference/layout/relative/": "untranslated",
-	"/docs/reference/layout/repeat/": "untranslated",
+	"/docs/reference/layout/repeat/": "translated",
 	"/docs/reference/layout/rotate/": "untranslated",
 	"/docs/reference/layout/scale/": "untranslated",
 	"/docs/reference/layout/skew/": "untranslated",
-	"/docs/reference/layout/h/": "untranslated",
-	"/docs/reference/layout/v/": "untranslated",
+	"/docs/reference/layout/h/": "translated",
+	"/docs/reference/layout/v/": "translated",
 	"/docs/reference/layout/stack/": "translated",
 	"/docs/reference/visualize/": "untranslated",
 	"/docs/reference/visualize/circle/": "untranslated",