gemini - kennedy.gemi.dev

💾 Archived View for sl1200.dystopic.world › art › hugo.gmi captured on 2022-06-11 at 20:50:23. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

HUGO, primer contacto con un generador de sitios estáticos

12-2021 | #hugo #ssg

Instalación en Windows, sí esto lo he hecho en Windows. Lo primero, creamos el directorio "c:\Hugo" y dentro de él los directorios "bin" y "Sites"
Copiar el archivo https://github.com/gohugoio/hugo/releases/download/v0.89.4/hugo_0.89.4_Windows-64bit.zip en "c:\Hugo\bin", y lo descomprimimos. Dentro de "bin" tendremos el ejecutable "hugo.exe".
Añadimos la ruta "c:\Hugo\bin" al path. Para ello entramos en "Propiedades del Sistema" y despúes "Variables de Entorno".
En el cuadro inferior "Variables del Sistema" clickamos sobre "Path", después "Nuevo" y añadimos la línea "c:\Hugo\bin"
Ahora hugo.exe ya será ejecutable desde cualquier directorio. Para crear nuestro primer sitio accedemos al directorio "Sites" que hemos creado antes e introducimos la orden:

       hugo new site nombredelsitio

Entonces Hugo te creará una serie de directorios y archivos en la carpeta "c:\Hugo\Sites\nombredelsitio"
Buscamos un tema que nos guste en https://themes.gohugo.io/ y lo instalamos copiando el archivo .zip del repositorio en github del tema en la carpeta "themes" que ha creado Hugo dentro de "c:\Hugo\Sites\nombredelsitio" y lo descomprimimos.
Modificamos el archivo de configuración del sitio "config.tolm" para añadir el tema, mirar si hay que añadir algo más según las instrucciones de tema en github. Si es un tema sencillo sólo tendrás que añadir la línea theme = "nombre del tema" al archivo "config.tolm".
Nos metemos en el directorio principal del sitio que estamos creando "c:\Hugo\Sites\nombredelsitio" y creamos un primer post:

       hugo new post/post_1.md

Esto nos creará un archivo markdown en "c:\Hugo\Sites\nombredelsitio\content\post" ,en ese archivo escribiremos el artículo con sintaxis markdown.
Una vez creada tu primera entrada activamos el servidor para comprobar cómo queda nuestra web ejecutando esta orden dentro del directorio de tu sitio:

       hugo server

Copiamos la dirección que se nos indica y la pegamos en nuestro navegador, ahora ya vemos cómo quedará.
Si nos gusta, paramos el servidor con Ctrl+c y ejecutamos esta simple orden:

       hugo

Ahora Hugo ha construido tu sitio web, encontrarás los archivos index.html, los css y demás en el directorio "public" del directorio de tu sitio. Ahora sólo tienes que copiar esos archivos en tu propio servidor o, si quieres, en Onionshare para tener una web .onion.

Crear tu sitio estático con Hugo vs crear una cápsula gémini.

Desde la óptica de una persona que no tenga conocimientos informáticos es un lío crear tu sitio web comparado con crear tu sitio gemini. Usar un generador de sitios estáticos como Hugo puede facilitar las cosas pero debes someterte a las limitaciones de usar un tema bastante rígido o liarte a hacer de informático editando el tema o creando uno nuevo. Además, una vez has creado el sitio se generan un chorreo de archivos que no sabes qué son y en según que tema cuando entras a la web descubres conexiones y recursos de google y cloudflare que no entiendo qué hacen ahí. En gemini también es muy sencillo plantearte un "diseño" de lo que es el árbol de directorios, página indice, archivos y demás, algo que no es fácil en un sitio web aunque uses un generador de sitios estáticos. A esto hay que añadir la relativa dificultad para un iniciado al instalar y gestionar tu servidor web, incluso nginx, y el certificado Let's Encrypt si se compara con la extrema sencillez de instalación y obtención de certificado con un servidor gemini como Agate.

Para páginas web muy sencillas pasaría de usar un generador de sitios estáticos, vale la pena usar directamente un editor markdown que te permita exportar a html y gestionar tú mismo la estructura de archivos de tu web.

This work by SL1200 is marked with CC0 1.0

◄ BACK

🏠 Home