cafegale(LeafCage備忘録)スマートフォン用の表示で見るcafegale(LeafCage備忘録)LeafCage備忘録(はてなダイアリー)と統一しました。2012の341日目の記事です。前回(84日前)Vimプラグインのスクリプトファイルからヘルプファイルを生成するというのをやりました。cafegaleしかしGitHubではREADME.mdファイルがリポジトリの窓口であり、説明であり、これによってそのプラグインの概要を知り、それを導入するかどうかが判断されます。README.mdを置いていないとプラグインの詳細を知るためには、リポジトリトップから2クリックもかかるdoc/xxx.txtを見に行かなければいけませんし、リポジトリトップにはGitHubがREADME.mdを置けと勧めてきます。我々はREADME.mdを書くことを暗に強いられているのです。helpに概要含め色々書いているのにさらに別の場所で二重に概要を書かなければいけないなんて苦痛です。helpに書いたことを改めて書かなければいけないのでしょうか。そこでLeafCage/vimhelpgeneratorに:HelpIntoMarkdownというコマンドを追加しました。*1ヘルプファイル内でREADME.mdに含めたいところをビジュアル行選択(“概要”や“使い方”などを選択すると良いでしょう)して、:HelpIntoMarkdownを実行すると、そのヘルプファイルの上にあるREADME.mdファイルが開かれます。*2ここでPすると、先ほど行選択されたテキストがmarkdown形式に変換されてputされます。(README.mdを初めて作成するときにはプラグイン名と説明もhelpファイルの第1行目から生成されます。)手直しした後、:writeしましょう。:HelpIntoMarkdownはアンダースコア(_)のエスケープには対応していません*3。自力で対応させて下さい。ヘルプファイルを改修したときには改修した箇所をビジュアル行選択して:HelpIntoMarkdownして下さい。その部分の変換結果がレジスタにセットされるのでREADME.mdにて貼り付けて手直しして下さい。これでヘルプファイルとREADME.mdを管理する手間を大幅に減らすことが出来ました。:VimHelpGeneratorVirtualでヘルプを仮想バッファに出力するvimhelpgeneratorには、:VimHelpGeneratorVirtualというコマンドも加わっています。:VimHelpGeneratorが生成したバッファをそのまま書き込むのに対し、:VimHelpGeneratorVirtualは仮想バッファに出力します。これにより、vimhelpgeneratorの、ヘルプファイルを初めて作るときにしか使えなかったという欠点を解消しました。プラグインに機能を追加するなどしてヘルプの改修の必要性が生じたとき、:VimHelpGeneratorVirtualを実行して、出力された仮想バッファ内で必要な部分だけを、既存のヘルプファイルにコピーペースト(Vim風に言うとヤンクプット)すれば良いのです。単純にVimHelpGeneratorの出力を確認したいときにも利用できます。:VimHelpGeneratorを実行したときにすでにヘルプファイルが存在している場合もこのモードで出力されます。*1:これに伴い、:VimHelpGenerator実行時に吐き出していた、クソの役にも立たないREADME.mdを生成させる機能はオミットされました。変更され...2015-05-19Vimのマークをハイライトするプラグイン作りました久しぶりの投稿です。257日目の記事です...2012-09-16vimrc読書会11今回から後学のためにログを残すことにした。»プロフィールid:leafcage世間的にはマイナーなソフトウェアなどが好き。(ツイプロフィール)github/LeafCagevimに関する記事(はてなグループ)はてなブログをはじめよう!leafcageさんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。