Tutorial Primer Post

En esta guía se muestra el paso a paso de cómo crear un archivo dentro del proyecto de blog python chile de manera simple.

🚀 ¡Vamos por tu primer post!

Primero es crear un archivo markdown. Situado en la ruta raíz del proyecto, crea un archivo .md en la ruta content/post/:

El nombre del archivo .md debe tener el formato AAAA-MM-DD-<titulo post>.md:

Luego debes agregar al inicio del archivo la metadata:

Esta metadata es esencial para poder crear los preview de los post al inicio del blog.

Se debe respetar los caracteres --- tanto al inicio como al final de la metadata y separando la metadata del contenido del post con un salto de línea:

Una vez listo con la metada puedes agregar tu contenido ocupando formato markdown. Para más información puedes entrar a la siguiente documentación.

Dentro de tu contenido se puede agregar texto con el formato que se quiera, imágenes, código o cualquier otro elemento.

Importante: Todo contenido con estilo personalizado es permitido siempre y cuando no interfiera con el estilo global del blog.

Para agregar alguna imágen se hace con el formato ![<nombre-img>.webp](<ruta hacia imagen>.webp):

Opcionalmente puedes agregar la clase .post-img para centrar la imagen (por defecto la imagen no estará centrada):

Toda imagen agregada al proyecto se debe guardar en la ruta content/img/<nombre-post>/:

Si quieres agregar una imagen ocupando una URL, se debe usar el mismo formato mostrado anteriormente ![<nombre imagen>](<URL de imagen>)

También puedes agregar código que se puede copiar:

1
2
3

```<nombre lenguaje>
código de ejemplo aquí
```

Por ejemplo:

1
2
3

```python
print("Tu primer post en Python Chile!")
```

Quedando como resultado:

1

print("Tu primer post en Python Chile!")

Para ocupar info panels como warning o note:

1
2

!!! note 
    Este es un info panel tipo **note**

Puedes agregar un título también:

1
2

!!! warning "🪐 Titulo ejemplo" 
    Este es un info panel con título tipo **note**

Confirma que se visualice bien el post a medida que lo vayas modificando:

1
2

# para crear archivos de sitio estático
pelican content

1
2

# para levantar localhost http://127.0.0.1:8000 
pelican -l

Ya teniendo todo listo 👌, puedes proceder a abrir una pull request y esperar la ✅️revisión para que se pueda agregar tu post al blog de Python Chile.

Para saber más sobre cómo contribuir al blog visita la documentación oficial.

Si has llegado hasta aquí... ¡Muchas gracias por tú interés 🎉🎉!