Vim：Javascriptドキュメント検索

私は通常、ケイトまたはジェニーで働いています。 しかし、時には、すべての人々と同様に、私はVimを学びたいです。 そして、毎回、「開発」の約2分で、まったくばかげた質問が発生します。 たとえば、矢印（またはjkキー）を押すと、カーソルが段落のすべての行を一度にジャンプするのはなぜですか？

質問をどのように定式化しようとしても、毎回検索すると、「100の最も便利なVimコマンド」などの見出しのある同じ100のサイトが表示されます。 また、どのサイトを選択しても、現在必要な「チーム」が常に見逃されるとは限りません。

100個ではなく、一般的にすべてのWimチームを見つける方法を考えました。 そして、ネットワーク上で「すべてのVimチーム」と呼ばれる同じページを見つけました。 そして、本当に非常に大きなリストがありました-約600語。 しかし、これらのコマンドが何をするのかは示されていません-単なる用語のリストです。 この冗談は私をとても怒らせたので、私はついにドキュメントを読むことにし、「すべてのVimチーム」のリストを作成しました。 画面上の結果。 以下の詳細。

公式ウェブサイトでは、 vimdoc.sourceforge.netページのドキュメントを研究するために送られました 。 このページには、さまざまなファイルへの100以上のリンクがあります。 それらのタスクの説明はしばしば交差します。たとえば、私にとって、 editing.html、motion.html、insert.html-これらはすべて、1つの堅実な「編集」のようなものです。 いくつかのファイルは、ソリューションを見つけるためにまったく必要ありません-たとえば、 version5.htmlのようなバージョンを比較します。 一部はチュートリアルの一部です（ usr_NN.html ）。

多かれ少なかれ「参照」に関連するものをすべて選択し、ダウンロードして、すべての素材に対して検索フィルタリングを一度に整理することにしました。 sedとgluingで処理した後、サイズが3.5メガバイトのファイルを得ました。 そこにある「チーム」は600ではなく、6000でした（すべての仮名と変形-約4,000の「記事」または「段落」に収まる）。 ドキュメントの作者であるBram Moolenaarがそれらをすべて「 a name 」タグで慎重に囲んでいたため、彼らはすべてを見つけて選択しました。

この原則により、ドキュメントのテキスト全体を1つの「キーワード」（または同義語のグループ）-テキストの1つのセグメントに分割しました。 任意の単語を検索するときに、さまざまなドキュメントファイルの断片を表示できるように、「スルー」フィルタリングを整理したかったのです。 また、ドキュメントの標準的な可能性を失わないでください。用語または「タグ」をクリックすると、この用語の定義（または説明）が記載されたテキストにジャンプします。

これを行うには、すべての資料を1つの大きなhtmlテーブルに配置し、Javascriptを使用して検索を整理しました。

ブラウザー内のこのような大きなテーブル（4,000行、3.5メガバイト）がかろうじて回転することは誰もが知っています。 しかし、目は怖く、手はしている。 最新のブラウザのJavascriptは非常に高速な言語です。 画面にテキストを表示するのにより多くの時間が費やされます。 したがって、テーブル全体を一度に表示する必要はありません。

これは、大きなページで最大の負荷加速を実現する最初のシンプルなテクニックdisplay:none;



ルールのdisplay:none;



指定しますdisplay:none;



。 目に見えないテーブルは、桁違いに速くロードされます。その後、必要なすべてのインデックスをゆっくり作成できます。 その後、ユーザーが検索を開始すると、表のごく一部のみが表示されます。 もちろん、検索フィールドに文字を1つだけ入力すると、大きな文字になることがあります。

長い待ち時間からユーザー（つまり、自分自身）を倒すために、フィルタースクリプトに2つのパラメーターを入力しました_Table.tx = 2



ユーザーが少なくとも2文字入力した場合にのみ検索を開始します。 _Table.vrows = 100



最初の100個の検索結果のみを表示します（これ以上はありません）。

Vimにはもちろん、2文字のチーム、さらには1文字のチームがあります。 多くの普通の単語が見つかるため、それらを使用して目的のテキストを除外することはほとんど不可能です。 検索時に検索用語の文字が「通常の文字」と混ざらないように、すべての「用語」をアスタリスクで囲みました（より正確には、これらのアスタリスクはソースファイルのように残しました）。 たとえば、「B」コマンドの説明（大文字のラテン文字B）を検索するには、検索フィールドにアスタリスク付きの文字を直接入力する必要があります。

結果の数、たとえば200で、合理的なユーザーがフィルタリングを続けて、見つかった行の数を減らし、たとえば、別の列の検索フィールドに文字を追加すると仮定します。 しかし、見つかった4000行すべてを本当に見たい場合は、「非表示を表示」チェックボックスをクリックします。

