Files
nvim/README.md
Maxime TEYSSIER 58c73c64a6 Add last lines
2026-03-08 19:30:27 +01:00

79 lines
3.2 KiB
Markdown

# 🚀 Max's Neovim Configuration (v0.11-dev)
Bienvenue dans ma configuration Neovim personnalisée, optimisée pour le développement Python, C, Bash et l'administration système. Cette configuration privilégie la vitesse, l'intelligence (LSP) et une interface moderne.
## 🛠️ Architecture du Projet
Les fichiers sont structurés de manière modulaire pour une maintenance facile :
- `init.lua` : Point d'entrée principal.
- `lua/core/` : Options de base et raccourcis clavier globaux.
- `lua/plugins/` : Un fichier par plugin (chargement via Lazy.nvim).
---
## 📦 Gestionnaire de Plugins : [Lazy.nvim](https://github.com/folke/lazy.nvim)
Toute la configuration est gérée de manière asynchrone pour un démarrage ultra-rapide.
- **Commande :** `:Lazy` pour gérer les mises à jour.
---
## 🧠 Intelligence & Code (LSP)
Propulsé par le moteur natif de Neovim 0.11 et configuré via `nvim-lspconfig`.
- **Mason.nvim** : Gestionnaire d'installation pour serveurs LSP, Linters et Formatters.
- **LSP Config** : Configuration pour `Pyright` (Python), `Clangd` (C/C++), `Bashls` (Bash).
- **Trouble.nvim** : Vue d'ensemble de toutes les erreurs du projet (`<leader>xx`).
- **Nvim-cmp** : Auto-complétion de type "IntelliSense" (LSP, Buffers, Chemins).
---
## ⚡ Productivité & Navigation
- **Telescope.nvim** : Le coeur de la navigation.
- `<leader>ff` : Trouver un fichier.
- `<leader>fg` : Recherche de texte (Live Grep).
- **Flash.nvim** : Téléportation du curseur sur l'écran via la touche `s`.
- **Nvim-tree** : Explorateur de fichiers latéral classique (`<leader>e`).
- **Oil.nvim** : Édition du système de fichiers comme un simple buffer texte (`-`).
- **ToggleTerm** : Terminal flottant persistant (`Ctrl+\`).
- **Persistence.nvim** : Sauvegarde et restauration automatique des sessions (`<leader>qs`).
---
## ✍️ Édition Avancée
- **LuaSnip & Friendly-snippets** : Moteur de templates de code (ex: taper `def` en Python génère la structure).
- **Nvim-surround** : Manipulation des parenthèses/quotes (`ds"`, `cs'(`).
- **Comment.nvim** : Commentaire rapide de blocs (`gcc`, `gc`).
- **Todo-comments** : Coloration et recherche des `TODO`, `FIXME`.
---
## 🎨 Interface & UI
- **Alpha-nvim** : Dashboard d'accueil au démarrage.
- **Treesitter** : Coloration syntaxique haute performance basée sur l'AST.
- **Gitsigns** : Visualisation des modifications Git dans la marge.
- **Indent-blankline** : Guides visuels pour l'indentation (vital pour Python).
- **Noice.nvim** : Interface moderne pour les messages et la ligne de commande.
---
## ⌨️ Raccourcis Clés (Cheat Sheet)
| Touche | Action |
| :--- | :--- |
| `<leader>ff` | Rechercher un fichier |
| `<leader>e` | Ouvrir l'explorateur (Arbre) |
| `K` | Afficher la documentation (Hover) |
| `gd` | Aller à la définition |
| `gcc` | Commenter / Décommenter |
| `Ctrl + \` | Ouvrir le terminal flottant |
| `<leader>qs` | Restaurer la session du projet |
| `s` | Sauter (Flash) vers un mot |
| `<leader>f` | Formater le code proprement |
---
## 🔧 Installation sur une nouvelle machine
1. Installer **Neovim
2. Cloner ce repo dans `~/.config/nvim`.
3. Lancer `nvim`.
4. Exécuter `:Lazy install`.
5. Exécuter `:Mason` pour installer les serveurs de langage (pyright, etc.).