Notas de Hacking

English version

Sitio publicado en: https://fravelz.github.io/WEB-Notas-de-Hacking/

Posicionamiento: jardín de notas / Docs · Lab — no es producto SaaS ni plataforma de cursos. En el portafolio (WEB-Fravelz) la ficha notas-hacking lleva badges de honestidad lab + terminado (contrato plan 11 / regresión A1-7). No pitchar como app fullstack.

Apuntes para repasar ciberseguridad. Sitio estático con Astro y el tema Starlight: las notas viven en Markdown (y MDX donde aplica), con búsqueda, tema oscuro y barra lateral definida explícitamente para mantener el orden de los temas.

Con esta carpeta como raíz del workspace en Cursor, los comandos /update-docs y /auto-commit están en .cursor/commands/ para mantener documentación bilingüe y commits alineados al repo.

✨ Características

• Contenido por secciones: notas agrupadas (Linux, Python, Windows, redes, pentesting, etc.).
• Búsqueda: incluida por Starlight sobre títulos y cuerpo de las páginas.
• Tabla de contenidos: por página cuando aplica.
• Tema personalizado: paleta en src/styles/theme.css y contenido Markdown / foco / selección en src/styles/markdown-layout.css, cargados en orden como customCss de Starlight (astro.config.mjs).
• Responsive: enlaces públicos desde GitHub Pages (base: /WEB-Notas-de-Hacking).

🛠️ Tecnologías

• Astro 5 — generador del sitio y rutas estáticas.
• @astrojs/starlight — documentación, navegación y búsqueda.
• @astrojs/mdx — Markdown con componentes cuando hace falta.
• TypeScript — tipos en configuración y tipos de contenido.
• Content Collections — colección docs en src/content/docs (definida en src/content.config.ts).

🚀 Desarrollo local

Requisitos: Node.js compatible con Astro 5. El repo incluye pnpm-lock.yaml (recomendado usar pnpm).

pnpm install
pnpm dev

Otros comandos útiles:

• pnpm build — genera la salida en dist/ (lista para GitHub Pages con el base configurado).
• pnpm preview — sirve el build localmente para revisar antes de desplegar.
• pnpm lint:md — markdownlint-cli2 (0 errores en main).
• pnpm lint:links — link check interno del sitio compilado (requiere pnpm build antes).
• pnpm ci:local — lint:md + build + lint:links.

Tracks documentados en la home (Linux, Redes, OSINT) y labs reproducibles bajo src/content/docs/labs/. Plantilla de nota: TEMPLATE-nota.md.

📁 Estructura del proyecto

├── public/                    # Estáticos (favicon, capturas, robots, etc.)
├── src/
│   ├── content/
│   │   └── docs/               # Notas Markdown / MDX (rutas = slugs Starlight)
│   ├── pages/
│   │   └── 404.astro           # 404 personalizado (Starlight tiene disable404Route)
│   ├── styles/
│   │   ├── theme.css           # Paleta (--sl-*) y modo claro/oscuro
│   │   └── markdown-layout.css # Tablas, listas, código en línea, foco, selección
│   ├── content.config.ts       # Colección `docs` (loader y schema de Starlight)
│   └── env.d.ts
├── astro.config.mjs            # Integraciones Starlight + MDX, site/base, metadatos
├── starlight-sidebar.mjs       # Árbol y orden del menú lateral
└── package.json

La barra lateral no se deduce solo de carpetas: el orden visible lo controla starlight-sidebar.mjs para alinearlo con la página de inicio (src/content/docs/index.md).

🎯 Áreas de contenido

• Conceptos básicos — fundamentos, legalidad, mitos.
• Virtualización — conceptos y notas relacionadas.
• Linux — comandos, bash, Bandit y subpáginas de comandos.
• Python — lenguaje y módulos (subprocess, threading, sockets, etc.).
• Windows — PowerShell, permisos, procesos y administración.
• Redes — teoría, subnetting, herramientas.
• Pentesting — fases, tipos de entornos (cajas).
• Web — HTTP, Burp, SQLi, XSS.
• Privilege escalation — Linux y Windows (lab).
• Active Directory — conceptos, enum, ataques de lab.
• CTF / labs — plantilla, cheatsheet, índice de walkthroughs.
• Criptografía — hash, encoding vs cifrado, César.
• Forense — volatilidad, artefactos, herramientas básicas.
• OSINT — terminología, Google dorks, básicos.
• Anonimato — privacidad, huella digital, filtraciones, user-agent.
• Otros — ramas de ciberseguridad, herramientas, recursos, actualizaciones.

📝 Información

Licencia: Apache License 2.0

Fravelz

• GitHub: @fravelz
• Repositorio: WEB-Notas-de-Hacking

🙏 Contribuciones

Las contribuciones son bienvenidas. Si encuentras errores o tienes sugerencias, abre un issue o un pull request.

---

Si te resulta útil el proyecto, puedes darle una estrella en GitHub.