init

cheatsheets/nix-beginner-guide.es.md

@@ -0,0 +1,67 @@
+# Guía para Principiantes de ZaneyOS: Personalización Básica
+
+¡Bienvenido! Esta guía es para quienes son nuevos en Nix y quieren realizar personalizaciones comunes y seguras en su instalación de ZaneyOS. Mantendremos todo simple y al grano.
+
+## Diseño del repositorio (dónde cambiar las cosas)
+
+- `flake.nix`: Punto de entrada del sistema. Normalmente no necesitas editarlo para ajustes cotidianos.
+- `hosts/`: Configuración por máquina.
+  - `hosts/<tu-hostname>/`
+    - `variables.nix`: Tu panel principal (activar/desactivar funciones, establecer opciones).
+    - `host-packages.nix`: Paquetes extra solo para esta máquina.
+- `modules/`: Bloques reutilizables para el sistema y Home Manager.
+  - `modules/core/global-packages.nix`: Paquetes instalados en todas las máquinas.
+  - `modules/home/hyprland/binds.nix`: Atajos de Hyprland.
+
+## Instalar paquetes
+
+Dos patrones comunes:
+
+### 1) Solo en esta máquina
+Edita `hosts/<tu-hostname>/host-packages.nix` y añade el nombre del paquete:
+
+```nix
+[
+  brave
+  (catppuccin-vsc.override {
+    variant = "mocha";
+  })
+  cowsay
+]
+```
+
+### 2) En todas las máquinas
+Edita `modules/core/global-packages.nix` y añade el paquete a la lista.
+
+## Ajustes de monitores (por host)
+
+Edita `hosts/<tu-hostname>/variables.nix` y define la(s) línea(s) extra del monitor:
+
+```nix
+# Ejemplo: 1080p a 144 Hz en DP-1
+extraMonitorSettings = "monitor=DP-1,1920x1080@144";
+```
+
+## Cambiar atajos de Hyprland
+
+Edita `modules/home/hyprland/binds.nix`. Por ejemplo, cambiar la terminal de Super+Return a Super+T:
+
+```nix
+"SUPER, T, exec, ${terminal}"
+```
+
+## Aplicar y probar tus cambios
+
+Preferido (específico de ZaneyOS):
+- `zcli rebuild`
+  - Nota: el alias `fr` está obsoleto.
+
+Método manual de respaldo (funciona en cualquier instalación):
+- Desde la raíz del repo, reemplaza PROFILE por tu perfil (intel, nvidia, nvidia-laptop, vm):
+  - `sudo nixos-rebuild switch --flake .#PROFILE`
+
+Consejos
+- Si un rebuild falla, lee el error cerca del final: suele apuntar al archivo/línea exacta.
+- Si un cambio rompe tu sesión tras reiniciar, elige una “generación” anterior en el menú de arranque.
+- Usa Git para versionar tus cambios y poder revertir fácilmente.
+