hbox-docs/mkdocs.yml

site_name: Drogheda
site_description: HBOX RTK (EinarBoard) — producción, taller, campo, tableros y hardware. Sitio interno de Helgen Technologies.
site_url: https://drogheda.helgen.online/
copyright: "© Helgen Technologies — uso interno"

theme:
  name: material
  custom_dir: overrides          # logo, plantilla de tableros e íconos de línea (overrides/.icons/helgen)
  language: es
  favicon: img/favicon.png
  font: false                    # letras propias en docs/fonts (sitio utilizable sin Internet)
  icon:
    search: helgen/buscar
    menu: helgen/menu
    close: helgen/cerrar
    previous: helgen/izquierda
    next: helgen/derecha
    top: helgen/arriba
  # Oscuro por omisión: el primero de la lista manda. El botón del encabezado cambia a claro.
  palette:
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: helgen/sol
        name: Cambiar a modo claro
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: helgen/luna
        name: Cambiar a modo oscuro
  features:
    - navigation.sections        # barra lateral con secciones, sin pestañas arriba
    - navigation.indexes
    - navigation.top
    - navigation.footer
    - navigation.tracking
    - search.suggest
    - search.highlight
    - content.code.copy
    - toc.follow

extra:
  # Clave con que el navegador guarda las preferencias (modo claro/oscuro).
  # Se cambió el 20-oct-2026 para que todos arranquen en oscuro; js/tema.js lee la misma clave.
  scope: /drogheda/

extra_css:
  - stylesheets/helgen.css
  - stylesheets/extra.css

extra_javascript:
  - js/sitio.js

hooks:
  - hooks/iconos.py              # íconos del menú lateral (también para páginas que llegan por sync-docs.sh)
  - hooks/frontmatter.py         # encabezados YAML con «: » sin comillas: se leen igual (no toca los archivos)
  - hooks/documentos.py          # «Documentos recientes» del inicio: site/datos/documentos.json (páginas con date:)
  - hooks/versiones.py           # ?v=<huella> en las ligas a .css y .js propios: cada deploy llega sin recargar a la fuerza

plugins:
  - search:
      lang: [es, en]
      separator: '[\s\-\.,:/]+'

markdown_extensions:
  - admonition
  - tables
  - def_list
  - attr_list
  - md_in_html
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tasklist:
      custom_checkbox: true
  - toc:
      permalink: true

