Alias estables
/docs/ y /latest/ son los puntos de entrada públicos duraderos de plasmoid. Son
alias de ruta reales de la versión actual, no páginas de redirección, así que un
enlace profundo como /docs/getting-started/quickstart/ se resuelve a un archivo
real y sobrevive a los cambios de versión.
/latest/refleja el directorio de la versión actual./docs/refleja el subárbol del locale por defecto de la versión actual./<version>/redirige al locale por defecto de esa versión (de modo que una URL de versión a secas aterriza en el inicio).
Elegir cómo se materializan
Define el modo en plasmoid.toml:
[deploy]
aliases = "symlink" # symlink (default) | copy | redirect
| Modo | /docs/ + /latest/ son… | Enlaces profundos | Portabilidad | Ajuste de nginx por publicación |
|---|---|---|---|---|
symlink (por defecto) | enlaces simbólicos relativos (docs → 1.2.0/en) | se resuelven como archivos | necesita un transporte que preserve los enlaces simbólicos (rsync -a, tar; nginx los sirve sin problema) | ninguno |
copy | árboles duplicados reales | se resuelven como archivos | funciona en cualquier sitio (almacenes de objetos, hosts simples) | ninguno |
redirect | páginas de redirección a secas | solo /docs/ en sí; las rutas profundas dan 404 | funciona en cualquier sitio | sí |
Usa symlink para nginx (el valor por defecto), o copy para
almacenamiento de objetos y hosts estáticos que no preservan los enlaces
simbólicos. Ambos hacen que el despliegue sea agnóstico a la versión.
La reserva redirect
El modo redirect emite las páginas de redirección de entrada al estilo antiguo:
/docs/ funciona, pero /docs/<deep/path> devuelve 404 bajo un servidor de
archivos simple. Para restaurar los enlaces profundos bajo nginx reintroduces una
reescritura por publicación (comentada en el deploy/nginx.conf que se incluye):
set $plasmoid_latest "1.2.0";
set $plasmoid_locale "en";
location ^~ /docs/ { rewrite ^/docs/(.*)$ /$plasmoid_latest/$plasmoid_locale/$1 last; }
location ^~ /latest/ { rewrite ^/latest/(.*)$ /$plasmoid_latest/$1 last; }
Los modos por defecto existen precisamente para que nunca tengas que tocar esto.
Enviar enlaces simbólicos
Los enlaces simbólicos son relativos, así que el árbol se mantiene reubicable.
Solo usa un transporte que los preserve: rsync -a, tar o un montaje bind de
Docker lo hacen. nginx sigue los enlaces simbólicos de fábrica.