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.
Top comments (0)