Actualizacion de Documentación + Workflow

Primer Intento de publicación workflow para automatización de README.md (futura escalabilidad y menor dependencia de actualización manual)

Author: Nisamov

.github/media/img.png .github/media/LinuxCommandsDarkTheme.png.github/media/img.png renamed to .github/media/LinuxCommandsDarkTheme.png

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+import re
+from pathlib import Path
+
+EXCLUDED_DIRS = {
+    '.git',
+    '.github',
+    '__pycache__'
+}
+
+EXCLUDED_FILES = {
+    'README.md',
+    'CONTRIBUTING.md',
+    'INFO.md',
+    'KEYWORD.md',
+    'LICENSE'
+}
+
+ROOT = Path('.')
+
+def generate_tree(path: Path, depth: int = 0):
+    lines = []
+
+    for item in sorted(path.iterdir(), key=lambda x: x.name):
+        if item.name in EXCLUDED_DIRS:
+            continue
+
+        if item.is_dir():
+            indent = '  ' * depth
+            lines.append(f"{indent}- {item.name}")
+            lines.extend(generate_tree(item, depth + 1))
+
+        elif (
+            item.is_file()
+            and item.suffix == '.md'
+            and item.name not in EXCLUDED_FILES
+        ):
+            indent = '  ' * depth
+            rel_path = item.as_posix()
+            lines.append(f"{indent}- [{item.name}](/{rel_path})")
+
+    return lines
+
+
+def update_readme(tree_md: str):
+    readme = Path('README.md')
+
+    if not readme.exists():
+        raise FileNotFoundError("README.md no encontrado")
+
+    content = readme.read_text(encoding='utf-8')
+
+    start = '<!-- AUTO-GENERATED-INDEX:START -->'
+    end = '<!-- AUTO-GENERATED-INDEX:END -->'
+
+    pattern = re.compile(
+        re.escape(start) + '.*?' + re.escape(end),
+        re.DOTALL
+    )
+
+    new_block = f"{start}\n{tree_md}\n{end}"
+
+    updated = pattern.sub(new_block, content)
+
+    readme.write_text(updated, encoding='utf-8')
+
+
+if __name__ == '__main__':
+    tree = '\n'.join(generate_tree(ROOT))
+    update_readme(tree)

.github/media/LinuxCommandsWhiteTheme.png

@@ -0,0 +1,30 @@
+name: Auto-generate README index
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  update-readme:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Generate README index
+        run: python .github/scripts/generate_readme_index.py
+
+      - name: Commit README changes
+        run: |
+          git config user.name "github-actions"
+          git config user.email "[email protected]"
+          git add README.md
+          git commit -m "docs: auto-update repository index" || echo "No changes to commit"
+          git push

.github/scripts/generate_readme_index.py

