/docs/reference/layout/block/および/docs/reference/layout/box/の翻訳 (#179)

Co-authored-by: Copilot <[email protected]>
Co-authored-by: gomazarashi <[email protected]>

Author: 3 people

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

@@ -11,14 +11,13 @@ use crate::layout::{
 };
 use crate::visualize::{Paint, Stroke};
 
-/// An inline-level container that sizes content.
+/// コンテンツの大きさを持つインラインレベルのコンテナ。
 ///
-/// All elements except inline math, text, and boxes are block-level and cannot
-/// occur inside of a [paragraph]($par). The box function can be used to
-/// integrate such elements into a paragraph. Boxes take the size of their
-/// contents by default but can also be sized explicitly.
+/// インライン数式、テキスト、ボックスを除く全ての要素はブロックレベルであり、[段落]($par)の中に含めることはできません。
+/// box関数を用いることで、そのような要素を段落にまとめることができます。
+/// ボックスはデフォルトで、受け取ったコンテンツに合わせた大きさになりますが、明示的に大きさを指定することもできます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// Refer to the docs
 /// #box(
@@ -29,51 +28,48 @@ use crate::visualize::{Paint, Stroke};
 /// ```
 #[elem]
 pub struct BoxElem {
-    /// The width of the box.
+    /// ボックスの幅。
     ///
-    /// Boxes can have [fractional]($fraction) widths, as the example below
-    /// demonstrates.
+    /// ボックスは以下の例で示すように、[比率]($fraction)を用いて幅を指定できます。
     ///
-    /// _Note:_ Currently, only boxes and only their widths might be fractionally
-    /// sized within paragraphs. Support for fractionally sized images, shapes,
-    /// and more might be added in the future.
+    /// _注意:_ 現在、パラグラフ内で比率指定が可能なのはボックスおよびその幅のみです。
+    /// 比率で指定した大きさを持つ画像や図形などは今後サポートされる可能性があります。
     ///
     /// ```example
     /// Line in #box(width: 1fr, line(length: 100%)) between.
     /// ```
     pub width: Sizing,
 
-    /// The height of the box.
+    /// ボックスの高さ。
     pub height: Smart<Rel<Length>>,
 
-    /// An amount to shift the box's baseline by.
+    /// ボックスのベースラインをシフトさせる量。
     ///
     /// ```example
     /// Image: #box(baseline: 40%, image("tiger.jpg", width: 2cm)).
     /// ```
     #[resolve]
     pub baseline: Rel<Length>,
 
-    /// The box's background color. See the
-    /// [rectangle's documentation]($rect.fill) for more details.
+    /// ボックスの背景色。
+    /// 詳細は[rectangleのドキュメント]($rect.fill)を参照してください。
     pub fill: Option<Paint>,
 
-    /// The box's border color. See the
-    /// [rectangle's documentation]($rect.stroke) for more details.
+    /// ボックスの枠線の色。
+    /// 詳細は[rectangleのドキュメント]($rect.stroke)を参照してください。
     #[resolve]
     #[fold]
     pub stroke: Sides<Option<Option<Stroke>>>,
 
-    /// How much to round the box's corners. See the
-    /// [rectangle's documentation]($rect.radius) for more details.
+    /// ボックスの角の丸めの大きさ。
+    /// 詳細は[rectangleのドキュメント]($rect.radius)を参照してください。
     #[resolve]
     #[fold]
     pub radius: Corners<Option<Rel<Length>>>,
 
-    /// How much to pad the box's content.
+    /// ボックスのコンテンツのパディング量。
     ///
-    /// _Note:_ When the box contains text, its exact size depends on the
-    /// current [text edges]($text.top-edge).
+    /// _注意:_ ボックスがテキストを含むとき、その正確な大きさは現在の[テキストの端]($text.top-edge)に依存します。
     ///
     /// ```example
     /// #rect(inset: 0pt)[Tight]
@@ -82,11 +78,10 @@ pub struct BoxElem {
     #[fold]
     pub inset: Sides<Option<Rel<Length>>>,
 
-    /// How much to expand the box's size without affecting the layout.
+    /// レイアウトに影響を与えずにボックスの大きさを拡大する量。
     ///
-    /// This is useful to prevent padding from affecting line layout. For a
-    /// generalized version of the example below, see the documentation for the
-    /// [raw text's block parameter]($raw.block).
+    /// これはパディングが行のレイアウトに影響を与えるのを防ぐために便利です。
+    /// 以下の例より一般的な場合については、[未加工テキストのblockパラメーター]($raw.block)のドキュメントを参照してください。
     ///
     /// ```example
     /// An inline
@@ -101,10 +96,8 @@ pub struct BoxElem {
     #[fold]
     pub outset: Sides<Option<Rel<Length>>>,
 
-    /// Whether to clip the content inside the box.
-    ///
-    /// Clipping is useful when the box's content is larger than the box itself,
-    /// as any content that exceeds the box's bounds will be hidden.
+    /// ボックスの内側のコンテンツのクリッピングを行うか否か。
+    /// クリッピングは、ボックスの境界を超えたコンテンツを隠すため、ボックスのコンテンツがボックス本体よりも大きい場合に便利です。
     ///
     /// ```example
     /// #box(
@@ -117,7 +110,7 @@ pub struct BoxElem {
     #[default(false)]
     pub clip: bool,
 
-    /// The contents of the box.
+    /// ボックスの内容。
     #[positional]
     #[borrowed]
     pub body: Option<Content>,
@@ -179,18 +172,15 @@ pub enum InlineItem {
     Frame(Frame),
 }
 
-/// A block-level container.
+/// ブロックレベルのコンテナ。
 ///
-/// Such a container can be used to separate content, size it, and give it a
-/// background or border.
+/// このようなコンテナは、コンテンツを区切り、その大きさを調整し、背景や枠線を付与するために使用できます。
 ///
-/// Blocks are also the primary way to control whether text becomes part of a
-/// paragraph or not. See [the paragraph documentation]($par/#what-becomes-a-paragraph)
-/// for more details.
+/// ブロックは、テキストが段落の一部となるかどうかを制御する主要な方法でもあります。
+/// 詳細は[段落のドキュメント]($par/#what-becomes-a-paragraph)を参照してください。
 ///
-/// # Examples
-/// With a block, you can give a background to content while still allowing it
-/// to break across multiple pages.
+/// # 例
+/// ブロックを使用すると、複数のページに渡って分割されるコンテンツに背景を与えることができます。
 /// ```example
 /// #set page(height: 100pt)
 /// #block(
@@ -201,8 +191,7 @@ pub enum InlineItem {
 /// )
 /// ```
 ///
-/// Blocks are also useful to force elements that would otherwise be inline to
-/// become block-level, especially when writing show rules.
+/// ブロックは、特にshowルールを記述する際、本来インラインとなる要素を強制的にブロックレベルとして扱う場合にも有用です。
 /// ```example
 /// #show heading: it => it.body
 /// = Blockless
@@ -214,7 +203,7 @@ pub enum InlineItem {
 /// ```
 #[elem]
 pub struct BlockElem {
-    /// The block's width.
+    /// ブロックの幅。
     ///
     /// ```example
     /// #set align(center)
@@ -227,9 +216,8 @@ pub struct BlockElem {
     /// ```
     pub width: Smart<Rel<Length>>,
 
-    /// The block's height. When the height is larger than the remaining space
-    /// on a page and [`breakable`]($block.breakable) is `{true}`, the
-    /// block will continue on the next page with the remaining height.
+    /// ブロックの高さ。
+    /// 高さがページに残された余白より大きく、[`breakable`]($block.breakable)が`{true}`の場合、 ブロックは残りの高さで次のページに続きます。
     ///
     /// ```example
     /// #set page(height: 80pt)
@@ -242,7 +230,7 @@ pub struct BlockElem {
     /// ```
     pub height: Sizing,
 
-    /// Whether the block can be broken and continue on the next page.
+    /// ブロックが分割可能で次のページに継続するかどうか。
     ///
     /// ```example
     /// #set page(height: 80pt)
@@ -256,48 +244,43 @@ pub struct BlockElem {
     #[default(true)]
     pub breakable: bool,
 
-    /// The block's background color. See the
-    /// [rectangle's documentation]($rect.fill) for more details.
+    /// ブロックの背景色。
+    /// 詳細は[rectangleのドキュメント]($rect.fill)を参照してください。
     pub fill: Option<Paint>,
 
-    /// The block's border color. See the
-    /// [rectangle's documentation]($rect.stroke) for more details.
+    /// ブロックの枠線の色。
+    /// 詳細は[rectangleのドキュメント]($rect.stroke)を参照してください。
     #[resolve]
     #[fold]
     pub stroke: Sides<Option<Option<Stroke>>>,
 
-    /// How much to round the block's corners. See the
-    /// [rectangle's documentation]($rect.radius) for more details.
+    /// ブロックの角の丸めの大きさ。
+    /// 詳細は[rectangleのドキュメント]($rect.radius)を参照してください。
     #[resolve]
     #[fold]
     pub radius: Corners<Option<Rel<Length>>>,
 
-    /// How much to pad the block's content. See the
-    /// [box's documentation]($box.inset) for more details.
+    /// ブロックのコンテンツのパディング量。
+    /// 詳細は[boxのドキュメント]($box.inset)を参照してください。
     #[resolve]
     #[fold]
     pub inset: Sides<Option<Rel<Length>>>,
 
-    /// How much to expand the block's size without affecting the layout. See
-    /// the [box's documentation]($box.outset) for more details.
+    /// レイアウトに影響を与えずにブロックの大きさを拡大する量。
+    /// 詳細は[boxのドキュメント]($box.outset)を参照してください。
     #[resolve]
     #[fold]
     pub outset: Sides<Option<Rel<Length>>>,
 
-    /// The spacing around the block. When `{auto}`, inherits the paragraph
-    /// [`spacing`]($par.spacing).
+    /// ブロック周りの間隔。`{auto}`の場合、段落の[`spacing`]($par.spacing)を継承します。
     ///
-    /// For two adjacent blocks, the larger of the first block's `above` and the
-    /// second block's `below` spacing wins. Moreover, block spacing takes
-    /// precedence over paragraph [`spacing`]($par.spacing).
+    /// 隣接する2つのブロックについては、最初のブロックの`above`と2番目のブロックの`below`のうち、 大きい方の間隔が優先されます。
+    /// また、ブロックの間隔は段落の[`spacing`]($par.spacing)よりも優先されます。
     ///
-    /// Note that this is only a shorthand to set `above` and `below` to the
-    /// same value. Since the values for `above` and `below` might differ, a
-    /// [context] block only provides access to `{block.above}` and
-    /// `{block.below}`, not to `{block.spacing}` directly.
+    /// これは`above`と`below`を同じ値に設定するための短縮記法にすぎないことに注意してください。
+    /// `above`と`below`の値は異なる可能性があるため、[context]ブロックでは`{block.above}`と `{block.below}`にのみアクセスでき、`{block.spacing}`に直接アクセスすることはできません。
     ///
-    /// This property can be used in combination with a show rule to adjust the
-    /// spacing around arbitrary block-level elements.
+    /// このプロパティはshowルールと組み合わせて使用することで、任意のブロックレベル要素の周りの間隔を調整できます。
     ///
     /// ```example
     /// #set align(center)
@@ -311,21 +294,20 @@ pub struct BlockElem {
     #[default(Em::new(1.2).into())]
     pub spacing: Spacing,
 
-    /// The spacing between this block and its predecessor.
+    /// このブロックとその前のブロックとの間隔。
     #[parse(
         let spacing = args.named("spacing")?;
         args.named("above")?.or(spacing)
     )]
     pub above: Smart<Spacing>,
 
-    /// The spacing between this block and its successor.
+    /// このブロックとその後のブロックとの間隔。
     #[parse(args.named("below")?.or(spacing))]
     pub below: Smart<Spacing>,
 
-    /// Whether to clip the content inside the block.
+    /// ブロックの内側のコンテンツのクリッピングを行うか否か。
     ///
-    /// Clipping is useful when the block's content is larger than the block itself,
-    /// as any content that exceeds the block's bounds will be hidden.
+    /// クリッピングは、ブロックの境界を超えたコンテンツを隠すため、ブロックのコンテンツがブロック本体よりも大きい場合に便利です。
     ///
     /// ```example
     /// #block(
@@ -338,11 +320,9 @@ pub struct BlockElem {
     #[default(false)]
     pub clip: bool,
 
-    /// Whether this block must stick to the following one, with no break in
-    /// between.
+    /// このブロックが、次のブロックとの間に区切りを入れることなく続ける必要があるかどうか。
     ///
-    /// This is, by default, set on heading blocks to prevent orphaned headings
-    /// at the bottom of the page.
+    /// この設定は、ページの下部で見出しが孤立することを防ぐために、見出しブロックに対してデフォルトで適用されています。
     ///
     /// ```example
     /// >>> #set page(height: 140pt)
@@ -356,7 +336,7 @@ pub struct BlockElem {
     #[default(false)]
     pub sticky: bool,
 
-    /// The contents of the block.
+    /// ブロックの内容。
     #[positional]
     #[borrowed]
     pub body: Option<BlockBody>,

website/translation-status.json

@@ -104,8 +104,8 @@
 	"/docs/reference/layout/align/": "translated",
 	"/docs/reference/layout/alignment/": "translated",
 	"/docs/reference/layout/angle/": "translated",
-	"/docs/reference/layout/block/": "untranslated",
-	"/docs/reference/layout/box/": "untranslated",
+	"/docs/reference/layout/block/": "translated",
+	"/docs/reference/layout/box/": "translated",
 	"/docs/reference/layout/colbreak/": "untranslated",
 	"/docs/reference/layout/columns/": "untranslated",
 	"/docs/reference/layout/direction/": "untranslated",