Conversation
| /// 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. | ||
| /// ストロークはペイント(単一の色またはグラデーション)、太さ、ラインキャップ、線の接続、マイターリミット、および破線パターンを持ちます。 |
There was a problem hiding this comment.
この部分原文では強調でコンストラクタのパラメータを列挙していますが、絶妙にパラメータ名と一致していなかったり名称の一部だけが強調されていたりしており判断に迷ったため、暫定的にこのようにしています。
| 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 |
There was a problem hiding this comment.
この部分の文中の "instead or"ですが、"instead of"の誤記かと思います。
そうでないと文法的にすこし不自然になるのと、文意や実際の挙動との整合性を鑑みても"instead of"の方が自然な意味になります。
訳文ではそのように解釈した文になっています。
There was a problem hiding this comment.
これはタイポっぽいですね。
本家に修正PRを送ると良いのではないでしょうか?
|
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つの組み合わせによって単純な単一色の線を作成できます。 | ||
| /// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡すことができます。 |
There was a problem hiding this comment.
| /// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡すことができます。 | |
| /// 具体的にはストロークが期待される場所ならどこでも、以下の値をどれでも渡せます。 |
| /// 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のキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます。 |
There was a problem hiding this comment.
好みの問題かもしれませんが「任意の」だと謎のパラメーターを許容するように読める懸念があるので
| /// dictionaryのキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます。 | |
| /// dictionaryのキーには、以下に示されるコンストラクタ関数のパラメーターならどれでも含められます。 |
はどうでしょうか?
あるいは単に
| /// dictionaryのキーは以下に示されるコンストラクタ関数の任意のパラメータを含むことができます。 | |
| /// dictionaryのキーには、以下に示されるコンストラクタ関数のパラメーターを含められます。 |
でも良いかもしれません。
あと「以下に示される」は敬体に対して硬すぎる印象なので「以下の」「以下にある」ぐらいがちょうど良いかもしれません。
| /// Meanwhile, `{stroke(red).cap}` is `{auto}` because it's unspecified. Fields | ||
| /// set to `{auto}` are inherited. | ||
| /// # フィールド | ||
| /// ストロークオブジェクトにおいては、コンストラクタ関数で列挙されている任意のフィールドにアクセスすることができます。 |
There was a problem hiding this comment.
| /// ストロークオブジェクトにおいては、コンストラクタ関数で列挙されている任意のフィールドにアクセスすることができます。 | |
| /// ストロークオブジェクトでは、コンストラクタ関数で列挙されている任意のフィールドにアクセスできます。 |
| /// this constructor can be useful to ensure a value has all the fields of a | ||
| /// stroke. | ||
| /// ほとんどの場合は自動的に変換が行われるため、ストロークを使用する際に値を明示的に変換する必要はありません。 | ||
| /// しかし、このコンストラクタは値がストロークの全てのフィールドを含んでいることを保証するためには役立つかもしれません。 |
There was a problem hiding this comment.
意訳気味ですが
| /// しかし、このコンストラクタは値がストロークの全てのフィールドを含んでいることを保証するためには役立つかもしれません。 | |
| /// しかし、このコンストラクタを使うと値がストロークの全てのフィールドを含んでいることを保証できます。 |
| /// | ||
| /// Specifically, the miter limit is the maximum ratio between the | ||
| /// corner's protrusion length and the stroke's thickness. | ||
| /// 具体的には、miter limitとはコーナーの突起の長さとストロークの太さの間の比の最大値です。 |
There was a problem hiding this comment.
ここの"Specifically"は「厳密には」のニュアンスに近いかなと思いました。
| /// 具体的には、miter limitとはコーナーの突起の長さとストロークの太さの間の比の最大値です。 | |
| /// 厳密には、マイターリミットはコーナーから突き出た長さとストロークの太さの比の最大値です。 |
|
|
||
| impl Stroke<Abs> { | ||
| /// Unpack the stroke, filling missing fields from the `default`. | ||
| /// ストロークをアンパックし、不足したフィールドをデフォルト値で埋めます。 |
| } | ||
|
|
||
| /// Unpack the stroke, filling missing fields with the default values. | ||
| /// ストロークをアンパックし、不足したフィールドをデフォルト値で埋めます。 |
visualize/strokeの翻訳です。一部表現に疑問が残るのでDraftとしています。
以下の用語は次のように訳しました。
mitermiter limitmiter joinline capline joindash patternsharp turns、sharp bendsなど他に再考の余地があると考えている部分はコメントで付しておきます。