文体が統一されていない

[thinca]

恐らく歴史的経緯でこうなっていて、労力の関係で放置されているものと思われますが、実際にやるかどうかは別としてIssueとして登録しておきます。
ここでは、統一するとしたらどの方向に統一すべきか議論できれば、と思います。決まったことは Wiki にまとめましょう。

[thinca]

最低限、「です・ます」と「だ・である」は統一すべき。
個人的には「です・ます」に1票。マニュアルなどは「です・ます」調で書かれていることが多い印象があります。

[koron]

以下は意見表明じゃなくて、現状の概要を説明しているだけです。

最初はリファレンスマニュアルは「だ、である」で書いてました。
リファレンスということで紋切り型の説明が多かったのと文字数調整の意味もあります。
なので「です・ます」に直すと修正箇所はかなり量があるかも。

一方、ユーザマニュアルは、おそらく「です・ます」でまとまってると思います。
読み物の体裁である&清水さん(でしたっけ)が一人で手をつけておられたので、ある程度整っているかと。

---

以下意見。統一には賛成。どちらであるかはそんなに問わない。
それどころかユーザマニュアルとリファレンスで違っても、大丈夫だとは思う。

[h-east]

「だ・である」に1票。理由:ストイックな感じがカッコイイからｗ。
初心者には威圧的に感じるのかなぁ。
「Vim＝ストイック」というイメージにシビれるあこがれるって感じで近づいて来てる人いませんかね。

options.jax はほぼ「だ・である」ですね。

青山（mm）です。色んな名前を使っていてまぎらわしくてすみませんが、gitでのユーザーIDはこれになっています。
私が翻訳していたときは、既存のファイルについてはすでに使われているほう、新規のファイルについては私とnakadairaさんとも敬体を使っていたと思います。
私は敬体のほうが好みです。その方が翻訳しているときの気分もやさしくなって、翻訳が丁寧になるという効果がありました（私の場合）。

その他覚えていること
・ASCIIの範囲にある文字（半角英数・記号）は全角でなく半角を使う。
・半角と全角の間にスペースを入れるか？→KoRoNさんはなし派。私とnakadairaさんはあり派。
・1行は78桁以下になるように（KaoriYa版に付属のformat.vimを使って整形すると楽です）
・ヘルプファイルでは「help-context」や「|help-context|」のように_と|がマーカーに使われているので見落とさないように注意
今はconcealで消えるようになっているので、
~/.vim/after/ftplugin/help.vimで
setlocal conceallevel=0
syn match Error /%>79v._/
のように設定しておくといいかもしれません。

[uakms]

あれ？ Notifications が送られて来ない...

青山さんのコメントで回答をもらったようなものですが、下記のような質問を書いていました。各人の conceallevel の設定によって列が揃わなくなってしまいますね...。

---

端末の幅を半角 80 文字としているのですが、稀に一行が 80 文字を越える文章と出会います。また、カラムの行頭が揃わない文章もあります。例えば下記のような場所です。

intro.jax の line 551 改行の位置
index.jax の line 1625, 1626, 1629, 1631, 1634 改行の位置
various.jax の line 352, 354, 355, 356, 358 タブの数

自分は conceallevel や concealcursor を設定しておらず、バーティカルバーが(見えないけれど)表示された状態になっているので、その分表示が多くなってしまうのでしょうが、中途半端に右折り返しされるために美しくなく困っています。79 文字目で改行し直しても良いものでしょうか？

また、例えば重複文字の修正等で文字を削除した場合に、それが 1 文字であったとしても段落全体を(一行78文字に)修正し直した方が良いでしょうか？(1文字なら大目に見る、2文字も許容範囲、3文字なら段落を直す...とか。ヘルプの初級編ではかなりキッチリと78文字が守られていた気がしますが)

[uakms]

ごめんなさい閉じてしまいました。

[koron]

@nakinor それ文体の統一からは少し外れてますから、新しいissue起こしてもらえませんか? conceal使うとフォーマット変だよ、ってなことで (なんかVim本体の問題にもなりそうなw)

[uakms]

conceal については issues の # 115 で議論されてませんでしたっけ？

[koron]

ややこしいけどそれは issues で、かつsyntax絡みなんですわw。こっちのconceallevelでヘルプの見た目が崩れるよね、ってのはまた別の問題としてエントリしておくべきだと思いました。

[uakms]

質問の内容については文体の話になっていると思うのですが、「各人の conceallevel の設定によって列が揃わなくなってしまいますね...。」という部分が余計でしたね。これについては自分の環境だけかもしれないのでスクリーンショット撮って記事書きます。

[koron]

質問の内容については文体の話になっていると思う

おっと。ちゃんと読むと文体じゃなくて「改行位置があっていない」っていうフォーマットの話だw
それはそれで別にissueがあったほうがよさそうです…
申し訳ないですがそっちのissueもお任せしちゃっていいですか?