`/docs/reference/layout/grid`の翻訳 by ultimatile · Pull Request #242 · typst-jp/docs

ultimatile · 2025-08-04T04:13:33Z

layout/gridの翻訳です。

Copilot

Pull Request Overview

This PR translates the layout/grid documentation from English to Japanese, updating the module-level documentation and parameter descriptions for the grid element.

Translates the grid element's comprehensive documentation from English to Japanese
Updates field descriptions for grid parameters to Japanese
Marks the grid reference page as translated in the status file

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File	Description
website/translation-status.json	Updates translation status for grid page from "untranslated" to "translated"
crates/typst-library/src/layout/grid/mod.rs	Translates module documentation and parameter descriptions from English to Japanese

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

crates/typst-library/src/layout/grid/mod.rs

ultimatile · 2026-01-02T01:35:51Z

crates/typst-library/src/layout/grid/mod.rs

-    /// one instead), since then the position after a column becomes different
-    /// from the position before the next column due to the spacing between
-    /// both.
+    /// この設定は`column-gutter`が設定されている場合にのみ有効です（それ以外の場合は使用せず、単に`x`フィールドの値を1ずつ増やしてください）。


訳すよりオプション名の方がわかりやすいと思ったのでcolumn　gutterをcolumn-gutterに変更しています。

ultimatile · 2026-01-02T01:36:33Z

crates/typst-library/src/layout/grid/mod.rs

-    /// shouldn't be used otherwise - prefer just increasing the `y` field by
-    /// one instead), since then the position below a row becomes different
-    /// from the position above the next row due to the spacing between both.
+    /// この設定は`row-gutter`が設定されている場合にのみ有効です（それ以外の場合は使用せず、単に`y`フィールドの値を1ずつ増やしてください）。


訳すよりオプション名の方がわかりやすいと思ったのでrow　gutterをrow-gutterに変更しています。

ultimatile · 2026-01-02T01:37:13Z

crates/typst-library/src/layout/grid/mod.rs

-    /// If the `position` field is set to `{end}`, the line is placed after the
-    /// column with the given index instead (see that field's docs for
-    /// details).
+    /// 配置される垂直方向の線の前にある列（0始まり）。


horizontalはverticalのtypoだと思います。最新版の公式ドキュメントでは修正されていました。

ultimatile · 2026-01-02T01:38:32Z

@kimushun1101 @gomazarashi @3w36zj6 あけましておめでとうございます。大変遅くなりましたが翻訳が完了しましたのでレビューよろしくお願いします。

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

crates/typst-library/src/layout/grid/mod.rs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

kimushun1101

ご対応ありがとうございます。内容は問題ないと思います。読みやすさの観点で少しコメントを入れさせていただきました。

crates/typst-library/src/layout/grid/mod.rs

Co-authored-by: Shunsuke KIMURA <kimushun1101@gmail.com>

Co-authored-by: ultimatile <ultimatile@users.noreply.github.com>

ultimatile · 2026-01-31T15:37:35Z

crates/typst-library/src/layout/grid/mod.rs

-    /// This can be a color or a function that returns a color. The function
-    /// receives the cells' column and row indices, starting from zero. This can
-    /// be used to implement striped grids.
+    /// これはcolorかcolorを返す関数が使用可能です。


Suggested change

/// これはcolorかcolorを返す関数が使用可能です。

/// colorかcolorを返す関数を指定できます。

alRex-U · 2026-02-01T05:46:18Z

