Skip to content

/docs/reference/styling/の再翻訳#385

Open
kimushun1101 wants to merge 3 commits into
mainfrom
retranslate-reference-styling
Open

/docs/reference/styling/の再翻訳#385
kimushun1101 wants to merge 3 commits into
mainfrom
retranslate-reference-styling

Conversation

@kimushun1101
Copy link
Copy Markdown
Member

@kimushun1101 kimushun1101 commented May 22, 2026

Closes #364

意訳した箇所や訳語選定で悩んだポイントは以下です。

  • transformational show rule → 変換型showルール
    既存の訳語が見当たらなかったため、原文のイタリック強調(_transformational_)を保ったまま「_変換型_showルール」としました。「変換的な」「変形」などとも迷いましたが、「型」を付けることでshow-setルールとの分類対比が明確になると考えました。
  • non-breaking space → ノーブレークスペース
    JIS X 0201/X 0212で用いられる規格用語「ノーブレークスペース」を採用しました。「ノンブレーキングスペース」「改行されないスペース」とも迷いましたが、規格名に統一するのが無難と判断しました。
  • keeping styling composable → スタイル設定を組み合わせやすい状態が保たれます
    「合成可能性」と直訳することもできますが、抽象的でわかりにくいため、「組み合わせやすい状態」と平易に意訳しました。
  • would not be overridable anymore → 後から上書きできなくなります
    「もはや上書きできません」とも訳せますが、「以前は可能だったが以後は不可」という状態変化を明確にするため、「後から〜できなくなります」と意訳しました。
  • For maximum flexibility → より柔軟な設定方法として
    「最大限の柔軟性を得るために」と直訳もできますが、続く文との接続を自然にするため、トーンを若干和らげました。

@kimushun1101 kimushun1101 force-pushed the retranslate-reference-styling branch from fbd81d0 to e0ea309 Compare May 22, 2026 23:11
@kimushun1101 kimushun1101 force-pushed the retranslate-reference-styling branch from e0ea309 to dcbe587 Compare May 22, 2026 23:17
@kimushun1101 kimushun1101 marked this pull request as ready for review May 22, 2026 23:20
Comment thread docs/reference/language/styling.md Outdated
Comment thread docs/reference/language/styling.md Outdated
kimushun1101 and others added 2 commits May 23, 2026 20:23
Co-authored-by: ultimatile <ultimatile@users.noreply.github.com>
Co-authored-by: ultimatile <ultimatile@users.noreply.github.com>
@kimushun1101
Copy link
Copy Markdown
Member Author

@ultimatile コメントありがとうございます。採用させていただきました。

@kimushun1101 kimushun1101 requested a review from ultimatile May 23, 2026 11:24
このshowルール自体は、タイトルの両側にチルダ文字を加え(このチルダはバックスラッシュでエスケープする必要があります。エスケープしないとノーブレークスペースとして解釈されてしまうためです)、タイトルをイタリック体で強調表示し、その後ろに見出しカウンターを表示します。

この例では、中央揃えと別のフォントの適用もあわせて行いたいとします。
これらのsetルールを既存のshowルールの中に書き加えられますが、ここでは別々のshow-setルールとして追加しています。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

すみません、提案した側が言うのはどうかと思うのですが、読み返すと受動態っぽく読めるので「追加可能ですが」のように受動ではなく可能であると読みやすい文に変えた方が良さそうです。

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

話の流れとしては「こういう手段も取れますが、ここではこういう手段をとります。なぜならスタイル設定の組み合わせを見せたいから」という感じかと思います。以下の修正ではいかがでしょうか?

Suggested change
これらのsetルールを既存のshowルールの中に書き加えられますが、ここでは別々のshow-setルールとして追加しています。
これらのsetルールを既存のshowルールの中に追記する手もありますが、ここでは別々のshow-setルールとして追加しています。

Copy link
Copy Markdown
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.

v0.14.0への更新に伴う/docs/reference/styling/の再翻訳

2 participants