Skip to content

Comments

visualize/strokeの翻訳#367

Draft
alRex-U wants to merge 2 commits intotypst-jp:mainfrom
alRex-U:translate-visualize-stroke
Draft

visualize/strokeの翻訳#367
alRex-U wants to merge 2 commits intotypst-jp:mainfrom
alRex-U:translate-visualize-stroke

Conversation

@alRex-U
Copy link

@alRex-U alRex-U commented Feb 8, 2026

visualize/strokeの翻訳です。
一部表現に疑問が残るのでDraftとしています。

以下の用語は次のように訳しました。

  • miter
    • 「マイター」
  • miter limit
    • 「マイターリミット」
  • miter join
    • 「マイター接合」
  • line cap
    • 「ラインキャップ」
  • line join
    • 「線の接続」
  • dash pattern
    • 「破線パターン」
  • sharp turnssharp bendsなど
    • 「鋭い(線の)折り返し」

他に再考の余地があると考えている部分はコメントで付しておきます。

/// A stroke has a _paint_ (a solid color or gradient), a _thickness,_ a line
/// _cap,_ a line _join,_ a _miter limit,_ and a _dash_ pattern. All of these
/// values are optional and have sensible defaults.
/// ストロークはペイント(単一の色またはグラデーション)、太さ、ラインキャップ、線の接続、マイターリミット、および破線パターンを持ちます。
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この部分原文では強調でコンストラクタのパラメータを列挙していますが、絶妙にパラメータ名と一致していなかったり名称の一部だけが強調されていたりしており判断に迷ったため、暫定的にこのようにしています。

dash: Smart<Option<DashPattern>>,

/// Number at which protruding sharp bends are rendered with a bevel
/// instead or a miter join. The higher the number, the sharper an angle
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この部分の文中の "instead or"ですが、"instead of"の誤記かと思います。
そうでないと文法的にすこし不自然になるのと、文意や実際の挙動との整合性を鑑みても"instead of"の方が自然な意味になります。
訳文ではそのように解釈した文になっています。

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

これはタイポっぽいですね。
本家に修正PRを送ると良いのではないでしょうか?

@ultimatile
Copy link
Contributor

https://developer.mozilla.org/ja/docs/Web/SVG/Reference/Attribute/stroke-miterlimit

を見ると"miter join"は「マイター接続」、"miter limit"は「マイター制限」のようです。

https://developer.mozilla.org/ja/docs/Web/API/CanvasRenderingContext2D/lineJoin

を見ると

"line join"は「線結合」のようです。

///
/// Specifically, the miter limit is the maximum ratio between the
/// corner's protrusion length and the stroke's thickness.
/// 具体的には、miter limitとはコーナーの突起の長さとストロークの太さの間の比の最大値です。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここの"Specifically"は「厳密には」のニュアンスに近いかなと思いました。

Suggested change
/// 具体的には、miter limitとはコーナーの突起の長さとストロークの太さの間の比の最大値です
/// 厳密には、マイターリミットはコーナーから突き出た長さとストロークの太さの比の最大値です

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この部分ですがMozillaのドキュメントを踏襲するとして"miter limit"を「マイター制限」と訳すにあたっては、このパラメータの項で唯一この用語が使われている部分であるということもあり、"miter limit"を「マイター制限」と訳していると明示せずにこの訳をここで使用するのは、唐突に用語が登場した印象を与えてしまう可能性もあると考えていたのですが、注を付け加えるか表現を変えるかした方がよいのでしょうか?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

確かにご懸念は尤もですね。
マイター制限(miter limit)のように原文併記が良いかもしれません

/// instead or a miter join. The higher the number, the sharper an angle
/// can be before it is bevelled. Only applicable if `join` is
/// `{"miter"}`.
/// 突出した鋭い折り返しがマイター接合の代わりにベベルによってレンダリングされる数値を指定します。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"a bevel"はjoinが省略されているとみて「ベベル接合」のようにして「マイター接合」に合わせた方が自然だと思います。

Suggested change
/// 突出した鋭い折り返しがマイター接合の代わりにベベルによってレンダリングされる数値を指定します
/// 突出して鋭い折り返しがマイター接合の代わりにベベル接合を用いてレンダリングされるようになる数値を指定します

/// can be before it is bevelled. Only applicable if `join` is
/// `{"miter"}`.
/// 突出した鋭い折り返しがマイター接合の代わりにベベルによってレンダリングされる数値を指定します。
/// 数値が高いほどより鋭い角がベベルではなくマイター接合されます。`join`フィールドが`{"miter"}`の場合のみ有効です。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こちらは意訳気味になりますが同上です。

Suggested change
/// 数値が高いほどより鋭い角がベベルではなくマイター接合されます。`join`フィールドが`{"miter"}`の場合のみ有効です。
/// 数値が高いほどより鋭い角がベベル接合ではなくマイター接合されます。`join`フィールドが`{"miter"}`の場合のみ有効です。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants