como-hacer-un-post.md

pdep-lunes bitacora

📖 ¿Cómo hacer un post?

1. Nuevo archivo

   Para crear un nuevo post es necesario crear un nuevo archivo bajo la carpeta content/blog/ con un nombre y la extensión .md (markdown).

   Nota: si se pone dentro de otra carpeta (dentro de /blog) esa carpeta va a formar parte de la url. Por ejemplo: si creamos el post clase-01.md entonces la url va a ser https://pdep-lunes.github.io/bitacora/funcional/clase-01.

2. Respetar los headers de metadata

   Todos los posts tienen que respetar este formato al comienzo para poder dar contexto sobre su contenido.

   ---
   title: Titulo de la clase
   date: 'AAAA-MM-DD'
   description: 'Una descripción mas detallada sobre la clase'
   tags: [un-tag, otro-tag-que-relacione]
   ---
   

   • La fecha es útil para ordenar los posts
   • La descripción es lo que se ve en la página principal debajo del titulo

   Nota: tener en cuenta que los tags dependen de su nombre para tener algun estilo especial que tiene que declararse en el archivo tags.css que se encuentra dentro de la carpeta src/css/.

3. Escribir en markdown

   El post nueva-clase.md se tiene que escribir en markdown se puede ver una guía de como escribir markdown acá.

4. Hacer un PR (pull request)

   La idea es hacer un PR con los cambios que probablemente sean solo el markdown del post o algun cambio en tags.

   Pedir alguna review para validar que esta todo ok (recontra opcional).

📷 ¿Cómo agregar imagenes a un post?

Cuando probamos de subir imagenes las subimos a la carpeta /content/assets y funciona cuando miramos los .md desde el repo de github pero se rompe cuando se sube a gh-pages, con lo cual la froma correcta sería tener las imagenes dentro de la carpeta /content/blog y referise desde cualquier .md haciendo ![texto alternativo](./nombre.jpg "Titulo").