Resumen/X Linux (distro)
Repositorio de la distribución X
Otros idiomas: English
Este es el índice de documentación del repositorio x (equislinux/x), el hogar
de la distribución X (antes conocida como X Linux / x-linux). X es un
spin personalizado de Arch Linux centrado en la simplicidad, el branding
limpio y las construcciones reproducibles. Incluye su propio repositorio de
paquetes (x-repo) para poder instalar paquetes específicos de X directamente
con pacman.
Visión general
El repositorio contiene la fuente de construcción de la distribución, no un producto de cara al usuario por sí solo. Aporta:
- Un perfil archiso que produce el ISO en vivo arrancable.
- Un instalador de texto que se ejecuta automáticamente en el entorno en vivo (no hay instalador gráfico; Calamares fue eliminado).
- El aprovisionamiento del sistema instalado mediante el payload
x-scripts, incluido de forma offline dentro del ISO. - Utilidades para construir tarballs de sistema de archivos importables en WSL.
- Generaciones del sistema: el instalador crea los subvolúmenes
@/@home/@snapshots/@xstatey una primera generación booteable; el payload registra snapshots con manifiesto, rollback y restore granular (x gen), más generaciones de dotfiles (x home) y hooks de pacman. Ver Generaciones.
El ISO usa el flujo estándar de mkarchiso. En pacman.conf se declara un
repositorio [x] de pacman propio que se usa tanto en la construcción como en
el sistema instalado, de modo que los paquetes de branding y herramientas de
X (x-release, x-dev) se instalan con pacman.
Estado del proyecto
La distribución está en desarrollo activo. Los ISOs firmados se publican en
SourceForge; el enlace estable del portal
https://equislinux.org/download/latest/ solo redirige allí. Los dos canales de paquetes —el repositorio pacman [x] y el
endpoint nativo .xp— están vivos. El instalador de texto ofrece Hyprland,
niri, KDE Plasma o un sistema solo de consola. Consulta ROADMAP.md y
docs/project-state.md.
Cómo se mapea este repositorio en la organización
Cada repositorio vive en su propia carpeta bajo la organización equislinux en
GitHub. Los nombres cambiaron con el tiempo, así que las referencias antiguas a
x-linux (la distro) o a un repo x de scripts deben leerse con este mapeo:
| Repositorio | Rol |
|---|---|
equislinux/x | La distro (este repo). Perfil archiso, ISO en vivo, instalador de texto, construcción de rootfs para WSL. |
equislinux/x-arm | Build overlay aarch64: ISO UEFI, repositorio [x]/aarch64 e imágenes de VM. |
equislinux/scripts | Payload de aprovisionamiento y la CLI x (x setup, x theme, ...). Se empaqueta como x-scripts y lo instala el instalador de texto. |
equislinux/x-repo | Repositorio binario de paquetes de X (alojado en GitHub Pages, [x] en pacman.conf), portal de paquetes y publicación de ISOs. |
equislinux/xpm | Gestor de paquetes de X (Rust). |
equislinux/xpkg | Herramienta de empaquetado de X para desarrolladores (Rust). |
equislinux/wsl / equislinux/wsl-scripts | Rootfs de WSL (release publicado v0.1.0) y su setup de primer arranque. |
equislinux/utils | Utilidades de operador: descubrimiento del workspace, clonado, reglas sudo y claves de firma. |
equislinux/wiki / equislinux/web | Espejo de documentación (en/es) y el portal de documentación. |
equisdots/* | Org dueña de los stacks de escritorio (config Lua de Hyprland, config de niri, shell Quickshell, paletas, motores, login SDDM) consumidos de solo lectura por las herramientas de escritorio en scripts. Instaladores oficiales: equisdots/dots (Hyprland) y equisdots/niri-meta (niri). |
Documentación relacionada en este repositorio:
- Construir el ISO y el rootfs de WSL
- Generaciones (snapshots btrfs, rollback, restore)
- Instalador de texto
- Pruebas en una máquina virtual
- Referencia de la estructura del proyecto
Aspectos destacados
- Branding. Identidad aplicada a GRUB (
GRUB_DISTRIBUTOR="X"), a la etiqueta/editor del ISO, al MOTD y a los paquetes instalados. - Instalador de texto.
configurator.shrecoge las opciones y escribe un plan JSON;install.shparticiona (GPT/btrfs), ejecutapacstrap, configura el sistema base, aprovisiona conx-scriptse instala un gestor de arranque. - Instalación desatendida. El ISO incluye una entrada de arranque
autoinstall(hotkeya,xauto=1) para un disco etiquetadocidatacon unx-install.json. - Elección de escritorio. Hyprland (
equisdots/dots), niri (equisdots/niri-meta) o KDE Plasma con branding X; también se puede instalar sin escritorio. La elección se hace en el instalador de texto. - Payload de aprovisionamiento. El paquete
x-scriptsviaja dentro del ISO. La instantánea de Hyprland sigue disponible para instalaciones legacy offline; el selector nuevo instala Hyprland, niri y KDE Plasma online. - Soporte WSL. El rootfs se construye en el repositorio dedicado
equislinux/wsl(releasev0.1.0) y se aprovisiona conequislinux/wsl-scripts.
Modelo de desarrollo
- El desarrollo ocurre en
maincon ramas cortas por PR. - Las ramas antiguas (
checkpoint/calamares-installer-v1,x/reboot,dev) son históricas y no reflejan el código actual.
Alcance
Todo lo que hay en este repositorio forma parte de la organización equislinux.
Aquí solo viven las referencias relacionadas con construir, instalar y
aprovisionar X; la lógica de configuración del usuario vive en el payload
x-scripts.