@@ -4,7 +4,7 @@ Linux Commands es un repositorio creado por [Nisamov](https://github.com/Nisamov
 
 ## Origen
 
-El origen del proyecto está reistrado sobre la fecha 01/03/2023, sin embargo, el origen oficial del documento, se sitúa a mediados del verano del año 2022, mientras Nisamov estaba comenzando a descubir el mundo de Linux y las posibilidades que traía consigo.
+El origen del proyecto está registrado sobre la fecha 01/03/2023, sin embargo, el origen oficial del documento, se sitúa a mediados del verano del año 2022, mientras Nisamov estaba comenzando a descubir el mundo de Linux y las posibilidades que traía consigo.
 
 ## Historia
 
@@ -19,75 +19,22 @@ En 22/11/2023, se creó el primer directorio en un USB portatil con la funcional
 
 Para  el 11/09/2025, ya había entrado en grado superior, aportando así tanto nuevo conocimiento, como actualizando el viejo contenido subido al repositorio.
 
-## Infromación
-
-El contenido de Linux commands ha hecho que a partir de si mismo, puedan crearse nuevos repositorios, como bien [SwitchCommands](https://github.com/NisamovOrg/SwitchCommands), estos, siendo una variante de LinuxCommands, cumplen con el mismo objetivo, proveer información y servir como hoja de apuntes completamente abierta.
-El lenguaje oficial de LinuxCommands es el Español, cualquier otro idioma que se muestre en el repositorio ha de ser tomado como una referencia o falta de traducción, es posible que a la larga puedan aparecer versiones específicas para ciertos idiomas, no obstante, el original es y siempre será el Español.
-
-Las tildes son restringidas, permitendo la búsqueda exacta de los comandos mediante 'Control + H'.
-
-## Recomendación
-
-> Recomendación de uso:
-Se recomienda clonar el repositorio para un mayor manejo y libre uso (siguiendo siempre, las restricciones impuestas).
-
-**Extensiones:**
-
-Cuando se use `Visual Studio Code`, se recomienda instalar las siguiente extensiones:
-```
-[Extensiones - Visual Studio Code]
-    ├── Open in New Window (Permite mostrar contendo en una nueva ventana)
-    ├── HTML Preview (Permite previsualizar documentos HTML)
-    └── MDX Preview (Permite previsualizar documentos MARKDOWN)
-```
-
-## Clonación de repositorio:
-### Clonar el repositorio: [Windows]
-
-Abrimos la terminal  y nos posicionamos en la ubicación donde queremos que se copie el repositorio:
-```
-Control + R
-cd /Desktop
-```
-Clonamos el repositorio:
-```
-git clone https://github.com/Nisamov/LinuxCommands
-```
-Este comando clonará el respositorio dentro de la localiación de escritorio, en caso de quererla en otra ubicación, ten en cuenta el idioma de tu sistema operativo y ambia los valores según tus preferencias:
-`/Desktop` = `/Escritorio`
-
-### Clonar el repositorio: [Linux]
-
-Abrimos la terminal y nos posicionamos en la ubicación donde queremos que se copie el repositorio:
-```
-Control + T
-cd /home/user
-```
-Instalamos git
-```
-sudo apt install git
-```
-Clonamos el respotiorio:
-```
-git clone https://github.com/Nisamov/LinuxCommands /home/user/Documents
-```
-Este comando clona el repositorio en la ruta indicada al final, si se elimina dicha ruta, el repositorio se clonará en la ruta donde se encuentre con la consola.
-
 ## Contribución
 
 Durante la creación de LinuxCommands, varias personas aportaron infromación de tal froma que a partir de sus Contribuciones, se pudieron crear nueva subcategorías, dando así lugar, a nuevas secciones y mayor contenido dentro del repositorio.
 
 Las personas que en los orígenes aportaron grandes cantidades de infromación al repositorio son:
 
 - ⥏﹅⥑ [Andrés Abadías](https://github.com/Nisamov) [Creador del repositorio y dueño de LinuxCommands]
-- ⥏﹆⥑ Unai Urrestarazu [Contribuidor en sección de ciberseguridad]
-- ⥏﹆⥑ Clara C. [Contribuidora en sección de gestión de ficheros y directorios]
-- ⥏﹆⥑ Juan P. [Contribuidor en sección de servicios servidor]
-- ⥏﹆⥑ Diego Gracía [Contribuidor en información del sistema]
+- ⥏﹆⥑ Unai Urrestarazu : Profesor [Grado Medio y Superior]
+- ⥏﹆⥑ Clara Cirac Nerín : Profesor [Grado Medio]
+- ⥏﹆⥑ Juan Palacios Perez : Profesor [Grado Medio]
+- ⥏﹆⥑ Diego Gracía : Compañero de Clase [Grado Medio]
+- ⥏﹆⥑ David Torralba : Profesor [Grado Superior]
 
 ## Licencia
 
 Licencia de uso [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.es)
 
 > [ ! ] Repositorio creado por [Andrés Abadías](https://github.com/Nisamov).
-<!-- por y para -->
+<!-- por y para Nisamov-->

.github/workflows/auto-readme.yml

@@ -72,7 +72,7 @@ Todos los derechos pertenecientes a Andrés Ruslan Abadías Otal | Nisamov: gith
   </div>
 -->
 
-![Cartel Principal](.github/media/img.png)
+![Cartel Principal](.github/media/LinuxCommandsWhiteTheme.png)
 
 # LinuxCommands | Comandos y Servicios
 
@@ -83,124 +83,6 @@ Este repositorio está basado en los apuntes personales del creador [Andrés Rus
 El formato de comandos establecido en ficheros `commands.md`, está basado en el [Documento de Origen](.github/origins/LinuxCommandsOrigen.md) creado el 15/07/2022, siendo [document_gestion/commands.md](/document_gestion/commands.md) el producto definitivo de ese mismo fichero.
 
 ### Estructura del Repositorio:
-```sh
-.
-├── .github
-│   ├── media
-│   │   └── img.png
-│   ├── origins
-│   │   └── LinuxCommandsOrigen.md
-│   └── FUNDING.yml
-├── access_control_lists
-│   ├── commands.md
-│   └── theory.md
-├── backup_rsync
-│   ├── commands.md
-│   └── theory.md
-├── combination_keys
-│   └── combination.md
-├── cron_tasks
-│   ├── commands.md
-│   └── theory.md
-├── data_dump
-│   ├── commands.md
-│   └── theory.md
-├── document_gestion
-│   ├── commands.md
-│   ├── compression.md
-│   ├── main.md
-│   └── theory.md
-├── firewall_ufw
-│   ├── commands.md
-│   └── theory.md
-├── iptables
-│   ├── command-list.md
-│   ├── commands.md
-│   └── theory.md
-├── permission_gestion
-│   ├── permissions.md
-│   └── theory.md
-├── scripts
-│   └── bash
-│       ├── scripts_ejemplo
-│       │   ├── echo.sh
-│       │   └── for.sh
-│       └── theory.md
-├── secure_channel
-│   ├── secure_channel_ftp
-│   │   ├── commands.md
-│   │   └── theory.md
-│   └── secure_channel_ssh
-│       ├── commands.md
-│       └── theory.md
-├── security
-│   ├── backup
-│   │   ├── commands.md
-│   │   └── theory.md
-│   ├── proxy_squid
-│   │   └── documentation.md
-│   ├── raid
-│   │   ├── mount.md
-│   │   ├── process.sh
-│   │   └── theory.md
-│   ├── vpn_openvpn
-│   │   └── documentation.md
-│   └── audit.md
-├── services
-│   ├── commands.md
-│   └── theory.md
-├── software_gestion
-│   └── commands.md
-├── system_data
-│   ├── disk_partition
-│   │   ├── commands.md
-│   │   ├── theory.md
-│   │   └── virtualdisk.md
-│   ├── network_configuration
-│   │   ├── dhcp_failover
-│   │   │   ├── manual.md
-│   │   │   ├── serv1_01-network-manager-all.yaml
-│   │   │   ├── serv1_dhcpd.conf
-│   │   │   ├── serv2_01-network-manager-all.yaml
-│   │   │   ├── serv2_dhcpd.conf
-│   │   │   └── servers_isc-dhcp-server
-│   │   ├── dhcp_samba
-│   │   │   ├── smb.conf
-│   │   │   └── theory.md
-│   │   ├── interfaces_net
-│   │   │   ├── dynamic-network.conf
-│   │   │   ├── static-network.conf
-│   │   │   └── theory.md
-│   │   ├── netplan_net
-│   │   │   ├── dynamic-network.conf
-│   │   │   ├── static-network.conf
-│   │   │   └── theory.md
-│   │   ├── commands.md
-│   │   └── theory.md
-│   ├── system_data
-│   │   ├── packet_install_theory.md
-│   │   └── system_code.md
-│   └── system_structure
-│       └── linux-structure.md
-├── users_permissions
-│   ├── system_users.md
-│   └── user_gestion.md
-├── web_server
-│   ├── apache2
-│   │   └── documentation.md
-│   ├── nginx
-│   │   ├── GeoIP2
-│   │   │   └── documentation.md
-│   │   └── documentation.md
-│   └── wordpress
-│       └── documentation.md
-├── .gitignore
-├── CONTRIBUTING.md
-├── INFO.md
-├── KEYWORD.md
-├── LICENSE
-└── README.md
-```
-<!--
-</div>
--->
+
+<!-- AUTO-GENERATED-INDEX:START -->
+<!-- AUTO-GENERATED-INDEX:END -->