docs/reference/layout/blockの翻訳

Author: ultimatile

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

@@ -172,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(
@@ -194,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
@@ -207,7 +203,7 @@ pub enum InlineItem {
 /// ```
 #[elem]
 pub struct BlockElem {
-    /// The block's width.
+    /// ブロックの幅。
     ///
     /// ```example
     /// #set align(center)
@@ -220,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)
@@ -235,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)
@@ -249,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 ruleと組み合わせて使用することで、 任意のブロックレベル要素の周りの間隔を調整できます。
     ///
     /// ```example
     /// #set align(center)
@@ -304,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(
@@ -331,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)
@@ -349,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,7 +104,7 @@
 	"/docs/reference/layout/align/": "untranslated",
 	"/docs/reference/layout/alignment/": "untranslated",
 	"/docs/reference/layout/angle/": "untranslated",
-	"/docs/reference/layout/block/": "untranslated",
+	"/docs/reference/layout/block/": "translated",
 	"/docs/reference/layout/box/": "translated",
 	"/docs/reference/layout/colbreak/": "untranslated",
 	"/docs/reference/layout/columns/": "untranslated",