From a2694c7ba6ef69650f3127330754c63edc54634d Mon Sep 17 00:00:00 2001 From: Marco Gallegos Date: Sun, 11 Jan 2026 10:33:45 -0600 Subject: [PATCH] docs: add Neovim configuration documentation from mg_dotfiles Add sections in README and installed_software.md explaining that Neovim configuration is available in mg_dotfiles/nvim/ and how to link it manually. Update software list to clarify Neovim is manually installed. --- Readme.md | 37 ++++++++++++++++++++++++++++++++++++- installed_software.md | 24 +++++++++++++++++++++--- 2 files changed, 57 insertions(+), 4 deletions(-) diff --git a/Readme.md b/Readme.md index e6508b2..891c04c 100644 --- a/Readme.md +++ b/Readme.md @@ -36,6 +36,10 @@ omarchy_setup/ │ ├── zsh-config.sh # Enlaza .zshrc y funciones desde mg_dotfiles │ ├── hyprland-config.sh # Enlaza configs de Hyprland desde mg_dotfiles │ └── ... # Docker, ZeroTier, Impresoras, etc. +├── mg_dotfiles/ # Dotfiles personales (Zsh, Hyprland, Neovim) +│ ├── zsh/ # Configuración de Zsh +│ ├── omarchy/hypr/ # Configuración de Hyprland +│ └── nvim/ # Configuración de Neovim (LazyVim) ├── doc_templates/ # Plantillas para ~/Templates ├── themes/ # Temas de apoyo (Oh My Posh) └── installed_software.md # Lista detallada de componentes instalados @@ -58,6 +62,24 @@ omarchy_setup/ | **T** | **Plantillas** | Documentos en ~/Templates | | **A** | **Instalar Todo** | Ejecuta la mayoría de los módulos | +> **Nota:** Neovim debe instalarse manualmente (ej: `paru -S neovim-git`) y su configuración está disponible en `mg_dotfiles/nvim/`. + +--- + +## 🎨 Configuraciones de mg_dotfiles + +Este repositorio vincula configuraciones personalizadas desde [mg_dotfiles](https://github.com/marcogll/mg_dotfiles): + +- **Zsh**: Configuración del shell con Oh My Zsh, Oh My Posh, plugins y alias personalizados +- **Hyprland**: Configuración completa del gestor de ventanas tiling y componentes relacionados +- **Neovim**: Configuración personalizada de Neovim con plugins y LazyVim (ubicado en `mg_dotfiles/nvim/`) + +Para usar la configuración de Neovim: +```bash +# Opcional: Crea un enlace simbólico (si prefieres mantener config en mg_dotfiles) +ln -s ~/Work/code/mg_dotfiles/nvim ~/.config/nvim +``` + --- ## 📚 Documentación Técnica de Módulos @@ -186,7 +208,19 @@ Mejora la gestión de claves SSH. - **Importancia:** Evita tener que escribir la contraseña de la clave SSH cada vez que se establece una conexión. - **Nota:** A partir de gnome-keyring 46.0+, la funcionalidad SSH fue movida a `gcr`, por lo que este módulo ahora usa `gcr-ssh-agent` en lugar del componente SSH de `gnome-keyring`. -#### 2.11. `zerotier.sh` +#### 2.11. Neovim (mg_dotfiles) + +Configuración personalizada de Neovim disponible en mg_dotfiles. + +- **Ubicación:** La configuración se encuentra en `mg_dotfiles/nvim/` y se ha copiado a este repositorio. +- **Contenido:** Incluye configuración con LazyVim, plugins personalizados, colores y atajos de teclado. +- **Instalación Manual:** Si deseas vincular la configuración desde mg_dotfiles: + ```bash + ln -s ~/Work/code/mg_dotfiles/nvim ~/.config/nvim + ``` +- **Nota:** Neovim debe instalarse previamente (ej: `paru -S neovim-git` o `pacman -S neovim`). + +#### 2.12. `zerotier.sh` Instala una herramienta de VPN. @@ -201,6 +235,7 @@ Instala una herramienta de VPN. ## 📝 Notas Importantes - **Dotfiles**: Este script ahora es **opinionated**. Si no encuentra `mg_dotfiles` en la ruta configurada en `common.sh`, los módulos de Zsh e Hyprland fallarán. +- **Neovim**: La configuración personalizada de Neovim está disponible en `mg_dotfiles/nvim/`. No se instala automáticamente, pero puede vincularse manualmente con `ln -s ~/Work/code/mg_dotfiles/nvim ~/.config/nvim`. - **Fuentes**: Es imprescindible usar una **Nerd Font** (ej: `CaskaydiaMono NF` o `ttf-firacode-nerd`) para que los iconos de la terminal y Hyprland se visualicen correctamente. - **Reinicio**: Tras la instalación de Docker o el cambio de Shell, es necesario **cerrar sesión** para aplicar los cambios de grupos y entorno. - **Logs**: Cada ejecución genera un log en `logs/omarchy-setup-YYYY-MM-DD_HH-MM-SS.log` diff --git a/installed_software.md b/installed_software.md index ea8c091..d750e90 100644 --- a/installed_software.md +++ b/installed_software.md @@ -13,7 +13,7 @@ Este documento lista todos los componentes que se instalan al ejecutar el script - `git`: Control de versiones - `curl` y `wget`: Descarga de archivos - `vim`: Editor de texto -- `neovim`: Editor de texto moderno +- `neovim`: Editor de texto moderno (instalado manualmente por el usuario) - `tree`: Visualizador de directorios en árbol - `htop`: Monitor de procesos - `btop`: Monitor de procesos mejorado @@ -41,6 +41,7 @@ Este documento lista todos los componentes que se instalan al ejecutar el script - `code-marketplace`: Extensión para VS Code marketplace - `v3dv-git`: Drivers para Raspberry Pi - `xdg-desktop-portal-hyprland`: Portal para Hyprland +- `neovim-git`: Editor de texto moderno (versión bleeding edge, instalación manual) ### Paquetes instalados desde Flatpak: - VLC: Reproductor multimedia @@ -167,6 +168,22 @@ Este documento lista todos los componentes que se instalan al ejecutar el script --- +## ✏️ Neovim (mg_dotfiles) + +### Configuración disponible: +- La configuración personalizada de Neovim está disponible en `mg_dotfiles/nvim/` +- Incluye LazyVim, plugins personalizados, colores y atajos de teclado + +### Pasos para vincular (opcional): +1. Neovim debe estar instalado previamente (ej: `paru -S neovim-git` o `pacman -S neovim`) +2. Para vincular la configuración desde mg_dotfiles: + ```bash + ln -s ~/Work/code/mg_dotfiles/nvim ~/.config/nvim + ``` +3. Al abrir Neovim, se instalarán automáticamente los plugins mediante Lazy.nvim + +--- + ## 📄 Opción T: Plantillas de Documentos ### Pasos realizados: @@ -194,14 +211,15 @@ F. Formatos de Disco H. Hyprland T. Plantillas de Documentos -**Nota:** No ejecuta la opción 7 (Gestor Interactivo de Iconos) porque requiere selección manual. +**Nota:** No ejecuta la opción 7 (Gestor Interactivo de Iconos) porque requiere selección manual. Neovim debe instalarse y configurarse manualmente según las instrucciones en la sección de Neovim. --- ## 📝 Notas para el Equipo - **Actualización de este documento**: Cuando se agreguen nuevos módulos o software a los scripts existentes, actualizar este archivo para mantener la lista sincronizada. -- **Dotfiles**: Las configuraciones de Zsh y Hyprland se crean como enlaces simbólicos a `mg_dotfiles`. Cualquier cambio en los archivos originales se refleja inmediatamente. +- **Dotfiles**: Las configuraciones de Zsh, Hyprland y Neovim se encuentran en `mg_dotfiles`. Zsh y Hyprland se crean como enlaces simbólicos automáticamente. Neovim puede vincularse manualmente según preferencia. +- **Neovim**: La configuración de Neovim no se instala automáticamente con el script. Debe instalarse previamente (ej: `paru -S neovim-git`) y la configuración en `mg_dotfiles/nvim/` está disponible para ser copiada o enlazada. - **Fuentes**: Asegurarse de instalar una **Nerd Font** para que los iconos se vean correctamente. - **Reiniciar**: Cerrar sesión después de instalar para aplicar cambios de grupos (Docker) y variables de entorno. - **Logs**: Cada ejecución genera un log en `logs/omarchy-setup-YYYY-MM-DD_HH-MM-SS.log`