Resumen de despliegue

La tarea de plasmoid termina al producir un árbol estático. No hay tiempo de ejecución, ni servidor de aplicaciones, ni herramienta de despliegue obligatoria: sirves el directorio que build produjo desde cualquier host estático. El despliegue queda deliberadamente fuera del núcleo: los destinos varían demasiado como para integrar uno.

El flujo

# 1. build
plasmoid build --docs ./docs --site ./public

# 2. ship the tree (rsync preserves the alias symlinks)
rsync -a --delete ./public/ web:/srv/www/site/

# 3. serve it — see the nginx recipe

La página de inicio en /

La raíz del sitio (/) se elige por una simple precedencia:

1. Página de inicio estática preconstruida — si [landing] dir apunta a un directorio, plasmoid lo copia a / tal cual (tu página de marketing construida por separado). plasmoid nunca la compila; solo monta el resultado terminado.
2. Inicio en Markdown — de lo contrario, si el locale por defecto tiene un index.md, su página de inicio renderizada se monta en /.
3. Redirección — de lo contrario / redirige a /docs/.

Esto permite que un proyecto vistoso publique una página de inicio a medida mientras que uno sencillo obtiene un inicio limpio en Markdown, sin ningún cambio de código en plasmoid.

Conectar la página de inicio y la documentación

Cuando una página de inicio real está en / (niveles 1 y 2), plasmoid conecta las dos automáticamente, sin cableado manual de URL:

• Documentación → página de inicio. La marca/logo de la documentación enlaza a / (la página de inicio), de modo que al hacer clic desde cualquier página de documentación regresas a la página de inicio en lugar de volver a entrar en la documentación. Con una raíz de solo redirección (nivel 3) la marca permanece en /docs/.
• Página de inicio → documentación. Apunta el botón Lee la documentación de tu página de inicio al alias estable /docs/. Se resuelve a la documentación del locale por defecto de la versión actual y sobrevive a cada publicación, así que el enlace nunca queda obsoleto.

Ese es todo el contrato: coloca una página de inicio, enlázala a /docs/, y el ida y vuelta simplemente funciona.

Puntos de entrada estables

Sin importar cómo lo alojes, enlaza a la gente a los alias estables: /docs/ (documentación del locale por defecto actual) y /latest/ (versión actual). Sobreviven a los cambios de versión para que los enlaces externos y los marcadores no se degraden.

Opciones de alojamiento

• nginx — la receta documentada se encarga de las URL limpias, el 404 personalizado, las descargas de archivos y el caché. Es el destino de referencia.
• Almacenamiento de objetos / hosts estáticos — también funcionan. Si tu host no preserva los enlaces simbólicos, compila con [deploy] aliases = "copy" para que los alias sean directorios reales. Consulta Alias.