日本語環境だと翻訳されるメッセージの表記方法が統一されていない
Closed this issue · 10 comments
問題の内容
#896, #898 からです。
:language ja_JP だと一部のメッセージが日本語に翻訳されますが、そのようなメッセージの表記方法がヘルプ全体で統一されていません。
たとえば、*'shortmess'* では、そのようなメッセージはヘルプの本文中で日本語に訳されています（[最終行が不完全], [変更あり] など）：
vimdoc-ja-working/doc/options.jax
Lines 6773 to 6787 in ea36c8d
一方で、*read-messages* では、本文中では原文ママで、日本語訳は訳注で記載されています。
vimdoc-ja-working/doc/insert.jax
Lines 1952 to 1982 in ea36c8d
一貫性のため、このようなメッセージの表記方法を全体で統一したほうがよいと思います。
表記方法の候補
表記方法の候補としては次の４つになるかと思います。
-
本文中で日本語に翻訳、訳注はなし。（
*'shortmess'*での表記方法と同じ） -
本文中で日本語に翻訳、原文を訳注で記載する。
-
本文中では原文ママ。日本語訳を訳注で記載する。（
*read-messages*での表記方法と同じ） -
本文中では原文ママ。訳注もなし。
個人的には 3 が良いような気がしますが、どうでしょうか？
3 がよいと思います。
vim-jp slack で Milly さんに起票していただいた poll の途中結果を載せておきます。
https://vim-jp.slack.com/archives/CJMV3MSLR/p1616677702147100
Sat Mar 27 20:06:36 JST 2021 時点で、画像の通り
0票0票8票0票
となっています。
表記方法を統一する方針をとるのであれば、3 に決定しても良いかなと思いますが、いかがでしょうか？
それと今思いましたが、「あえて表記方法を統一しない」という選択肢も入れておいたほうがよかったですね・・
ここで仮で3方向で修正をつくっておき、対応可能にする、くらいがいいですかね
3 に1票。
(私は普段 :lang message C を設定しているので、"原文ママ+訳注" が良いですね)
みなさんありがとうございます。では、3. 原文ママ+訳注 で決定ということでよさそうですね。
wiki/Guide#vim-ドキュメント翻訳者の手引き に記載する用の文章を書いてみましたが、こんな感じでどうでしょうか？
これでよければ、どなたか権限のある方に記載していただければと思います。
整形前（コピペ用）
整形後
-
日本語環境だと翻訳されるメッセージ
:language messages ja_JPなどの日本語環境では、一部のメッセージが日本語に翻訳される。そのようなメッセージは本文中では原文のままにし、その日本語訳を訳注で記載すること。基本的に一つのメッセージに対して一つの訳注をつければよいが、くどくなる場合は複数のメッセージに対して一つの訳注をつけてもよい。例：1訳注 /1メッセージh F ヘルプバッファフラグ。表示されるのは "[help]"。 {訳注: 日本語メッセージの場合: "[ヘルプ]"} H F ヘルプバッファフラグ。表示されるのは ",HLP"。 w F プレビューウィンドウフラグ。表示されるのは "[Preview]"。 {訳注: 日本語メッセージの場合: "[プレビュー]"}1訳注 /nメッセージ（n >= 2）*read-messages* ファイルを読み込むときVimはその情報を表示する。いくつかのものについての説明 をあげる。他のものは見ればわかる。ロングとショートのどちらを使うかは 'shortmess' オプションに依存する。 ロング ショート 意味 ~ [readonly] {RO} ファイルは書き込み制限されている [fifo/socket] ストリームを使っている [fifo] FIFOストリームを使っている [socket] ソケットストリームを使っている [CR missing] "dos" ファイルフォーマットで読み込ん でいてCRのないNLを見つけた [NL found] "mac" ファイルフォーマットで読み込ん でいてNLを見つけた(unixフォーマット なのだろう) [long lines split] 少なくとも1つの行が2つに分割された [NOT converted] 'fileencoding' から 'encoding' の変換 が失敗した [converted] 'fileencoding' から 'encoding' の変換 を実施した [crypted] 暗号が解除された [READ ERRORS] ファイルを全て読み込めなかった {訳注: 以下日本語メッセージの場合: ロング ショート 意味 ~ [読込専用] [読専] ファイルは書き込み制限されている [FIFO/ソケット] ストリームを使っている [FIFO] FIFOストリームを使っている [ソケット] ソケットストリームを使っている [CR無] "dos" ファイルフォーマットで読み込ん でいてCRのないNLを見つけた
{訳注:} 部分が離れてしまう場合は、次のように微妙な文言の違いに気づきにくいですね。
[READ ERRORS] ファイルを全て読み込めなかった
[読込エラー] ファイルを全ては読み込めなかった
{訳注:} 部分が離れてしまう場合は、次のように微妙な文言の違いに気づきにくいですね。
[READ ERRORS] ファイルを全て読み込めなかった [読込エラー] ファイルを全ては読み込めなかった
これ、前者は誤訳だと思うので他のちょっとした修正と合わせて PR 出しておきました。#900
複数に一つの訳注を付ける場合、おっしゃるとおり訳注が離れてしまうので、原文と日本語訳の対応が明確になるように工夫する必要がありますね。
obcatさんをvimdoc-jaメンバに招待しました。
様子を見て手引きを更新しても良いと思います。
ありがとうございます！join しました。
手引きについても了解しました。
とりあえず上記のまま手引に記載してみました。改善点があったら修正していただければと思います。
この issue の目的は達成したので close します。みなさんありがとうございました！