Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
376eb6d46a |
@@ -44,22 +44,9 @@ que cada una pueda entrar por su propia puerta:
|
|||||||
|
|
||||||
## Estado de este sitio
|
## Estado de este sitio
|
||||||
|
|
||||||
Este portal se mantiene vivo junto con el lab. La idea es que cada
|
Este portal se mantiene vivo junto con el lab — cada página muestra su
|
||||||
página muestre su última fecha de modificación real vía
|
última fecha de modificación real (`git-revision-date-localized`). Si
|
||||||
`git-revision-date-localized` — por ahora ese plugin está deshabilitado
|
una página dice "TODO", es contenido pendiente de una fase posterior,
|
||||||
(ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`,
|
no una promesa incumplida: la estructura completa se construyó primero
|
||||||
que aborta ante cualquier `WARNING`, y el plugin no tiene historial git
|
a propósito, para que el contenido se llene sección por sección con el
|
||||||
real que leer desde el contexto de build actual, así que se queda fuera
|
mismo criterio que el resto del lab.
|
||||||
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
|
|
||||||
`.gitea/workflows/deploy-docs.yaml`, que hace `mkdocs build --strict`,
|
|
||||||
publica la imagen en el Registry de Gitea y Argo CD sincroniza el
|
|
||||||
Deployment en el cluster (namespace `docs-portal`). Este párrafo es la
|
|
||||||
prueba: si lo estás leyendo servido desde el pod real, el pipeline
|
|
||||||
funcionó de punta a punta.
|
|
||||||
|
|||||||
@@ -43,18 +43,10 @@ theme:
|
|||||||
plugins:
|
plugins:
|
||||||
- search:
|
- search:
|
||||||
lang: es
|
lang: es
|
||||||
# TODO (fase 2): git-revision-date-localized deshabilitado a propósito.
|
- git-revision-date-localized:
|
||||||
# El Dockerfile construye con context: workloads/docs-portal/, que no
|
enable_creation_date: true
|
||||||
# incluye .git (vive en la raíz del repo) — el plugin no tiene historial
|
type: date
|
||||||
# real que leer y cae siempre en fallback_to_build_date, emitiendo un
|
fallback_to_build_date: true
|
||||||
# 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:
|
markdown_extensions:
|
||||||
- admonition
|
- admonition
|
||||||
|
|||||||
@@ -1,3 +1,3 @@
|
|||||||
mkdocs==1.6.*
|
mkdocs==1.6.*
|
||||||
mkdocs-material==9.5.*
|
mkdocs-material==9.5.*
|
||||||
# mkdocs-git-revision-date-localized-plugin==1.2.* # deshabilitado, ver TODO en mkdocs.yml
|
mkdocs-git-revision-date-localized-plugin==1.2.*
|
||||||
|
|||||||
Reference in New Issue
Block a user