# Menú lateral. Reglas: sin emoji, títulos de 4 palabras o menos.
# Documento nuevo con fecha (auditoría, pasada, plan): agréguelo arriba en
# Tarjetas y hardware → Auditorías y pasadas («19 oct · Tema») y en bitacora.md.
# Cuando lo supere otro, muévalo a Historia → Tarjetas superadas.
nav:
  - Inicio: index.md
  - Pendientes: tableros/pendientes.md
  - Bitácora: bitacora.md

  - Tableros:
      - tableros/index.md
      - Ingeniería: tableros/ingenieria.md
      - Producción: tableros/produccion.md
      - Actas: tableros/actas.md
      - Inventario: tableros/inventario.md
      - Sitios: tableros/sitio.md
      - Equipo: tableros/equipo.md
      - Expediente de unidad: tableros/unidad.md
      - Visitas de campo: tableros/campo.md

  - Documentos:
      - Guía del ingeniero: guia-ingeniero.md
      - Producción:
          - produccion/index.md
          - Prueba de tarjetas:
              - Procedimiento: procedimientos/v5-prueba-y-flasheo.md
              - Acta de tarjeta V5: formularios/v5.html
          - Módulos RTK y 4G:
              - Procedimiento: procedimientos/v5-modulos-integracion.md
              - Acta ArduSimple: formularios/ardusimple.html
              - Acta módem 4G: formularios/modem4g.html
              - Acta de integración: formularios/integracion.html
          - Ensamble:
              - Procedimiento: procedimientos/v5-ensamble.md
              - Acta de ensamble: formularios/ensamble.html
          - Prueba final: procedimientos/v5-prueba-final-unidad.md
          - Configuración: procedimientos/v5-configuracion-unidad.md
          - Política de inventario: inventario/index.md
      - Taller:
          - taller/index.md
          - Diagnóstico en banco:
              - Procedimiento: procedimientos/diagnostico-banco.md
              - Acta de banco: formularios/banco.html
          - Reflasheo:
              - Procedimiento: procedimientos/reflasheo-unidades.md
              - Acta de reflasheo: formularios/reflasheo.html
          - Módem en batería:
              - Procedimiento: procedimientos/prueba-bateria-modem.md
              - Acta de la prueba: formularios/prueba-bateria.html
          - Ethernet y serie:
              - Procedimiento: procedimientos/v5-prueba-ethernet-serie.md
              - Acta de la prueba: formularios/ethernet-serie.html
          - V4 con 0.6.0:
              - Procedimiento: procedimientos/v4-prueba-fw-0.5.6.md
              - Acta de prueba V4: formularios/v4.html
          - V4 sin NMEA: procedimientos/v4-prueba-riel-sw5v-f9p.md
      - Campo:
          - campo/index.md
          - Diagnóstico en campo:
              - Procedimiento: diagnostico/procedimiento-diagnostico-campo.md
              - Acta de diagnóstico: formularios/diagnostico.html
          - Instalación:
              - Checklist para imprimir: procedimientos/v5-checklist-puesta-en-marcha.md
              - Acta de instalación: formularios/instalacion.html
          - Envío y recepción:
              - Ciclo de vida: procedimientos/ciclo-de-vida.md
              - Acta de envío: formularios/envio.html
              - Acta de recepción: formularios/recepcion.html
              - Acta de daño: formularios/dano.html
          - Sitios y puertos: sitios/index.md
          - Cómo funcionan las actas: actas/index.md
      - Tarjetas y hardware:
          - hardware/index.md
          - Manuales por tarjeta: manuales/index.md
          - Auditorías y pasadas:
              - 21 oct · Estado v6 (T25, T28, T38): hardware/v6-estado-21oct.md
              - 21 oct · V5.6/V5.7, pasadas 4 a 6: hardware/v56-v57-auditoria-21oct.md
              - 19 oct · Críticos V5.6: hardware/v56-clasificacion-19oct.md
              - 19 oct · Re-auditoría: hardware/re-auditoria-19oct.md
              - 19 oct · Pasada 4: hardware/v56-v57-layout-pasada-4.md
              - 16 oct · Plan v6: hardware/v6-plan-fines-de-semana.md
              - 16 oct · Auditoría v6: hardware/v6-auditoria-produccion-16oct.md
              - 16 oct · Auditoría de producción: hardware/auditoria-produccion-16oct.md
          - V5.5 y V5.6:
              - Manual V5: manuales/manual-tarjeta-V5.md
              - Hoja de datos V5.6: hardware/v56-datasheet.md
              - Pinout V5.6: hardware/v56-pinout.md
              - ECO V5.6: hardware/v56-eco.md
              - Cambios al esquemático: hardware/v56-cambios-esquematico.md
              - Reglas de layout: hardware/v56-layout-instrucciones.md
          - V5.7:
              - ECO V5.7: hardware/v57-eco-fuente.md
          - v6:
              - Manual v6: manuales/manual-tarjeta-v6.md
              - Plan de corrección: hardware/v6-plan-correccion.md
              - Esquemático final: hardware/v6-cambios-resumen.md
              - Mapa de pines: hardware/v6-pinmap.md
              - Plan de cobre: hardware/EinarBoard-v6_Plan-de-Cobre_ES.html
              - Plan de cobre (inglés): hardware/EinarBoard-v6_Copper-Plan_EN.html
              - Auditoría del 28 sep: hardware/v6-auditoria-completa.md
              - Auditoría 28 sep (inglés): hardware/v6-full-audit.md
              - Pasada 1 (28 sep): hardware/v6-cambios-esquematico.md
              - Pasada 2 (inglés): hardware/v6-puertos-sin-nueva-version.md
              - Pasada 3 (inglés): hardware/v6-revision-final.md
              - Próximos pasos (superado): hardware/v6-proximos-pasos.md
          - V4 y V3:
              - Manual V4: manuales/manual-tarjeta-V4.md
              - Manual V3: manuales/manual-tarjeta-V3.md
              - Pinout V3: montaje/pinout-arneses.md
      - Manuales y descargas:
          - Manual del cliente: manuales/manual-cliente.md
          - Manual de instalación (PDF): manuales/Drogheda-Manual-Instalacion-Operacion_v2.0.pdf
          - Ficha técnica (PDF): manuales/Drogheda-HBOX-Datasheet_v2.0.pdf
          - Descargas:
              - descargas/index.md
              - Notas de versión: descargas/notas-de-version.md
              - README del firmware: descargas/hbox-v5-bringup-README.md
          - Git y KiCad:
              - Guía Git: git/guia-git-es.md
              - Guía Git (inglés): git/git-guide-en.md
      - Historia:
          - historia/index.md
          - Procedimientos superados:
              - Diagnóstico remoto v1: diagnostico/protocolo-diagnostico-remoto.md
              - EinarBoard 1.0: procedimientos/einarboard-1.0-bringup.md
              - Ventilador FW 3.0.3: procedimientos/fan-policy-bench-test.md
              - Protoboard v3: procedimientos/historico-proto-bench-v3.md
              - Compras protoboard v3: procedimientos/historico-protoboard.md
          - Producción V3:
              - BOM V3: montaje/bom-split.md
              - Ensamble y QC V3: montaje/guia-ensamble-qc.md
              - Gabinete 0007-1000: montaje/assembly-guide.md
          - Tarjetas superadas:
              - 16 oct · Pasada 3: hardware/v56-v57-layout-pasada-3.md
              - 14 oct · Ruteo V5.7: hardware/v57-colocacion-ruteo.md
              - 13 oct · Pasada 2: hardware/v56-layout-pasada-2.md
              - 13 oct · Auditoría de layout: hardware/v56-auditoria-layout-13oct.md
              - 13 oct · Guía fuente V5.7: hardware/v57-layout-guia.md
              - 12 oct · Pasada 1: hardware/v56-layout-pasada-1.md
              - 28 sep · Lecciones V5.5: hardware/v6-revision-lecciones-v55.md
              - 25 sep · Pre-fabricación v6: hardware/v6-auditoria-prefab.md
              - 25 sep · Pre-fab (inglés): hardware/v6-prefab-audit.md

  - Cuenta:
      - Mi cuenta: cuenta.html
      - Administración: admin.html
      - Salir: salir.html