Actualizacion general del repositorio

Author: Nisamov

.github/scripts/generate_readme_index.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+import re
+from pathlib import Path
+
+EXCLUDED_DIRS={'.git','.github','__pycache__'}
+EXCLUDED_FILES={'README.md','CONTRIBUTING.md','INFO.md','LICENSE'}
+
+ROOT=Path('.')
+START='<!-- AUTO-GENERATED-INDEX:START -->'
+END='<!-- AUTO-GENERATED-INDEX:END -->'
+
+def write_readme(path:Path,lines):
+    readme=path/'README.md'
+    block=f"{START}\n"+'\n'.join(lines)+f"\n{END}"
+    if readme.exists():
+        content=readme.read_text(encoding='utf-8')
+        if START in content and END in content:
+            content=re.sub(
+                re.escape(START)+'.*?'+re.escape(END),
+                block,
+                content,
+                flags=re.DOTALL
+            )
+        else:
+            content=content.rstrip()+"\n\n"+block
+    else:
+        content=f"# {path.name}\n\n{block}"
+    readme.write_text(content,encoding='utf-8')
+
+def generate_root_readme():
+    lines=[
+        f"- [{d.name}](/{d.name})"
+        for d in sorted(ROOT.iterdir())
+        if d.is_dir() and d.name not in EXCLUDED_DIRS
+    ]
+    write_readme(ROOT,lines)
+
+def generate_section_readme(section:Path):
+    lines=[]
+
+    for d in sorted(section.iterdir()):
+        if not d.is_dir() or d.name in EXCLUDED_DIRS:
+            continue
+        lines.append(f"- [{d.name}](/{d.as_posix()})")
+        for f in sorted(d.glob('*.md')):
+            if f.name in EXCLUDED_FILES:
+                continue
+            rel=f.relative_to(section).as_posix()
+            lines.append(f"  - [{rel}](/{f.as_posix()})")
+
+    for f in sorted(section.glob('*.md')):
+        if f.name in EXCLUDED_FILES:
+            continue
+        lines.append(f"- [{f.name}](/{f.as_posix()})")
+
+    write_readme(section,lines)
+
+if __name__=='__main__':
+    generate_root_readme()
+    for d in sorted(ROOT.iterdir()):
+        if d.is_dir() and d.name not in EXCLUDED_DIRS:
+            generate_section_readme(d)

.github/workflows/auto-readme.yml

@@ -0,0 +1,30 @@
+name: Auto-generate README index
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  update-readme:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repositorio
+        uses: actions/checkout@v4
+
+      - name: Montaje de python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Indexación de Readmes
+        run: python .github/scripts/generate_readme_index.py
+
+      - name: Commit cambios
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          git add **/README.md
+          git commit -m "docs: Indexación automática" || echo "Sin cambios por aplicar"
+          git push

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,60 @@
+[![Last commit](https://img.shields.io/github/last-commit/Nisamov/RouterSwitchCommands?style=flat-square&color=000000&labelColor=ffffff)](https://github.com/Nisamov/RouterSwitchCommands/commits) [![License](https://img.shields.io/static/v1?label=License&message=MIT&color=000000&style=flat-square&labelColor=ffffff)](LICENSE) [![Stars](https://img.shields.io/github/stars/Nisamov/RouterSwitchCommands?style=flat-square&color=000000&labelColor=ffffff)](https://github.com/Nisamov/RouterSwitchCommands/stargazers) [![Forks](https://img.shields.io/github/forks/Nisamov/RouterSwitchCommands?style=flat-square&color=000000&labelColor=ffffff)](https://github.com/Nisamov/RouterSwitchCommands/network/members)
+
+# Router & Switch Commands
+### Estructura y referencia para documentar comandos y conceptos de redes
+
+Router & Switch Commands nació como una recopilación de apuntes personales para organizar y entender mejor distintos comandos, configuraciones y conceptos de redes, incluyendo routing, switching, seguridad y servicios de red.
+
+Con el tiempo, se fue estructurando para que sea más fácil de navegar y consultar, tanto para mí como para cualquier persona interesada en aprender o consultar conceptos y comandos de manera práctica.
+
+---
+<details open>
+<summary><strong>• OBJETIVOS DEL PROYECTO</strong></summary>
+<h1>Objetivos del proyecto</h1>
+
+- Proporcionar un **formato claro y reutilizable** para documentar comandos y configuraciones de routers y switches.
+- Facilitar una documentación **legible y mantenible a largo plazo**.
+- Reducir duplicación, ambigüedad y variaciones innecesarias entre distintos materiales de referencia.
+- Servir como guía práctica para administradores de redes, ingenieros y estudiantes de networking.
+</details>
+
+---
+<details open>
+<summary><strong>• ENFOQUE DEL PROYECTO</strong></summary>
+<h1>Enfoque del proyecto</h1>
+
+El repositorio no pretende sustituir la documentación oficial de fabricantes, sino **complementarla** mediante:
+
+- Ficheros organizados por área (routing, switching, seguridad, servicios),
+- Convenciones claras de documentación,
+- Ejemplos prácticos y homogéneos,
+- Una estructura pensada para crecer sin perder consistencia.
+</details>
+
+---
+<details open>
+<summary><strong>• ESTRUCTURA DEL PROYECTO</strong></summary>
+<h1>Estructura del proyecto</h1>
+
+La organización del repositorio está pensada para facilitar la navegación y el crecimiento progresivo del contenido:
+
+<!-- AUTO-GENERATED-INDEX:START -->
+<!-- AUTO-GENERATED-INDEX:END -->
+</details>
+
+---
+<details open>
+<summary><strong>• CONTRIBUYE AL PROYECTO</strong></summary>
+<h1>Contribuye al proyecto</h1>
+
+Las contribuciones son bienvenidas siempre que respeten el formato y la estructura definidos.  
+El objetivo es mantener una documentación coherente y de alta calidad.
+
+> [Crear pull request](https://github.com/Nisamov/RouterSwitchCommands/pulls)
+</details>
+
+---
+<div align="center">
+  <p>Router & Switch Commands - By Nisamov | MIT License - 2026</p>
+  <p>Contacto: <a href="mailto:nisamov.contact@gmail.com">nisamov.contact@gmail.com</a></p>
+</div>

Router/enrutamiento_ospf.md

@@ -14,4 +14,4 @@ Ejemplo práctico:
 Router(config)# interface gigabitEthernet 0/0
 Router(config-if)# ip address 192.168.1.1 255.255.255.0
 Router(config-if)# no shut
-```
+```