vimのヘルプファイルの生成


8

現在、私は直接ドキュメントをvimヘルプファイルとして作成しています。時々私は他のフォーマット(例えばPDF)を生成する必要があります。私のワークフローは、ヘルプファイルの内容をコピーして、必要なものに変換することです。ほとんどの場合、マークアップを追加する必要があるため、これはかなり退屈な作業です。

Markdownのアプローチが気に入っています。Pandocを使用するなど、さまざまな出力形式に変換できます。残念ながらvimヘルプファイルではありません。標準の入力形式(XML、Markdown、reStructed Text、プレーンテキストなど)を取り、vimヘルプファイル出力するコンバーターを探しています。または、そのようなコンバーターを自分で作成せずにvimヘルプファイルを自動的に生成する他の方法はありますか?


おそらく数時間でXSLTスタイルシートを組み合わせることができます。
Ignacio Vazquez-Abrams

回答:


11

非常に古いスレッドを復活させて申し訳ありません。私は以前にlornixmkd2vimdocによって提案された最初のリンクの背後にあるスクリプトの作成者です。私は最近、最初からhtml2vimdocと書き直しました。Markdownは引き続き入力形式としてサポートされています。MarkdownをHTMLに変換し、そのHTMLをVimヘルプファイルに変換します。書き換え中の焦点は、より広範な入力ドキュメントのサポートにありました。mkd2vimdoc

新しいスクリプトは私と他のいくつかのプラグイン作成者が使用しているため、間違いなく一般的な使用を目的としています。もう一度お試しになりたい場合は、使用したいドキュメントにうまく機能するかどうかを確認してください。それでも機能しない場合は、GitHubで問題を作成してください。


3
SuperUserへようこそ!ここでは古い質問への回答を歓迎します。一部の人々はまだそれらの回答を探している可能性があり、古いものを改善することは問題ありません。
gronostaj 2013年

4

筆者がmarkdownをvimドキュメントに変換するために作成したこのスクリプトを見つけました。あなたが探しているものに非常に近い音。

一方で、この vim.orgスクリプト(githubのレポ)変換値下げほとんどエヴリシングvimdocのように見えるものに。(ため息)とても近い...たぶんわずかな変更?


最初のスクリプトは、一般的な使用には使用できません。著者のマークアップスタイルでは機能する可能性がありますが、私の(有効な)マークダウンファイルの1つを正しく変換できませんでした。2番目のオプションはpandocです。これは、私が非常に気に入っている非常に有能なコンバーターです。残念ながら、これはvimhelpをサポートしていません。メーリングリストでサポートを追加するように依頼しましたが、vimhelpは汎用の出力形式ではなく、サポートされている他の形式とは対照的に、vimドキュメント用の特別な形式であるという返答がありました。とにかく、先端をたくさんありがとう。
マルコ

ほとんどのvimdocはフォーマットと特殊なマーカー文字であり、マジックはhelptagsコマンドとvimヘルプビューア自体によって実行されるため、markdownからvimdocへのコンバーターを作成するのに何が必要かについて知りたいです。もちろん、私は(再び!)足を口に入れているかもしれません...多分それはあなたの最初の値下げの複雑さに依存します。
lornix 2012年

メーリングリストで提案されたスマートな回避策は、有効なマークダウンでもあるvimhelpを作成することでした。欠点は、マークダウンがvim構文で少し雑然としていて、vimhelpファイルがフォーマット規則に従っていないことです。しかし、それとは別に、それは使用可能です。
マルコ
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.