また、通常のCtrl+f



を使用して用語とホットキーを検索することもできます。「すべてのWimコマンド」があるサイトのように、すべてのキーワードは右側の別のリストのページに完全に表示されます。 任意の単語のページでのみ、クリックしてドキュメントの詳細なテキストを表示できます。 右側のリストでCtrl+f



をCtrl+f



、1文字のチームを見つけることもできます-アスタリスクで囲まれたチームもあります。

これは2番目の高速化方法です-ソリッドテキスト全体ではなく、個別のリストでの検索の編成-これには、いくつかの列と、場合によってはテーブルの外にいくつかの列を持つテーブルが必要です。

3番目のトリックは、DOMに触れないことです。 JavaScriptの検索は、実際のDOMノードではなく、特別に準備された配列を使用して常に最適に実行されます。

4番目の手法は「インデックス付け」です。 リストの単語を、その番号で配列の特定の要素に直接関連付けます。 これは主キーのようなものです。 次に、そのような単語をクリックすると、必要な情報をほぼ瞬時に表示できます。これが右側の用語のリストの仕組みです。 リンクを配列のいくつかの要素に関連付けると、検索も行われないため、検索も高速化されます。配列の要素のセットに関連付けられた行が表示されるだけです（ 1対多の関係のようなもの）。 これは、左側の「カテゴリ」のリストの仕組みです。ソースドキュメントファイルの名前が含まれています。 オプション、編集、モーション ... 確かに、このセクションには500以上のポイント（行） があるため、 vim.evalリンクをクリックすると「加速」はあまり目立ちませんテーブル）、および長い間表示されています（もちろん、[非表示]チェックボックスをオンにしている場合）。

indexOf()



関数を使用してJavascriptでテキストを検索します。配列内のすべての値がソートされ、検索用に入力された文字と比較されます。 通常、この方法で検索するには、検索配列のすべての値を小文字に減らす必要があります。 ただし、この場合、ggはGGと同じではないため、検索では大文字と小文字が区別されます。

***

各段落のドキュメントには多くのリンクがあります。 もちろん、これらのリンクは決して手作業で作成されたものではなく、ファイルの中に非常に奇妙なものが見つかることもあります。 そのため、「motion.as」コマンドへのリンクを完全に削除する必要がありました-最終ファイルにそのようなリンクが1,000個以上あったため（「 同じ 」 ：mapの形式のステートメントで）。 私はすでに問題が解決したと判断しました。 しかし、突然、次の一連の「ノイズ」リンクを見ました-「do」という単語があります。

それから、「最新」のhtmlドキュメントファイルを検索するのは良いアイデアだと思わなくなりました。 Vimは最後ではありませんが、私のドキュメントはとにかく毎日変わりません。 したがって、なぜ「wget ...」の代わりに、コンソールにcp -R /usr/share/vim/vim74/doc ~/Downloads/vim7/source



とcp -R /usr/share/vim/vim74/doc ~/Downloads/vim7/source



してください。 また、ソースファイルを探す必要はありません。

vim74 / docフォルダーには、ロシア語への翻訳である.ruxファイルがまだありました。 多くのファイルがあり、拡張子が異なる場合もあります。 そして、一般に、検索するファイルの選択は少し異なります。「参照に似たものすべてを選択する」のではなく、明らかに非参照を削除します： rm -R usr_*; rm -R version*; rm -R todo*



rm -R usr_*; rm -R version*; rm -R todo*



rm -R usr_*; rm -R version*; rm -R todo*



。

正しいリストの「vimコマンド」またはタグの数は9000に増えました。より正確には、「9000を超える」ものになりました。 また、タグの一部は、テキストの1つのセグメントではなく、英語とロシア語（翻訳がある場合）の2つのセグメントに関連付けられていることが判明しました。 私の意見では、これは悪化しませんでした。 確かに、テーブル内の行数も増加しました-「8000を超える」。 ただし、4000行のテーブルと肉眼での8000行のテーブルの検索速度の違いは目立ちません。

Vimタグ

ドキュメントファイルを見て、タグファイルで「Wimコマンドのリスト」を見つけましたが、Javascriptで使用できませんでした。何が得られるのか理解できませんでした。 同じフォルダーにあるvim2html.plスクリプトのように、htmlを生成するときに以前に使用して、キーワードを強調表示し、html に名前タグを付けます。 ただし、Javascriptでの検索には、厳密に「名前」は必要ありません。条件付きラベルで十分です（ <b>を選択しました）。 また、vim2html.plのような複雑なツールは必要ありません。通常の正規表現sedを使用してタグを配置できます（コードは記事の最後に記載されています）。

