Note, Warning, Careful等の訳

[Milly]

vim-jp/vimdoc-ja#43: に古い(2012年)議論があります。

現状

• Note:
  • 原文のまま未変換である。
• Careful:
  • 注意: に変換されている。
  • 原文の表記の違い (Careful: vs CAREFUL:) は考慮されていない。
• Warning:
  • 警告: に変換されている。
    • 翻訳済だが "WARNING:" のままの箇所がある。
      

      vimdoc-ja-working/doc/syntax.jax

      Line 5001 in c0fbffe

      WARNING: tagsファイルが大きくなるほどこの操作は遅くなり、消費するメモリ量も多

      
      

      vimdoc-ja-working/doc/options.jax

      Line 1171 in c0fbffe

      WARNING: バックアップファイルを作らないということは、すなわち、何らか

      
      

      vimdoc-ja-working/doc/options.jax

      Line 9108 in c0fbffe

      WARNING: このオプションをオフにするということは、すなわち、何らかの理

  • 原文の表記の違い (Warning: vs WARNING:) は考慮されていない。
    • 強調表現として ‘警告’: となっている箇所が1つだけある。
      

      vimdoc-ja-working/doc/gui_x11.jax

      Line 210 in c0fbffe

      ‘警告’: GUIからの外部コマンドの実行は常に動作するとは限らないだろう。"ls",

提案

• Note: は変換しない。

• Careful: は 注意: とする。

  • 原文の表記の違い (Careful: vs CAREFUL:) は考慮しない。

• Warning: は 警告: とする。

  • 原文の表記の違い (Warning: vs WARNING:) は考慮しない。

• 以上を Vim ドキュメント翻訳者の手引き に記述する。

• 注意: と 警告: のハイライトを定義する。

  • "警告:" をハイライト. #204 で警告ハイライトの PR があります。

• ❓ nvcheck をかける。

[Milly]

Note についての提案の変更

• Note: は 注記: とする。
• 注記: のハイライトを定義する。

Deprecated についての提案の追加

• DEPRECATED: は 非推奨: とする。
• 非推奨: のハイライトを定義する。
  • 非推奨 (コロンが無い)もハイライトしてしまっても問題ない気もする。
    → やっぱりコロン無しのハイライトはやめておく。

[Milly]

@h-east @k-takata 何かご意見ありましたらお願いします。

[Milly]

文中の Note that ～ の翻訳について

過去の議論が issue #61 にある。

• ハイライトによる視覚効果を期待したいので 注記: ～ に統一したい。
• 普通に翻訳されている箇所も 注記: ～ 形式に変更する。

[h-east]

@Milly 特に問題ないと思います。進めてもらって構いません。:+1:
1点だけ。非推奨 (コロンが無い)はハイライトしない方がいいかなと思いました。

[Milly]

Careful: 注意: のハイライト

原文には Careful: のハイライト定義は存在しない。
そのため 注意: のハイライト定義は保留する。

[Milly]

nvcheck で replace 試したら「原文n文字、修正後n-2文字以下」の条件でpanicするバグを引き当てたので、 koron/nvcheck#9 を投げるなどした。