Compilar y publicar documentación¶
Compile en el directorio de salida habitual del proyecto:
guidedog build html docs/manual -j auto -W
guidedog build pdf docs/manual -W
El sitio está en docs/manual/_build/html; el PDF y su fuente Typst, en docs/manual/_build/pdf. Un servidor web puede servir el directorio HTML como archivos estáticos. En producción no hace falta un servidor Odin.
Elegir el directorio de salida¶
La forma al estilo de Sphinx indica explícitamente fuente y destino:
guidedog build -b html docs/manual build/manual-site -W
Mantén la salida fuera de las fuentes. Guidedog rechaza una disposición que las sustituya al publicar. Un destino personalizado tiene una caché vecina estable, como build/.manual-site.guidedog/.doctrees. El directorio publicado contiene así solo la publicación.
Vista previa y comprobación¶
guidedog serve docs/manual
guidedog build dummy docs/manual -n -W
El constructor dummy lee y resuelve el proyecto sin publicar. Sirve para una comprobación semántica rápida, no para verificar el diseño final.
Una fecha reproducible¶
SOURCE_DATE_EPOCH=1790812800 guidedog build html docs/manual -W
Esto fija la hora de construcción. La reproducibilidad también depende de fuentes, plantillas, tipografías, versiones del compilador y recursos. Fijar el reloj no basta.
Publica el directorio completo tras una construcción exitosa. La salida correcta del proceso es necesaria; después de cambiar plantillas también hace falta una revisión visual.