Su primera compilación
Ejecutemos una compilación real y veamos qué produjo plasmoid.
Ejecutarla
--version es opcional. Por defecto, plasmoid lee la versión del Cargo.toml de su proyecto
([versions] source = "cargo"); pase --version para anularla o
cuando el proyecto no sea de Rust. Consulte Versionado.
El árbol de salida
public/
index.html # the landing (mounted static, markdown home, or redirect)
docs/ # stable alias → current version's default locale
latest/ # stable alias → current version
0.1.0/ en/ # the actual rendered docs
search/ # the sharded search index
versions/ # the version index page
archive/ # zipped versions older than `retain`
assets/ # css, tiny js, fonts, highlight styles
404.html # custom not-found page
Cada página es un index.html real en una ruta de URL limpia; por ejemplo,
0.1.0/en/getting-started/quickstart/index.html se sirve en
/0.1.0/en/getting-started/quickstart/.
Puntos de entrada estables
Usted no enlaza a las personas a una ruta fijada a una versión. plasmoid garantiza dos alias estables:
/docs/→ la documentación del locale por defecto de la versión actual./latest/→ la versión actual.
Estos son alias de ruta reales, de modo que los enlaces profundos como
/docs/getting-started/quickstart/ siguen funcionando a través de las versiones.
Las recompilaciones se hacen en el sitio
Volver a ejecutar build para la misma versión sobrescribe /<version>/: las correcciones de documentación
entre versiones no generan una versión nueva. Incrementar la versión crea un nuevo
directorio /<version>/ y desplaza las versiones más antiguas a través de la
retención.
Servir el resultado
Cualquier servidor de archivos estáticos sirve para echar un vistazo rápido:
&&
Para producción, use la receta de nginx: gestiona las URL limpias, el 404 personalizado, las descargas del archivo y el almacenamiento en caché.