bookdown: Escritura de libros y documentos técnicos con R Markdown

4.3 Plantillas

Cuando Pandoc convierte Markdown a otro formato de salida, utiliza una plantilla bajo la manga. La plantilla es un archivo de texto plano que contiene algunas variables de la forma $variable$ . Estas variables se reemplazarán por sus valores generados mediante Pandoc. A continuación se muestra una breve plantilla para la salida HTML:

<html>
  <head>
    <title>$title$</title>
  </head>
  
  <body>
  $body$
  </body>
</html>

Tiene dos variables title y body. El valor de title viene del campo title de los metadatos YAML, y body es el código HTML generado por el cuerpo del documento Markdown. Por ejemplo, supongamos que tenemos un documento Markdown:

---
title: Un libro chévere
---

# Introducción

Este es una **berraquera** de libro!

Si usamos la plantilla anterior para generar un documento HTML, su código fuente sería así:

<html>
  <head>
    <title>Una berraquera de libro</title>
  </head>
  
  <body>
  
  <h1>Introducción</h1>
  
  <p>Este es una <strong>berraquera</strong> de libro!</p>
  
  </body>
</html>

Las plantillas actuales HTML, LaTeX, y EPUB son más complicadas pero la idea es la misma. Usted sólo necesita saber qué variables están disponibles: algunas variables están incorporados en las variables Pandoc, y algunas se puede definir por los usuarios en los metadatos YAML, o se pasan de la opción de línea de comandos -V o --variable. Algunas variables sólo tienen sentido para determinados formatos de salida, por ejemplo, la variable documentclass sólo se utiliza en la producción de documentos en LaTeX. Consulte la documentación de Pandoc para aprender más sobre estas variables, y puede encontrar todas las plantillas Pandoc por defecto en el repositorio GitHub https://github.com/jgm/pandoc-templates.

Tenga en cuenta que para la salida HTML, bookdown requiere algunas fichas adicionales de comentarios en la plantilla que se explicó en la sección 3.1.2.