Workflow: ¿cómo crear un post?

(3ª parte del taller Mi primer blog con Quarto)

Autor
Afiliación
Pedro J. Pérez

Universitat de València

Fecha de Publicación

24 de noviembre de 2022

  • Tutorial preparado para el taller Mi primer blog con Quarto impartido en Córdoba (Spain) durante el I Congreso & XII Jornadas de Usuarios de R, 23-25 de noviembre de 2022.

  • El taller está pensado para realizar con R. Se utilizará el IDE RStudio y Quarto. Se recomienda tener instaladas versiones recientes de los 3 programas

  • Este tutorial es sólo una parte del taller. El taller completo está aquí.

  • En esta tercera parte del taller veremos como crear nuevos posts para el blog.

  • Las anteriores secciones del taller son:

    1. Intro: se presenta el taller

    2. Creación de un blog (básico) con Quarto: vimos como crear y alojar un blog básico con RStudio y Quarto.

    3. Tuneado básico del blog. Modificamos ligeramente los ficheros _quarto.yml, index.qmd, about.qmd y styles.css.


¿Qué haremos en este tutorial?

  • Ver como podemos iniciar un nuevo post

  • (podemos marcar post todavía no acabados con draft: true en el yaml del post)


El blog que hemos creado con Quarto y que estamos adaptando a nuestras necesidades, contiene de fábrica 2 posts muy sencillos. Sus títulos son: “Welcome to my blog” y “Post with code”.

Más adelante borraremos estos 2 posts, pero ahora mismo los vamos a utilizar de ejemplo para crear un nuevo post. Será en la sección siguiente, de momento veamos donde están los archivos que generan los posts de nuestro blog.

1 ¿Donde están los posts del blog?

Los ficheros .qmd que generan los posts están en la carpeta posts de nuestro Qproject con el que generamos el blog.

Cada post está en una subcarpeta diferente. Veámoslo:

Como ves, en la carpetaposts hay:

  • una subcarpeta para cada post.

  • el archivo _metadata.yml. Lo veremos más adelante, pero sirve para generar opciones comunes a todos los ficheros .qmd de la carpeta posts.


2 Contenido de cada subcarpeta de ./posts/

Veamos el contenido de una de las carpetas que generan los posts, por ejemplo la carpeta /welcome/:

Contenido de la carpeta welcome que genera el post titulado “Welcome to my blog”

Contenido del archivo index.qmd”

Como ves, la carpeta /welcome/ que genera el primer post del blog contiene 2 archivos:

  • index.qmd: es realmente el archivo que genera el post. Repasaremos su contenido más adelante.

  • thumbnail.jpg: sencillamente un archivo con una imagen que será usado al generar el post.


3 Creando un nuevo post

De momento, para generar un nuevo post lo que haremos será crear una nueva subcarpeta dentro de ./posts/, ponerle nombre y pegar allí los archivos que hay en la carpeta de uno de los dos posts de prueba. Por ejemplo:

Tarea 4.1

Tarea 4.1: Creando un nuevo post

  • Crea una nueva subcarpeta en ./posts/

  • Ponle nombre, por ejemplo: “my-primer-post”

  • Copia en la carpeta que hemos creado el contenido de la carpeta de uno de los 2 posts. Por ejemplo copia los 2 archivos que hay en ./posts/welcome/ y pégalos en ./posts/my-primer-post/; es decir, pegamos el archivo index.qmd y tumbnail.jpg en nuestra nueva carpeta.

  • Vuelve a regenerar el blog: Build > Render Website y verás que ahora nuestro blog ya tiene tres posts.

  • Bueno, pues ya lo tenemos, ya tenemos un nuevo post. Lo que ocurre es que, como no hemos cambiado el contenido de index.qmd ni de tumbnail.jpg, resulta que el tercer post de nuestro blog será idéntico al primero, al post de bienvenida.

  • Evidentemente puedes cambiar estos archivos para que el tercer post no sea idéntico al primero. Hagámoslo.

Tarea 4.2

Tarea 4.2: Modificando el tercer post
  • Modifica el contenido de /.posts/my-primer-post/index.qmd. Por ejemplo, puedes dejarlo así:
---
title: "Mi primer post con Quarto"
author: "Pedro J. Pérez"
date: "2022-10-25"
categories: [R, quarto]
image: "thumbnail.jpg"
---

Este es mi **primer post** con Quarto!!!!

```{r}
sqrt(2 + 2)
```

Voy a poner una imagen:

![](thumbnail.jpg)


Acabé con mi primer post. FIN

  • Sustituye thumbnail.jpg por otro archivo

  • La opción de yaml (linea 6): image: "thumbnail.jpg" nos permite elegir la imagen que acompañara al post en la listing page.

  • Vuelve a regenerar el blog: Build > Render Website


En el siguiente tutorial veremos en profundidad las posibilidades que nos ofrece Quarto para escribir nuestros posts.


4 Resumen

  • En esta cuarta parte del taller hemos visto como podemos generar/escribir nuevos posts para nuestro blog: solo hay replicar una de las carpetas de anteriores posts y cambiarle el nombre.


  • Hemos visto como cambiar la imagen que acompaña a los posts en la “listing page”.
  • Recuerda que podemos marcar un post con draft: true en el yaml del post.


  • En el siguiente tutorial veremos en profundidad las posibilidades que nos ofrece Quarto para escribir nuestros posts.