diff --git a/CHANGELOG.md b/CHANGELOG.md index 269eda2..907dc4b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,515 +5,15 @@ --- -# 🚀 **Current Release - ZaneyOS v2.6.1** - -- Removed `discord` and `discord-canary` - - They use an outdated `electron` - - That build uses and `openssl v1.1.1w` - - That ius OEL and marked insecure in NIXOS - - Users can use an alternativve client until discord is updated -- Disabled `zen browser` in `zaneyos/modules/home/default.nix` - - Needs to be migrated to being enabled via host variable -- Changed from `zen` to `latest` kernel - - Linux kernel v7.0 is much better than 6.19_zen -- Disabled `vfr = true;` in hyprland config - - It's not supportorted after `v54.3` - - Disabling now to avoid error on next update -- Added `awww` as flake input for installs < 25.11 -- Fixed eval warnings: - - `gtk.gtk4.theme` set to `null` - - `git.signing.format` set to `null` -- `nixvim` lualine theme set to `auto` -- Changed to NixOS unstable branch -- Ported `DropTerminal` from `KoolDots` to ZaneyOS - - Replaces pyprland and some python dependencies -- Hyprland updated to v0.54 - - Added support for scrolling and monocle layouts - - Fixed hyprland float-all bindings - - Updated Window Rules for new Hyprland format -- Disabled steam by default -- Removed `adb.enable` no longer supported and not needed for ZaneyOS -- Changed `nixfmt-rfc-style` package for updated `nitfmt` - - `nixfmt-rfc-style` no longer supported -- Fixed other evaluation warnings with `Xorg` package changes - -# 🚀 **Current Release - ZaneyOS v2.6.0** - -#### 📅 **Updated: April 3rd, 2026** - -- Swapped `awww` for `swww` - - `swww` is no longer maintained - - removed `--format xrgb` flag also no needed - -#### 📅 **Updated: February 19th, 2026** - -- Fixed `zcli` GPU detection for newer AMD GPUs - - Fixed the fix to properly detect VMs -- `nixvim.nix` changes - - Disabled Zig language server - - Disabled marksman language server - - Caused dotnet lib to be compiled (takes hours) - -#### 📅 **Updated: February 16th, 2026** - -- Removed `hyprpanel` - - No longer maintained - - Vendor created `wayle` to replace it - - Replaced in ZaneyOS with 'noctalia-shell' - -- `webkitgtk` being built from source - - Removed audacity is called `wxwidgets` - - Created overlay for `tumbler` to disable `libepub` - - These caused the build from source issue - - Building `webkitgtk` takes hours every rebuild/update - -#### 📅 **Updated: January 31st, 2026** - -- Changed default login manager to `TUI` - - Issues recently (again) with SDDM and some GPUs - - Often related to SDDM wayland support option - - Some GPUs need it enabled, others disabled - -#### 📅 **Updated: January 28th, 2026** - -- Disabled gnome in stylix. Caused install failure - -#### 📅 **Updated: January 26th, 2026** - -- `noctalia-shell` regression: - - Removed `noctalia-shell` systemd service - - Caused old version of `noctalia-shell` - - Adjusted `noctalia-shell` bindings to match change -- Default applications now settable - - Globally for all hosts - - `zaneyos/modules/home/xdg.nix` - - Per host - - `zaneyos/hosts/HOSTNAME/variables.nix` - - Host settings override `xdg.nix` settings - -#### 📅 **Updated: January 23rd, 2026** - -- Added additional fonts -- Fixed issue with Hypridle and Home Manager - - Added `systemdTarget = "hyprland-session.target";` - - Thank you `Yang Kexuan` for the fix - - Reference issue: [5899](https://github.com/nix-community/home-manager/issues/5899) - -#### 📅 **Updated: January 5th, 2026** - -- Removed extra newline in `exec-once.nix` -- Fixed typo in `noctalia.nix` -- Added docs reference per systemd spec -- Improved code overall - - Thanks `lichen.gel.calm` for finding these issues -- Disabled `noctalia-shell` systemd service - - Caused older revision of `noctalia-shell` to load - - Now started from hyprland - -#### 📅 **Updated: December 29th, 2025** - -- Removed extra `noctalia-shell` startup -- Added initial support for AMD, NVIDIA Hybrid laptops -- Keypress to recover from DPMS now enabled by default - -#### 📅 **Updated: December 21st, 2025** - -- Added user systemd service for `noctalia-shell` -- Updated Hyprland bindings to accomodate change -- Updated `nixvim` - -## `nixvim` Features Migrated from Bugsvim - -#### Custom Diagnostic Icons - - ```lua - Error = " " - Warn = " " - Hint = "" - Info = "" - ``` - - Custom unicode symbols for each diagnostic severity level - - Integrated into vim.diagnostic.config() for gutter display - -#### Diagnostic Display Options - - - **Sign Column**: Shows diagnostic icons in the gutter with custom text and highlight groups - - **Virtual Text**: Inline diagnostics with custom prefix (`●`) and 2-space spacing - - **Virtual Lines**: Enhanced visibility for error context without cluttering - - **Underline**: Visual underline for error locations - - **Floating Window**: Hover diagnostics with rounded borders and source attribution - - **Severity Sorting**: Errors prioritized over warnings - -### 2. Text Yank Highlighting - - **Migration**: Highlight yanked text for 200ms (IncSearch highlight group) - - Autocmd-based implementation in extraConfigLua - - Uses vim.hl.on_yank for smooth visual feedback - -### 3. LSP Attachment Keybindings - - **Enhanced LSP Integration** with on-attach callbacks: - ``` - K - Hover documentation - gd - Goto definition - gD - Goto declaration - gi - Goto implementation - gr - References - rn - Rename symbol - ca - Code action - ``` - - Buffer-local scope prevents global pollution - - Guard against multiple registrations with flag check - -### 4. Startup Dashboard - - **Migration**: alpha-nvim with custom banner generation - -#### Dynamic Header Generation - - - Primary: `toilet -f ansi-shadow NIXOS` - - Secondary: `figlet -f "ANSI Shadow" NIXOS` - - Tertiary: `figlet NIXOS` - - Fallback: ASCII art banner (9 lines) - -#### Dashboard Buttons - - | Shortcut | Action | Command | - |----------|--------|---------| - | `f` | Find file | Telescope find_files | - | `r` | Recent files | Telescope oldfiles | - | `g` | Live grep | Telescope live_grep | - | `n` | New file | :enew | - | `e` | File browser | Neotree toggle | - | `q` | Quit | :qa | - -#### Footer - - Dynamic version display: `NixVim • Neovim X.Y.Z` - -### 5. Theme Integration - - **Migration**: Tokyo Night colorscheme with Stylix integration - - Tokyo Night colors for status line (lualine) - - Notify background color tied to Stylix palette: `#${config.lib.stylix.colors.base01}` - - Consistent color management across UI components - -## Comprehensive Feature Set - -### UI/Visuals Migrated - - - Lualine status line (Tokyo Night theme) - - Bufferline for buffer management - - Indent-blankline for visual indentation - - Colorizer for inline color display - - Illuminate for reference highlighting - - Which-key for keybinding discovery (Helix preset) - -### Core Editing - - - Treesitter for syntax highlighting - - Neo-tree file browser - - Telescope fuzzy finder with media_files extension - - Project.nvim for project management - - Hop/Leap motion plugins - - vim-surround for text manipulation - - Comment.nvim for toggle comments - -### Advanced Features - - - snacks.nvim ecosystem (terminal, scratch buffers, zen mode, git integration, notifier) - - Noice for enhanced UI/messages - - Notify for notifications - - todo-comments for task navigation - - nvim-autopairs with Treesitter support - -### Language Support - - **LSP Servers**: nil_ls, lua_ls, pyright, ts_ls, html, cssls, clangd, zls, marksman, hyprls, tailwindcss, bashls - - **Formatters**: - - Nix: alejandra - - Lua: stylua - - JavaScript/TypeScript: prettierd - - Shell: shfmt - - **Completion**: blink-cmp with luasnip snippets - -### Development Tools - - - Git integration: gitsigns + diffview - - Markdown preview - - Trouble diagnostics panel - - Terminal: toggleterm with float direction - -## Implementation Details - -### Module Structure - - - **File**: `modules/home/editors/nixvim.nix` (743 lines) - - **Framework**: Nixvim home-manager module - - **Theme**: Tokyo Night (primary), Catppuccin (fallback) - - **Runtime Tools**: 23+ packages (bat, chafa, fd, figlet, lazygit, prettierd, ripgrep, etc.) - -## Keybinding Highlights - - ``` - jk - Exit insert mode - ff - Find files - fm - Find media files - lg - Live grep - fe - File explorer toggle - t - Toggle terminal - . - Toggle comment (line/visual) - z - Zen mode - Z - Zoom - gg - Lazygit - - Terminal (via snacks) - ]t / [t - Next/prev TODO comment - n - Notification history - ``` - -#### 📅 **Updated: December 21st, 2025** - -- Added user systemd service for `noctalia-shell` -- Updated Hyprland bindings to accomodate change -- Updated `nixvim` - -## `nixvim` Features Migrated from Bugsvim - -#### Custom Diagnostic Icons - - ```lua - Error = " " - Warn = " " - Hint = "" - Info = "" - ``` - - Custom unicode symbols for each diagnostic severity level - - Integrated into vim.diagnostic.config() for gutter display - -#### Diagnostic Display Options - - - **Sign Column**: Shows diagnostic icons in the gutter with custom text and highlight groups - - **Virtual Text**: Inline diagnostics with custom prefix (`●`) and 2-space spacing - - **Virtual Lines**: Enhanced visibility for error context without cluttering - - **Underline**: Visual underline for error locations - - **Floating Window**: Hover diagnostics with rounded borders and source attribution - - **Severity Sorting**: Errors prioritized over warnings - -### 2. Text Yank Highlighting - - **Migration**: Highlight yanked text for 200ms (IncSearch highlight group) - - Autocmd-based implementation in extraConfigLua - - Uses vim.hl.on_yank for smooth visual feedback - -### 3. LSP Attachment Keybindings - - **Enhanced LSP Integration** with on-attach callbacks: - ``` - K - Hover documentation - gd - Goto definition - gD - Goto declaration - gi - Goto implementation - gr - References - rn - Rename symbol - ca - Code action - ``` - - Buffer-local scope prevents global pollution - - Guard against multiple registrations with flag check - -### 4. Startup Dashboard - - **Migration**: alpha-nvim with custom banner generation - -#### Dynamic Header Generation - - - Primary: `toilet -f ansi-shadow NIXOS` - - Secondary: `figlet -f "ANSI Shadow" NIXOS` - - Tertiary: `figlet NIXOS` - - Fallback: ASCII art banner (9 lines) - -#### Dashboard Buttons - - | Shortcut | Action | Command | - |----------|--------|---------| - | `f` | Find file | Telescope find_files | - | `r` | Recent files | Telescope oldfiles | - | `g` | Live grep | Telescope live_grep | - | `n` | New file | :enew | - | `e` | File browser | Neotree toggle | - | `q` | Quit | :qa | - -#### Footer - - Dynamic version display: `NixVim • Neovim X.Y.Z` - -### 5. Theme Integration - - **Migration**: Tokyo Night colorscheme with Stylix integration - - Tokyo Night colors for status line (lualine) - - Notify background color tied to Stylix palette: `#${config.lib.stylix.colors.base01}` - - Consistent color management across UI components - -## Comprehensive Feature Set - -### UI/Visuals Migrated - - - Lualine status line (Tokyo Night theme) - - Bufferline for buffer management - - Indent-blankline for visual indentation - - Colorizer for inline color display - - Illuminate for reference highlighting - - Which-key for keybinding discovery (Helix preset) - -### Core Editing - - - Treesitter for syntax highlighting - - Neo-tree file browser - - Telescope fuzzy finder with media_files extension - - Project.nvim for project management - - Hop/Leap motion plugins - - vim-surround for text manipulation - - Comment.nvim for toggle comments - -### Advanced Features - - - snacks.nvim ecosystem (terminal, scratch buffers, zen mode, git integration, notifier) - - Noice for enhanced UI/messages - - Notify for notifications - - todo-comments for task navigation - - nvim-autopairs with Treesitter support - -### Language Support - - **LSP Servers**: nil_ls, lua_ls, pyright, ts_ls, html, cssls, clangd, zls, marksman, hyprls, tailwindcss, bashls - - **Formatters**: - - Nix: alejandra - - Lua: stylua - - JavaScript/TypeScript: prettierd - - Shell: shfmt - - **Completion**: blink-cmp with luasnip snippets - -### Development Tools - - - Git integration: gitsigns + diffview - - Markdown preview - - Trouble diagnostics panel - - Terminal: toggleterm with float direction - -## Implementation Details - -### Module Structure - - - **File**: `modules/home/editors/nixvim.nix` (743 lines) - - **Framework**: Nixvim home-manager module - - **Theme**: Tokyo Night (primary), Catppuccin (fallback) - - **Runtime Tools**: 23+ packages (bat, chafa, fd, figlet, lazygit, prettierd, ripgrep, etc.) - -## Keybinding Highlights - - ``` - jk - Exit insert mode - ff - Find files - fm - Find media files - lg - Live grep - fe - File explorer toggle - t - Toggle terminal - . - Toggle comment (line/visual) - z - Zen mode - Z - Zoom - gg - Lazygit - - Terminal (via snacks) - ]t / [t - Next/prev TODO comment - n - Notification history - ``` - -#### 📅 **Updated: December 21st, 2025** - -- Updated: - - `nixvim.nix` now uses `blink-cmp` for completion/suggestions - - This replaces `nvim-cmp` - - `blink-cmp` is better, integrated in nixvim - - Removed LUA code related to `nvim-cmp` - -- Fixed: - - Output of `zcli list-gens` corrected - - Thanks `@codingismy11to71` - -#### 📅 **Updated: December 14th, 2025** - -- Fixed: -- hyprlock background image -- `--diff-always` to `nh` rebuilds -- Removed extra `Ghz` in `fastfetch` output -- Fixed hard coded directory for cheatsheets path -- Removed hard coded title -- Focus follows mouse - - Consistent with hyprland -- Turned off resize overlay -- Added curosr wrap shader - - Thanks to Steven Scott for the fixes - -#### 📅 **Updated: December 12th, 2025** - -- Fixed: - - `Weather.py` script - - Start menu in waybars -- Ported from ddubsos: - - `kitty-bg` and `ghostty-bg` - - Adds random backgrounds to terminals - - Custom Quickshell logout menu - - Custom startmenu - - Custom logout menu - - Quickshell wallpaper apps - - One for images, one for video wallpapers - - `ly` login manager - - `nwg-dock-hyprland.nix` - - `SUPERCTRL+D` to toggle -- Added: - - More wallpapers - - Video wallpapers - -#### 📅 **Updated: December 9th, 2025** - -- Notifcation history binding had wrong keyword - - Thanks to Kexuan Yang for fixing it - -#### 📅 **Updated: December 7th, 2025** - -- Added `alejandra` formatter to `flake.nix` - - ran `nix fmt ./` and updated all files to current format spec -- Added `alejandra` as default formatter in `nixvim.nix` -- Hybrid GPU detection fails in `install-zaneyos.sh` - - Should be `nvidia-laptop` not `hybrid` - - Thanks to sasek @sasek333 for spotting this - -#### 📅 **Updated: December 6th, 2025** - -- Changed: - - Quickshell now comes fromm NixPkgs. - - No more compiling on rebuilds - - Remove Flake input and input in `quickshell.nix` +# 🚀 **Current Release - ZaneyOS v2.5.3** #### 📅 **Updated: December 3rd, 2025** -- Added: - - Cheatsheets from ddubsOS - - Covers, terminals, emacs, etc - - In English and Spanish - - Zen browser - - Via Flake, for current builds - - Nano customized config -- Pinned: `nixvim` to v25.11 branch -- Added: Support for `kb_variants` at install time. - - Keyboards, like `dvorak`, `coleman,` or `euro` - - Configures, console, SDDM and Hyprland -- Fixed: TUI greetd service name changed to `services.greetd` -- Updated: - - `cachix settings updated for better speed - - Moved to its own `cacheix.nix` file +- Added: Support for `kb_variants` at install time + - options like `dvorka`, `coleman`, `euro` + - Sets console, SDDM, and Hyprland +- Fixed: TUI greetd failed to build + - Service name changed to `services.greetd` #### 📅 **Updated: December 1st, 2025** @@ -566,7 +66,7 @@ - Updated Keybindings - Moved screenshots into a markdown suummary to reduce clutter - Added script to fix `doom iedit` update error -- Moved some modules/home/\*.nix files to their own subdir +- Moved some modules/home/*.nix files to their own subdir - Terminals - Alacritty - ghostty @@ -613,7 +113,7 @@ - 🛡️ Installer: Added defensive hostname validation and sanitization - Prevents invalid hostnames (e.g., with dots) from causing Nix evaluation errors - - Auto-sanitizes to a compliant hostname (letters/digits with '-' or '\_', 1–63 + - Auto-sanitizes to a compliant hostname (letters/digits with '-' or '_', 1–63 chars) and prompts for confirmation - Explicitly rejects 'default' to avoid template overwrites - 🧩 Nix: Added assertion in modules/core/network.nix for clearer errors if an @@ -827,7 +327,6 @@ - 📊 Added info on `zcli` utility - ⬆️ Updated `zcli` now uses `nh` util to select # of generations to keep - ➕ Added `zcli` CLI util. runs rebuild, update, garbage collection and diags - ```text ❯ zcli diff --git a/FAQ.es.md b/FAQ.es.md index 5a08953..3e10776 100644 --- a/FAQ.es.md +++ b/FAQ.es.md @@ -1,8 +1,8 @@ [English](FAQ.md) | [Español](FAQ.es.md) -# 💬 Preguntas frecuentes de ZaneyOS +# 💬 Preguntas frecuentes de ZaneyOS para v2.5.3 -- **Fecha:** 14 de deciembre de 2025 +- **Fecha:** 3 de deciembre de 2025 **⌨ ¿Dónde puedo ver los atajos de teclado de Hyprland?** @@ -139,32 +139,6 @@ zcli doom status # Verifica estado de instalación -
-**¿Cómo configuro aplicaciones predeterminadas (PDF, navegador) por host?** - -- Edita `~/zaneyos/hosts//variables.nix` y descomenta `mimeDefaultApps`. -- Home Manager usará esto vía `modules/home/xdg.nix` para escribir tu `~/.config/mimeapps.list`. -- Usa IDs `.desktop` reales de `/usr/share/applications` o `~/.local/share/applications`. - -```nix -# hosts//variables.nix -# Aplicaciones predeterminadas a nivel de host (consumidas por xdg.mimeApps) -# mimeDefaultApps = { -# # PDFs -# "application/pdf" = ["okular.desktop"]; -# "application/x-pdf" = ["okular.desktop"]; -# # Navegador web -# "x-scheme-handler/http" = ["google-chrome.desktop"]; # o brave-browser.desktop, firefox.desktop -# "x-scheme-handler/https" = ["google-chrome.desktop"]; -# "text/html" = ["google-chrome.desktop"]; -# # Archivos -# "inode/directory" = ["thunar.desktop"]; # gestor de archivos -# "text/plain" = ["nvim.desktop"]; # o code.desktop -# }; -``` - -
- ## Atajos Principales de Hyprland A continuación se muestran los atajos de teclado para Hyprland, formateados para @@ -413,9 +387,9 @@ Edita la línea `extraMonitorSettings`. **Ejemplos:** - Monitor Único: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Monitores Múltiples: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` - Para configuraciones multi-monitor más complejas, puedes usar la aplicación GUI, `nwg-displays` Esta mostrará tus monitores conectados actualmente @@ -825,7 +799,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** ¿Cómo puedo establecer un temporizador para cambiar el wallpaper automáticamente? ** 1. Edita el archivo `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comenta la línea `sleep 1.5 && awww img ...` +2. Comenta la línea `sleep 1.5 && swww img ...` 3. Agrega nueva línea después de eso con `sleep 1 && wallsetter` ```json @@ -833,13 +807,13 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q awww;sleep .5 && awww init" + "killall -q swww;sleep .5 && swww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` diff --git a/FAQ.md b/FAQ.md index 32c6708..d573634 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,8 +1,8 @@ [English](FAQ.md) | [Español](FAQ.es.md) -# 💬 ZaneyOS FAQ +# 💬 ZaneyOS FAQ for v2.5.3 -- **Date:** 14-Decemnber-2025 +- **Date:** 3-December-2025 **⌨ Where can I see the Hyprland keybindings?** @@ -228,32 +228,6 @@ Below are the keybindings for Hyprland, formatted for easy reference.
-
-**How do I set default apps (PDF, browser) per host?** - -- Edit `~/zaneyos/hosts//variables.nix` and uncomment `mimeDefaultApps`. -- Home Manager will consume these via `modules/home/xdg.nix` to write your `~/.config/mimeapps.list`. -- Use real `.desktop` IDs from `/usr/share/applications` or `~/.local/share/applications`. - -```nix -# hosts//variables.nix -# Host-level default applications (picked up by Home Manager xdg.mimeApps) -# mimeDefaultApps = { -# # PDFs -# "application/pdf" = ["okular.desktop"]; -# "application/x-pdf" = ["okular.desktop"]; -# # Web browser -# "x-scheme-handler/http" = ["google-chrome.desktop"]; # or brave-browser.desktop, firefox.desktop -# "x-scheme-handler/https" = ["google-chrome.desktop"]; -# "text/html" = ["google-chrome.desktop"]; -# # Files -# "inode/directory" = ["thunar.desktop"]; # file manager -# "text/plain" = ["nvim.desktop"]; # or code.desktop -# }; -``` - -
-
**How to I add flatpaks? ?** @@ -401,9 +375,9 @@ Edit the `extraMonitorSettings` line. **Examples:** - Single Monitor: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Multiple Monitors: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` - For more complex, multi-monitor configurations, you may wish to use the GUI application, `nwg-displays` This will show your currently connected monitors @@ -811,7 +785,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** How can I set a timer to change the wallpaper automatically? ** 1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comment out the line `sleep 1.5 && awww img ...` +2. Comment out the line `sleep 1.5 && swww img ...` 3. Add new line after that with `sleep 1 && wallsetter` ```json @@ -819,13 +793,13 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q awww;sleep .5 && awww init" + "killall -q swww;sleep .5 && swww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` @@ -1596,9 +1570,9 @@ Edit the `extraMonitorSettings` line. **Examples:** - Single Monitor: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Multiple Monitors: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` - For more complex, multi-monitor configurations, you may wish to use the GUI application, `nwg-displays` This will show your currently connected monitors @@ -2002,7 +1976,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** How can I set a timer to change the wallpaper automatically? ** 1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comment out the line `sleep 1.5 && awww img ...` +2. Comment out the line `sleep 1.5 && swww img ...` 3. Add new line after that with `sleep 1 && wallsetter` ```json @@ -2010,13 +1984,13 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q awww;sleep .5 && awww init" + "killall -q swww;sleep .5 && swww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` diff --git a/README.es.md b/README.es.md index 1e83376..b2fa0c9 100644 --- a/README.es.md +++ b/README.es.md @@ -4,7 +4,7 @@ ## ZaneyOS 🟰 Mejores Configs ❄️ NixOS -\*\* Actualizado: 16 de enero de 2026 +** Actualizado: 3 de junio de 2025 ZaneyOS es una forma sencilla de reproducir mi configuración en cualquier sistema NixOS. Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración y más. @@ -47,6 +47,13 @@ Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración - Guía para Principiantes de Nix: [English](cheatsheets/nix-beginner-guide.md) | [Español](cheatsheets/nix-beginner-guide.es.md) - Guía de Personalización de Hyprland: [English](cheatsheets/hyprland-customization-guide.md) | [Español](cheatsheets/hyprland-customization-guide.es.md) +### Ten en cuenta: + +> **Este proyecto tiene un [Wiki](https://zaney.org/wiki/zaneyos-2.3/). ¡Aprende a usar ZaneyOS aquí!** +> **ddubs ha puesto mucho esfuerzo en el +> [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq), así que debería ser preciso. +> Sin embargo, si notas que algo está mal, crea un issue o contáctanos en Discord.** + #### 🍖 Requisitos - Debes estar ejecutando NixOS, versión 23.11+. @@ -82,6 +89,13 @@ Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración - Muchas personas pacientes y con ganas de ayudar te apoyan usando ZaneyOS. - No dudes en pasar por el Discord para pedir ayuda. +
+ +Hazte un favor y +[lee el wiki](https://zaney.org/wiki/zaneyos-2.3/). + +
+ #### 📦 ¿Cómo instalo paquetes? - Puedes buscar en [Nix Packages](https://search.nixos.org/packages?) y @@ -95,7 +109,9 @@ Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración - Siéntete libre de abrir un issue en el repo. Por favor etiqueta las solicitudes de funcionalidades comenzando el título con [feature request], ¡gracias! -- Contáctanos también en [Discord](https://discord.gg/XhZmNTnhtp) para una respuesta potencialmente más rápida. +- Contáctanos también en [Discord](https://discord.gg/2cRdBs8) para una respuesta potencialmente más rápida. + +- No olvides revisar el [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) # Atajos de Hyprland @@ -164,7 +180,7 @@ A continuación los atajos de Hyprland, en formato de referencia rápida. La col ## 🎨 Atajos de Noctalia Shell -_Disponibles cuando `barChoice = "noctalia"` en `variables.nix`_ +*Disponibles cuando `barChoice = "noctalia"` en `variables.nix`* - `$modifier + D` → Alternar iniciador - `$modifier + Shift + Return` → Alternar iniciador @@ -180,7 +196,7 @@ _Disponibles cuando `barChoice = "noctalia"` en `variables.nix`_ ### Iniciador Rofi (Modo Waybar) -_Disponible cuando `barChoice = "waybar"` en `variables.nix`_ +*Disponible cuando `barChoice = "waybar"` en `variables.nix`* - `$modifier + D` → Lanzar Rofi - `$modifier + Shift + Return` → Lanzar Rofi @@ -224,7 +240,7 @@ Luego: ![Comando del script de instalación de ZaneyOS](img/install-script.jpg) ``` -sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/main/install-zaneyos.sh) +sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/stable-2.4/install-zaneyos.sh) ``` #### El proceso de instalación se verá así: @@ -255,7 +271,7 @@ nix-shell -p git vim 2. Clona este repo y entra: ``` -cd && git clone https://gitlab.com/zaney/zaneyos.git -b main --depth=1 ~/zaneyos +cd && git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.4 --depth=1 ~/zaneyos cd zaneyos También puedes ejecutar el script `install.sh` si quieres. @@ -283,7 +299,7 @@ nixos-generate-config --show-hardware-config > hosts//hardware. 7. Ejecuta esto para habilitar flakes e instalar, reemplazando hostname por el perfil (p. ej. `intel`, `nvidia`, `nvidia-laptop`, `amd-hybrid` o `vm`): ``` -NIX_CONFIG="experimental-features = nix-command flakes" +NIX_CONFIG="experimental-features = nix-command flakes" sudo nixos-rebuild switch --flake .#profile ``` @@ -291,13 +307,66 @@ Ahora, cuando quieras reconstruir, tienes el alias `fr` que reconstruye el flake
+## Actualizar de ZaneyOS 2.3 a 2.4 + +> **🚀 IMPORTANTE:** Si ya tienes ZaneyOS 2.3, usa el sistema de actualización automatizado en lugar de reinstalar. + +### ✅ Proceso de actualización automatizado: + +ZaneyOS incluye un sistema de actualización completo que migra tu configuración de forma segura: + +```bash +cd ~/zaneyos +./upgrade-2.3-to-2.4.sh +``` + +### 🔍 ¿Qué hace el sistema de actualización? + +1. **Análisis previo**: Escaneo integral de tus personalizaciones +2. **Respaldo completo**: Copia total de tu configuración actual +3. **Migración automática**: Conserva todos tus ajustes y personalizaciones +4. **Actualización segura**: Usa la opción `boot` para evitar conflictos del gestor de acceso +5. **Reversión fácil**: Un solo comando si algo sale mal + +### 📋 ¿Qué se migra automáticamente? + +- ✅ Todas las configuraciones y variables de hosts +- ✅ Configuraciones de hardware +- ✅ Paquetes personalizados (globales y por host) +- ✅ Temas, fondos y ajustes de monitores +- ✅ Configuración de Git y preferencias personales +- ✅ Preferencias de terminal con habilitación automática + +### ⚠️ Qué requiere atención manual + +- Entradas personalizadas en flake.nix +- Archivos de configuración personal del shell (zshrc-personal.nix, etc.) +- Modificaciones de módulos personalizados + +### 📚 Documentación completa + +Para instrucciones detalladas, solución de problemas y seguridad: + +- **Lee**: `UPGRADE-2.3-to-2.4.md` en tu directorio zaneyos +- **Informe de análisis**: Guardado automáticamente como `~/zaneyos-upgrade-analysis-TIMESTAMP.txt` + +### 🔄 Reversión sencilla + +Si algo falla, vuelve a 2.3 fácilmente: + +```bash +cd ~/zaneyos +./upgrade-2.3-to-2.4.sh --revert +``` + +--- + ### Reconocimientos especiales: Gracias por toda su ayuda -- KoolDots https://github.com/LinuxBeginnings - Jakookit https://github.com/jakookit -- Justaguylinux https://codeberg.org/Justaguylinux +- Justaguylinux https://github.com/drewgrif - Jerry Starke https://github.com/JerrySM64 ## ¡Disfruta! diff --git a/README.md b/README.md index 375ced2..369fece 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ## ZaneyOS 🟰 Best ❄️ NixOS Configs -\*\* Updated: January 16th, 2026 +\*\* Updated: November 28th,2025 ZaneyOS is a simple way of reproducing my configuration on any NixOS system. This includes the wallpaper, scripts, applications, config files, and more. @@ -55,6 +55,14 @@ This includes the wallpaper, scripts, applications, config files, and more. [English](cheatsheets/hyprland-customization-guide.md) | [Español](cheatsheets/hyprland-customization-guide.es.md) +### Please note: + +> **This project has a [Wiki](https://zaney.org/wiki/zaneyos-2.3/). Find out how +> to use ZaneyOS here!** **ddubs has put a lot of effort into the +> [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) so it should be accurate. +> However, please if you notice that something is wrong with it create an issue +> or reach out to us on Discord.** + #### 🍖 Requirements - You must be running on NixOS, version 24.05+. @@ -76,7 +84,7 @@ This includes the wallpaper, scripts, applications, config files, and more. #### 🏇 Optimized Workflow & Simple Yet Elegant Neovim - Using Hyprland for increased elegance, functionality, and efficiency. -- No massive NeoVIM project here, using `nixvim` for an +- No massive NeoVIM project here. This is my simple, easy to understand, yet incredible NeoVIM setup. With language support already added in. #### 🖥️ Multi Host & User Configuration @@ -94,6 +102,13 @@ This includes the wallpaper, scripts, applications, config files, and more. running ZaneyOS. - Feel free to reach out on the Discord for any help with anything. +
+ +Please do yourself a favor and +[read the wiki](https://zaney.org/wiki/zaneyos-2.3/). + +
+ #### 📦 How To Install Packages? - You can search the [Nix Packages](https://search.nixos.org/packages?) & @@ -108,9 +123,11 @@ This includes the wallpaper, scripts, applications, config files, and more. - Please feel free to raise an issue on the repo, please label a feature request with the title beginning with [feature request], thank you! -- Contact us on [Discord](https://discord.gg/XhZmNTnhtp) as well, for a potentially +- Contact us on [Discord](https://discord.gg/2cRdBs8) as well, for a potentially faster response. +- Don't forget to checkout the [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) + # Hyprland Keybindings Below are the keybindings for Hyprland, formatted for easy reference. The right @@ -245,7 +262,7 @@ Then: ![ZaneyOS Install Script Command](img/install-script.jpg) ``` -sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/main/install-zaneyos.sh) +sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/stable-2.4/install-zaneyos.sh) ``` #### The install process will look something like this: @@ -276,7 +293,7 @@ nix-shell -p git vim 2. Clone this repo & enter it: ``` -cd && git clone https://gitlab.com/zaney/zaneyos.git -b main --depth=1 ~/zaneyos +cd && git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.4 --depth=1 ~/zaneyos cd zaneyos You can still run the `install.sh` script if you want to. @@ -291,33 +308,93 @@ cp -r hosts/default hosts/ git add . ``` -4. Edit `hosts//variables.nix` - ```nixos-generate-config --show-hardware-config > hosts//hardware.nix``` +4. Edit `hosts//variables.nix`. +5. Edit `flake.nix` and fill in your username, profile, and hostname. + +6. Generate your hardware.nix like so: + +``` +nixos-generate-config --show-hardware-config > hosts//hardware.nix ``` 7. Run this to enable flakes and install the flake replacing hostname with profile. I.e. `intel`, `nvidia`, `nvidia-laptop`, `amd-hybrid`, or `vm` ``` - NIX_CONFIG="experimental-features = nix-command flakes" sudo nixos-rebuild switch --flake .#profile - ``` Now when you want to rebuild the configuration you have access to an alias called `fr` that will rebuild the flake and you do not have to be in the `zaneyos` folder for it to work. + + +## Upgrading from ZaneyOS 2.3 to 2.4 -- At this time do NOT user the upgrade script + +> **🚀 IMPORTANT:** If you already have ZaneyOS 2.3 installed, use the automated +> upgrade system instead of reinstalling! + +### ✅ Automated Upgrade Process: + +ZaneyOS includes a comprehensive upgrade system that safely migrates your +configuration: + +```bash +cd ~/zaneyos +./upgrade-2.3-to-2.4.sh +``` + +### 🔍 What the Upgrade System Does: + +1. **Pre-Upgrade Analysis** - Comprehensive scan of your customizations +2. **Complete Backup** - Full backup of your current configuration +3. **Automatic Migration** - Preserves all your settings and customizations +4. **Safe Upgrade** - Uses `boot` option to prevent display manager conflicts +5. **Easy Revert** - One-command rollback if needed + +### 📋 What Gets Automatically Migrated: + +- ✅ All host configurations and variables +- ✅ Hardware configurations +- ✅ Custom packages (both global and per-host) +- ✅ Themes, wallpapers, and monitor settings +- ✅ Git configuration and personal settings +- ✅ Terminal preferences with automatic enabling + +### ⚠️ What Requires Manual Attention: + +- Custom flake.nix inputs +- Personal shell configuration files (zshrc-personal.nix, etc.) +- Custom module modifications + +### 📚 Complete Documentation: + +For detailed upgrade instructions, troubleshooting, and safety information: + +- **Read**: `UPGRADE-2.3-to-2.4.md` in your zaneyos directory +- **Analysis Report**: Saved automatically as + `~/zaneyos-upgrade-analysis-TIMESTAMP.txt` + +### 🔄 Easy Revert: + +If anything goes wrong, easily revert to 2.3: + +```bash +cd ~/zaneyos +./upgrade-2.3-to-2.4.sh --revert +``` + +--- + ### Special Recognitions: Thank you for all your assistance -- KoolDots https://github.com/LinuxBeginnings -- JakKoolit https://github.com/Jakoolit -- Justaguylinux https://codeberg.org/Justaguylinux +- Jakookit https://github.com/jakookit +- Justaguylinux https://github.com/drewgrif - Jerry Starke https://github.com/JerrySM64 ## Hope you enjoy! -``` diff --git a/cheatsheets/README.es.md b/cheatsheets/README.es.md deleted file mode 100644 index 7f4ec67..0000000 --- a/cheatsheets/README.es.md +++ /dev/null @@ -1,66 +0,0 @@ -[English](./README.md) | Español - -# Índice de Cheatsheets (ZaneyOS) -Estos documentos cubren tanto el uso general como la configuración específica definida en la configuración de NixOS "ZaneyOS". - -- Uso general: Consejos prácticos centrados en tareas y los principales flujos de trabajo. -- Específicos de ZaneyOS: Notas que reflejan cómo se configuran las herramientas en este repositorio (modules/home/*) para que el comportamiento coincida con su sistema. - -## 🔗 Enlaces Rápidos -- Emacs - - [Los 10 mejores consejos para empezar](emacs/emacs.getting-started.top10.md) - - [Explorador de archivos](emacs/emacs.file-explorer.cheatsheet.md) - - [Autocompletado de código](emacs/emacs.code-completion.cheatsheet.md) - - [Magit (Git)](emacs/emacs.magit.cheatsheet.md) - - [Markdown](emacs/emacs.markdown.cheatsheet.md) -- Ghostty - - [Cheatsheet de Ghostty](ghostty/ghostty.cheatsheet.md) -- Tmux - - [Cheatsheet de Tmux](tmux/tmux.cheatsheet.md) -- Alacritty - - [Cheatsheet de Alacritty](alacritty/alacritty.cheatsheet.md) -- Kitty - - [Cheatsheet de Kitty](kitty/kitty.cheatsheet.md) -- WezTerm - - [Cheatsheet de WezTerm](wezterm/wezterm.cheatsheet.md) -- Hyprland - - [Atajos de teclado](hyprland/hyprland.binds.cheatsheet.md) - - [Reglas de ventana](hyprland/hyprland.windowrules.cheatsheet.md) -- Yazi - - [Mapa de teclas](yazi/yazi.keymap.cheatsheet.md) - -## 📚 Cómo usar -- Navegue por el área que le interese (por ejemplo, Emacs, Ghostty). -- Comience con los documentos de "primeros pasos" o "consejos principales" para obtener resultados rápidos. -- Consulte las cheatsheets específicas de cada herramienta para los comandos diarios y luego verifique cualquier configuración específica de ZaneyOS. - -## 📂 Árbol de Directorios - -``` -cheatsheets/ -├── emacs/ -│ ├── emacs.code-completion.cheatsheet.md -│ ├── emacs.file-explorer.cheatsheet.md -│ ├── emacs.getting-started.top10.md -│ ├── emacs.magit.cheatsheet.md -│ └── emacs.markdown.cheatsheet.md -├── ghostty/ -│ └── ghostty.cheatsheet.md -├── tmux/ -│ └── tmux.cheatsheet.md -├── alacritty/ -│ └── alacritty.cheatsheet.md -├── kitty/ -│ └── kitty.cheatsheet.md -├── wezterm/ -│ └── wezterm.cheatsheet.md -├── hyprland/ -│ ├── hyprland.binds.cheatsheet.md -│ └── hyprland.windowrules.cheatsheet.md -└── yazi/ - └── yazi.keymap.cheatsheet.md -``` - -## 🛠️ Notas -- El cheatsheet de Ghostty refleja los atajos de teclado de modules/home/terminals/ghostty.nix (ZaneyOS). -- Los documentos de Emacs siguen el mismo estilo de markdown para mayor consistencia y una lectura rápida. diff --git a/cheatsheets/README.md b/cheatsheets/README.md index c4c901c..23eee44 100644 --- a/cheatsheets/README.md +++ b/cheatsheets/README.md @@ -1,10 +1,9 @@ -English | [Español](./README.es.md) +# Cheatsheets Index (ddubsOS) -# Cheatsheets Index (ZaneyOS) -These documents cover both general usage and the specific configuration as defined in the NixOS configuration "ZaneyOS". +These documents cover both general usage and the specific configuration as defined in the NixOS configuration "ddubsOS". - General use: Practical, task-focused tips and top workflows. -- ZaneyOS specifics: Notes reflecting how tools are configured in this repository (modules/home/*) so behavior matches your system. +- ddubsOS specifics: Notes reflecting how tools are configured in this repository (modules/home/*) so behavior matches your system. ## 🔗 Quick Links - Emacs @@ -32,7 +31,7 @@ These documents cover both general usage and the specific configuration as defin ## 📚 How to use - Browse the area you care about (e.g., Emacs, Ghostty). - Start with the “getting started” or “top tips” docs for quick wins. -- Refer to tool-specific cheatsheets for day-to-day commands, then cross-check any ZaneyOS-specific settings. +- Refer to tool-specific cheatsheets for day-to-day commands, then cross-check any ddubsOS-specific settings. ## 📂 Directory Tree @@ -62,5 +61,6 @@ cheatsheets/ ``` ## 🛠️ Notes -- Ghostty cheatsheet reflects bindings from modules/home/terminals/ghostty.nix (ZaneyOS). +- Ghostty cheatsheet reflects bindings from modules/home/terminals/ghostty.nix (ddubsOS). - Emacs docs follow the same markdown style for consistency and quick scanning. + diff --git a/cheatsheets/add-gnome.md b/cheatsheets/add-gnome.md deleted file mode 100644 index b36cdc5..0000000 --- a/cheatsheets/add-gnome.md +++ /dev/null @@ -1,58 +0,0 @@ -# Add GNOME Desktop (overview) - -This guide gives **basic steps** and **which files to edit** to add GNOME to ZaneyOS. - -In NixOS, you enable it through NixOS options in a module (a `.nix` file), then pick a display manager (login screen). -This repo already has **SDDM** (graphical) and **LY** (text) login support. You can keep using either — both can start GNOME sessions. - -## Files to edit (minimal list) - -1. `modules/core/default.nix` - - Import your new GNOME module so it becomes part of the system config. - -2. `modules/core/xserver.nix` - - GNOME needs `services.xserver.enable = true;` (this file currently disables X11). - -3. `modules/core/gnome.nix` (new file you create) - - Turn on GNOME’s desktop manager. - -4. `hosts//variables.nix` - - Make sure your `displayManager` is set to either `"sddm"` or `"tui"` (for LY), since those are already supported here. - -## Suggested minimal GNOME module (example) - -```nix path=null start=null -{ ... }: -{ - services.xserver = { - enable = true; - desktopManager.gnome.enable = true; - }; -} -``` - -## Where to import the GNOME module - -In `modules/core/default.nix`, add your GNOME file to the imports list: - -```nix path=null start=null -imports = [ - # ... - ./gnome.nix - # ... -]; -``` - -## Flatpak: GNOME Extensions Manager - -To add the Flatpak app **Extension Manager** (for GNOME extensions), edit `modules/core/flatpak.nix` and add its ID: - -```nix path=null start=null -services.flatpak.packages = [ - "com.mattjakeman.ExtensionManager" -]; -``` - -## `git add .` and rebuild - -Once you have the file created. In the ZaneyOS directory run `git add . ` then `zcli rebuild` diff --git a/cheatsheets/alacritty/alacritty.cheatsheet.es.md b/cheatsheets/alacritty/alacritty.cheatsheet.es.md deleted file mode 100644 index 19bd1eb..0000000 --- a/cheatsheets/alacritty/alacritty.cheatsheet.es.md +++ /dev/null @@ -1,23 +0,0 @@ -[English](./alacritty.cheatsheet.md) | Español - -# Alacritty en ZaneyOS — Resumen y Cheatsheet -## 🚀 Resumen de modules/home/terminals/alacritty.nix - -- Programa - - Alacritty habilitado. - - Familia de fuentes (predeterminada): Maple NF; tamaño: 15. - - Estilos configurados: Regular, Negrita, Cursiva, Negrita Cursiva. - ---- - -## ⚙️ Opciones Predeterminadas (según configuración) - -Fuente -- normal: Maple NF Regular -- bold: Maple NF Negrita -- italic: Maple NF Cursiva -- bold_italic: Maple NF Negrita Cursiva -- size: 15 - -Notas -- Usa lib.mkDefault para la familia de fuentes, por lo que otros módulos pueden anularla. diff --git a/cheatsheets/alacritty/alacritty.cheatsheet.md b/cheatsheets/alacritty/alacritty.cheatsheet.md index 6047f92..84164f0 100644 --- a/cheatsheets/alacritty/alacritty.cheatsheet.md +++ b/cheatsheets/alacritty/alacritty.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./alacritty.cheatsheet.es.md) +# Alacritty on ddubsOS — Summary & Cheatsheet -# Alacritty on ZaneyOS — Summary & Cheatsheet ## 🚀 Summary of modules/home/terminals/alacritty.nix - Program diff --git a/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md b/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md deleted file mode 100644 index 1c4d7bc..0000000 --- a/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md +++ /dev/null @@ -1,129 +0,0 @@ -[English](./emacs.code-completion.cheatsheet.md) | Español - -# Cheatsheet de Autocompletado y Búsqueda de Código en Doom Emacs -## 🚀 **Lo que Tienes (Como nvim-cmp + blink.cmp)** - -Si tu configuración de Doom incluye: -- **Company Mode** - Framework de autocompletado -- **LSP Mode** - Soporte para el Protocolo de Servidor de Lenguaje -- **Tree-sitter** - Análisis de sintaxis avanzado -- **Herramientas de búsqueda** - Búsqueda de documentación y definiciones - -## ⌨️ **Autocompletado de Código (Company)** - -### **Controles de Autocompletado:** -- `TAB` o `C-SPC` - **Aceptar autocompletado** -- `C-n` / `j` - **Siguiente autocompletado** (modo evil) -- `C-p` / `k` - **Anterior autocompletado** (modo evil) -- `C-w` - **Mostrar documentación** para el autocompletado -- `C-s` - **Buscar/filtrar autocompletados** -- `ESC` o `C-g` - **Cancelar autocompletado** - -### **Autocompletado Manual:** -- `M-/` - **Completar en el punto** (disparador manual) -- `C-M-/` - **Expandir abreviatura** - -## 🔍 **Búsqueda y Navegación de Código** - -### **Ir a Definición/Referencias:** -- `gd` - **Ir a la definición** (modo evil) -- `gD` - **Ir a la declaración** -- `gr` - **Ir a las referencias** -- `SPC c d` - **Buscar definición** -- `SPC c D` - **Buscar referencias** -- `SPC c i` - **Buscar implementaciones** - -### **Búsqueda de Documentación:** -- `K` - **Buscar documentación** (modo evil) -- `SPC c k` - **Buscar documentación** -- `SPC c K` - **Buscar en conjuntos de documentos** -- `C-h f` - **Describir función** -- `C-h v` - **Describir variable** - -### **Navegación de Símbolos:** -- `SPC c j` - **Saltar a símbolo en el búfer** -- `SPC c J` - **Saltar a símbolo en el proyecto** -- `SPC s i` - **Buscar símbolo** - -## 🛠️ **Características de LSP (Servidor de Lenguaje)** - -### **Acciones de LSP:** -- `SPC c a` - **Acciones de código** (refactorizar, arreglar, etc.) -- `SPC c r` - **Renombrar símbolo** -- `SPC c f` - **Formatear búfer/región** -- `SPC c o` - **Organizar importaciones** - -### **Navegación de Errores:** -- `]e` - **Siguiente error** -- `[e` - **Error anterior** -- `SPC c x` - **Listar errores** - -### **Información de LSP:** -- `SPC c l` - **Menú de LSP** -- `SPC c h` - **Mostrar información al pasar el ratón** -- `SPC c s` - **Mostrar firma** - -## 🎯 **Características Específicas del Lenguaje** - -### **C/C++ (clang-tools)** -- Autocompletado completo para funciones, variables, tipos -- Ir a la definición a través de archivos -- Comprobación de errores y diagnósticos -- Formateo de código con clang-format - -### **Nix (nil LSP)** -- Autocompletado del lenguaje Nix -- Documentación de funciones -- Comprobación de sintaxis -- Ir a la definición para expresiones de Nix - -### **JSON (vscode-json-languageserver)** -- Autocompletado basado en esquemas -- Validación y comprobación de errores -- Ir a la definición en archivos JSON - -## ⚡ **Consejos Profesionales** - -### **Búsqueda Difusa en Todo:** -- `SPC f f` - **Buscar archivos** -- `SPC /` - **Buscar en el proyecto** -- `SPC s s` - **Buscar en el búfer** -- `SPC p p` - **Cambiar de proyecto** - -### **Mejor Navegación:** -- `C-o` - **Retroceder** (después de saltar a la definición) -- `C-i` - **Avanzar** -- `SPC j j` - **Saltar a un carácter** (como easymotion) - -### **Ajustes de Autocompletado:** -- Los autocompletados aparecen después de 0.2 segundos de escribir -- Mínimo 1 carácter para activarse -- Muestra la documentación en una ventana emergente -- Funciona tanto con Company como con LSP - -## 🔧 **Solución de Problemas** - -### **Si el autocompletado no funciona:** -1. Comprueba si el servidor LSP se está ejecutando: `SPC c l` -2. Reinicia LSP: `SPC c l r` -3. Comprueba si hay errores de sintaxis: `SPC c x` - -### **Rendimiento:** -- Los servidores LSP se inician automáticamente cuando abres archivos compatibles -- El autocompletado está optimizado para una respuesta rápida -- Usa `SPC h r r` para recargar la configuración de Doom después de los cambios - -## 🚀 **Flujo de Trabajo de Inicio Rápido** - -1. **Abre un archivo de código** (`.c`, `.nix`, `.json`) -2. **Empieza a escribir** - los autocompletados aparecen automáticamente -3. **Navega con `j/k`** y **acepta con `TAB`** -4. **Usa `gd`** para saltar a las definiciones -5. **Usa `K`** para ver la documentación -6. **Usa `SPC c a`** para acciones de código - -## 📚 **Servidores de Lenguaje Incluidos** -- **C/C++**: `clang-tools` (clangd) -- **Nix**: `nil` -- **JSON**: `vscode-json-languageserver` -- ¡Se pueden añadir más por lenguaje según sea necesario! diff --git a/cheatsheets/emacs/emacs.code-completion.cheatsheet.md b/cheatsheets/emacs/emacs.code-completion.cheatsheet.md index ae6069d..d1c074a 100644 --- a/cheatsheets/emacs/emacs.code-completion.cheatsheet.md +++ b/cheatsheets/emacs/emacs.code-completion.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./emacs.code-completion.cheatsheet.es.md) - # Doom Emacs Code Completion & Lookup Cheatsheet + ## 🚀 **What You Have (Like nvim-cmp + blink.cmp)** If your Doom config includes: diff --git a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md deleted file mode 100644 index 36f95bb..0000000 --- a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md +++ /dev/null @@ -1,306 +0,0 @@ -[English](./emacs.file-explorer.cheatsheet.md) | Español - -# Cheatsheet del Explorador de Archivos de Doom Emacs -## 🗂️ **¿Qué es Dired?** - -Dired (Directory Editor) es el gestor de archivos incorporado de Emacs que te permite navegar, gestionar y manipular archivos y directorios de manera eficiente. -- Navega por los directorios con el teclado -- Marca, copia, mueve y elimina archivos -- Ejecuta comandos en múltiples archivos a la vez -- Se integra con otras herramientas y búferes de Emacs - -## 📋 **Requisitos** -- Doom Emacs (Dired está incorporado) -- **Treemacs**: Debe estar habilitado en `~/.doom.d/init.el` (descomenta la línea `treemacs`) -- Herramientas opcionales para una funcionalidad mejorada: - - `rsync` - Sincronización y copia rápida de archivos - - `fd` o `find` - Búsqueda de archivos mejorada - - `rg` (ripgrep) o `ag` (the_silver_searcher) - Búsqueda rápida de texto - - `exa` o `lsd` - Listados de directorios mejorados - - `trash-cli` - Eliminación segura de archivos a la papelera - - `zip`/`unzip`, `tar`, `gzip` - Manejo de archivos comprimidos - -## ⌨️ **Abriendo Exploradores de Archivos** - -### **Dired (Gestor de Archivos Incorporado):** -- `SPC .` - **Abrir Dired** en el directorio actual -- `SPC f d` - **Buscar directorio** (abrir Dired en una ruta específica) -- `C-x d` - **Abrir Dired** (atajo clásico de Emacs) - -### **Navegación de Archivos del Proyecto:** -- `SPC SPC` - **Buscar archivo** en el proyecto -- `SPC f f` - **Buscar archivo** en cualquier lugar -- `SPC f r` - **Archivos recientes** -- `SPC p f` - **Buscar archivo** en el proyecto - -### **Exploradores en Estilo de Árbol:** -- `SPC o p` - **Alternar barra lateral del proyecto** (Treemacs) -- `SPC f t` - **Buscar archivo** en el árbol - -## 🧭 **Navegación en Dired** - -### **Movimiento Básico:** -- `j/k` o `n/p` - **Moverse arriba/abajo** entre archivos -- `h` - **Subir** un directorio (padre) -- `l` o `RET` - **Entrar en el directorio** o abrir archivo -- `^` - **Ir al directorio padre** -- `g` - **Refrescar** el listado del directorio - -### **Saltando:** -- `gg` - **Ir al principio** del listado -- `G` - **Ir al final** del listado -- `/` - **Buscar** por nombre de archivo/directorio -- `SPC s s` - **Buscar dentro** del directorio - -### **Información del Archivo:** -- `(` - **Alternar detalles** (mostrar/ocultar información del archivo) -- `s` - **Ordenar** archivos (por nombre, fecha, tamaño) -- `C-h m` - **Mostrar ayuda** para el modo actual - -## 📁 **Operaciones con Archivos** - -### **Abriendo Archivos:** -- `RET` - **Abrir archivo** en la ventana actual -- `o` - **Abrir archivo** en otra ventana -- `C-o` - **Abrir archivo** en otra ventana (mantener el cursor en Dired) -- `v` - **Ver archivo** (solo lectura) -- `f` - **Buscar archivo** (igual que RET) - -### **Creando Archivos y Directorios:** -- `+` - **Crear directorio** -- `SPC f c` - **Crear archivo** (cuando estás en el búfer de Dired) -- `C-x C-f` - **Buscar/crear archivo** (desde Dired) - -## 🏷️ **Marcando Archivos** - -### **Marcado Básico:** -- `m` - **Marcar archivo** para operaciones -- `u` - **Desmarcar archivo** -- `U` - **Desmarcar todos** los archivos -- `t` - **Alternar marcas** (marcar los no marcados, desmarcar los marcados) -- `* %` - **Marcar por patrón** de expresión regular - -### **Marcado Rápido:** -- `* .` - **Marcar por extensión** (ej., *.txt) -- `* /` - **Marcar directorios** -- `* @` - **Marcar enlaces simbólicos** -- `* *` - **Marcar ejecutables** - -### **Marcado Avanzado:** -- `% m` - **Marcar archivos** que coincidan con una expresión regular -- `% d` - **Marcar para eliminar** archivos que coincidan con una expresión regular -- `* c` - **Cambiar marcas** (cambiar una marca por otra) - -## ✂️ **Operaciones de Gestión de Archivos** - -### **Copiar, Mover, Eliminar:** -- `C` - **Copiar** archivos marcados (o el archivo bajo el cursor) -- `R` - **Renombrar/Mover** archivos marcados -- `D` - **Eliminar** archivos marcados inmediatamente -- `d` - **Marcar para eliminar** (usa `x` para ejecutar) -- `x` - **Ejecutar eliminaciones** (eliminar archivos marcados con `d`) - -### **Opciones de Eliminación:** -- `d` y luego `x` - **Eliminación segura** (marcar primero, luego ejecutar) -- `D` - **Eliminación inmediata** (omite el paso de marcar) -- **Integración con la papelera**: Si `trash-cli` está instalado, los archivos van a la papelera en lugar de ser eliminados permanentemente - -### **Operaciones Avanzadas:** -- `Z` - **Comprimir/descomprimir** archivos (usa `gzip`, `zip`, `tar` automáticamente) -- `A` - **Buscar** en archivos marcados (usa `grep` o `rg` si está disponible) -- `Q` - **Consultar y reemplazar** en archivos marcados -- `!` - **Ejecutar comando de shell** en archivos marcados -- `&` - **Ejecutar comando de shell asíncrono** en archivos marcados - -## 📋 **Copiando y Moviendo** - -### **Operaciones de Copia:** -- `C` - **Copiar archivos** (solicita el destino) -- Funciona con archivos marcados o un solo archivo bajo el cursor -- Usa `rsync` si está disponible para una copia más rápida y reanudable -- Admite la copia a diferentes unidades/particiones - -### **Operaciones de Mover/Renombrar:** -- `R` - **Renombrar/Mover** archivos -- Puede renombrar archivos individuales o mover múltiples archivos marcados -- Admite el movimiento entre directorios - -### **Consejos para Copiar/Mover:** -- Marca múltiples archivos primero, luego usa `C` o `R` -- El autocompletado con Tab funciona para las rutas de destino -- Usa rutas relativas (`.`, `..`) para una navegación rápida - -## 🔍 **Búsqueda y Filtro** - -### **Encontrando Archivos:** -- `/` - **Buscar** nombres de archivo en el listado actual -- `n/N` - **Siguiente/anterior** coincidencia de búsqueda - -### **Búsqueda Mejorada (con herramientas externas):** -- `A` - **Buscar dentro de los archivos** (usa `rg` > `ag` > `grep` en orden de prioridad) -- Mucho más rápido con `ripgrep` o `the_silver_searcher` -- Admite patrones de expresiones regulares y filtrado por tipo de archivo - -### **Filtrando la Visualización:** -- `(` - **Alternar** vista detallada -- `s` - **Ordenar** por diferentes criterios -- `C-u s` - **Ordenar** con opciones personalizadas - -### **Búsqueda de Contenido:** -- `A` - **Buscar dentro** de los archivos marcados -- `Q` - **Consultar y reemplazar** en los archivos marcados - -## 🔧 **Características Avanzadas** - -### **Wdired (Dired Editable):** -- `C-x C-q` - **Editar nombres de archivo** directamente (como renombrar) -- Edita los nombres de archivo como texto, luego `C-c C-c` para aplicar los cambios -- `C-c C-k` para cancelar las ediciones - -### **Múltiples Ventanas:** -- `o` - **Abrir en otra ventana** -- `C-o` - **Mostrar en otra ventana** (permanecer en Dired) -- `2` - **Dividir la ventana** verticalmente para dos vistas de Dired - -### **Subdirectorios:** -- `i` - **Insertar subdirectorio** en el mismo búfer -- `$` - **Ocultar/mostrar** el contenido del subdirectorio -- `M-$` - **Ocultar todos** los subdirectorios - -## 📊 **Comparación de Archivos** - -### **Operaciones de Diferencias:** -- `=` - **Comparar archivo** con otro -- `M-=` - **Comparar** archivos marcados entre sí -- Funciona con herramientas de diferencias externas - -## 🗜️ **Operaciones con Archivos Comprimidos** - -### **Compresión y Archivos:** -- `Z` - **Comprimir/descomprimir** detecta automáticamente el formato -- Admite: `.gz`, `.zip`, `.tar`, `.tar.gz`, `.tar.xz`, `.7z` -- Usa las herramientas apropiadas: `gzip`, `zip`, `tar`, `7z` - -### **Visualización de Archivos Comprimidos:** -- Abre archivos `.zip`, `.tar`, etc. directamente para navegar por su contenido -- Extrae archivos específicos de los archivos comprimidos - -## 🎛️ **Personalización y Ajustes** - -### **Opciones de Vista:** -- `(` - **Alternar** entre vista simple y detallada -- `s` - **Ciclar** entre los órdenes de clasificación (nombre, fecha, tamaño) -- Listados mejorados con `exa` o `lsd` si están disponibles - -### **Ajustes Útiles:** -- Dired reutiliza los búferes por defecto en Doom -- Actualización automática al cambiar los archivos -- Integración con los atajos de teclado del modo Evil - -## ⚡ **Treemacs (Explorador en Árbol)** - -### **Treemacs Básico:** -- `SPC o p` - **Alternar** la barra lateral de Treemacs -- `j/k` - **Navegar** arriba/abajo en el árbol -- `RET` - **Abrir archivo** o expandir/contraer directorio -- `TAB` - **Expandir/contraer** directorio - -### **Operaciones de Archivo en Treemacs:** -- `cf` - **Crear archivo** -- `cd` - **Crear directorio** -- `R` - **Renombrar** -- `d` - **Eliminar** -- `yy` - **Copiar** la ruta al portapapeles - -## 🚀 **Flujo de Trabajo de Inicio Rápido** - -### **Gestión Básica de Archivos:** -1. **Presiona `SPC .`** - Abre Dired en el directorio actual -2. **Navega con `j/k`** - Muévete entre los archivos -3. **Marca archivos con `m`** - Selecciona múltiples archivos -4. **Usa `C` para copiar** o `R` para mover/renombrar -5. **Presiona `g`** para refrescar cuando termines - -### **Operaciones de Archivo Eficientes:** -1. **Marca múltiples archivos** con `m` -2. **Ejecuta operaciones por lotes** (`C` para copiar, `R` para mover) -3. **Usa `!`** para ejecutar comandos de shell en los archivos marcados -4. **Alterna los detalles con `(`** para más/menos información - -## 📚 **Resumen de Atajos Esenciales** - -| Acción | Tecla | Descripción | -|--------|-----|-------------| -| Abrir Dired | `SPC .` | Abrir explorador de archivos | -| Navegar | `j/k` | Moverse arriba/abajo | -| Entrar/Abrir | `RET` o `l` | Abrir archivo/directorio | -| Directorio Padre | `h` o `^` | Subir un directorio | -| Marcar | `m` | Marcar archivo para operaciones | -| Copiar | `C` | Copiar archivos marcados | -| Mover/Renombrar | `R` | Mover o renombrar archivos | -| Eliminar | `d` y luego `x` | Marcar para eliminar, ejecutar | -| Crear Directorio | `+` | Crear nuevo directorio | -| Comprimir | `Z` | Comprimir/descomprimir | -| Buscar en Archivos | `A` | Buscar dentro de los archivos | -| Refrescar | `g` | Refrescar el listado del directorio | -| Ayuda | `?` | Mostrar comandos disponibles | - -## 🔧 **Solución de Problemas** - -### **Problemas Comunes:** -- **¿El búfer de Dired no se actualiza?** Presiona `g` para refrescar -- **¿No puedes ver los detalles del archivo?** Presiona `(` para alternar la vista detallada -- **¿Las operaciones son lentas?** Usa el marcado (`m`) para operaciones por lotes -- **¿Orden de clasificación incorrecto?** Presiona `s` para ciclar entre las opciones de clasificación - -### **Consejos de Rendimiento:** -- Instala `fd` para una búsqueda de archivos más rápida -- Instala `rg` (ripgrep) para una búsqueda de texto más rápida -- Usa `rsync` para una copia de archivos eficiente -- Considera `exa` o `lsd` para listados de directorios mejorados - -### **Obteniendo Ayuda:** -- `?` - **Ayuda contextual** en cualquier búfer de Dired -- `C-h m` - **Ayuda específica del modo** -- `SPC h d f dired` - **Documentación completa de Dired** - -## 📋 **Comparación: Dired vs Treemacs** - -### **Usa Dired cuando:** -- Gestionas múltiples archivos a la vez -- Necesitas información detallada de los archivos -- Realizas operaciones por lotes -- Trabajas con permisos/propiedad de archivos - -### **Usa Treemacs cuando:** -- Necesitas una vista rápida del proyecto -- Navegación de archivos simple -- Prefieres una estructura de árbol visual -- Necesitas una barra lateral persistente - -## 🛠️ **Integración con Herramientas Externas** - -### **Herramientas Recomendadas:** -- **`rsync`** - Copia de archivos rápida y fiable con capacidad de reanudación -- **`ripgrep` (rg)** - Búsqueda de texto extremadamente rápida, mucho más rápida que grep -- **`fd`** - Alternativa rápida a find con mejores valores predeterminados -- **`exa`** - Reemplazo moderno de ls con colores e integración con git -- **`trash-cli`** - Eliminación segura a la papelera en lugar de eliminación permanente -- **`7z`** - Maneja archivos 7zip y otros formatos de compresión - -### **Instalación (Debian/Ubuntu):** -```bash -sudo apt install rsync ripgrep fd-find exa trash-cli p7zip-full -``` - -## 🎯 **Consejos Profesionales** - -- **Operaciones por lotes**: Marca los archivos primero (`m`), luego ejecuta las operaciones -- **Navegación rápida**: Usa `/` para buscar archivos por nombre -- **Editar nombres de archivo**: Usa `C-x C-q` para el modo Wdired para renombrar múltiples archivos -- **Integración con la shell**: Usa `!` para ejecutar comandos de shell en los archivos -- **Múltiples directorios**: Usa `i` para mostrar subdirectorios en el mismo búfer -- **Eliminación segura**: Instala `trash-cli` para enviar archivos a la papelera en lugar de eliminarlos permanentemente -- **Búsqueda rápida**: Instala `ripgrep` para una búsqueda de texto ultrarrápida en los archivos - -Dired proporciona una experiencia completa de gestión de archivos que se integra bien con herramientas externas de Linux, haciendo que las operaciones con archivos sean eficientes y potentes. diff --git a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md index 01e8da2..b33bd75 100644 --- a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md +++ b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./emacs.file-explorer.cheatsheet.es.md) - # Doom Emacs File Explorer Cheatsheet + ## 🗂️ **What is Dired?** Dired (Directory Editor) is Emacs' built-in file manager that allows you to navigate, manage, and manipulate files and directories efficiently. diff --git a/cheatsheets/emacs/emacs.getting-started.top10.es.md b/cheatsheets/emacs/emacs.getting-started.top10.es.md deleted file mode 100644 index bc952a9..0000000 --- a/cheatsheets/emacs/emacs.getting-started.top10.es.md +++ /dev/null @@ -1,276 +0,0 @@ -[English](./emacs.getting-started.top10.md) | Español - -# Las 10 Cosas Principales que los Nuevos Usuarios de Doom Emacs Deberían Saber -## 🚀 **Primeros Pasos con Doom Emacs** - -¡Bienvenido a Doom Emacs! Aquí están las 10 cosas más esenciales que todo nuevo usuario debería dominar para ser productivo rápidamente. - ---- - -## 1. 🗝️ **Domina la Tecla Líder: `SPC`** - -**La tecla Espacio es tu puerta de entrada a todo en Doom Emacs.** - -- `SPC` se llama la "tecla líder" - abre menús para casi todas las acciones -- Después de presionar `SPC`, verás sugerencias útiles que muestran los comandos disponibles -- Los comandos están organizados lógicamente: `SPC f` para archivos, `SPC g` para git, `SPC p` para proyectos - -**Comandos esenciales para empezar:** - -- `SPC f f` - Buscar/abrir archivos -- `SPC f s` - Guardar archivo actual -- `SPC q q` - Salir de Emacs -- `SPC h` - Menú de ayuda (¡muy importante!) - -**Consejo Profesional:** Si olvidas lo que sigue, simplemente presiona `SPC` y espera - ¡Doom te mostrará las opciones! - ---- - -## 2. 📁 **Navega por los Archivos como un Profesional** - -**La navegación de archivos es fundamental para la productividad.** - -- `SPC .` - **Abrir explorador de archivos** (Dired) en el directorio actual -- `SPC f f` - **Buscar archivo** en cualquier parte de tu sistema -- `SPC f r` - **Archivos recientes** en los que has trabajado -- `SPC SPC` - **Buscar archivo en el proyecto actual** (¡súper útil!) - -📋 _Consulta la guía completa: `emacs.file-explorer.cheatsheet.md`_ - -**Flujo de trabajo rápido:** - -1. Abre el directorio de tu proyecto en la terminal -2. Inicia Emacs: `emacs` (o `emacsclient -c` para GUI, `et` para TTY) -3. Usa `SPC .` para explorar archivos o `SPC SPC` para encontrar archivos rápidamente - ---- - -## 3. ⌨️ **Entiende el Modo Evil (Atajos de Teclado de Vim)** - -**Doom Emacs usa atajos de teclado al estilo de Vim por defecto.** - -**Movimiento básico (en modo Normal):** - -- `h j k l` - Izquierda, abajo, arriba, derecha -- `w` - Saltar a la siguiente palabra -- `b` - Saltar una palabra hacia atrás -- `gg` - Ir al principio del archivo -- `G` - Ir al final del archivo - -**Cambio de modo:** - -- `i` - Entrar en modo de Inserción (para escribir texto) -- `ESC` - Volver al modo Normal -- `v` - Modo Visual (para seleccionar texto) - -**Si no estás familiarizado con Vim:** ¡No te asustes! Puedes aprender gradualmente. Lo básico anterior te ayudará a empezar. - ---- - -## 4. 🔍 **Busca y Reemplaza Eficientemente** - -**Encontrar y cambiar texto es una tarea diaria.** - -- `/` - Buscar hacia adelante en el búfer actual -- `?` - Buscar hacia atrás en el búfer actual -- `n/N` - Resultado de búsqueda siguiente/anterior -- `SPC s s` - Buscar en el búfer actual (interactivo) -- `SPC s p` - Buscar en todo el proyecto -- `SPC s r` - Buscar y reemplazar en el búfer actual - -**Para búsquedas en todo el proyecto:** `SPC s p` es increíblemente poderoso para encontrar código en todo tu proyecto. - ---- - -## 5. 🗂️ **Trabaja con Búferes y Ventanas** - -**Los búferes son archivos abiertos, las ventanas son cómo los ves.** - -**Gestión de búferes:** - -- `SPC b b` - Cambiar entre búferes abiertos -- `SPC b k` - Matar (cerrar) el búfer actual -- `SPC b s` - Guardar el búfer actual - -**Gestión de ventanas:** - -- `SPC w v` - Dividir la ventana verticalmente -- `SPC w s` - Dividir la ventana horizontalmente -- `SPC w c` - Cerrar la ventana actual -- `SPC w w` - Cambiar entre ventanas -- `C-h j/k/h/l` - Navegar entre ventanas (estilo Vim) - -**Piénsalo de esta manera:** Puedes tener muchos archivos abiertos (búferes) pero solo ver algunos de ellos a la vez (ventanas). - ---- - -## 6. 🛠️ **Configura y Personaliza Doom** - -**Doom es altamente configurable, pero empieza de forma sencilla.** - -**Archivos clave que debes conocer:** - -- `~/.doom.d/config.el` - Tu configuración personal -- `~/.doom.d/init.el` - Habilitar/deshabilitar módulos de Doom -- `~/.doom.d/packages.el` - Añadir paquetes adicionales - -**Comandos esenciales:** - -- `SPC h r r` - Recargar la configuración de Doom -- `SPC h d h` - Ayuda y documentación de Doom -- `doom doctor` - Comprobar si hay problemas de configuración (ejecutar en la terminal) -- `doom upgrade` - Actualizar Doom (ejecutar en la terminal) - -**Empieza poco a poco:** No intentes personalizar todo de una vez. Usa primero los valores predeterminados de Doom y luego ajusta las cosas gradualmente. - ---- - -## 7. 📝 **Domina los Conceptos Básicos de Edición de Texto** - -**Comandos de edición esenciales que funcionan en cualquier modo.** - -**En modo Normal (Evil):** - -- `x` - Eliminar el carácter bajo el cursor -- `dd` - Eliminar la línea entera -- `yy` - Copiar (yank) la línea entera -- `p` - Pegar después del cursor -- `u` - Deshacer -- `C-r` - Rehacer - -**En modo de Inserción:** - -- `C-w` - Eliminar palabra hacia atrás -- `C-u` - Eliminar hasta el principio de la línea - -**Selección y manipulación:** - -- `v` - Iniciar selección visual -- `V` - Seleccionar la línea entera -- `d` - Eliminar el texto seleccionado -- `y` - Copiar el texto seleccionado - ---- - -## 8. 💻 **Usa la Autocompletación de Código y las Funciones del Lenguaje** - -**Doom viene con un excelente soporte de código de fábrica.** - -**Autocompletación:** - -- Simplemente empieza a escribir - las terminaciones aparecen automáticamente -- `TAB` - Aceptar la terminación -- `C-n/C-p` o `j/k` - Navegar por las opciones de terminación - -**Navegación de código:** - -- `gd` - Ir a la definición -- `gr` - Encontrar referencias -- `K` - Mostrar documentación -- `SPC c a` - Acciones de código (refactorizar, arreglar, etc.) - -📋 _Consulta la guía completa: `emacs.code-completion.cheatsheet.md`_ - -**Lenguajes soportados:** La mayoría de los lenguajes populares funcionan de fábrica (Python, JavaScript, C/C++, Rust, Go, etc.) - ---- - -## 9. 📚 **Usa el Sistema de Ayuda Incorporado** - -**Doom tiene una excelente documentación incorporada.** - -- `SPC h` - **Menú principal de ayuda** -- `SPC h d h` - **Ayuda específica de Doom** -- `SPC h k` - **Describir tecla** (¿qué hace esta tecla?) -- `SPC h f` - **Describir función** -- `SPC h v` - **Describir variable** -- `C-h m` - **Mostrar ayuda para el modo actual** - -**Cuando estés perdido:** Presiona `SPC h` y explora. El sistema de ayuda es completo y siempre está disponible. - -**Consejo Profesional:** Si presionas una combinación de teclas y no sabes qué pasó, usa `SPC h l` para ver los comandos recientes. - ---- - -## 10. 🔧 **Aprende la Integración con Git (Magit)** - -**Magit es una de las mejores interfaces de Git disponibles en cualquier lugar.** - -- `SPC g g` - Abrir el estado de Magit (¡tu comando principal de Git!) -- `s` - Preparar archivos o fragmentos -- `c c` - Confirmar cambios -- `P P` - Empujar al remoto -- `F F` - Traer del remoto - -📋 _Consulta la guía completa: `emacs.magit.cheatsheet.md`_ - -**Flujo de trabajo básico:** - -1. `SPC g g` - Ver qué ha cambiado -2. `s` en los archivos para prepararlos -3. `c c` para confirmar (escribe el mensaje, luego `C-c C-c`) -4. `P P` para empujar - -**Por qué es esencial:** Si trabajas con Git, Magit transformará tu flujo de trabajo. Es visual, rápido e increíblemente poderoso. - ---- - -## 🎯 **Lista de Verificación de Inicio Rápido** - -Una vez que hayas leído lo anterior, prueba este flujo de trabajo de 5 minutos: - -1. ✅ **Abre Doom:** `emacs` en la terminal -2. ✅ **Encuentra un archivo:** `SPC f f` y abre cualquier archivo de texto -3. ✅ **Edita algo:** Presiona `i`, escribe texto, presiona `ESC` -4. ✅ **Guarda:** `SPC f s` -5. ✅ **Abre el explorador de archivos:** `SPC .` -6. ✅ **Obtén ayuda:** `SPC h` -7. ✅ **Divide la ventana:** `SPC w v` -8. ✅ **Cambia de búfer:** `SPC b b` -9. ✅ **Busca en el proyecto:** `SPC s p` (si estás en un proyecto) -10. ✅ **Sal:** `SPC q q` - ---- - -## 📖 **Próximos Pasos: Profundiza** - -Una vez que te sientas cómodo con lo básico anterior: - -1. **Lee las hojas de trucos específicas:** - - `emacs.file-explorer.cheatsheet.md` - Gestión de archivos - - `emacs.code-completion.cheatsheet.md` - Funciones de codificación - - `emacs.magit.cheatsheet.md` - Integración con Git - - `emacs.markdown.cheatsheet.md` - Edición de Markdown - -2. **Personaliza gradualmente:** Empieza a ajustar tu `config.el` -3. **Aprende tu lenguaje:** Explora las funciones específicas del lenguaje -4. **Únete a la comunidad:** Discord de Doom, Reddit, discusiones de GitHub - ---- - -## 🆘 **Cuando Estés Atascado** - -**Comandos de emergencia:** - -- `C-g` - Cancelar el comando actual (como presionar ESC) -- `SPC q q` - Salir de Emacs -- `SPC h d h` - Ayuda de Doom -- `:q` - Salir del búfer actual (comando de Vim) - -**Recuerda:** Todo experto fue una vez un principiante. No intentes aprender todo de una vez. Domina estas 10 cosas primero, luego explora gradualmente funciones más avanzadas. - -**El consejo más importante:** Usa `SPC` y explora los menús. ¡Doom está diseñado para ser descubrible - deja que te guíe! - ---- - -## 🎓 **Filosofía de Aprendizaje** - -**Empieza con flujos de trabajo, no con funciones:** En lugar de memorizar cada atajo de teclado, aprende flujos de trabajo completos para las tareas que haces a diario (editar archivos, confirmar código, buscar en proyectos). - -**Usa primero los valores predeterminados:** Los valores predeterminados de Doom son excelentes. Resiste la tentación de personalizar todo de inmediato. - -**Una cosa a la vez:** Domina la navegación de archivos antes de sumergirte en funciones de código avanzadas. Construye tus habilidades de forma incremental. - -**Practica a diario:** Usa Doom para el trabajo real, incluso si al principio eres más lento. La memoria muscular se desarrolla con la práctica. - -¡Bienvenido a Doom Emacs! 🚀 diff --git a/cheatsheets/emacs/emacs.getting-started.top10.md b/cheatsheets/emacs/emacs.getting-started.top10.md index 8ae5f12..3405622 100644 --- a/cheatsheets/emacs/emacs.getting-started.top10.md +++ b/cheatsheets/emacs/emacs.getting-started.top10.md @@ -1,6 +1,5 @@ -English | [Español](./emacs.getting-started.top10.es.md) - # Top 10 Things New Doom Emacs Users Should Know + ## 🚀 **Getting Started with Doom Emacs** Welcome to Doom Emacs! Here are the 10 most essential things every new user @@ -43,7 +42,7 @@ will show you the options! **Quick workflow:** 1. Open your project directory in terminal -2. Start Emacs: `emacs` (or `emacsclient -c` for GUI, `et` for TTY) +2. Start Emacs: `emacs` or `doom run` 3. Use `SPC .` to browse files or `SPC SPC` to quickly find files --- diff --git a/cheatsheets/emacs/emacs.magit.cheatsheet.es.md b/cheatsheets/emacs/emacs.magit.cheatsheet.es.md deleted file mode 100644 index 15e23e1..0000000 --- a/cheatsheets/emacs/emacs.magit.cheatsheet.es.md +++ /dev/null @@ -1,276 +0,0 @@ -[English](./emacs.magit.cheatsheet.md) | Español - -# Cheatsheet de Magit para Doom Emacs -## 🚀 **¿Qué es Magit?** - -Magit es una herramienta extremadamente poderosa para gestionar tu proyecto de Git. - -- Flujos de trabajo de Git visuales e interactivos -- Prepara para confirmación (stage) fragmentos (hunks), líneas o archivos completos con facilidad -- Confirma (commit), empuja (push), trae (pull), fusiona (merge), reorganiza (rebase) - todo desde menús intuitivos -- Ve el estado de tu repositorio de un vistazo - -## 📋 **Requisitos** - -- Git instalado en tu sistema -- Doom Emacs con Magit habilitado (incluido por defecto) -- Estar trabajando dentro de un repositorio de Git - -## ⌨️ **Abriendo Magit** - -### **Interfaz Principal de Magit:** - -- `SPC g g` - **Estado de Magit** (¡tu comando principal!) -- `SPC g d` - **Despacho de archivos de Magit** -- `SPC g f` - **Comandos de archivo de Magit** -- `SPC g l` - **Registro (log) de Magit** -- `SPC g b` - **Culpar (blame) de Magit** - -## 🎯 **El Búfer de Estado de Magit** (Tu Centro de Mando) - -### **Navegación:** - -- `j/k` o `n/p` - **Moverse arriba/abajo** entre secciones -- `TAB` - **Expandir/contraer** la sección bajo el cursor -- `M-TAB` - **Expandir/contraer** todas las secciones -- `g` - **Refrescar** el búfer de estado - -### **Resumen de Secciones:** - -``` -Archivos sin seguimiento - Archivos que no están en Git -Cambios sin preparar - Archivos modificados no preparados para confirmación -Cambios preparados - Archivos listos para confirmar -Confirmaciones recientes - Tu historial de confirmaciones -Aliijos (Stashes) - Tu trabajo en progreso guardado -``` - -## 📝 **Preparando y Despreparando (Staging & Unstaging)** - -### **Preparar Archivos:** - -- `s` - **Preparar** archivo/fragmento bajo el cursor -- `S` - **Preparar todos** los cambios sin preparar -- `i` - **Ignorar** archivo (añadir a .gitignore) - -### **Despreparar Archivos:** - -- `u` - **Despreparar** archivo/fragmento bajo el cursor -- `U` - **Despreparar todos** los cambios preparados - -### **Descartar Cambios:** - -- `k` - **Descartar** cambios en el archivo/fragmento bajo el cursor -- `K` - **Descartar todos** los cambios en el directorio de trabajo - -### **Preparando Fragmentos y Líneas:** - -- `RET` o `SPC` - **Mostrar diferencias (diff)** del archivo bajo el cursor -- En la vista de diferencias: - - `s` - **Preparar fragmento** bajo el cursor - - `u` - **Despreparar fragmento** bajo el cursor - - `k` - **Descartar fragmento** bajo el cursor - - `+/-` - **Mostrar más/menos** líneas de contexto - -## 💾 **Confirmando (Committing)** - -### **Crear Confirmaciones:** - -- `c c` - **Confirmar** (abre el búfer de mensaje de confirmación) -- `c a` - **Enmendar** la última confirmación -- `c e` - **Extender** la última confirmación (sin cambio de mensaje) -- `c w` - **Reescribir** el mensaje de la última confirmación -- `c f` - **Arreglar (fixup)** una confirmación -- `c s` - **Aplastar (squash)** una confirmación - -### **En el Búfer de Mensaje de Confirmación:** - -- `C-c C-c` - **Finalizar confirmación** -- `C-c C-k` - **Cancelar confirmación** -- `M-p/M-n` - **Mensaje de confirmación anterior/siguiente** del historial - -## 🌿 **Ramas y Cambio (Branching & Switching)** - -### **Operaciones con Ramas:** - -- `b b` - **Cambiar de rama** (checkout) -- `b c` - **Crear nueva rama** -- `b n` - **Crear rama** desde el HEAD actual -- `b s` - **Crear rama** y cambiar a ella -- `b r` - **Renombrar rama** -- `b k` - **Eliminar rama** - -### **Ramas Remotas:** - -- `b a` - **Establecer rama de seguimiento (upstream)** para la rama actual -- `b u` - **Establecer rama de seguimiento** y empujar - -## 🔄 **Operaciones Remotas** - -### **Traer y Actualizar (Fetch & Pull):** - -- `f f` - **Traer** desde el remoto predeterminado -- `f a` - **Traer desde todos** los remotos -- `F F` - **Actualizar** desde la rama de seguimiento -- `F u` - **Actualizar desde la rama de seguimiento** (rebase) - -### **Empujar (Push):** - -- `P P` - **Empujar** a la rama de seguimiento -- `P u` - **Empujar y establecer rama de seguimiento** -- `P f` - **Forzar empuje** (¡úsalo con cuidado!) -- `P t` - **Empujar etiquetas** - -## 📚 **Viendo Historial y Registros** - -### **Vistas de Registro:** - -- `l l` - **Mostrar registro** para la rama actual -- `l o` - **Mostrar registro** para otras ramas -- `l h` - **Mostrar registro** para HEAD -- `l a` - **Mostrar registro** para todas las ramas -- `l f` - **Mostrar registro** para el archivo bajo el cursor - -### **En la Vista de Registro:** - -- `RET` - **Mostrar detalles** de la confirmación -- `d d` - **Mostrar diferencias** para la confirmación -- `c c` - **Crear nueva confirmación** -- `r r` - **Revertir confirmación** - -## 🔍 **Diferencias y Comparaciones** - -### **Comandos de Diferencias:** - -- `d d` - **Diferencias del directorio de trabajo** vs preparado -- `d s` - **Diferencias de lo preparado** vs HEAD -- `d u` - **Diferencias de los cambios sin preparar** -- `d r` - **Diferencias de un rango** entre confirmaciones - -### **En las Vistas de Diferencias:** - -- `j/k` - **Navegar** entre fragmentos -- `n/p` - **Archivo siguiente/anterior** -- `TAB` - **Alternar** visibilidad de la sección de diferencias -- `+/-` - **Aumentar/disminuir** líneas de contexto - -## 🔧 **Reorganizando y Fusionando (Rebasing & Merging)** - -### **Fusionar:** - -- `m m` - **Fusionar** rama -- `m a` - **Abortar fusión** -- `m c` - **Continuar fusión** - -### **Reorganizar:** - -- `r i` - **Reorganización interactiva** -- `r r` - **Reorganizar** rama -- `r a` - **Abortar reorganización** -- `r c` - **Continuar reorganización** - -### **Durante la Reorganización Interactiva:** - -- `j/k` - **Moverse** entre confirmaciones -- `p` - **Elegir (pick)** confirmación (predeterminado) -- `r` - **Reescribir (reword)** mensaje de confirmación -- `e` - **Editar (edit)** confirmación -- `s` - **Aplastar (squash)** confirmación -- `f` - **Arreglar (fixup)** confirmación -- `d` - **Descartar (drop)** confirmación - -## 📦 **Aliijos (Stashing)** - -### **Operaciones con Aliijos:** - -- `z z` - **Alijar** los cambios actuales -- `z i` - **Alijar** con mensaje -- `z a` - **Aplicar alijo** -- `z p` - **Sacar alijo** (aplicar y eliminar) -- `z k` - **Descartar alijo** -- `z l` - **Listar alijos** - -## 🏷️ **Etiquetas (Tags)** - -### **Operaciones con Etiquetas:** - -- `t t` - **Crear etiqueta** -- `t a` - **Crear etiqueta anotada** -- `t k` - **Eliminar etiqueta** -- `t p` - **Empujar etiqueta** - -## ⚡ **Consejos Profesionales y Flujos de Trabajo** - -### **Flujo de Trabajo Diario de Git:** - -1. `SPC g g` - **Abrir estado de Magit** -2. Revisar cambios, preparar con `s` -3. `c c` - **Confirmar cambios** -4. `P P` - **Empujar al remoto** - -### **Trucos de Usuario Avanzado:** - -- Usa `M-x magit-find-file` para abrir rápidamente archivos del historial de Git -- `SPC g f s` - **Preparar archivo actual** sin abrir Magit -- `SPC g f u` - **Despreparar archivo actual** -- `SPC g f d` - **Mostrar diferencias del archivo** - -### **Granularidad de la Preparación:** - -- Prepara archivos completos con `s` en el búfer de estado -- Prepara fragmentos individuales entrando en la vista de diferencias (`RET`) y luego `s` -- Prepara líneas individuales seleccionando una región en la diferencia y luego `s` - -### **Buenas Prácticas de Confirmación:** - -- Usa `c c` para confirmaciones normales -- Usa `c a` para arreglar tu última confirmación -- Usa `c f` para crear confirmaciones de arreglo para una reorganización interactiva posterior - -## 🔧 **Solución de Problemas** - -### **Problemas Comunes:** - -- **¿Magit no se abre?** Asegúrate de estar en un repositorio de Git -- **¿Rendimiento lento?** Prueba `M-x magit-refresh` o reinicia Emacs -- **¿Conflictos de fusión?** Magit resalta los conflictos - resuélvelos y usa `m c` - -### **Obteniendo Ayuda:** - -- `?` - **Mostrar ayuda** en cualquier búfer de Magit -- `C-h m` - **Mostrar ayuda del modo** -- `SPC h d m magit` - **Documentación completa de Magit** - -## 🚀 **Flujo de Trabajo de Inicio Rápido** - -1. **Navega a tu repositorio de Git** en Doom Emacs -2. **Presiona `SPC g g`** - Abre el estado de Magit -3. **Prepara archivos** con `s`, revisa las diferencias con `RET` -4. **Confirma** con `c c`, escribe el mensaje, finaliza con `C-c C-c` -5. **Empuja** con `P P` - -## 📚 **Resumen de Atajos Esenciales** - -| Acción | Tecla | Descripción | -| --------- | --------- | -------------------- | -| Estado | `SPC g g` | Abrir estado de Magit| -| Preparar | `s` | Preparar archivo/fragmento | -| Despreparar| `u` | Despreparar archivo/fragmento | -| Confirmar | `c c` | Crear confirmación | -| Empujar | `P P` | Empujar a la rama de seguimiento | -| Actualizar| `F F` | Actualizar desde la rama de seguimiento | -| Rama | `b b` | Cambiar de rama | -| Registro | `l l` | Mostrar registro | -| Diferencias| `d d` | Mostrar diferencias | -| Alijar | `z z` | Alijar cambios | -| Ayuda | `?` | Mostrar ayuda contextual | - -## 🎉 **Por Qué Magit es Increíble** - -- **Visual**: Ve todo el estado de tu repositorio de un vistazo -- **Interactivo**: Prepara fragmentos, líneas o archivos con simples pulsaciones de teclas -- **Rápido**: Navega por las operaciones de Git más rápido que cualquier CLI -- **Potente**: Accede a todas las funciones de Git a través de menús intuitivos -- **Integrado**: Funciona perfectamente con Doom Emacs y el modo Evil - -**Consejo Profesional**: Una vez que aprendas Magit, ¡nunca más querrás usar Git desde la línea de comandos! 🚀 diff --git a/cheatsheets/emacs/emacs.magit.cheatsheet.md b/cheatsheets/emacs/emacs.magit.cheatsheet.md index 96d2a2f..0ccc062 100644 --- a/cheatsheets/emacs/emacs.magit.cheatsheet.md +++ b/cheatsheets/emacs/emacs.magit.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./emacs.magit.cheatsheet.es.md) - # Doom Emacs Magit Cheatsheet + ## 🚀 **What is Magit?** Magit is an extremely powerful tool for managing your Git project diff --git a/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md b/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md deleted file mode 100644 index 2e3c315..0000000 --- a/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md +++ /dev/null @@ -1,86 +0,0 @@ -[English](./emacs.markdown.cheatsheet.md) | Español - -# Cheatsheet de Markdown para Doom Emacs -## 📝 **Primeros Pasos** -- Abre cualquier archivo `.md` - Doom habilita automáticamente `markdown-mode` -- Obtendrás resaltado de sintaxis, sangría adecuada y características específicas de markdown - -## ⌨️ **Comandos Clave de Markdown** (con atajos de Evil/Vim) - -### **Formato de Texto:** -- `SPC m b` - Texto en **negrita** -- `SPC m i` - Texto en *cursiva* -- `SPC m c` - `Código en línea` -- `SPC m C` - Bloque de código -- `SPC m s` - ~~Tachado~~ - -### **Encabezados:** -- `SPC m h` - Insertar encabezado (solicita el nivel 1-6) -- `SPC m H` - Insertar encabezado con estilo de subrayado - -### **Listas:** -- `SPC m l` - Insertar elemento de lista no ordenada -- `SPC m L` - Insertar elemento de lista ordenada - -### **Enlaces e Imágenes:** -- `SPC m l l` - Insertar enlace -- `SPC m l i` - Insertar imagen -- `SPC m l u` - Insertar URL - -### **Navegación:** -- `]]` - Siguiente encabezado -- `[[` - Encabezado anterior -- `SPC m o` - Abrir esquema/tabla de contenidos - -## 👁️ **Vista Previa en Vivo** -- `SPC m p` - Vista previa en el navegador -- `SPC m P` - Exportar a HTML - -## 📊 **Tablas** -- `SPC m t` - Comandos de tabla -- `SPC m t t` - Insertar tabla -- `TAB` - Navegar entre celdas -- `S-TAB` - Navegar hacia atrás entre celdas - -## 🎯 **Atajos Útiles de Evil en Markdown** -- `TAB` - Ciclar el plegado de encabezados -- `S-TAB` - Ciclar el plegado globalmente -- `RET` - Seguir enlaces -- `M-RET` - Insertar nuevo elemento de lista - -## 🧪 **Ejemplos de Prueba** - -### Formato de Muestra -Este es **texto en negrita** y este es *texto en cursiva*. - -Aquí hay algo de `código en línea` y un bloque de código: - -```bash -# Ejemplo de bloque de código -echo "¡Hola desde markdown!" -``` - -### Lista de Muestra -- [ ] Elemento de casilla de verificación 1 -- [x] Casilla de verificación completada -- Punto de viñeta normal - -### Tabla de Muestra -| Característica | Atajo | Descripción | -|----------------|---------|--------------------------| -| Negrita | SPC m b | Poner texto en negrita | -| Cursiva | SPC m i | Poner texto en cursiva | -| Vista Previa | SPC m p | Vista previa en el navegador | - -## 🚀 **Consejos Profesionales** -1. Usa `SPC m o` para obtener una vista de esquema para la navegación -2. `TAB` en los encabezados para plegar/desplegar secciones -3. `RET` en los enlaces para seguirlos -4. Usa `SPC m p` para previsualizar tu markdown en un navegador -5. Crea listas de verificación con la sintaxis `- [ ]` - -## 📚 **Referencia Rápida** -- Todos los comandos de markdown comienzan con `SPC m` -- Usa `SPC m ?` o `C-h m` para ver todos los comandos disponibles -- Navegación entre encabezados: `]]` (siguiente) y `[[` (anterior) -- Alternar plegado: `TAB` (local) y `S-TAB` (global) diff --git a/cheatsheets/emacs/emacs.markdown.cheatsheet.md b/cheatsheets/emacs/emacs.markdown.cheatsheet.md index 43b8017..0e91631 100644 --- a/cheatsheets/emacs/emacs.markdown.cheatsheet.md +++ b/cheatsheets/emacs/emacs.markdown.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./emacs.markdown.cheatsheet.es.md) - # Doom Emacs Markdown Cheatsheet + ## 📝 **Getting Started** - Open any `.md` file - Doom automatically enables `markdown-mode` - You'll get syntax highlighting, proper indentation, and markdown-specific features diff --git a/cheatsheets/emacs/emacs.nix.cheatsheet.es.md b/cheatsheets/emacs/emacs.nix.cheatsheet.es.md deleted file mode 100644 index f92b0cc..0000000 --- a/cheatsheets/emacs/emacs.nix.cheatsheet.es.md +++ /dev/null @@ -1,45 +0,0 @@ -Español | [English](./emacs.nix.cheatsheet.md) - -# Guía Rápida: Doom Emacs + Nix - -Esta guía enumera los comandos de Nix y los atajos configurados en tu Doom Emacs. - -## Requisitos -- Módulo de Doom habilitado: `(nix +tree-sitter +lsp)` en `~/.doom.d/init.el` -- Paquetes instalados (en `~/.doom.d/packages.el`): `nix`, `nix-update`, `nixos-options` -- Herramientas Nix disponibles en el sistema: `nix`, `nixfmt` (o tu formateador preferido) -- Opcional pero recomendado: `nil` (LSP de Nix) - -## Convenciones de teclas (Leader) -- `SPC` = tecla líder de Doom -- `SPC m` = menú del modo mayor (contextual al buffer actual, p. ej., buffers Nix) - -## Atajos para Nix -- `SPC m f` → `nix-format-buffer` — Formatea el buffer Nix actual (usa `nixfmt` por defecto) -- `SPC m b` → `nix-build` — Construye la derivación/expresión actual -- `SPC m s` → `nix-shell` — Abre un `nix-shell` -- `SPC m u` → `nix-unpack` — Desempaqueta una fuente de Nix -- `SPC m r` → `nix-repl-show` — Muestra información de símbolo en el REPL de Nix -- `SPC m U` → `nix-update-fetch` — Actualiza fetchers/hashes en expresiones Nix -- `SPC m o` → `+nix/lookup-option` — Busca una opción de NixOS (requiere `:tools lookup` y `nixos-options`) - -## Referencia de comandos -- `nix-format-buffer`: Formatea el buffer usando `nixfmt`. - - Configuración: `(setq nix-nixfmt-bin "nixfmt")`. - - Consejo: ¿Prefieres otro formateador? Instálalo y ajusta `nix-nixfmt-bin` (p. ej., `"alejandra"` o `"nixpkgs-fmt"`). -- `nix-build`: Inicia una construcción para el archivo/contexto actual. -- `nix-shell`: Abre un shell de desarrollo derivado de la expresión Nix actual. -- `nix-unpack`: Desempaqueta la fuente de una derivación (útil para inspeccionar fuentes). -- `nix-repl-show`: Muestra información de símbolo desde una sesión del REPL de Nix. -- `nix-update-fetch`: Actualiza atributos de fetcher (rev, sha256, etc.). -- `+nix/lookup-option`: Salta a la documentación de una opción de NixOS usando la integración con `nixos-options`. - -## Consejos -- Asegúrate de estar editando un archivo `.nix` para que `SPC m` (modo mayor) esté disponible. -- Para funciones LSP (documentación, autocompletado, diagnósticos), verifica que el servidor `nil` esté instalado y activo. - -## Solución de problemas -- ¿Comandos no disponibles en Emacs? Ejecuta `~/.emacs.d/bin/doom sync` y reinicia Emacs. -- ¿El formateador no funciona? Verifica que `nixfmt` (u otro) esté en tu PATH y que `nix-nixfmt-bin` coincida con su nombre. -- ¿La búsqueda de opciones no funciona? Asegúrate de tener `nixos-options` instalado y que `:tools lookup` esté habilitado en Doom. - diff --git a/cheatsheets/emacs/emacs.nix.cheatsheet.md b/cheatsheets/emacs/emacs.nix.cheatsheet.md deleted file mode 100644 index fa59dce..0000000 --- a/cheatsheets/emacs/emacs.nix.cheatsheet.md +++ /dev/null @@ -1,45 +0,0 @@ -English | [Español](./emacs.nix.cheatsheet.es.md) - -# Doom Emacs + Nix Cheatsheet - -This guide lists the Nix commands and keybindings configured in your Doom Emacs. - -## Requirements -- Doom module enabled: `(nix +tree-sitter +lsp)` in `~/.doom.d/init.el` -- Packages installed (via `~/.doom.d/packages.el`): `nix`, `nix-update`, `nixos-options` -- Nix tooling available on system: `nix`, `nixfmt` (or your preferred formatter) -- Optional but recommended: `nil` (Nix LSP) - -## Leader key conventions -- `SPC` = Doom leader -- `SPC m` = Major mode menu (contextual to current buffer, e.g., Nix buffers) - -## Nix keybindings -- `SPC m f` → `nix-format-buffer` — Format current Nix buffer (uses `nixfmt` by default) -- `SPC m b` → `nix-build` — Build the current derivation / expression -- `SPC m s` → `nix-shell` — Open a `nix-shell` -- `SPC m u` → `nix-unpack` — Unpack a Nix source -- `SPC m r` → `nix-repl-show` — Show symbol info in Nix REPL -- `SPC m U` → `nix-update-fetch` — Update fetchers/hashes in Nix expressions -- `SPC m o` → `+nix/lookup-option` — Lookup NixOS option (requires `:tools lookup` and `nixos-options`) - -## Command reference -- `nix-format-buffer`: Formats the current buffer using `nixfmt`. - - Configured via `(setq nix-nixfmt-bin "nixfmt")`. - - Tip: Prefer a different formatter? Install it and set `nix-nixfmt-bin` accordingly (e.g., `"alejandra"` or `"nixpkgs-fmt"`). -- `nix-build`: Triggers a build for the current file/context. -- `nix-shell`: Opens a development shell derived from the current Nix expression. -- `nix-unpack`: Unpacks the source for a derivation (useful to inspect sources). -- `nix-repl-show`: Displays symbol info from a Nix REPL session. -- `nix-update-fetch`: Updates fetcher attributes (rev, sha256, etc.). -- `+nix/lookup-option`: Jumps to documentation for a NixOS option using `nixos-options` integration. - -## Tips -- Ensure you are editing a `.nix` file so the `SPC m` (major mode) bindings are available. -- For LSP features (hover docs, completion, diagnostics), make sure the `nil` language server is installed and running. - -## Troubleshooting -- Commands not found in Emacs? Run `~/.emacs.d/bin/doom sync`, then restart Emacs. -- Formatter not working? Verify `nixfmt` (or chosen formatter) is on your PATH and `nix-nixfmt-bin` matches its name. -- Option lookup not working? Ensure `nixos-options` is installed and Doom’s `:tools lookup` is enabled. - diff --git a/cheatsheets/ghostty/ghostty.cheatsheet.es.md b/cheatsheets/ghostty/ghostty.cheatsheet.es.md deleted file mode 100644 index 01e8cd9..0000000 --- a/cheatsheets/ghostty/ghostty.cheatsheet.es.md +++ /dev/null @@ -1,123 +0,0 @@ -[English](./ghostty.cheatsheet.md) | Español - -# Ghostty en ZaneyOS — Resumen y Cheatsheet -## 🚀 Resumen de modules/home/terminals/ghostty.nix - -- Programa - - Ghostty habilitado con el paquete de Nix: pkgs.ghostty - - Integraciones de shell: Fish, Zsh, Bash - - clearDefaultKeybinds = true (todos los atajos se definen explícitamente a continuación) - -- Apariencia - - Título: ZaneyOS-GhosTTY - - TERM: xterm-256color - - Tema: oscuro: catppuccin-mocha; claro: catppuccin-mocha - - Tema de la ventana: oscuro - - Fuente: Maple Mono NF, tamaño 12 - - Ajuste de altura de celda: +10% - - Opacidad del fondo: 1.00 (opaco) - - Radio de desenfoque del fondo: 60 - - Estilo del cursor: barra - - Colores de selección: fondo #2d3f76, frente #c8d3f5 - - Opacidad de división sin foco: 0.5 - - Posición de terminal rápida: centro - -- Ventana y Comportamiento - - Tamaño de ventana predeterminado: 110x32 (columnas x filas) - - Confirmar cierre de superficie: false - - Esperar después del comando: false - - Integración de shell: detectar; características: cursor, sudo - - Estado de guardado de ventana: siempre - - Instancia única de GTK: true - - Ratón: ocultar al escribir: true - -- Atajos de Teclado (esquema de prefijo Super/Alt) - - El acorde personalizado tipo líder usa Alt+s y luego la tecla, ej. alt+s>c - - Portapapeles estándar y tamaño de fuente con acordes Ctrl+Shift - - Pestañas, divisiones, navegación, zoom, ecualizar definidos a continuación - ---- - -## 🗝️ Cheatsheet de Atajos de Teclado - -Portapapeles -- Ctrl+Shift+C — copy_to_clipboard -- Ctrl+Shift+V — paste_from_clipboard - -Tamaño de fuente -- Ctrl+Shift+= (más) — increase_font_size:1 -- Ctrl+Shift+- (menos) — decrease_font_size:1 -- Ctrl+Shift+0 — reset_font_size - -Sesión -- Alt+s r — reload_config -- Alt+s x — close_surface -- Alt+s n — new_window - -Pestañas -- Alt+s c — new_tab -- Alt+s Shift+L — next_tab -- Alt+s Shift+H — previous_tab -- Alt+s , — move_tab:-1 -- Alt+s . — move_tab:+1 -- Alt+s 1..9 — goto_tab:N - -Divisiones -- Alt+s \ — new_split:right -- Alt+s - — new_split:down -- Alt+s j — goto_split:bottom -- Alt+s k — goto_split:top -- Alt+s h — goto_split:left -- Alt+s l — goto_split:right -- Alt+s z — toggle_split_zoom -- Alt+s e — equalize_splits - -Notas -- clearDefaultKeybinds = true significa que solo los anteriores están activos. -- La notación Alt+s> denota un acorde de dos teclas: mantén presionado Alt, presiona s, luego la siguiente tecla. - ---- - -## ⚙️ Referencia de Opciones Predeterminadas (según configuración) - -Terminal y ventana -- term: xterm-256color -- window-width: 110 -- window-height: 32 -- window-theme: dark -- window-save-state: always -- gtk-single-instance: true -- quick-terminal-position: center - -Apariencia -- theme: catppuccin-mocha (oscuro y claro mapeados a mocha) -- font-family: Maple Mono NF -- font-size: 12 -- adjust-cell-height: 10% -- background-opacity: 1.00 -- background-blur-radius: 60 -- selection-background: #2d3f76 -- selection-foreground: #c8d3f5 -- cursor-style: bar -- unfocused-split-opacity: 0.5 - -Comportamiento -- confirm-close-surface: false -- mouse-hide-while-typing: true -- wait-after-command: false -- shell-integration: detect -- shell-integration-features: cursor,sudo - -Integraciones -- Integraciones de Fish, Zsh, Bash habilitadas - ---- - -## 📝 Notas de Estilo/Formato - -Este cheatsheet refleja el estilo de tus cheatsheets de Emacs: -- Encabezados de sección claros con emoji -- Listas con viñetas con descripciones concisas -- Bloques cortos de "Notas" para comportamientos especiales - -Si lo deseas, puedo enlazar esto desde un índice central o agregar más consejos de Ghostty (temas, indicadores de rendimiento, solución de problemas). diff --git a/cheatsheets/ghostty/ghostty.cheatsheet.md b/cheatsheets/ghostty/ghostty.cheatsheet.md index ad1634b..f7c069f 100644 --- a/cheatsheets/ghostty/ghostty.cheatsheet.md +++ b/cheatsheets/ghostty/ghostty.cheatsheet.md @@ -1,6 +1,5 @@ -English | [Español](./ghostty.cheatsheet.es.md) +# Ghostty on ddubsOS — Summary & Cheatsheet -# Ghostty on ZaneyOS — Summary & Cheatsheet ## 🚀 Summary of modules/home/terminals/ghostty.nix - Program @@ -9,7 +8,7 @@ English | [Español](./ghostty.cheatsheet.es.md) - clearDefaultKeybinds = true (all bindings are explicitly defined below) - Appearance - - Title: ZaneyOS-GhosTTY + - Title: ddubsOS-GhosTTY - TERM: xterm-256color - Theme: dark: catppuccin-mocha; light: catppuccin-mocha - Window theme: dark diff --git a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md deleted file mode 100644 index 95b2bae..0000000 --- a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md +++ /dev/null @@ -1,213 +0,0 @@ -# Cómo tematizar o añadir Waybars en ZaneyOS - -Esta guía muestra cómo ZaneyOS selecciona y configura Waybar, cómo añadir tu propio módulo de Waybar y cómo personalizar fuentes, tamaños, colores, iconos, widgets y layout. También indica dónde colocar scripts y una nota crítica sobre git add para evitar fallos de rebuild. - -## Módulos Waybar disponibles -Guardados en modules/home/waybar/: -- waybar-tony.nix -- waybar-ddubs.nix -- waybar-ddubsos-v1.nix -- waybar-dwm.nix -- waybar-curved.nix -- waybar-simple.nix -- waybar-ddubs-2.nix -- waybar-mecha.nix -- waybar-dwm2.nix -- waybar-nekodyke.nix -- Jerry-waybar.nix - -## Dónde seleccionas tu Waybar -Selecciona el módulo en hosts/default/variables.nix vía waybarChoice. Ejemplo (extracto real): -```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=73 - # Set Waybar - # Includes alternates such as: - # Comment out the current choice and uncomment the one you want - #waybarChoice = ../../modules/home/waybar/waybar-curved.nix; - #waybarChoice = ../../modules/home/waybar/Jerry-waybars.nix; - #waybarChoice = ../../modules/home/waybar/waybar-simple.nix; - #waybarChoice = ../../modules/home/waybar/waybar-mecha.nix; - #waybarChoice = ../../modules/home/waybar/waybar-nekodyke.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; - waybarChoice = ../../modules/home/waybar/waybar-tony.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; -``` -Notas: -- Asegúrate de que la ruta coincide con un archivo real bajo modules/home/waybar/. Por ejemplo, la lista incluye Jerry-waybar.nix (singular) pero el comentario muestra Jerry-waybars.nix (plural). Usa el nombre correcto para evitar errores de build. - -## CRÍTICO: usa git add o fallará el rebuild -Cuando añadas un archivo Waybar o scripts que use, debes prepararlos con git antes de reconstruir, o Nix no verá esas rutas y fallará la build. -- Ejemplo: -```bash path=null start=null -# Añade tu módulo y scripts -git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/my-widget.sh -# Commit (opcional pero recomendado) -git commit -m "Add my Waybar module and widget script" -``` - -## Cómo están estructurados los módulos Waybar aquí -- Exponen un módulo de Home Manager que define programs.waybar.settings (config estilo JSON) y programs.waybar.style (CSS). -- Copian scripts auxiliares a ~/.config/waybar/scripts desde un directorio compartido scripts. - -Ejemplo: waybar-tony.nix copia scripts y define config y CSS de Waybar: -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=15 - # Configure & Theme Waybar (Tony) - home.file = builtins.listToAttrs (map - (name: { - name = ".config/waybar/scripts/" + name; - value = { - source = "${scriptsDir}/${name}"; - executable = true; - }; - }) - scripts); - - programs.waybar = { - enable = true; - package = pkgs.waybar; - settings = [ - { - layer = "top"; - position = "top"; - height = 30; - spacing = 4; - modules-left = [ - "custom/startmenu" "hyprland/workspaces" "custom/sep" "tray" "custom/sep" "hyprland/window" "custom/sep" - ]; - modules-center = [ "custom/sep" "idle_inhibitor" "custom/notification" "custom/sep" ]; - modules-right = [ "custom/sep" "pulseaudio" "network" "cpu" "memory" "clock" "custom/sep" "custom/power" ]; - # ... component configs ... - } - ]; - style = concatStrings [ - '' - @define-color bg #1a1b26; - @define-color fg #a9b1d6; - * { font-family: "JetBrainsMono Nerd Font", monospace; font-size: 16px; font-weight: bold; } - window#waybar { background-color: @bg; color: @fg; } - #workspaces button { padding: 0 6px; color: @cyn; } - #clock { color: @cyn; border-bottom: 4px solid @cyn; } - #pulseaudio { color: @blu; border-bottom: 4px solid @blu; } - #idle_inhibitor.activated { color: @grn; border-bottom: 4px solid @grn; } - '' - ]; - }; -``` -Puntos clave: -- El layout se controla con modules-left, modules-center y modules-right. -- La configuración de cada módulo (p. ej., hyprland/workspaces, pulseaudio) va en el mismo objeto. -- El CSS controla tipografías, tamaños, colores, bordes y espaciado. -- scriptsDir = ./scripts relativo al archivo; se instalan en ~/.config/waybar/scripts y se marcan como ejecutables. - -## Añadir tu propio Waybar (paso a paso) -1) Copia un módulo como base: -```bash path=null start=null -cp modules/home/waybar/waybar-simple.nix modules/home/waybar/my-waybar.nix -``` -2) (Opcional) Añade scripts auxiliares en modules/home/waybar/scripts/. -3) Apunta variables.nix a tu módulo: -```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=81 - #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; - waybarChoice = ../../modules/home/waybar/waybar-tony.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; -``` -Cámbialo a: -```nix path=null start=null -waybarChoice = ../../modules/home/waybar/my-waybar.nix; -``` -4) Prepara los archivos antes de reconstruir (crítico): -```bash path=null start=null -git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/* -``` -5) Reconstruye como siempre. - -## Ejemplos de personalización -1) Cambiar tipografía y tamaño (CSS) -```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=207 -* { - font-family: "JetBrainsMono Nerd Font", monospace; - font-size: 16px; - font-weight: bold; -} -``` -2) Mover widgets izquierda/centro/derecha -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-simple.nix start=28 -modules-center = [ "hyprland/workspaces" ]; -modules-left = [ "custom/startmenu" "custom/arrow6" "pulseaudio" "cpu" "memory" "idle_inhibitor" "custom/arrow7" "hyprland/window" ]; -modules-right = [ "custom/arrow4" "custom/hyprbindings" "custom/arrow3" "custom/notification" "custom/arrow3" "custom/power" "battery" "custom/arrow2" "tray" "custom/arrow1" "clock" ]; -``` -3) Cambiar colores y estilos de botones -```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=218 -#workspaces button { - padding: 0 6px; - color: @cyn; - background: transparent; - border-bottom: 3px solid @bg; -} -#workspaces button.active { - color: @cyn; - border-bottom: 3px solid @mag; -} -``` -4) Añadir iconos o cambiar etiquetas -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=104 -"pulseaudio" = { - format = "{icon} {volume}% {format_source}"; - format-icons = { - headphone = ""; - default = [ "" "" "" ]; - }; -}; -``` -5) Añadir un widget que ejecute un script -```nix path=null start=null -"custom/mywidget" = { - exec = "~/.config/waybar/scripts/my-widget.sh"; - return-type = "json"; - interval = 5; - format = "{}"; - on-click = "kitty -e my-tool"; -}; -``` -6) Hacer la barra flotante o acoplada -```nix path=null start=null -settings = [ - { - layer = "top"; - position = "top"; - mode = "overlay"; - # ... - } -]; -``` -```css path=null start=null -window#waybar { - background: rgba(0, 0, 0, 0.6); - margin: 6px 10px; - border-radius: 12px; -} -``` - -## Dónde guardar scripts usados por widgets -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=14 -home.file = builtins.listToAttrs (map (name: { - name = ".config/waybar/scripts/" + name; - value = { source = "${scriptsDir}/${name}"; executable = true; }; -}) scripts); -``` -Copia todo desde ./scripts a ~/.config/waybar/scripts y marca ejecutable. - -## Solución de problemas -- Fallo de ruta: asegúrate de hacer git add de los archivos nuevos. -- Nombre incorrecto en variables.nix: usa exactamente el nombre real. -- Iconos faltan: instala una Nerd Font (p. ej., JetBrainsMono Nerd Font) y selecciónala en CSS. -- Widgets faltan: confírmalos en modules-left/center/right y su bloque de config. - -## Receta rápida -1) Crea modules/home/waybar/my-waybar.nix (copia uno y edítalo) -2) Añade scripts en modules/home/waybar/scripts/ -3) En variables.nix: -```nix path=null start=null -waybarChoice = ../../modules/home/waybar/my-waybar.nix; -``` -4) git add de los archivos -5) Reconstruye. diff --git a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md deleted file mode 100644 index 154b680..0000000 --- a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md +++ /dev/null @@ -1,254 +0,0 @@ -# How to theme or add Waybars in ZaneyOS - -This guide shows how ZaneyOS selects and configures Waybar, how to add your own Waybar module, and how to customize fonts, sizes, colors, icons, widgets, and layout. It also calls out where to put scripts and a critical note about git add to avoid rebuild failures. - - -## Current Waybar modules available -Saved in modules/home/waybar/: -- waybar-tony.nix -- waybar-ddubs.nix -- waybar-ddubsos-v1.nix -- waybar-dwm.nix -- waybar-curved.nix -- waybar-simple.nix -- waybar-ddubs-2.nix -- waybar-mecha.nix -- waybar-dwm2.nix -- waybar-nekodyke.nix -- Jerry-waybar.nix -- waybar-TheBlackDon.nix - - -## Where you select your Waybar -Select the Waybar module in hosts/default/variables.nix via waybarChoice. Example (actual excerpt): -```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=73 - # Set Waybar - # Includes alternates such as: - # Comment out the current choice and uncomment the one you want - #waybarChoice = ../../modules/home/waybar/waybar-curved.nix; - #waybarChoice = ../../modules/home/waybar/Jerry-waybars.nix; - #waybarChoice = ../../modules/home/waybar/waybar-simple.nix; - #waybarChoice = ../../modules/home/waybar/waybar-mecha.nix; - #waybarChoice = ../../modules/home/waybar/waybar-nekodyke.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; - waybarChoice = ../../modules/home/waybar/waybar-tony.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; -``` -Notes: -- Ensure the file path matches an actual file name under modules/home/waybar/. For example, the list includes Jerry-waybar.nix (singular), but the commented example shows Jerry-waybars.nix (plural). Use the actual filename to avoid build errors. - - -## CRITICAL: git add or rebuild will fail -When you add a new Waybar file or any scripts it uses, you must stage them in git before rebuilding, or Nix will not see those paths and the build will fail. -- Example: -```bash path=null start=null -# Add your new module and scripts -git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/my-widget.sh -# Commit (optional but recommended) -git commit -m "Add my Waybar module and widget script" -``` - - -## How Waybar modules are structured here -Most Waybar modules follow this pattern: -- They expose a Home Manager module that sets programs.waybar.settings (JSON-like config) and programs.waybar.style (CSS). -- They also copy any helper scripts to ~/.config/waybar/scripts via a shared scripts directory. - -Example: waybar-tony.nix copies scripts and sets Waybar config and CSS: -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=15 - # Configure & Theme Waybar (Tony) - home.file = builtins.listToAttrs (map - (name: { - name = ".config/waybar/scripts/" + name; - value = { - source = "${scriptsDir}/${name}"; - executable = true; - }; - }) - scripts); - - programs.waybar = { - enable = true; - package = pkgs.waybar; - settings = [ - { - layer = "top"; - position = "top"; - height = 30; - spacing = 4; - modules-left = [ - "custom/startmenu" "hyprland/workspaces" "custom/sep" "tray" "custom/sep" "hyprland/window" "custom/sep" - ]; - modules-center = [ "custom/sep" "idle_inhibitor" "custom/notification" "custom/sep" ]; - modules-right = [ "custom/sep" "pulseaudio" "network" "cpu" "memory" "clock" "custom/sep" "custom/power" ]; - # ... component configs ... - } - ]; - style = concatStrings [ - '' - @define-color bg #1a1b26; - @define-color fg #a9b1d6; - * { font-family: "JetBrainsMono Nerd Font", monospace; font-size: 16px; font-weight: bold; } - window#waybar { background-color: @bg; color: @fg; } - #workspaces button { padding: 0 6px; color: @cyn; } - #clock { color: @cyn; border-bottom: 4px solid @cyn; } - #pulseaudio { color: @blu; border-bottom: 4px solid @blu; } - #idle_inhibitor.activated { color: @grn; border-bottom: 4px solid @grn; } - '' - ]; - }; -``` - -Key takeaways: -- Layout is controlled by modules-left, modules-center, and modules-right arrays. -- Individual module settings (e.g., hyprland/workspaces, pulseaudio) are configured under the same top-level object. -- CSS controls fonts, sizes, colors, borders, and spacing. -- scriptsDir = ./scripts relative to the module file; any files inside that directory are installed into ~/.config/waybar/scripts and made executable. - - -## Add your own Waybar module (step-by-step) -1) Copy an existing module as a starting point, e.g.: -```bash path=null start=null -cp modules/home/waybar/waybar-simple.nix modules/home/waybar/my-waybar.nix -``` -2) (Optional) Add any helper scripts your widgets will use into modules/home/waybar/scripts/ (they will be installed to ~/.config/waybar/scripts automatically by modules using scriptsDir = ./scripts). -3) Point variables.nix to your new module: -```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=81 - #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; - waybarChoice = ../../modules/home/waybar/waybar-tony.nix; - #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; -``` -Change the active line to: -```nix path=null start=null -waybarChoice = ../../modules/home/waybar/my-waybar.nix; -``` -4) Stage your files before rebuilding (critical): -```bash path=null start=null -git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/* -``` -5) Rebuild as you normally do for ZaneyOS. - - -## Customization examples -Below are quick edits you can make, demonstrated using existing modules. - -1) Change font family and size (CSS) -- In waybar-tony.nix: -```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=207 -* { - font-family: "JetBrainsMono Nerd Font", monospace; - font-size: 16px; - font-weight: bold; -} -``` -Change font-family and font-size to your preference. - -2) Move widgets left/center/right -- In any module, edit modules-left, modules-center, modules-right arrays. For example in waybar-simple.nix: -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-simple.nix start=28 -modules-center = [ "hyprland/workspaces" ]; -modules-left = [ "custom/startmenu" "custom/arrow6" "pulseaudio" "cpu" "memory" "idle_inhibitor" "custom/arrow7" "hyprland/window" ]; -modules-right = [ "custom/arrow4" "custom/hyprbindings" "custom/arrow3" "custom/notification" "custom/arrow3" "custom/power" "battery" "custom/arrow2" "tray" "custom/arrow1" "clock" ]; -``` -Just reorder or move entries between arrays to place widgets where you want. - -3) Change colors and button styles -- In waybar-tony.nix, CSS color variables and workspace button styling: -```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=218 -#workspaces button { - padding: 0 6px; - color: @cyn; - background: transparent; - border-bottom: 3px solid @bg; -} -#workspaces button.active { - color: @cyn; - border-bottom: 3px solid @mag; -} -``` -Adjust colors (e.g., @cyn, @mag) or borders as desired. You can also define your own @define-color variables at the top of the CSS block. - -4) Add icons or change labels -- Many modules set format and format-icons. Example (pulseaudio) in waybar-ddubs.nix: -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=104 -"pulseaudio" = { - format = "{icon} {volume}% {format_source}"; - format-icons = { - headphone = ""; - default = [ "" "" "" ]; - }; -}; -``` -Replace icons with Nerd Font glyphs you prefer. - -5) Add a new widget that runs a script -- Waybar custom modules can execute scripts and display the output. Put your script in modules/home/waybar/scripts/ and configure a custom module: -```nix path=null start=null -"custom/mywidget" = { - exec = "~/.config/waybar/scripts/my-widget.sh"; - return-type = "json"; # or "text" depending on your script - interval = 5; # seconds - format = "{}"; # how to render the output - on-click = "kitty -e my-tool"; -}; -``` -- Scripts placed in modules/home/waybar/scripts/ are installed to ~/.config/waybar/scripts and marked executable by modules that include the home.file mapping. - -6) Make the bar floating or docked -- Waybar supports a mode field; CSS margins/transparency give a floating look: -```nix path=null start=null -settings = [ - { - layer = "top"; - position = "top"; - mode = "overlay"; # overlay (floats), or "dock" (reserves space), or "invisible" - # ... - } -]; -``` -- CSS for floating effect: -```css path=null start=null -window#waybar { - background: rgba(0, 0, 0, 0.6); - margin: 6px 10px; /* space from screen edges */ - border-radius: 12px; -} -``` - -7) Known Waybar modules you’ll see in ZaneyOS configs -- Hyprland modules: hyprland/workspaces, hyprland/window, wlr/taskbar (wlroots taskbar) -- System modules: clock, tray, cpu, memory, network, disk, battery, bluetooth, backlight, idle_inhibitor, mpris, temperature, pulseaudio -- Custom modules: custom/* (e.g., custom/power, custom/notification, custom/startmenu, etc.) - - -## Where to store scripts that widgets call -- Place scripts under modules/home/waybar/scripts/. -- Many Waybar modules here include: -```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=14 -home.file = builtins.listToAttrs (map (name: { - name = ".config/waybar/scripts/" + name; - value = { source = "${scriptsDir}/${name}"; executable = true; }; -}) scripts); -``` -This copies all files from ./scripts (next to the module file) to ~/.config/waybar/scripts and makes them executable, so your Waybar configuration can reference them as ~/.config/waybar/scripts/