Skip to content

feat(guías): estructura navegable, progreso y portada de ruta#12

Merged
TellMeAlex merged 5 commits into
mainfrom
feat/guias-estructura-navegacion
Jun 14, 2026
Merged

feat(guías): estructura navegable, progreso y portada de ruta#12
TellMeAlex merged 5 commits into
mainfrom
feat/guias-estructura-navegacion

Conversation

@SirMinionBot

@SirMinionBot SirMinionBot commented Jun 14, 2026

Copy link
Copy Markdown
Collaborator

Qué hace

Arregla y reestructura la sección Guías (rutas). Construye sobre el commit de renombrado dojo→Guías.

🐞 Fix raíz · scroll de página (el más importante)

El tokens.css del theme fuerza body { overflow: hidden } (pensado para los slide decks). Al importarlo, toda la web heredaba ese bloqueo: como html es visible, el hidden del body se propaga al viewport y la página entera dejaba de scrollear — sin barra, sin rueda, sin teclado, en todas las páginas. Se sobrescribe en site.css con overflow-x: hidden; overflow-y: auto. (Era la causa del "ni siquiera tenemos scroll".)

P0 · Bugs de contenido

  • Numeración de módulos correlativa (orden 1–6); elimina el "módulo intro" fantasma.
  • Elimina 12+ enlaces rotos heredados de Docusaurus (./intro, ./0x-*, /docs/proyectos/*); el taller apunta a /talleres.

P1 · Navegabilidad de la guía

  • Layout a 2 columnas con TOC pegajoso generado desde los encabezados.
  • Resaltado de sección activa (IntersectionObserver) + barra de progreso de lectura.

P2 · Progreso y portada

  • ListaPasos.svelte: barra de progreso siempre visible + toggle de completado por paso en ambas rutas (sincroniza con el botón de la guía vía localStorage).
  • Portada de ruta con contrato: "qué te llevas / requisitos / qué no cubre".
  • Elimina ProgresoRuta.svelte (código muerto).

P3 · Iconos SVG en encabezados

  • Plugin rehype (src/lib/rehype-heading-icons.mjs) que mapea el emoji inicial de cada H2/H3 a un icono SVG inline estilo trazo en color de marca, sin depender de fuentes de emoji del sistema (adiós tofu).

Capturas

Portada de ruta — contrato + lista con progreso

portada de ruta

Página de guía — TOC pegajoso + iconos SVG

página de guía

Notas

  • docs/pr/*.png son solo para esta descripción; no entran en el build y se pueden borrar tras el merge.
  • pnpm build verde (23 páginas).

🤖 Generated with Claude Code

SirMinionBot and others added 2 commits June 13, 2026 15:11
Etiquetas visibles, nav, eyebrows, CTAs, títulos y RSS pasan de
'el dojo'->'Guías' y 'el zine'->'Artículos' para que se entienda mejor
qué ofrece el sitio. URLs (/rutas, /ensayos), colecciones e identificadores
de datos se mantienen para no romper enlaces ni contenido.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
P0 — numeración de módulos correlativa (orden 1–6) y eliminación de enlaces rotos heredados de Docusaurus (./intro, ./0x-*, /docs/proyectos/*).
P1 — página de guía a 2 columnas con TOC pegajoso, resaltado de sección activa y barra de progreso de lectura.
P2 — ListaPasos.svelte: barra de progreso siempre visible y toggle de completado por paso en ambas rutas; portada de ruta con contrato (qué te llevas / requisitos / qué no cubre). Elimina ProgresoRuta.svelte (código muerto).

Capturas en docs/pr/ solo para la descripción del PR (no entran en el build; eliminables tras el merge).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added size/XL content documentation Improvements or additions to documentation frontend styles labels Jun 14, 2026
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added size/XL and removed size/XL labels Jun 14, 2026
Plugin rehype (src/lib/rehype-heading-icons.mjs) mapea el emoji inicial de cada H2/H3 a un icono SVG inline estilo trazo en color de marca, sin depender de fuentes de emoji del sistema (adiós tofu). El markdown conserva el emoji como marcador semántico. Limpia el emoji del texto del TOC. Actualiza la captura del PR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added size/XL and removed size/XL labels Jun 14, 2026
… caché de GitHub)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added size/XL and removed size/XL labels Jun 14, 2026
@TellMeAlex TellMeAlex merged commit 8f7d28a into main Jun 14, 2026
9 checks passed
@TellMeAlex TellMeAlex deleted the feat/guias-estructura-navegacion branch June 14, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content documentation Improvements or additions to documentation frontend size/XL styles

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants