Skip to content

Comments

visualize/strokeの翻訳#367

Draft
alRex-U wants to merge 1 commit intotypst-jp:mainfrom
alRex-U:translate-visualize-stroke
Draft

visualize/strokeの翻訳#367
alRex-U wants to merge 1 commit 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"は「線結合」のようです。

/// pass any of the following values:
/// # 単純なストローク
/// 色、線の太さ、またはそれら2つの組み合わせによって単純な単一色の線を作成できます。
/// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡すことができます。
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
/// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡すことができます
/// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡せます

/// to any function that expects a stroke. The dictionary's keys may include any
/// of the parameters for the constructor function, shown below.
/// 完全な制御のために、ストロークを期待する任意の関数に対して[dictionary]または`{stroke}`オブジェクトを提供することもできます。
/// dictionaryのキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます。
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
/// dictionaryのキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます
/// dictionaryのキーには、以下に示されるコンストラクタ関数のパラメーターならどれでも含められます

はどうでしょうか?

あるいは単に

Suggested change
/// dictionaryのキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます
/// dictionaryのキーには、以下に示されるコンストラクタ関数のパラメーターを含められます

でも良いかもしれません。

あと「以下に示される」は敬体に対して硬すぎる印象なので「以下の」「以下にある」ぐらいがちょうど良いかもしれません。

/// Meanwhile, `{stroke(red).cap}` is `{auto}` because it's unspecified. Fields
/// set to `{auto}` are inherited.
/// # フィールド
/// ストロークオブジェクトにおいては、コンストラクタ関数で列挙されている任意のフィールドにアクセスすることができます。
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
/// ストロークオブジェクトにおいては、コンストラクタ関数で列挙されている任意のフィールドにアクセスすることができます
/// ストロークオブジェクトでは、コンストラクタ関数で列挙されている任意のフィールドにアクセスできます

/// this constructor can be useful to ensure a value has all the fields of a
/// stroke.
/// ほとんどの場合は自動的に変換が行われるため、ストロークを使用する際に値を明示的に変換する必要はありません。
/// しかし、このコンストラクタは値がストロークの全てのフィールドを含んでいることを保証するためには役立つかもしれません。
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
/// しかし、このコンストラクタは値がストロークの全てのフィールドを含んでいることを保証するためには役立つかもしれません
/// しかし、このコンストラクタを使うと値がストロークの全てのフィールドを含んでいることを保証できます

///
/// 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とはコーナーの突起の長さとストロークの太さの間の比の最大値です
/// 厳密には、マイターリミットはコーナーから突き出た長さとストロークの太さの比の最大値です


impl Stroke<Abs> {
/// Unpack the stroke, filling missing fields from the `default`.
/// ストロークをアンパックし、不足したフィールドをデフォルト値で埋めます。
Copy link
Contributor

Choose a reason for hiding this comment

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

ここはドキュメントにないようです

}

/// Unpack the stroke, filling missing fields with the default values.
/// ストロークをアンパックし、不足したフィールドをデフォルト値で埋めます。
Copy link
Contributor

Choose a reason for hiding this comment

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

同上

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