Proyecto basado en Doks y doks-gh-pages
Puede utilizarse con las herramientas instaladas o utilizando un contenedor de 🐳, como por ejemplo este.
Para comenzar a editar, se debe clonar o forkear el repositorio (recordando que si se clona será necesario cambiar el link al repositorio remoto, ya que esto se trata de una plantilla y no debe ser modificada)
Una vez descargado el proyecto, se debe ejecutar el siguiente comando para contar con los paquetes necesarios para compilar el código:
npm install
Luego, para probar el funcionamiento, se puede ejecutar:
npm run start
lo cual iniciará el servidor de desarrollo en el puerto 1313 por defecto.
Para modificar según sea necesario, las carpetas más importantes a tener en cuenta son:
-
content
: Como su nombre lo indica, allí se encuentran los archivos que hacen al contenido del documento. -
layouts
: Contiene la estructura html del template, además de ciertas configuraciones como headers y redirecciones -
config
: Archivos de configuración varios._default
contiene la configuración en sí de la estructura de la página, mientras queproduction
es exclusiva para ambientes productivos (en este caso sólo contiene la url de producción enconfig.toml
)
Para mayor detalle de la estructura de directorios y su contenido, visitar aquí.
En este caso se desplegó en Github Pages, utilizando Github Actions. Sin embargo si se observa el .yml de ci, se notará que utiliza simplemente una imagen de node para generar el documento estático.
En la documentación oficial de Doks se encuentran ejemplos de otros servicios como AWS o Gitlab pages.