diff --git a/workloads/docs-portal/Dockerfile b/workloads/docs-portal/Dockerfile index c2a4b7d..22bdd77 100644 --- a/workloads/docs-portal/Dockerfile +++ b/workloads/docs-portal/Dockerfile @@ -3,14 +3,6 @@ FROM python:3.12-slim AS build WORKDIR /site -# mkdocs-git-revision-date-localized-plugin depende de GitPython, que -# necesita el binario git presente solo para poder importarse (si falta, -# el import truena y rompe el build --strict, incluso con -# fallback_to_build_date activado en mkdocs.yml). -RUN apt-get update \ - && apt-get install -y --no-install-recommends git \ - && rm -rf /var/lib/apt/lists/* - COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt diff --git a/workloads/docs-portal/docs/index.md b/workloads/docs-portal/docs/index.md index 99ad957..06fe08d 100644 --- a/workloads/docs-portal/docs/index.md +++ b/workloads/docs-portal/docs/index.md @@ -44,12 +44,17 @@ que cada una pueda entrar por su propia puerta: ## Estado de este sitio -Este portal se mantiene vivo junto con el lab — cada página muestra su -última fecha de modificación real (`git-revision-date-localized`). Si -una página dice "TODO", es contenido pendiente de una fase posterior, -no una promesa incumplida: la estructura completa se construyó primero -a propósito, para que el contenido se llene sección por sección con el -mismo criterio que el resto del lab. +Este portal se mantiene vivo junto con el lab. La idea es que cada +página muestre su última fecha de modificación real vía +`git-revision-date-localized` — por ahora ese plugin está deshabilitado +(ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`, +que aborta ante cualquier `WARNING`, y el plugin no tiene historial git +real que leer desde el contexto de build actual, así que se queda fuera +hasta que ese contexto incluya `.git` de verdad. Si una página dice +"TODO", es contenido pendiente de una fase posterior, no una promesa +incumplida: la estructura completa se construyó primero a propósito, +para que el contenido se llene sección por sección con el mismo +criterio que el resto del lab. Desde este commit, el sitio se construye y publica solo: cada push a `main` que toca `docs/` o `mkdocs.yml` dispara diff --git a/workloads/docs-portal/mkdocs.yml b/workloads/docs-portal/mkdocs.yml index 15e64e5..b6e71fe 100644 --- a/workloads/docs-portal/mkdocs.yml +++ b/workloads/docs-portal/mkdocs.yml @@ -43,10 +43,18 @@ theme: plugins: - search: lang: es - - git-revision-date-localized: - enable_creation_date: true - type: date - fallback_to_build_date: true + # TODO (fase 2): git-revision-date-localized deshabilitado a propósito. + # El Dockerfile construye con context: workloads/docs-portal/, que no + # incluye .git (vive en la raíz del repo) — el plugin no tiene historial + # real que leer y cae siempre en fallback_to_build_date, emitiendo un + # WARNING por página. mkdocs build --strict aborta ante CUALQUIER + # WARNING, así que mientras no se le dé contexto de build con .git real + # (mover el build a la raíz del repo + fetch-depth:0 en el workflow), + # este plugin debe quedar fuera para no romper el pipeline. + # - git-revision-date-localized: + # enable_creation_date: true + # type: date + # fallback_to_build_date: true markdown_extensions: - admonition diff --git a/workloads/docs-portal/requirements.txt b/workloads/docs-portal/requirements.txt index 0f4e44e..617064a 100644 --- a/workloads/docs-portal/requirements.txt +++ b/workloads/docs-portal/requirements.txt @@ -1,3 +1,3 @@ mkdocs==1.6.* mkdocs-material==9.5.* -mkdocs-git-revision-date-localized-plugin==1.2.* +# mkdocs-git-revision-date-localized-plugin==1.2.* # deshabilitado, ver TODO en mkdocs.yml