melihat dokumentasi info dengan vim

11

Saya mencoba menggunakan addon ManPageView untuk melihat dokumentasi info di dalamnya vim.

Meskipun saya menemukan ManPageView sangat berguna untuk, yah, melihat halaman manual, fungsionalitas membaca informasi sepertinya tidak berfungsi sama sekali. Tapi kemudian saya hampir tidak pernah membaca dokumentasi info, terutama karena sepertinya tidak ada gunanya meluangkan waktu untuk mempelajari infoantarmuka. Jadi saya mungkin salah melakukannya.

Bagaimanapun: berjalan :Man info.iseperti yang disarankan oleh dokumentasi ManPageView memberi saya

info: No menu item `(info)Top' in node `(dir)Top'.
info: No menu item `(info)Top' in node `(dir)Top'.
info: No menu item `(info)Top' in node `(dir)Top'.
***warning*** sorry, no manpage exists for <(info)Top>

Saya melihat beberapa keberhasilan jika saya menghapus baris berikut, yang dimulai pada baris 345 dalam file autoload/manpageview.vim:

" special exception for info {{{3
if a:viamap == 0 && ext == "i"
 let s:manpageview_pfx_i = "(".manpagetopic.")"
 let manpagetopic        = "Top"
" call Decho("top-level info: manpagetopic<".manpagetopic.">")
endif

Menghapus garis-garis itu akan memungkinkan :Man info.iuntuk berfungsi, tetapi saya masih tidak dapat mengikuti tautan di halaman yang ditampilkan.

Ini bekerja dengan memanggil infobaris perintah dan menangkap output, jadi mungkin hanya itu infoCLI telah berubah? Khususnya, $ info info Advancedakan memunculkan topik "Advanced" di dalam simpul "info". Saya mencari-cari dalam kode sumber addon untuk sementara waktu tetapi tidak menemukan cara yang jelas untuk mengarahkannya untuk melewati node sebagai argumen tambahan alih-alih melakukan apa yang seharusnya dilakukan, yaitu untuk membungkus nama node di kurung dan awali ke topik, meneruskan kombinasi sebagai argumen baris perintah tunggal info.

Saya belum mencoba menggunakan addon ini untuk melihat dokumentasi info sebelumnya. Saya menjalankan ubuntu 10.10 yang diperbarui, menggunakan paket vim-gnome.

Saya telah mengajukan beberapa laporan bug di lokasi yang tampaknya direkomendasikan

Sudahkah orang lain berhasil menggunakan addon ini untuk melihat dokumentasi info? Saya merasa seperti tersesat dalam kabut yang selamanya menutupi jangkauan luar dari ketidakjelasan.

catatan : Saat menulis pesan ini, saya telah menemukan info tambahan , yang tampaknya berfungsi dengan baik, setidaknya pada pandangan pertama.

intuisi
sumber
1
"Saya telah mengajukan beberapa laporan bug yang tampaknya merupakan lokasi yang direkomendasikan" - tidak. Tempat yang tepat untuk mengisi laporan bug langsung ke penulis. Jika penulis menggunakan pelacak untuk pengaya, mungkin ini solusi yang lebih baik (tergantung pada masing-masing pengelola skrip)
Luc Hermitte
1
@LucHermitte Hmm .. Saya kira seseorang harus memperbarui vim.org, kalau begitu. Spanduk di bagian atas setiap halaman addon memberikan tautan ke halaman wiki dengan label "Komentar, bug, peningkatan".
Intuited
Plugin Vinfo sangat baik untuk ini. Anda harus menerima jawaban itu.
vitiral

Jawaban:

3

Saya telah menemukan bahwa cara termudah untuk melihat dokumen info dalam vim adalah dengan membukanya saja. Mereka hanya teks gzip dengan beberapa kode biner ditambahkan sebagai markup. Ini sangat berguna untuk mengetahui dalam kasus di mana tidak praktis untuk menginstal addon.

Lokasi dokumen info khusus untuk distro; di bawah ubuntu, dan agaknya suka-debian lainnya, mereka ada di /usr/share/info/*.info.gz. Mereka di-gzip, tetapi vim akan menangani terjemahan untuk Anda jika Anda membukanya.

Saya sebenarnya lebih suka cara melihat mereka daripada menggunakan infopembaca, karena menyajikan dokumen sebagai satu file panjang yang dapat Anda cari dengan cepat atau melalui halaman. Memiliki addon akan tetap berguna untuk memfasilitasi tautan berikut dan semacamnya. Saya sebenarnya belum mencoba menggunakan infoaddon yang disebutkan dalam pembaruan; Saya tidak perlu melihat file informasi sejak itu.

intuisi
sumber
luar biasa. Saya tidak tahan dengan penampil info. Akan membuat skrip untuk mengotomatisasi ini.
Thomas Dignan
3

Gunakan plugin Vim ini:

Vinfo

Untuk membaca dokumentasi Info seperti file bantuan Vim

alx741
sumber
Plugin ini luar biasa, terima kasih telah mempostingnya.
vitiral
1

Hanya pipa Info keluaran ke vim mis.,:

    info info Advanced | vim -R -

atau

    info info Advanced | less

Anda juga dapat memohon Info menggunakan --vi-keys, tetapi ikatan kunci "vi" yang seharusnya benar-benar aneh.

Anda juga dapat menyesuaikan bindings kunci Info menggunakan infokeyalat (lihat Menyesuaikan Bindings dan Variabel Kunci ). Sampel .infokeyfile sumber vi sudah disediakan (lihat format sumber infokey ).

Layak untuk mempelajari Info GNU ( info info-stnd) karena ini adalah alat yang tepat untuk melihat file info. Dokumentasi lengkap untuk alat GNU ada dalam file info, misalnya membandingkan perbedaan konten antara man tardan info tar. Info juga dapat memberikan akses terstruktur yang lebih baik ke dokumentasi terutama untuk dokumen berukuran besar.

Tetapi cara sebenarnya untuk membaca file info adalah dengan mode Info Emacs (tipe C-h i) karena binding kunci Info hampir sama, dan Anda juga mendapatkan semua keuntungan dari editor Emacs (mis. Tanda, register, pemisahan jendela vertikal dll) . Sangat berguna untuk membiasakan diri dengan Emacs karena banyak alat GNU menggunakan binding kunci gaya Emacs (mis. Info, Bash, Layar dll.). Coba tutorial Emacs.

mvanle
sumber