crates/typst-library/src/layout/grid/mod.rs

 #[elem(scope, Show)]
 pub struct GridElem {
-    /// The column sizes.
+    /// 列の数。


この部分とこれに関連する翻訳文ですが両方を同時に指定する部分ですので「列の数とサイズ」のようにしてしまうのはどうでしょうか。

その次に続く翻訳で説明されておりますが、列の数（整数値）またはそれぞれの列の幅を指定した配列が入るものだと思います。
「列の数または各列のサイズ」と言ったところでしょうか？

「サイズ」でも意味は通りますが、これまでは「大きさ」と訳していたと思います。

Suggested change

/// 列の数。

/// 列の数または各列の大きさ。

crates/typst-library/src/layout/grid/mod.rs

alRex-U · 2026-02-01T05:47:25Z

crates/typst-library/src/layout/grid/mod.rs

    pub align: Celled<Smart<Alignment>>,

-    /// How to [stroke]($stroke) the cells.
+    /// セルの[ストローク]($stroke)をどうするか。


おそらく原文は「どのように(罫線を引くことで)セルを描くか」のような意味で、この入力は罫線の描画に使用するstrokeの定義なので、そのような翻訳に変更するのはどうでしょう。

ここに関してはstrokeへの参照を潰す訳は好ましくないと思っています

折衷案としては「ストローク」を「罫線」と訳し、それに対応する動詞を付けるといったところでしょうか？

Suggested change

/// セルの[ストローク]($stroke)をどうするか。

/// どのようにセルの[罫線]($stroke)を引くか。

課題としては、gridやtableではストロークを罫線と訳出するとスッキリしますが、ストロークには単純に"線"（の色や太さを設定するパラメータ）を意味することもあるところです。例えば、circleにもstrokeパラメータは適用できます。

https://typst.app/docs/reference/visualize/stroke/

https://typst.app/docs/reference/visualize/circle/

これを把握したうえで[罫線]($stroke)という参照を許容するという考えもあります。

個人的には"stroke"は「ストローク」としか言いようがないと思っています。

"線"（の色や太さを設定するパラメータ）

の括弧内を含めたものが定義だと思っています。

上でlineは「線」より「罫線」のほうがよさそうと書きましたが、tableはそれで良いのですが、gridの場合は「罫線」と呼ぶのは不自然な気がしてきました。
両者で訳し分けてもいいかもですが、元の単語は同じlineではあるので、合わせるなら共通部分としては「線」の方が適切かもしれないという気がしています。
これに関しては他のレビュワーの方の意見も伺いたいところです。

Originally posted by @ultimatile in #341 (comment)

こちらにも言及がありましたね。無理に「罫線」にする必要もないと思います。

gridの場合に罫線という訳が不自然なことは同感ですので、提案されたように単に「線」と訳すか強いて言えば「枠線」くらいかとは思います。

strokeの解釈についても了解しましたので、この部分はこのまま置いておくか他の案を挙げさせていただけるなら「セルの線(ないしは枠線)の描画に用いるストローク」などでしょうか

原文のHow to ~を尊重して「どのように~」と訳す場合は現在の表現しか思いつきかねますのでこのままでよいと思っています。

ultimatile force-pushed the translate-layout/grid branch from 55dbcbf to 2ed24dc Compare August 4, 2025 06:41

ultimatile added the translation Translation additions or improvements label Aug 6, 2025

ultimatile force-pushed the translate-layout/grid branch 2 times, most recently from e7882da to d6fa3a6 Compare August 29, 2025 00:11

/docs/reference/layout/gridの翻訳

31723b0

ultimatile force-pushed the translate-layout/grid branch from d6fa3a6 to 31723b0 Compare August 29, 2025 00:11

3w36zj6 requested a review from Copilot September 30, 2025 15:11

Copilot AI reviewed Sep 30, 2025

View reviewed changes

Merge branch 'main' into translate-layout/grid

554b48c

ultimatile force-pushed the translate-layout/grid branch from 566fdf9 to 554b48c Compare January 2, 2026 01:30

Merge branch 'main' into translate-layout/grid

4c8c096

ultimatile marked this pull request as ready for review January 2, 2026 01:33

ultimatile requested review from 3w36zj6, gomazarashi and kimushun1101 as code owners January 2, 2026 01:33

ultimatile commented Jan 2, 2026

View reviewed changes

ultimatile requested a review from Copilot January 2, 2026 01:38

Copilot started reviewing on behalf of ultimatile January 2, 2026 01:39 View session

Copilot AI reviewed Jan 2, 2026

View reviewed changes

ultimatile and others added 7 commits January 2, 2026 10:53

fix textlint

3c61933

Update crates/typst-library/src/layout/grid/mod.rs

20b2ed3

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update crates/typst-library/src/layout/grid/mod.rs

276d29c

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update crates/typst-library/src/layout/grid/mod.rs

d59771c

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update crates/typst-library/src/layout/grid/mod.rs

0c229ab

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update crates/typst-library/src/layout/grid/mod.rs

7e569cc

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update crates/typst-library/src/layout/grid/mod.rs

a3d23a1

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

ultimatile force-pushed the translate-layout/grid branch from 50d17b5 to a3d23a1 Compare January 2, 2026 02:03

kimushun1101 reviewed Jan 8, 2026

View reviewed changes

crates/typst-library/src/layout/grid/mod.rs Outdated Show resolved Hide resolved

crates/typst-library/src/layout/grid/mod.rs Outdated Show resolved Hide resolved

crates/typst-library/src/layout/grid/mod.rs Outdated Show resolved Hide resolved

ultimatile and others added 3 commits January 13, 2026 15:55

Update crates/typst-library/src/layout/grid/mod.rs

143e450

Co-authored-by: Shunsuke KIMURA <kimushun1101@gmail.com>

Update crates/typst-library/src/layout/grid/mod.rs

1d90987

Update crates/typst-library/src/layout/grid/mod.rs

1800d53

Co-authored-by: ultimatile <ultimatile@users.noreply.github.com>

kimushun1101 approved these changes Jan 21, 2026

View reviewed changes

ultimatile mentioned this pull request Jan 31, 2026

model/table の翻訳 #341

Open

ultimatile commented Jan 31, 2026

View reviewed changes

alRex-U added a commit to alRex-U/typst-jp-docs that referenced this pull request Feb 1, 2026

model/table:layout/grid(typst-jp#242) に合わせていくつかの表現を修正

ebc83dd

alRex-U reviewed Feb 1, 2026

View reviewed changes

crates/typst-library/src/layout/grid/mod.rs Outdated Show resolved Hide resolved

alRex-U reviewed Feb 1, 2026

View reviewed changes

Update crates/typst-library/src/layout/grid/mod.rs

cdbfbc6

	/// これはcolorかcolorを返す関数が使用可能です。
	/// colorかcolorを返す関数を指定できます。

	/// セルの[ストローク]($stroke)をどうするか。
	/// どのようにセルの[罫線]($stroke)を引くか。

Conversation

ultimatile commented Aug 4, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ultimatile commented Jan 2, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kimushun1101 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants