From 0762ec44e913cb682136d9b8b190f5a5091f3e25 Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Sat, 20 Jun 2026 09:06:48 +0900 Subject: [PATCH 1/9] =?UTF-8?q?=E7=BF=BB=E8=A8=B3=E9=96=8B=E5=A7=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/translation-status.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/translation-status.json b/website/translation-status.json index d6ab3d56d..5d710182d 100644 --- a/website/translation-status.json +++ b/website/translation-status.json @@ -49,7 +49,7 @@ "/docs/reference/model/cite/": "translated", "/docs/reference/model/document/": "translated", "/docs/reference/model/emph/": "translated", - "/docs/reference/model/figure/": "partially_translated", + "/docs/reference/model/figure/": "translated", "/docs/reference/model/footnote/": "translated", "/docs/reference/model/heading/": "translated", "/docs/reference/model/link/": "translated", From 86eb84d0b2f969d892e6b3abe251bfc852dd843a Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Sat, 20 Jun 2026 10:59:32 +0900 Subject: [PATCH 2/9] =?UTF-8?q?=E7=BF=BB=E8=A8=B3=E5=AE=8C=E4=BA=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- crates/typst-library/src/model/figure.rs | 72 ++++++++++++------------ 1 file changed, 36 insertions(+), 36 deletions(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index 8adde9cfd..bb8cebcc4 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -94,42 +94,42 @@ use crate::visualize::ImageElem; /// ) /// ``` /// -/// # Accessibility -/// You can use the [`alt`]($figure.alt) parameter to provide an [alternative -/// description]($guides/accessibility/#textual-representations) of the figure -/// for screen readers and other Assistive Technology (AT). Refer to [its -/// documentation]($figure.alt) to learn more. +/// # アクセシビリティ +/// [`alt`]($figure.alt) パラメーターを使用して、 +/// スクリーンリーダーやその他の支援技術(AT)のための図表の[代替説明]($guides/accessibility/#textual-representations)を提供できます。 +/// 詳細については、 +/// [ドキュメント]($figure.alt)を参照してください。 /// -/// You can use figures to add alternative descriptions to paths, shapes, or -/// visualizations that do not have their own `alt` parameter. If your graphic -/// is purely decorative and does not have a semantic meaning, consider wrapping -/// it in [`pdf.artifact`] instead, which will hide it from AT when exporting to -/// PDF. +/// 独自の`alt`パラメーターを持たないパス、図形、 +/// または視覚化に代替説明を追加したい場合は図表を使用できます。 +/// グラフィックが純粋に装飾目的であり、セマンティックな役割を持たない場合は、 +/// 代わりに[`pdf.artifact`]で囲むことを検討してください。 +/// これにより、PDFにエクスポートする際にATから隠されます。 /// -/// AT will always read the figure at the point where it appears in the -/// document, regardless of its [`placement`]($figure.placement). Put its markup -/// where it would make the most sense in the reading order. +/// ATは、図表の[`placement`]($figure.placement)による配置に関係なく、 +/// その図表が文書中に現れる位置で常に読み上げます。 +/// 読み上げ順序の中で最も自然になる位置にそのマークアップを配置してください。 #[elem(scope, Locatable, Tagged, Synthesize, Count, ShowSet, Refable, Outlinable)] pub struct FigureElem { /// 図表のコンテンツ。多くの場合、 [image] が使われます。 #[required] pub body: Content, - /// An alternative description of the figure. + /// 図表の代替説明。 /// - /// When you add an alternative description, AT will read both it and the - /// caption (if any). However, the content of the figure itself will be - /// skipped. + /// 代替説明を追加すると、 + /// ATはその代替説明とキャプションの両方を読み上げます。 + /// ただし、図表そのもののコンテンツはスキップされます。 /// - /// When the body of your figure is an [image]($image) with its own `alt` - /// text set, this parameter should not be used on the figure element. - /// Likewise, do not use this parameter when the figure contains a table, - /// code, or other content that is already accessible. In such cases, the - /// content of the figure will be read by AT, and adding an alternative - /// description would lead to a loss of information. + /// 図表の本体が、それ自体に`alt`テキストが設定された[画像]($image)である場合、 + /// このパラメーターは図表要素で使用しないでください。 + /// 同様に、図表が表、コード、またはすでにアクセシブルなその他のコンテンツを含む場合も、 + /// このパラメーターを使用しないでください。 + /// このような場合、図表のコンテンツはATによって読み上げられるため、 + /// 代替説明を追加すると情報が失われることになります。 /// - /// You can learn how to write good alternative descriptions in the - /// [Accessibility Guide]($guides/accessibility/#textual-representations). + /// 適切な代替説明の書き方については、 + /// [アクセシビリティガイド]($guides/accessibility/#textual-representations)を参照してください。 pub alt: Option, /// ページ上における図表の配置。 @@ -196,7 +196,7 @@ pub struct FigureElem { /// 種類は、要素関数または文字列に設定できます。 /// [`table`]($table)、[`raw`]($raw)、[`image`]($image)以外の要素関数に設定した場合は、図表の補足語(supplement)を手動で指定する必要があります。 /// - /// ```example:"Customizing the figure kind" + /// ```example:"図表の種類のカスタマイズ" /// #figure( /// circle(radius: 10pt), /// caption: [A curious atom.], @@ -205,15 +205,15 @@ pub struct FigureElem { /// ) /// ``` /// - /// If you want to modify a counter to skip a number or reset the counter, - /// you can access the [counter] of each kind of figure with a - /// [`where`]($function.where) selector: + /// カウンターの値を変更して番号をスキップしたり、 + /// カウンターをリセットしたりしたい場合は、[`where`]($function.where)セレクターを使用して、 + /// 各種類の図表に対応する[counter]にアクセスできます。 /// - /// - For [tables]($table): `{counter(figure.where(kind: table))}` - /// - For [images]($image): `{counter(figure.where(kind: image))}` - /// - For a custom kind: `{counter(figure.where(kind: kind))}` + /// - [表]($table)の場合: `{counter(figure.where(kind: table))}` + /// - [画像]($image)の場合: `{counter(figure.where(kind: image))}` + /// - 独自の種類の場合: `{counter(figure.where(kind: kind))}` /// - /// ```example:"Modifying the figure counter for specific kinds" + /// ```example:"特定の種類に対する図表カウンターの変更" /// #figure( /// table(columns: 2, $n$, $1$), /// caption: [The first table.], @@ -234,9 +234,9 @@ pub struct FigureElem { /// ) /// ``` /// - /// To conveniently use the correct counter in a show rule, you can access - /// the `counter` field. There is an example of this in the documentation - /// [of the `figure.caption` element's `body` field]($figure.caption.body). + /// showルール内で適切なカウンターを便利に使用するために、`counter`フィールドにアクセスできます。 + /// これについては、 + /// [`figure.caption`要素の`body`フィールド]($figure.caption.body)のドキュメントに例があります。 pub kind: Smart, /// 図表の補足語。 From 054b496f8bb0d06dd3916e48adf1b340b3ae178a Mon Sep 17 00:00:00 2001 From: gomazarashi <60730277+gomazarashi@users.noreply.github.com> Date: Sat, 20 Jun 2026 19:16:20 +0900 Subject: [PATCH 3/9] Apply suggestions from code review Co-authored-by: ultimatile --- crates/typst-library/src/model/figure.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index bb8cebcc4..b9d9fef12 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -118,7 +118,7 @@ pub struct FigureElem { /// 図表の代替説明。 /// /// 代替説明を追加すると、 - /// ATはその代替説明とキャプションの両方を読み上げます。 + /// ATはその代替説明と(存在すれば)キャプションの両方を読み上げます。 /// ただし、図表そのもののコンテンツはスキップされます。 /// /// 図表の本体が、それ自体に`alt`テキストが設定された[画像]($image)である場合、 From a277446bd4a244e143b15fcf6b84b8e635c7525d Mon Sep 17 00:00:00 2001 From: gomazarashi <60730277+gomazarashi@users.noreply.github.com> Date: Sat, 20 Jun 2026 19:53:19 +0900 Subject: [PATCH 4/9] Apply suggestions from code review Co-authored-by: ultimatile --- crates/typst-library/src/model/figure.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index b9d9fef12..c7dbf1aac 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -207,7 +207,7 @@ pub struct FigureElem { /// /// カウンターの値を変更して番号をスキップしたり、 /// カウンターをリセットしたりしたい場合は、[`where`]($function.where)セレクターを使用して、 - /// 各種類の図表に対応する[counter]にアクセスできます。 + /// 各種類の図表に対応する[カウンター]($counter)にアクセスできます。 /// /// - [表]($table)の場合: `{counter(figure.where(kind: table))}` /// - [画像]($image)の場合: `{counter(figure.where(kind: image))}` From 9f3a6ff524f1dffb3fd48474563eef255d47d36f Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Sat, 20 Jun 2026 19:58:29 +0900 Subject: [PATCH 5/9] =?UTF-8?q?=E5=8D=8A=E8=A7=92=E3=81=A8=E5=85=A8?= =?UTF-8?q?=E8=A7=92=E3=81=AE=E6=B7=B7=E5=9C=A8=E3=82=92=E8=A7=A3=E6=B6=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- crates/typst-library/src/model/figure.rs | 4 ++-- website/typst-docs-web | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index c7dbf1aac..b629421cf 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -95,8 +95,8 @@ use crate::visualize::ImageElem; /// ``` /// /// # アクセシビリティ -/// [`alt`]($figure.alt) パラメーターを使用して、 -/// スクリーンリーダーやその他の支援技術(AT)のための図表の[代替説明]($guides/accessibility/#textual-representations)を提供できます。 +/// [`alt`]($figure.alt)パラメーターを使用して、 +/// スクリーンリーダーやその他の支援技術(AT)のための図表の[代替説明]($guides/accessibility/#textual-representations)を提供できます。 /// 詳細については、 /// [ドキュメント]($figure.alt)を参照してください。 /// diff --git a/website/typst-docs-web b/website/typst-docs-web index 59cabb49a..230699f7d 160000 --- a/website/typst-docs-web +++ b/website/typst-docs-web @@ -1 +1 @@ -Subproject commit 59cabb49a426b852923850bdd4c6f9385f85e83f +Subproject commit 230699f7d8cd90c454656d901096cfeb72b20a7e From abd7ff87ffa4312f54dd59395d055d4818691177 Mon Sep 17 00:00:00 2001 From: gomazarashi <60730277+gomazarashi@users.noreply.github.com> Date: Sat, 20 Jun 2026 19:59:51 +0900 Subject: [PATCH 6/9] Update crates/typst-library/src/model/figure.rs Co-authored-by: ultimatile --- crates/typst-library/src/model/figure.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index b629421cf..1709228e0 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -234,7 +234,7 @@ pub struct FigureElem { /// ) /// ``` /// - /// showルール内で適切なカウンターを便利に使用するために、`counter`フィールドにアクセスできます。 + /// `counter`フィールドにアクセスすることで、showルール内で適切なカウンターが活用できます。 /// これについては、 /// [`figure.caption`要素の`body`フィールド]($figure.caption.body)のドキュメントに例があります。 pub kind: Smart, From 12783d70ba696db0a29405b6e30c3e6e7578c674 Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Sat, 20 Jun 2026 20:05:00 +0900 Subject: [PATCH 7/9] =?UTF-8?q?=E3=80=8C=E3=83=91=E3=83=A9=E3=83=A1?= =?UTF-8?q?=E3=83=BC=E3=82=BF=E3=83=BC=E3=81=AF=E3=80=8D=E2=86=92=E3=80=8C?= =?UTF-8?q?=E3=83=91=E3=83=A9=E3=83=A1=E3=83=BC=E3=82=BF=E3=83=BC=E3=82=92?= =?UTF-8?q?=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- crates/typst-library/src/model/figure.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index 1709228e0..f13db7e9f 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -122,7 +122,7 @@ pub struct FigureElem { /// ただし、図表そのもののコンテンツはスキップされます。 /// /// 図表の本体が、それ自体に`alt`テキストが設定された[画像]($image)である場合、 - /// このパラメーターは図表要素で使用しないでください。 + /// このパラメーターを図表要素で使用しないでください。 /// 同様に、図表が表、コード、またはすでにアクセシブルなその他のコンテンツを含む場合も、 /// このパラメーターを使用しないでください。 /// このような場合、図表のコンテンツはATによって読み上げられるため、 From 985fab8b6bd3997518f0bd44006b4983d3ba30dc Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Thu, 25 Jun 2026 10:31:43 +0900 Subject: [PATCH 8/9] =?UTF-8?q?=E8=A1=A8=E7=8F=BE=E3=82=92=E6=94=B9?= =?UTF-8?q?=E5=96=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- crates/typst-library/src/model/figure.rs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs index f13db7e9f..9d4f7e13f 100644 --- a/crates/typst-library/src/model/figure.rs +++ b/crates/typst-library/src/model/figure.rs @@ -100,11 +100,11 @@ use crate::visualize::ImageElem; /// 詳細については、 /// [ドキュメント]($figure.alt)を参照してください。 /// -/// 独自の`alt`パラメーターを持たないパス、図形、 -/// または視覚化に代替説明を追加したい場合は図表を使用できます。 -/// グラフィックが純粋に装飾目的であり、セマンティックな役割を持たない場合は、 +/// 図表を使用すれば、独自の`alt`パラメーターを持たないパス、 +/// 図形、または視覚化に代替説明を追加できます。 +/// グラフィックが純粋に装飾目的であり、セマンティックな意味を持たない場合は、 /// 代わりに[`pdf.artifact`]で囲むことを検討してください。 -/// これにより、PDFにエクスポートする際にATから隠されます。 +/// これにより、PDFにエクスポートする際にATから認識されなくなります。 /// /// ATは、図表の[`placement`]($figure.placement)による配置に関係なく、 /// その図表が文書中に現れる位置で常に読み上げます。 From 831ce3d57304c52ed0547b044686b01151d015a7 Mon Sep 17 00:00:00 2001 From: gomazarashi Date: Sat, 27 Jun 2026 10:03:55 +0900 Subject: [PATCH 9/9] Revert typst-docs-web submodule update --- website/typst-docs-web | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/typst-docs-web b/website/typst-docs-web index 230699f7d..59cabb49a 160000 --- a/website/typst-docs-web +++ b/website/typst-docs-web @@ -1 +1 @@ -Subproject commit 230699f7d8cd90c454656d901096cfeb72b20a7e +Subproject commit 59cabb49a426b852923850bdd4c6f9385f85e83f