[WIP] Vim faq for vim8.1/8.2

[Milly]

WIPですがなかなか時間とれないので現状をアップしておきます。

• 体裁など気に入らない点を本家にPRしてマージ済み。
• 本家から英語版を取り込み済。(vim_faq/vim_faq.txt)
• 英語版の更新差異を日本語版にマージ済。(vim_faq/vim_faq.jax)
• 一部翻訳済み。

[Milly]

dict.yml に「リポジトリ」追加したら doc/usr_05.jax でこけた。 😢

[tsuyoshicho]

最新への追従を行います。

[tsuyoshicho]

dict.yml に「リポジトリ」追加したら doc/usr_05.jax でこけた。 😢

こちらは、usr_05.jax/dict.ymlが対応できたので、dict.ymlからは(重複になるので)削除しています。

[tsuyoshicho]

https://github.com/chrisbra/vim_faq/pull/13 最新の生成済みファイル、なんか変だったっぽい(作業が...orz)

[Milly]

59843c5ea0fcfe3592634eb8cab5457693fb7991 で "..." を '...' などに修正されているのはおそらく原文に合わせたのでしょうが、そこが違っているのは原文でのクォートの使い方がおかしいので私が意図的に変えた部分だと思います。 原文において、help としてのハイライトやリンク生成が不適切な部分です。 明らかに不便になるので原文に無理に合わせなくてもいいと思っています。 できれば原文を直すPRをしたいところ。

[Milly]

ってすでにコメントで言及されてた。

[Milly]

クォートなどが原文でおかしくなる原因は、本家のFAQ自体がさらに上位のFAQ文書を元に作成されているためです。 クォートを直すPRで修正されても、次回のFAQ更新でリグレッションしてしまうという。

[tsuyoshicho]

@Milly う、とするとこのPRはちょっとまずい? Makefileから生成しなおしたので。

これがまずいとなると、原文or生成ロジック修正か...むずいですね。

[Milly]

本家FAQのクォートがおかしい場合のPRはなんども受理してもらっていますので問題ないと思います。 ただし、せっかく受理してもらってもそれを維持するようには気を付けてもらえないので毎度PRすることになります。

[tsuyoshicho]

再生成したファイルがマージされました。 これにすることで、差分はほぼなくなりました。