Deploy de Contentz a Netlify

Publicado originalmente en https://sergiodxa.com/articles/contentz-netlify/

Contentz es una herramienta para crear sitios web y blogs fácilmente sin configurar nada, pero con la opción de hacerlo para algunas cosas. Netlify es una plataforma para hacer deploy de sitios web estáticos de forma global.

Contentz genera sitios estáticos por lo que es candidato ideal para usar Netlify. En este artículo vamos a ver como configurar todo lo que necesitemos para usarlos juntos.

Creando el repositorio

Primero necesitamos crear el repositorio de Git donde vamos a tener nuestro contenido. Netlify soporta GitHub, GitLab y Bitbucket, en este caso vamos a usar GitHub.

Para esto vamos a https://github.com/new y creamos un repositorio que vamos a llamar personal-site. Luego clonamos nuestro repositorio a nuestra computadora.

git clone git@github.com:username/personal-site.git

Iniciamos el proyecto

Ahora vamos a iniciar nuestro sitio, para esto corremos los siguientes comandos:

npx gitignore node
npx license MIT -o "Sergio Xalambrí" > LICENSE
yarn init --yes
yarn add contentz
mkdir articles

Ahora vamos a crear nuestro primer artículo con el comando:

yarn contentz write hola-mundo.mdx

Y vamos a cambiar published a true en la metadata del artículo, al principio del archivo.

Luego generamos la imagen social de nuestro artículo:

yarn contentz social articles/hola-mundo.mdx

Por último guardamos todo, hacemos commit y push de GitHub.

git add .
git commit -m "Inicio del sitio"
git push origin master

Configurando Netlify

Ahora vamos a configurar Netlify, para esto iniciamos sesión y vamos a https://app.netlify.com/start para agregar un nuevo sitio. Lo conectamos a nuestra cuenta de GitHub y buscamos nuestro repositorio.

Creamos el sitio en las opciones de build dejamos todo vacío.

Ahora en nuestro repositorio vamos a crear un archivo netlify.toml con el siguiente contenido:

[build]
  publish = "public"
  command = "yarn contentz build"

Con esto configuramos que va a publicar la carpeta public que genera Contentz y que el comando que va a usar para hacer construir el sitio es yarn contentz build.

Ahora guardamos, hacemos commit y push del repositorio.

git add netlify.toml
git commit -m "Configure Netlify"
git push origin master

Accedemos a nuestro sitio

Con esto Netlify debería poder construir nuestro sitio y hacerle deploy sin problemas. Si accedemos a la URL que nos provee Netlify, ó a nuestro dominio propio en caso de haberlo configurado, vamos a ver nuestro sitio web hecho con Contentz funcionando.