affichage de la documentation d'informations avec vim

11

J'essaie d'utiliser l' addon ManPageView pour afficher la documentation d'informations à l'intérieur vim.

Bien que je trouve ManPageView très utile pour, eh bien, la visualisation des pages de manuel, sa fonctionnalité de lecture d'informations ne semble pas du tout fonctionner. Mais je ne lis presque jamais la documentation info, principalement parce que cela ne semble pas valoir la peine de prendre le temps d'apprendre l' infointerface. Je me trompe donc peut-être.

Quoi qu'il en soit: courir :Man info.icomme suggéré par la documentation ManPageView me donne

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>

Je constate un certain succès si je supprime les lignes suivantes, qui commencent à la ligne 345 du fichier 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

La suppression de ces lignes permettra :Man info.ide travailler, mais je ne peux toujours pas suivre les liens dans la page affichée.

Cela fonctionne en appelant infosur la ligne de commande et en capturant la sortie, alors peut-être que c'est juste que infola CLI a changé? Plus précisément, $ info info Advancedfera apparaître le sujet "Avancé" dans le nœud "info". J'ai fouillé dans le code source de l'addon pendant un certain temps, mais je n'ai trouvé aucun moyen évident de le diriger pour passer le nœud en tant qu'argument supplémentaire au lieu de faire ce qu'il semble être censé faire, qui est d'envelopper le nom du nœud dans entre parenthèses et préfixez-la à la rubrique, en passant la combinaison en tant qu'argument de ligne de commande unique à info.

Je n'ai pas essayé d'utiliser cet addon pour afficher la documentation d'informations auparavant. J'utilise un ubuntu 10.10 mis à jour, en utilisant le paquet vim-gnome.

J'ai déposé un semblant de rapport de bogue à ce qui semble être l' emplacement recommandé

D'autres ont-ils réussi à utiliser cet addon pour afficher la documentation d'informations? J'ai l'impression d'être perdu dans les brumes qui enveloppent éternellement les confins extérieurs de l'obscurité.

note : Lors de la rédaction de ce message, j'ai découvert l' addon info , qui semble fonctionner de manière acceptable, du moins à première vue.

intuition
la source
1
"J'ai déposé un semblant de rapport de bug à ce qui semble être l'emplacement recommandé" - non. Le bon endroit pour remplir le rapport de bogue est directement à l'auteur. Si l'auteur utilise un tracker pour ses plugins, cela peut être une meilleure solution (cela dépend de chaque mainteneur de script)
Luc Hermitte
1
@LucHermitte Hmm .. Je suppose que quelqu'un devrait alors mettre à jour vim.org. La bannière en haut de chaque page du module complémentaire donne un lien vers sa page wiki avec le libellé "Commentaires, bogues, améliorations".
intuition le
Le plugin Vinfo est excellent pour cela. Vous devez accepter cette réponse.
vitiral

Réponses:

3

J'ai découvert que le moyen le plus simple d'afficher les documents d'information dans vim est de simplement les ouvrir. Ce sont juste du texte compressé avec quelques codes binaires ajoutés en tant que balisage. C'est particulièrement utile à savoir dans les cas où il n'est pas pratique d'installer un addon.

L'emplacement des documents d'information est spécifique à la distribution; sous ubuntu, et vraisemblablement d'autres likes de Debian, ils sont à /usr/share/info/*.info.gz. Ils sont compressés, mais vim se chargera de la traduction pour vous si vous les ouvrez.

En fait, je préfère cette manière de les visualiser à l'aide du infolecteur, car elle présente les documents comme un long fichier que vous pouvez rechercher rapidement ou parcourir. Avoir un addon serait toujours utile pour faciliter les liens suivants et autres. En fait, je n'ai pas essayé d'utiliser l' infoaddon mentionné dans la mise à jour; Depuis, je n'ai pas eu besoin de consulter un fichier d'informations.

intuition
la source
impressionnant. Je ne supporte pas la visionneuse d'informations. Je vais créer un script pour automatiser cela.
Thomas Dignan
3

Utilisez ce plugin Vim:

Vinfo

Pour lire la documentation Info comme les fichiers d'aide Vim

alx741
la source
Ce plugin est incroyable, merci de l'avoir posté.
vitiral
1

Il suffit de diriger la sortie Info vers vim, par exemple:

    info info Advanced | vim -R -

ou

    info info Advanced | less

Vous pouvez également appeler Info en utilisant --vi-keys, mais les supposées liaisons de touches "vi" sont vraiment étranges.

Vous pouvez également personnaliser les raccourcis clavier Info à l'aide de l' infokeyoutil (voir Personnalisation des raccourcis clavier et des variables ). Un exemple de .infokeyfichier source vi est déjà fourni (voir format source infokey ).

Cela vaut la peine d'apprendre GNU Info ( info info-stnd) car c'est l'outil approprié pour afficher les fichiers d'informations. La documentation complète pour les outils GNU se trouve dans des fichiers d'informations, par exemple comparer la différence de contenu entre man taret info tar. Les informations peuvent également fournir un accès mieux structuré à la documentation, en particulier pour les documents volumineux.

Mais la vraie façon de lire les fichiers d'informations est avec le mode Info d'Emacs (type C-h i) car les raccourcis clavier Info sont pratiquement les mêmes, et vous bénéficiez en outre de tous les avantages de l'éditeur Emacs (par exemple, les marques, les registres, le fractionnement de fenêtres verticales, etc.) . Il est utile de se familiariser avec Emacs car de nombreux outils GNU utilisent des raccourcis clavier de type Emacs (par exemple, Info, Bash, Screen, etc.). Essayez le didacticiel Emacs.

mvanle
la source