Como Crear Un Post

¡Hola! Que bueno que quieras aportar a la comunidad con tu conocimiento, a continuación veras lo facil que es contribuir ❤️.

Instalación de Hugo

Lo primero que ocupas que instalar es Hugo, Hugo es el generador de sitios estáticos que ocupamos para nuestra página.

Instalación en Arch Linux

1

sudo pacman -Syu hugo

Instalación en Debian & Ubuntu:

1

sudo apt-get install hugo

Instalación en Fedora:

1

sudo dnf install hugo

Instalación en Windows (Chocolatey):

1

choco install hugo -confirm

Instalación en macOS (Homebrew):

1

brew install hugo

Clona el repositorio de github.

Después de instalar Hugo puedes proceder a clonar el repositorio.

1

git clone https://github.com/gophers-mx/gophers-mx.github.io.git

Crea tu rama.

Dentro del repositorio debes de crear tu propia rama.

1

git checkout -b blog/post-name

Crea tu post.

Ahora puedes crear el archivo de markdown donde podrás escribir tu post.

1

hugo new blog/post-name.md

El archivo será creado dentro del directorio content/blog/post-name.md, ahora abre el archivo y verás algunos valores.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

---
title: "Post Name"
date: 2021-03-30T20:55:43-06:00
draft: true
author: "Your name"
twitter: "https://twitter.com/username"
github: "https://github.com/username"
original_post: "https://blog.yoursite.com/post"
cover_image: '/img/blog/post-name/cover-image.jpg'
description: "post's brief summary"
tags: ['tag']
---

Todas las propiedades son obligatorias, excepto original_post; esa la puedes remover. Para entender mejor como llenar cada propiedad ocupas comprender de que se trata cada una:

Author

Tu nombre.

Draft.

De ser true no se mostrará en producción, por favor cambialo a false cuando termines de escribir tu post.

Twitter

Tu cuenta de twitter.

Github

Tu cuenta de Github.

Original Post (Opcional)

Esta propiedad es completamente opcional ya que hace referencia al link del post original que escribiste en tu propio blog u otra plataforma.

Cover Image

Es la miniatura del post, el tamaño recomendado es 1200x620px. Debes de guardar esta imagen dentro del directorio static/img/blog/post-name/cover.png. De preferencia usa tinypng para reducir el peso tus imágenes.

Description

Un resumen del post.

Tags

Puedes añadir tags a tu post para categorizarlo, por favor verifica cuales tags ya existen para no repetirlos y cuando crees un tag por favor que solo sea una palabra y en minúsculas.

Escribiendo el post.

Para escribir el post el único conocimiento que necesitas es la sintaxis de markdown, pero si quieres optimizar algunas cosas para Hugo, puedes checar su documentación.

Ahora para empezar a ver tu post dentro de el proyecto ocupas escribir el siguiente comando en tu terminal:

1

hugo serve -D

La bandera -D significa que va a mostrar los posts que tengan la propiedad draft: true, recuerda que tienes que cambiar el valor a false cuando termines de escribir tu post, de otra manera no aparecerá en producción.

Finalmente despues de terminar de escribir tu post, ejecuta en tu terminal:

1

hugo

Si el log no muestra ningún error, puedes proceder a crear tu pull request.

Fin.

Eso ha sido todo, gracias por contribuir con la comunidad. 😊