docs(add): enlaces al guion y manual en el readme

tambien se puede pasar a html con pandoc

README.md

@@ -1,3 +1,8 @@
 # Arch-i3wm
 
 Repositorio de la charla de Arch + i3wm realizada el 16 de abril de 2026
+
+# Contenido
+
+- Nuestro manual de arch está en <doc/manual.pdf>.
+- El guión de la presentación está en <doc/gion.md>.

doc/gion.md

@@ -0,0 +1 @@
+../notas-jaime/gion-arch.md

doc/manual.pdf

@@ -0,0 +1 @@
+../i3-manual.pdf

notas-jaime/Makefile

@@ -63,6 +63,7 @@ vm-nographic: exit-notice root.img $(VM_DEPS)
 # custom.db.tar.gz ./*.pkg.tar.zst~*.sig` (pq lo he copiado todo, sig incluido)
 # para generar los archivos de la base de datos de los paquetes
 serve:
+	@echo -e "\033[4;7m/etc/pacman.conf:\033[0m"
 	@echo "[custom]"
 	@echo "SigLevel = Optional TrustAll"
 	@echo "http://192.168.122.1:8080"

notas-jaime/gion-arch.md

@@ -0,0 +1,135 @@
+<!--
+  for vim:
+    set makeprg=./make-html.sh
+-->
+
+# Índice de la Charla
+
+- Filosofía
+  Te lo montas tu... Es importante conocer las partes de un SO de Linux.
+- Partes de un SO:
+  - Kernel (linux, linux-zen)
+  - Coreutils (GNU Core utils, uutils)
+  - Bootloader (grub, systemd-boot, limine)
+  - Init System (systemd, runit, openrc, dinit)
+  - Network Manager (NetworkManager, iwd)
+  - Administrador de Paquetes (pacman)
+  - Repositorios (core, extra, kde-testing, custom)
+  - AUR (como un pseudo-repositorio alternativo)
+  - GUI
+    - DE
+      - GNOME / KDE
+    - WM(xorg):
+      - i3
+      - xmonad
+    - Compositor(wayland):
+      - sway
+      - Hyprland
+      - Niri
+  - Display Manager
+    - GDM / SSDM
+    - lidm
+  - Notif daemon, sudo, etc
+- Mencion de la wiki
+- Forks de Arch (artix, black arch, alarm, cachyos, nyarch)
+- Instalación (que es el iso)
+
+> [!NOTE]
+>
+> `kernel -> coreutils -> init -> network`
+>
+> Hacerlo como una progresión.
+>
+> - El kernel es lo básico, maneja los procesos y permite que estos reserven memoria, tengan un sistema de archivos, se comuniquen con periféricos, etc.
+> - Coreutils da una serie de programas básicos para interactuar con lo que ofrece el kernel (ls, cat, touch, mkdir, etc). **no son parte del kernel**
+> - Linux no esta preparado para arrancar directamente cuando el ordenador arranca (a menos que sea UEFI y esté configurado). Entonces hay un programa llamado <q>boot loader</q> que se encarga de arrancar un SO al encender el ordenador. También pueden ser <q>boot managers</q>, que además ofrecen menús y opciones para configurar que SO arrancar si hay varios o incluso con que opciones.
+> - Cuando linux arranca, aunque tenga programas instalados, alguien tiene que decidir que ejecutar y que no, no tiene sentido que se ejecute <q>mkdir</q> al arrancar. A esto se le llama el <q>init</q>, que es el programa que se ejecuta al arrancar y se encarga de arrancar los <q>servicios</q> en su orden correcto, como configurar el teclado, arrancar el <q>daemon</q> de red, etc, y mostrarnos nuestra interfaz de usuario cuando todo esté listo.
+>
+> Dejar <q>daemon</q> un poco en el aire y desarrollarlo en NetworkManager como ejemplo.
+
+> [!NOTE]
+>
+> En Network Manager
+>
+> Hay muchas alternativas, NetworkManger es el <q>todo en uno</q>, pero hay paquetes para cosas mas pequeñas, <q>iwd</q> con <q>wpa_supplicant</q> para configurar wifi solo, etc. Incluso combinaciones, hacer que <q>NetworkManager</q> use solo <q>iwd</q> para configurar el wifi, o que use <q>dnsmasq</q> para <q>cache</q> de DNS, etc.
+
+---
+
+# Filosofía
+
+> Arch is installed as a minimal base system, configured by the user upon which their own ideal environment is assembled by installing only what is required or desired for their unique purposes.
+
+> Arch strives to keep its packages as close to the original upstream software as possible.
+
+> &mdash; <cite> <https://archlinux.org/about/> </cite>
+
+Arch es una distribución de Linux que te deja el trabaho de configurar tu ordenador a ti.
+
+Muchas otras distribuciones vienen con todas las partes de un SO incluidas, sin libertad de elegir, y muchas veces modifican el codigo de los projectos para ajustarse más a la distribución. Por ejemplo:
+
+- Debian suele modificar el código de linux para ajustarse a su filosofía de estabilidad y largo soporte de hardware y software.
+- Ubuntu usa GNOME por defecto y suele modificarlo para ajustarse a la temática y comportamiento del escritorio y aherirse a su filosofía de mejorar la experiencia del usuario.
+- Fedora suele modificar los paquetes para adoptar las últimas características lo antes posible y mejorar la seguridad de la distribución.
+
+Arch Linux en cambio busca evitar modificar el código original, prioriza mantenerse original al proyecto. Solo lo modifica cuando es necesario para compilar correctamente o funcionar con el resto del sistema.
+
+## Consecuencias
+
+Por esto mismo es un sistema que no trae nada por defecto. Te obliga a entender cada una de las partes de tu ordenador para poder instalarlo y eres tú el responsable de configurarlas para que cada una de las partes de tu sistema funcionen correctamente entre si.
+
+Hay herramientas para instalar arch con un solo click, pero con estas es muy fácil desentendernos de los componentes que conforman nuestro sistema operativo, y luego cuando cualquier cosa cambie que requiera nuestra intervención, no entenderemos nuestro sistema para arreglarlo. Una vez entiendes tu sistema es muy dificil cargárselo, ya que sabremos que componente ha fallado, porque, como arreglarlo o incluso alternativas a ese componente.
+
+También lo convierte en uno de los sistemas más personalizables ya que nadie ni nada se interpone entre ti y la configuración original de los programas de tu ordenador.
+
+## ¿Por qué usar arch?
+
+Está muy bien la excusa de que Ubuntu <q>solo funciona</q>, pero arch te obliga a entender como funciona tu ordenador.
+
+Como estudiantes de informática y teleco estudiamos sobre los ordenadores, y usar una distribución como arch es una manera muy buena de probar cosas nuevas y aprender por el camino como funciona uno.
+
+# Partes de un SO
+
+## Kernel
+
+El kernel es la parte más baja y central de un sitema operativo. Se encarga de manjear los procesos y ofrecerles servicios para reservar memoria, trabajar con un sistema de archivos, abstraer los periféricos con una interfaz común, etc.
+
+Arch soporta oficialmente linux, pero tecnicamente podrías instalar cualquier implementación similar a linux. Existen incluso varias versiones de linux con distintas modificaciones. Las más conocidas son `linux-lts`, `linux-zen` o `linux-hardened`. Pero CachyOS también ofrece sus propios <q>mix</q>[^cachyos-kernel].
+
+> [^cachyos-kernel]: <https://wiki.cachyos.org/features/kernel/>
+
+<details>
+
+<summary markdown="1">Paquetes <code>linux-cachyos</code> en el AUR actualmente.</summary>
+
+`linux-cachyos` `linux-cachyos-bore` `linux-cachyos-rc` `linux-cachyos-lts` `linux-cachyos-cjktty` `linux-cachyos-eevdf` `linux-cachyos-hardened` `linux-cachyos-bmq` `linux-cachyos-server` `linux-cachyos-deckify-native` `linux-cachyos-native` `linux-cachyos-native-nvidia-open` `linux-cachyos-rc-native` `linux-cachyos-rc-native-nvidia-open`
+
+</details>
+
+## Coreutils
+
+Los coreutils (core utilities) en linux son el conjunto de programas básicos de un sistema unix. En linux los coreutils tradicionales son [los de GNU](https://www.gnu.org/software/coreutils/), pero son reemplazables por otras implementaciones como [uutils](https://github.com/uutils/coreutils) (en rust).
+
+La lista de programas que ofrece coreutils (9.10-1) en arch es: \
+`[` `b2sum` `base32` `base64` `basename` `basenc` `cat` `chgrp` `chmod` `chown` `chroot` `cksum` `comm` `cp` `csplit` `cut` `date` `dd` `df` `dir` `dircolors` `dirname` `du` `echo` `env` `expand` `expr` `factor` `false` `fmt` `fold` `groups` `head` `hostid` `id` `install` `join` `link` `ln` `logname` `ls` `md5sum` `mkdir` `mkfifo` `mknod` `mktemp` `mv` `nice` `nl` `nohup` `nproc` `numfmt` `od` `paste` `pathchk` `pinky` `pr` `printenv` `printf` `ptx` `pwd` `readlink` `realpath` `rm` `rmdir` `seq` `sha1sum` `sha224sum` `sha256sum` `sha384sum` `sha512sum` `shred` `shuf` `sleep` `sort` `split` `stat` `stdbuf` `stty` `sum` `sync` `tac` `tail` `tee` `test` `timeout` `touch` `tr` `true` `truncate` `tsort` `tty` `uname` `unexpand` `uniq` `unlink` `users` `vdir` `wc` `who` `whoami` `yes`
+
+Estos programas **no son parte del kernel**, se ofrecen a parte para interactuar con él.
+
+## Bootloader
+
+Un ordenador no está diseñado para arrancar directamente un kernel (hasta recientemente con configuraciones específicas de UEFI). Para esto hay un programa llamado <q>boot loader</q> que se encarga de cargar el kernel y ejecutarlo adecuadamente al arrancar el ordenador.
+
+Además, muchos de estos <q>bootloaders</q> ofrecen menus antes de arrancar el kernel para seleccionar el sistema en casos de multiboot o configurar las opciones con las que arranca ell kernel. En este caso se les considera un <q>boot manager</q>.
+
+## Init System
+
+Una vez el kernel arranca, este tiene programas instalados y esta listo para ofrecer sus servicios, pero no puede ejecutar cualquier cosa como `mkdir`. Entones se usa un init system, que consiste simplemente en el primer programa que linux ejecuta al arrancar el ordenador (por defecto se busca en `/sbin/init`).
+
+El trabajo de un init system completo es el de iniciar todas las partes del sistema adecuadas, llamadas <q>servicios</q>. Estos servicios pueden ser programas simples que configuren el teclado, o programas que se mantienen activos de fondo, como el <q>daemon</q> de red.
+
+El orden también es muy importante, la interfaz gráfica también se considera un servicio que solo se puede ejecutar cuando el resto de servicios previos han terminado de ejecutarse adecuadamente. No tiene mostrar la interfaz de inicio de sesión si el teclado no está preparado.
+
+## <q>_Daemons_</q> de red
+
+Un daemon es simplemente un programa que se mantiene ejecutando de fondo, normalmente manejados por el init system como un servicio.
+
+El ejemplo más claro son los _daemons_ de red, estos procesos se mantienen activos de fondo buscando las redes disponibles y decidiendo constantemente si deben conectarse, desconectarse, o que hacer.

notas-jaime/make-html.sh

@@ -0,0 +1,8 @@
+set -xeuo pipefail
+
+${PANDOC_PATH:-pandoc} \
+  --template="${HTML_TEMPLATE:-template.html}" \
+  --metadata title="${HTML_TITLE:-"Arch + i3"}" \
+  -f gfm \
+  \
+  "${1:-guion-arch.md}" -o "${2:-guion-arch.html}"

notas-jaime/style.css

@@ -0,0 +1,102 @@
+:root {
+  --text-color: #eee;
+  --faint-text-color: #888;
+  --background-color: #121415;
+
+  --blockquote-color: #444;
+
+  --link-color: #d55;
+  --visited-link-color: #a22;
+
+  --code-background-color: #0a0a0a;
+
+  --text-font: system-ui, sans-serif;
+
+  --quoteish-left-width: 4px;
+}
+
+/* General */
+
+html {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+}
+
+body {
+  font-family: var(--text-font);
+  line-height: 1.6;
+  max-width: 700px;
+  margin: 30px 50px;
+
+  color: var(--text-color);
+  background-color: var(--background-color);
+}
+
+/* Headings */
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  border-bottom: 1px var(--faint-text-color) solid;
+}
+
+/* Block Quotes */
+
+blockquote {
+  border-left: var(--quoteish-left-width) var(--blockquote-color) solid;
+  padding: 0 30px;
+  margin-left: 10px;
+  /* margin-bottom: 20px; */
+}
+
+/* Code */
+
+code {
+  background-color: var(--code-background-color);
+  padding: 5px 10px;
+  border-radius: 8px;
+}
+
+a {
+  color: var(--link-color);
+}
+
+a:visited {
+  color: var(--visited-link-color);
+}
+
+/* Alerts */
+
+.note {
+  --color: #7cf;
+  --icon: '🛈';
+}
+
+.note {
+  border-left: var(--quoteish-left-width) var(--color) solid;
+  padding: 15px 30px;
+  margin-left: 10px;
+  margin-bottom: 20px;
+
+  background-color: #ffffff05;
+}
+
+.note > .title > p {
+  color: var(--color);
+  font-size: 1.25em;
+  font-weight: bold;
+  margin-top: 0;
+}
+
+.note > :last-child {
+  margin-bottom: 0;
+}
+
+.note > .title > p::before {
+  content: var(--icon);
+  margin-right: 0.25em;
+}

