From ec65c97cc7c856a12a0564a45514e34d327e3939 Mon Sep 17 00:00:00 2001 From: julien Date: Thu, 15 Oct 2026 23:20:35 +0200 Subject: [PATCH] doc --- docs/neovim.md | 68 ++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 52 insertions(+), 16 deletions(-) diff --git a/docs/neovim.md b/docs/neovim.md index 18f2568..fe14259 100644 --- a/docs/neovim.md +++ b/docs/neovim.md @@ -215,22 +215,10 @@ Le réglage `vim.opt.clipboard = "unnamedplus"` relie le registre par défaut de La section `Clipboard` doit indiquer qu'un outil de presse-papiers a été trouvé. -### Mise à jour des plugins - -Pour rechercher les mises à jour disponibles pour les plugins gérés par `vim.pack` : - -```text -:lua vim.pack.update() -``` - -Vérifiez les changements proposés, puis utilisez `:write` pour les accepter. Redémarrez ensuite Neovim pour utiliser les plugins mis à jour. Pour contrôler l'état du gestionnaire de plugins : - -```text -:checkhealth vim.pack -``` - ## Ruby +Installez d'abord Ruby avec `rbenv` en suivant la fiche [Ruby avec rbenv](ruby.md), puis utilisez le même Ruby pour les outils ci-dessous. + ### Ruby LSP Installez `ruby-lsp` avec le Ruby utilisé par votre environnement : @@ -239,7 +227,7 @@ Installez `ruby-lsp` avec le Ruby utilisé par votre environnement : $ gem install ruby-lsp ``` -Vérifiez ensuite le client LSP dans Neovim : +Ouvrez un fichier Ruby, puis vérifiez que le client LSP est bien détecté dans Neovim : ```text :checkhealth vim.lsp @@ -328,9 +316,33 @@ Les commandes suivantes suffisent pour commencer : | `Space r` | Ouvrir Grug Far pour rechercher et remplacer | | `Ctrl-]` | Aller à la définition | | `Ctrl-t` | Revenir après un saut vers une définition | +| `K` | Afficher les informations LSP sur le symbole sous le curseur | | `Ctrl-s` | Afficher la signature de la méthode en mode insertion (raccourci LSP natif) | +| `Ctrl-x Ctrl-o` | Afficher manuellement la complétion LSP en mode insertion | | `u` | Annuler | +### IRB + +Pour explorer Ruby, découvrir des méthodes, consulter leur documentation ou tester rapidement du code, gardez de préférence IRB dans un split de Konsole dédié, en dessous de Neovim : + +```sh +$ irb +``` + +IRB fournit sa propre complétion. `Tab` parcourt les propositions et `Shift-Tab` revient à la proposition précédente. + +Quelques commandes utiles : + +| Commande | Action | +| --- | --- | +| `show_doc Array#select` | Afficher la documentation avec RI | +| `ls objet` | Afficher les méthodes, constantes et variables accessibles | +| `show_source nom` | Afficher le code source lorsqu'il est disponible | +| `help` | Afficher les commandes IRB | +| `exit` | Quitter IRB | + +IRB reste l'outil privilégié pour explorer Ruby. Dans Neovim, `K`, `Ctrl-s` et `Ctrl-x Ctrl-o` servent surtout à obtenir rapidement des informations contextuelles sans quitter le fichier en cours. + ### Grug Far `Space r` ouvre Grug Far dans un split vertical. En mode visuel, la sélection courante est utilisée pour préremplir le texte recherché. @@ -351,6 +363,8 @@ Pour vérifier l'installation ou diagnostiquer un problème : :checkhealth grug-far ``` +### Telescope + Dans Telescope : | Commande | Action | @@ -363,7 +377,13 @@ Dans Telescope : | `Ctrl-t` | Ouvrir dans un nouvel onglet | | `Ctrl-c` | Fermer Telescope | -La ligne de commande de Neovim propose automatiquement les complétions lorsque vous saisissez une commande après `:`. +Pour vérifier l'installation ou diagnostiquer un problème : + +```text +:checkhealth telescope +``` + +La ligne de commande de Neovim propose automatiquement les complétions pour les commandes `:` et les recherches `/` et `?`. ## Ignorer des fichiers du projet @@ -377,4 +397,20 @@ $ printf 'doc/\n' > .rgignore `ripgrep` prendra ce fichier en compte pour les recherches effectuées par Telescope lorsqu'il est utilisé comme moteur de recherche. +## Maintenance + +Pour rechercher les mises à jour disponibles pour les plugins gérés par `vim.pack` : + +```text +:lua vim.pack.update() +``` + +Vérifiez les changements proposés, puis utilisez `:write` pour les accepter. Redémarrez ensuite Neovim pour utiliser les plugins mis à jour. + +Pour contrôler l'état du gestionnaire de plugins : + +```text +:checkhealth vim.pack +``` + [Retour au guide principal](../README.md)