Vim hjklに戻る

ケイトでVimドックのJavascriptフィルタリングをゆっくりと見ながら、このテキストをVimで並行して入力しました。 そして、jkナビゲーションに関する彼の最初の質問に対する答えは、5日後の仕事の最後でのみ受け取られました。 最初の近似では、答えはすぐに見つかりました-Habréのこの記事の1つで：カーソルを段落ではなく画面の行に沿って移動するには、マップ命令を使用してキー割り当てを変更する必要があります-ファイル〜/ .vimrc： map k gk



、 map j gj



。

しかし、それは問題の最小の部分でした。 ビッグはイデオロギーでした。 矢印の代わりに使用されるhjklキーは、ナビゲーションの利便性を向上させるように設計されています。メインキーから矢印まで手を離さないでください。 さて、テキストの適切な場所に移動し、 iを押して文字を入力しました。 それから何？ これらのjkに進む方法は？ それらを押すと、印刷されます。

何らかの形で「通常」モードに戻る必要があります。つまり、メインキーからEscキーまでのいずれかの手を離します。 もちろん、矢印に移動するよりもクリックする方が簡単です。 しかし、マイナーな編集のために頻繁にモードを切り替えるという事実はいらいらさせます-利益は失われます。

「map k gk」についての賢明な考えは、次のステップを示唆しました： imap <Cj> <Esc>gji



。 また、ほぼすべての4つの方向で完全に機能しました。 <Cl>に加えて、押されたとき、Vimは何らかの理由で頑固に何もすることを拒否しました。 ドキュメントを新たに検索したところ、この組み合わせはデフォルトではどこでも使用されていませんでした。 あらゆる種類のトリックを含むいくつかのオプションを検討しました。

 imap <Cl> <Esc>l map <Cl> li
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

そして、この最後の1つで、キーが2回おきに何らかの形で機能することに突然気付きました。 患者の行動についてもう少し見ていた後、私は不可解にも労働者であることが判明した奇妙な解決策を見つけました：

 imap <Cl> <Esc>lli
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

***

Javascriptの内部の美しさと、 table-layout: fixed;



ようなtable-layout: fixed;



を操作することの複雑さについて、長い間話すことができtable-layout: fixed;



、しかし、私はLinusの非難的な後ろ姿を感じ始めています：「すでにコードを見せてください！」ここに、ソースドキュメントファイルを処理するためのコードがあります。

 cd source rm -R usr_* rm -R version* rm -R todo* for f in *.txt; do n=$(echo "$f" | sed -r 's/\.\w+//'); perl -pe 's/</&lt;/g' <"$f">"$n".html; done; for f in *.rux; do n=$(echo "$f" | sed -r 's/\.\w+//'); perl -pe 's/</&lt;/g' <"$f">"$n"-ru.html; done; for f in *.html; do n=$(echo "$f" | sed -r 's/\.\w+//'); for ((i=0; i < 3; i++)); do sed -i -r "s:\|([^\t ]+)\|:<u>\1</u>:g; s:(^|\t| )(\*[^\t ]+\*)(\t| |$):\1<b>\2</b>\3:g" "$n".html; done; sed -i "/<b>/i<\/pre><\/td><\/tr><tr><td><u>vim.$n<\/u><\/td><td><pre>" "$n".html; done; cat *.html > ../table.htm cd .. sed -i '/vim:tw=78:ts=8:ft=help:norl/d' table.htm cat htm00.htm table.htm endhtm.htm >vim.html
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

まず、テキスト内のすべての開始タグをHTMLでエンコードします。 同時に、ソースを異なる拡張子を持つファイルにコピーします。 次に、アスタリスクが付いたすべての単語を探し、 <b>タグで囲みます。 「：autocmd BufRead * / doc / *。Txt set tw = 78」-キーワードなしのアスタリスクの形式の出現をキャッチすることは困難です。 困難な状況のため、コンテキストの一部が交差するため、検索を数回繰り返す必要があります。 すべてのキーワードが見つかり、それらに依存してマークアウトされると、将来のhtmlテーブルを行に分割できます。

次に、ファイルは1つ!DOCTYPE



接着されます!DOCTYPE



メタタグ付きの!DOCTYPE



、300行のjsおよび40行のcssは、最終ファイルのすぐ内側で表示できます。 結果： Vimドキュメント

PS説明を仕上げている間に、Javascriptに何かを追加しました。1）マ​​ウスをダブルクリックすると、選択した単語の検索が開始されます。 2）マウスでいくつかの単語を選択し、クリックしてF2を検索できます。 3）Ctrl +左は前の検索結果に戻ります（Ctrl +右-逆も同様）。