notas-jaime/template.html

@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+        <title>$title$</title>
+        <link href="style.css" rel="stylesheet">
+    </head>
+    <body> $body$ </body>
+</html>

notas-jaime/toc.md

@@ -1,75 +0,0 @@
-# Índice de la Charla
-
-- Filosofia
-  Te lo montas tu... Es importante conocer las partes de un SO de Linux.
-- Partes de un SO?:
-  - Kernel (linux, linux-zen)
-  - Coreutils (GNU Core utils, uutils)[^coreutils-bins]
-  - Bootloader (grub, systemd-boot, limine)
-  - Init System (systemd, runit, openrc, dinit)
-  - Network Manager (NetworkManager, iwd)
-  - Administrador de Paquetes (pacman)
-  - Repositorios (core, extra, kde-testing, custom)
-  - AUR (como un pseudo-repositorio alternativo)
-  - GUI
-    - DE
-      - GNOME / KDE
-    - WM(xorg):
-      - i3
-      - xmonad
-    - Compositor(wayland):
-      - sway
-      - Hyprland
-      - Niri
-  - Display Manager
-    - GDM / SSDM
-    - lidm
-  - Notif daemon, sudo, etc
-- Mencion de la wiki
-- Forks de Arch (artix, black arch, alarm, cachyos, nyarch)
-- Instalación (que es el iso)
-
-[^coreutils-bins]: \[ b2sum base32 base64 basename basenc cat chgrp chmod chown chroot cksum comm cp csplit cut date dd df dir dircolors dirname du echo env expand expr factor false fmt fold groups head hostid id install join link ln logname ls md5sum mkdir mkfifo mknod mktemp mv nice nl nohup nproc numfmt od paste pathchk pinky pr printenv printf ptx pwd readlink realpath rm rmdir seq sha1sum sha224sum sha256sum sha384sum sha512sum shred shuf sleep sort split stat stdbuf stty sum sync tac tail tee test timeout touch tr true truncate tsort tty uname unexpand uniq unlink users vdir wc who whoami yes
-
-> [!NOTE]
-> kernel -> coreutils -> init -> network
->
-> Hacerlo como una prograsión.
->
-> - El kernel es lo básico, maneja los procesos y permite que estos reserven memoria, tengan un sistema de archivos, se comuniquen con periféricos, etc.
-> - Coreutils da una serie de programas básicos para interactuar con lo que ofrece el kernel (ls, cat, touch, mkdir, etc). **no son parte del kernel**
-> - Linux no esta preparado para arrancar directamente cuando el ordenador arranca (a menos que sea UEFI y esté configurado). Entonces hay un programa llamado "boot loader" que se encarga de arrancar un SO al encender el ordenador. También pueden ser "boot managers", que además ofrecen menús y opciones para configurar que SO arrancar si hay varios o incluso con que opciones.
-> - Cuando linux arranca, aunque tenga programas instalados, alguien tiene que decidir que ejecutar y que no, no tiene sentido que se ejecute "mkdir" al arrancar. A esto se le llama el "init", que es el programa que se ejecuta al arrancar y se encarga de arrancar los "servicios" en su orden correcto, como configurar el teclado, arrancar el "daemon" de red, etc, y mostrarnos nuestra interfaz de usuario cuando todo esté listo.
->
-> Dejar "daemon" un poco en el aire y desarrollarlo en NetworkManager como ejemplo.
-
-> [!NOTE]
-> En Network Manager
->
-> Hay muchas alternativas, NetworkManger es el "todo en uno", pero hay paquetes para cosas mas pequeñas, "iwd" con "wpa_supplicant" para configurar wifi solo, etc. Incluso combinaciones, hacer que "NetworkManager" use solo "iwd" para configurar el wifi, o que use "dnsmasq" para "cache" de DNS, etc.
-
----
-
-# Filosofia
-
-> Arch is installed as a minimal base system, configured by the user upon which their own ideal environment is assembled by installing only what is required or desired for their unique purposes.
-
-> Arch strives to keep its packages as close to the original upstream software as possible.
-
-> &emph; <cite> <https://archlinux.org/about/> </cite>
-
-Arch es una distribución de Linux que te deja el trabaho de configurar tu ordenador a ti.
-
-Muchas otras distribuciones vienen con todas las partes de un SO incluidas, sin libertad de elegir, y muchas veces modifican el codigo de los projectos para ajustarse más a la distribución. Por ejemplo:
-
-- Debian suele modificar el código de linux para ajustarse a su filosofia de estabilidad y largo soporte de hardware y software.
-- Ubuntu usa GNOME por defecto y suele modificarlo para ajustarse a la temática de debian y ajustar su comportamiento par ajustarse a su filosofía de mejorar la experiencia del usuario.
-- Fedora suele modificar los paquetes para adoptar las últimas características lo antes posible y mejorar la seguridad de la distribución.
-
-Arch Linux en cambio busca evitar modificar el código original, prioriza mantenerse original al projecto. Solo lo modifica cuando es necesario para compilar correctamente o funcionar con el resto del sistema.
-
-## Consecuencias
-
-Por esto mismo es un sistema que no trae _casi_\* nada por defecto (una excepción). Te obliga a entender cada una de las partes de tu ordenador para poder instalarlo y eres tú el responsable de configurarlas para que cada una de las partes de tu sistema funcionen correctamente entre si.
-
-Hay herramientas para instalar arch con un solo click, pero con estas es muy fácil desentendernos de los componentes que conforman nuestro sistema operativo, y luego cuando cualquier cosa cambie que requiera nuestra intervención, no entenderemos nuestro sistema para arreglarlo. Una vez entiendes tu sistema es muy dificil cargárselo, ya que sabremos que componente ha fallado, porque, como arreglarlo o incluso alternativas a ese componente.