Además de publicar una presentación, también podemos crear un blog y publicarlo con GitHub Pages.
Existen muchos generadores estáticos que podemos usar para crear un blog, pero he elegido el generador Hugo. ¿Por qué? ¿por rapidez? ¿facilidad de uso? ¿porque se llama igual que la película que homenajea a Georges Méliès?
Por si no lo sabes, estoy haciendo una serie de proyectos que mezclen GitHub Pages, desarrollo Front-end y Georges Méliès, así que sí, he elegido Hugo para incluir la temática de Georges Méliès en este proyecto :)
La opción por defecto sería usar Jekyll como generador estático y eso fue lo que hice para crear mi blog. Puedes consultarlo si quieres saber cómo funciona, teniendo en cuenta que cuando lo hice sólo se podía usar la rama gh-pages para publicar en GitHub Pages (ahora también se puede usar la rama master).
Esta vez voy a crear primero la estructura en local y después la subiré a un repositorio de GitHub. En este caso voy a habilitar GitHub Pages en /docs para que se visualice lo que hay en ese directorio (que será el contenido del blog) pero pueda subirse toda la estructura que genera Hugo a GitHub.
Para que Hugo genere el contenido en una carpeta distinta a /public hay que modificar config.toml y poner:
publishDir = "docs"
Puedes consultar el tutorial de Hugo para una explicación más exhaustiva, en mi caso ejecuto estos comandos para instalarlo en Mac:
brew update && brew install hugo
Lo primero que tienes que hacer es crearte el proyecto, que en mi caso se llama melies-hugo:
hugo new site melies-hugo
Después ya puedes escribir el primer artículo eligiendo un nombre de fichero descriptivo:
hugo new post/crear-blog-github-pages.md
Esto crea un fichero en la ruta melies-hugo/content/post/.
Inicialmente se crea un fichero con una fecha, un título y en modo draft.
+++
date = "2017-06-03T16:26:19+02:00"
draft = true
title = "Crear blog con Hugo y publicarlo en Github pages"
+++
El contenido se pondria después de +++ y puedes editar también el front matter, que es el contenido entre +++.
Por ejemplo, en el front matter puedes añadir las etiquetas que va a tener el artículo:
tags = ["Hugo", "GitHub Pages"]
Una vez que termines de editar el fichero puedes quitar la línea de draft o ejecutar:
hugo undraft content/post/crear-blog-github-pages.md
Puedes probarlo ejecutando:
hugo server
Inicialmente es una página en blanco porque necesitas crear o elegir un tema.
Yo he elegido un tema sencillo para el blog, que después se puede customizar: http://themes.gohugo.io/hucore/.
Para el tema que he elegido se ejecuta (una vez estamos en la raíz del proyecto creado):
git init
cd themes
git clone https://github.com/mgjohansen/hucore.git
En la raíz tienes que editar el fichero config.toml con los datos de tu proyecto. Si quieres usar Disqus para habilitar comentarios en tu blog, puedes crear una cuenta y crear un nuevo proyecto en https://disqus.com/admin/create/. En Settings de Disqus tendrás el shortname que tienes que poner en el fichero config.toml.
Ahora puedes probar de nuevo en local utilizando el tema bajado:
Si tienes ficheros draft:
hugo server --theme=hucore --buildDrafts
Si no tienes ficheros draft:
hugo server --theme=hucore
Para generar los ficheros de salida (por defecto sería en /public pero nosotros lo cambiamos para que fuera en /docs):
hugo --theme=hucore
Comprobamos que en la carpeta /docs se han generado todos los ficheros necesarios (html, css y js) que serán los que se visualicen en GitHub Pages.
Se crea o añade en .gitignore para que no se suba el directorio de themes
echo "/themes/" >> .gitignore
Se crea un repositorio nuevo en GitHub (en mi caso melies-hugo), esta vez sin README, para evitar conflictos.
Se habilita GitHub Pages en la pestaña de Settings, eligiendo como fuente la carpeta /docs de la rama master.
Hacemos las operaciones de git para subir los ficheros:
git status
git add . (para subir todos los ficheros)
git commit -m "New blog with Hugo and hucore theme"
git remote add origin https://github.com/cristinafsanz/melies-hugo.git
git remove -v (para verificar)
git push -u origin master
Y con esto ya tenemos el blog publicado con GitHub Pages en la url que te indica GitHub. En mi caso: https://cristinafsanz.github.io/melies-hugo/.
Para cada subida tenemos que hacer lo siguiente (después de hacer los cambios y probar en local):
hugo --theme=hucore
git add .
git commit -m "Mensaje"
git push origin master
Podemos usar el Hook pre-commit de Git para ejecutar los comandos anteriores al commit siempre y así evitar olvidarnos de generar los ficheros de salida (idea de Ángel M. Miguel).
cd .git/hooks
vi pre-commit
chmod +x pre-commit
-
Contenido pre-commit
#!/bin/bash ROOT_REPO=$HOME/Others/Melies/melies-hugo hugo -s $ROOT_REPO --theme=hucore git add $ROOT_REPO
Añadimos algún cambio en el blog y ejecutamos directamente el commit:
git commit -m "Prueba pre-commit"
git push origin master
Por defecto GitHub Pages publica el blog en https://cristinafsanz.github.io/melies-hugo, pero voy a cambiar el dominio a modo de prueba para ver cómo se hace.
Voy a usar el servicio gratuito de dns.js.org para cambiar a un dominio distinto (lo encontré por casualidad buscando "GitHub Pages" en GitHub).
Para poner cambiar al dominio que te da js.org tienes que hacer 3 pasos:
-
Determinar el subdominio js.org, que puede ser tanto el nombre de usuario como el nombre del repositorio. En mi caso elijo esto último: https://melies-hugo.js.org.
-
Añadir el dominio
melies-hugo.js.org
en la sección "Custom Domain" de la pestaña Settings del repositorio. Esto automáticamente crea un fichero CNAME dentro de la carpeta /docs con el dominio (en /docs porque es ahí donde se publica en GitHub Pages, si se publicara en master el fichero CNAME se crearía en la raíz del repositorio). -
Hacer un pull request al repositorio dns.js.org añadiendo una nueva línea con tu dominio en el fichero cnames_active.js. En mi caso añadí esta línea (manteniendo el orden alfabético):
,"melies-hugo": "cristinafsanz.github.io/melies-hugo"
Nota: Para hacer una pull request a un repositorio donde no tienes permisos:
-
Haz un fork al repositorio.
-
Haz los cambios en el repositorio tuyo después del fork (en este caso edité el fichero cnames_active.js en GitHub directamente).
-
Volver al repositorio original y hacer una pull request.
-
Hacer click en el link "Compare across forks": El Base fork es el repositorio original y el base branch el repositorio mío.
-
Poner la descripción de la pull request (ellos te la dan en el fichero PULL_REQUEST_TEMPLATE).
Con esto en un plazo de menos de 24 horas tendré el blog publicado en la nueva URL (de hecho fue en el plazo de 1 hora).
Nota: Como con Hugo se enlaza el css usando la url completa y no como ruta relativa he tenido que cambiar config.toml para que la baseurl sea "https://melies-hugo.js.org". Si no, había errores de "Mixed Content" porque realmente se publica la página con http desde GitHub (no permite https al utilizar el Custom Domain).
El error que me daba era éste, que con el cambio de baseurl ya se ha solucionado:
Mixed Content: The page at 'https://melies-hugo.js.org/' was loaded over HTTPS, but requested an insecure stylesheet 'http://melies-hugo.js.org/css/style.css'. This request has been blocked; the content must be served over HTTPS.