From 787236d2aee24feb3292939da96efad382c887bd Mon Sep 17 00:00:00 2001 From: Marco Gallegos Date: Fri, 9 Jan 2026 09:58:19 -0600 Subject: [PATCH] docs: update install.md to reflect dependency on mg_dotfiles --- install.md | 40 +++++++++++++++++++++++++--------------- 1 file changed, 25 insertions(+), 15 deletions(-) diff --git a/install.md b/install.md index a4be471..f93962e 100644 --- a/install.md +++ b/install.md @@ -1,17 +1,27 @@ # 🌀 Guía de Instalación - Omarchy Setup -Este script modular automatiza la configuración de Arch Linux, instalando aplicaciones esenciales, configurando el entorno gráfico (Hyprland), y optimizando el sistema para desarrollo y multimedia. +Este script modular automatiza la configuración de Arch Linux, vinculando tus **dotfiles personales** e instalando aplicaciones esenciales. ## 🚀 Requisitos Previos 1. **Sistema Operativo:** Arch Linux (instalación base). -2. **Usuario:** Un usuario con permisos de `sudo`. -3. **Conexión a Internet:** Necesaria para descargar paquetes. -4. **Git:** Para clonar el repositorio (si no lo tienes, instálalo con `sudo pacman -S git`). +2. **Repositorio de Dotfiles:** Debes tener clonado tu repositorio personal en `~/Work/code/mg_dotfiles`. +3. **Git:** Para clonar los repositorios (`sudo pacman -S git`). ## 📥 Instalación -Clona el repositorio y ejecuta el script principal: +El proceso recomendado consta de dos pasos: preparar tus dotfiles y ejecutar el setup. + +### 1. Clonar Dotfiles (Obligatorio para Zsh/Hyprland) + +El script buscará la configuración en esta ruta específica: + +```bash +mkdir -p ~/Work/code +git clone https://github.com/marcogll/mg_dotfiles.git ~/Work/code/mg_dotfiles +``` + +### 2. Ejecutar Omarchy Setup ```bash git clone https://github.com/marcogll/omarchy_setup.git @@ -22,10 +32,10 @@ chmod +x omarchy-setup.sh ## 🛠️ Uso del Script -Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo con las siguientes opciones: +Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo: -1. **Instalar Aplicaciones:** Herramientas base, desarrollo (Node, Python), multimedia (VLC, OBS), y drivers Intel. -2. **Configurar Zsh:** Shell Zsh con Oh My Zsh, Oh My Posh y plugins. +1. **Instalar Aplicaciones:** Herramientas base, desarrollo (Node, Python), multimedia y drivers Intel. +2. **Configurar Zsh:** Enlaza `.zshrc` desde `mg_dotfiles` e instala Oh My Zsh/Posh. 3. **Docker:** Instala Docker, Docker Compose y Portainer. 4. **ZeroTier:** Configura la VPN P2P ZeroTier. 5. **Impresoras:** Configura CUPS y drivers (especialmente Epson). @@ -33,21 +43,21 @@ Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo con las siguientes 7. **Iconos:** Gestor de temas de iconos (Tela, Papirus, Candy). * **K:** Sincronizar claves SSH con GNOME Keyring. * **F:** Soporte para formatos de disco (NTFS, exFAT, etc.). - * **R:** DaVinci Resolve (Intel) - *Requiere descargar el ZIP manualmente en ~/Downloads*. - * **H:** Configuración de Hyprland (copia archivos de configuración). + * **R:** DaVinci Resolve (Intel) - *Requiere ZIP en ~/Downloads*. + * **H:** Configuración de Hyprland (enlaza desde `mg_dotfiles`). * **T:** Plantillas de documentos. * **A) Instalar Todo:** Ejecuta la mayoría de los módulos automáticamente (excluye DaVinci Resolve). ## 📝 Notas Importantes -* **Reiniciar Sesión:** Muchos cambios (Docker, grupos de usuario, variables de entorno) requieren cerrar sesión y volver a entrar. -* **Fuentes:** Para que la terminal se vea correctamente, asegúrate de instalar una **Nerd Font** (ej. `ttf-firacode-nerd`) y configurarla en tu terminal. -* **DaVinci Resolve:** Debes descargar el archivo `DaVinci_Resolve_Studio_*_Linux.zip` (o la versión gratuita) desde la web de Blackmagic y ponerlo en `~/Downloads` antes de ejecutar la opción **R**. +* **Enlace Simbólico:** Las configuraciones de **Zsh** y **Hyprland** se crean como enlaces simbólicos a `mg_dotfiles`. Cualquier cambio que hagas en tus archivos originales se reflejará inmediatamente. +* **Fuentes:** Asegúrate de instalar una **Nerd Font** (ej. `ttf-firacode-nerd`) para que los iconos se vean correctamente. +* **Reiniciar:** Cierra sesión después de instalar para aplicar cambios de grupos (Docker) y variables de entorno. ## 📂 Estructura * `omarchy-setup.sh`: Script principal. * `modules/`: Scripts individuales para cada tarea. -* `hypr_config/`: Archivos de configuración para Hyprland (se copian a `~/.config/hypr`). -* `themes/`: Temas personalizados (ej. para Oh My Posh). +* `doc_templates/`: Plantillas de documentos. +* `themes/`: Temas de apoyo (ej. configuraciones por defecto de Oh My Posh).