Este es el repositorio de la página web de la Asociación QGIS España disponible en qgis.es, realizada con el generador de contenidos HUGO y desplegada automáticamente a través de netlify.
Buena parte de la organización y el proceso de edición de la página web está recogida en la propia página web en el apartado de manual de uso.
Para poder trabajar con el repositorio en local,subir las modificaciones a github incluso si se quiere recrear la web con HUGO se comenta a continuación el proceso:
Hay que tener presente que la página web se genera con el repositorio de github y los submódulos para HUGO.
Opción A: (1 paso)
- Clonar el repositorio junto con los submódulos
git clone [email protected]:qgises/qgis-es.git --recurse-submodules
Opción B (2 pasos):
- Clonar repositorio:
git clone [email protected]:qgises/qgis-es.git
- Descargar contenido del theme (es un submódulo)
git submodule update --init --recursive
Por la naturaleza propia de la tecnología usada en el desarrollo de esta página web (HUGO) la edición de contenidos se realiza en la carpeta content
como se indica en el manual.
Aunque la página web se genera automáticamente vía Netlify si queremos tenerla en local o de cara a un futuro para no depender de Netlify, se puede correr y servir corriendo HUGO.
Este es un ejemplo de cómo recrear la página web en local con una imagen docker de HUGO:
docker run --rm -it -v $PWD:/src klakegg/hugo:0.70.0-ext
Si además queremos verla debemos servirla en un puerto de nuestro equipo:
docker run --rm -it -v $PWD:/src -p 1313:1313 klakegg/hugo:0.70.0-ext serve
# también se puede correr con podman
podman run --rm -it -v $PWD:/src -p 1313:1313 klakegg/hugo:0.70.0-ext serve
También se ha añadido un archivo docker-compose.yml en el repositorio que se puede ejecutar, del siguiente modo:
# arrancar servicio en local
docker-compose up -d
# parar servicio en local
docker-compose down
Más instrucciones en la misma página de HUGO