Títulos

Si queremos tener una mejor presentación y organización, podemos agregar títulos o subtítulos. Para crear un título se debe usar el símbolo gato (#). Entre más gatos (#) usemos, más pequeño será el título:

#### Título 1
##### Título 2
###### Título 3

Se vuelve en:

Resaltar información

También es posible querer alguna edición de texto que permita al lector tener atención en algo, por ejemplo:

_itálicas_, *itálicas*;

__bold__, **bold**;

~~tachar~~.

Que se ve como:

itálicas, itálicas;

bold, bold;

tachar.

Alineación del código

• Justificado #<div style="text-align: justify"> al inicio y #<div/> al final.

• Centrado #<div style="text-align: center"> al inicio y #<div/> al final.

• A la izquierda #<div style="text-align: left"> al inicio y #<div/> al final.

Formato tipo código

Podemos hacer que el texto escrito se vea en el formato del código (para dar a notar que nos referimos a un objeto del código) de la forma investment_services_projects. Para obtener esta esritura se pone el texto investment_services_projects dentro de dos comillas invertidas ``.

Agregar referencias

Agregar imágenes

Podemos también agregar imágenes con una sintáxis parecida a la anterior, es decir, poner un par de corchetes después de un signo de admiración y posterior a los corchetes añadir el enlace donde se encuentra la imagen (entre paréntesis), como sigue: ![](enlace).

Ejemplo.

El encabezado YAML

El encabezado YAML (Hierarchical data structures) es la parte del archivo R Markdown que contiene, entre otras cosas, el título del archivo, la (el) autora (autor) del mismo, la fecha de creación y el tipo de formato en el que se “tejerá” o cargará el archivo (HTML ó PDF).

Podemos empezar cambiando la forma en que se pone la fecha, en general esta fecha aparece por defecto con el día en que se crea el archivo. Con el código date: ‘r format(Sys.Date(),’%d de %B del %Y’)’ y algunos otros podremos poner la sintáxis de la fecha a nuestra conveniencia. En el ejemplo en negritas la fecha en el archivo aparecerá como: 05 de marzo del 2021 (suponiendo que la fecha en la que se “teje” el archivo es la ejemplificada).

Insertar resultados en el texto

Para poder usar algún resultado calculado dentro de los chunks en el texto, se usa la sintáxis ‘r resultado_deseado’ (en vez de las comillas simples, se usan comillas invertidas), por ejemplo:

The total investment amount for all projects in Indonesia in the 2012 fiscal year was 100 million dollars. Lo cual se obtuvo de la sintáxis ‘r indonesia_investment_projects_2012_total’. Notemos que esto es parecido a editar el texto en forma de código, la diferencia es que añadimos una r y un espacio antes de seleccionar el resultado_deseado.

Lo anterior es un ejemplo de cómo se pueden plasmar en el documento los datos que se han calculado hasta el momento en el código.

Es importante que los resultados se pongan posterior al cálculo en los chunks porque al correr el archivo de R Markdown se hace una lectura ordenada del mismo y por tanto si se requieren resultados antes de su cálculo, habrá un error en la carga del archivo.

Dimensiones

Análogo a la especificación echo = FALSE, las funciones siguientes se colocan en el inicio de los chunks.

Usemos las especificaciones fig.width (ancho) y fig.height (alto) para modificar las dimensiones de los gráficos que aparezcan en el documento “tejido”. Estas funciones se hacen al inicio del chunk, por lo que no puedes ver su aplicación en lo que aparecerá al “tejer” el archivo.

Una forma más resumida es con el comando fig.dim al cual se le especifica un vector fig.dim = c(ancho, largo).

Como a veces no conocemos las dimensiones precisas de los diagramas que queremos presentar, podemos usar la especificación out.width que se usa con un porcentaje (por ejemplo 30%) para que tome el 30% del aspecto en el R Markdown.

Otro argumento que se puede agregar es la alineación del gráfico en el archivo, la cual puede ser izquierda (‘left’), centro (‘center’) o derecha (‘right’) con la especificación fig.align, por ejemplo: fig.align='right'

Algo que también nos puede interesar es una descripción o título del gráfico que aparezca en el R Markdown, esto se hace con el comando fig.cap.

Figure 1.1 Esto es un ejemplo de descripción de la gráfica que se muestra

Nombre de las columnas

Para agregar el nombre que queremos a las columnas, usamos el argumento col.names

Alineación de las columnas

Dentro de la función kable agregamos el argumento para el alineado de cada columna llamado align. Si queremos que la columna uno se aline a la derecha, la dos al centro y la tres a la izquierda, debemos usar el comando aling = "rcl" que significa r ight, c enter, l eft.

Título de la tabla

Añadimos el argumento caption en la función kable

Hay otras formas de crear tablas que tengan mejores ediciones, con una sintaxis de HTML o Latex

Si deseas conocer más información sobre la edición de R Markdown, da click aquí

Eval

• Si se desea que el código no se evalúe (no se calcule) entonces al inicio del chunk se agrega una especificación eval = FALSE. Esto evitará que se ejecute esa línea de código aun cuando éste aparezca en el archivo.

Include

• Si se desea que el código se cargue pero que no aparezca éste ni sus resultados en el archivo Markdown (no se vea el código ni los resultados que calcula) entonces podemos usar la opción include = FALSE. Esta opción hace invisible el código y los resultados por defecto pero sí permite usar los mismos como parte del texto en el archivo (ver sección.)

Echo

• Si queremos que no aparezca el código y sí los resultados entonces se puede usar la especificación echo = FALSE. Es una práctica usual cuando se presentan gráficas, porque se quiere el gráfico pero no el código con el cual se realiza.

Collapse

• Se puede usar collapse = TRUE si queremos que el código presentado en el archivo de R Markdown aparezca en el mismo espacio de chunk. Ejemplo:

  • collapse = FALSE por defecto. Aquí se separan los resultados en dos partes del código.

  investment_annual_summary

  ## # A tibble: 42 x 3
  ##    fiscal_year region                          dollars_in_millions
  ##          <dbl> <chr>                                         <dbl>
  ##  1        2012 East Asia and the Pacific                      2548
  ##  2        2012 Europe and Central Asia                        2915
  ##  3        2012 Latin America and the Caribbean                3680
  ##  4        2012 Middle East and North Africa                   2210
  ##  5        2012 South Asia                                     1312
  ##  6        2012 Sub-Saharan Africa                             2733
  ##  7        2013 East Asia and the Pacific                      2873
  ##  8        2013 Europe and Central Asia                        3261
  ##  9        2013 Latin America and the Caribbean                4822
  ## 10        2013 Middle East and North Africa                   2038
  ## # ... with 32 more rows

  ggplot(
    investment_annual_summary,
    aes(x = fiscal_year, y = dollars_in_millions, color = region)
  ) + geom_line() + labs(title = 'Inversión en Proyectos',x = "Año fiscal",y = 'Inversión total en millones de dólares')+theme_classic()

  

  • collapse = TRUE se tiene que especificar. Aquí se “juntan” los resultados del código.

  investment_annual_summary
  ## # A tibble: 42 x 3
  ##    fiscal_year region                          dollars_in_millions
  ##          <dbl> <chr>                                         <dbl>
  ##  1        2012 East Asia and the Pacific                      2548
  ##  2        2012 Europe and Central Asia                        2915
  ##  3        2012 Latin America and the Caribbean                3680
  ##  4        2012 Middle East and North Africa                   2210
  ##  5        2012 South Asia                                     1312
  ##  6        2012 Sub-Saharan Africa                             2733
  ##  7        2013 East Asia and the Pacific                      2873
  ##  8        2013 Europe and Central Asia                        3261
  ##  9        2013 Latin America and the Caribbean                4822
  ## 10        2013 Middle East and North Africa                   2038
  ## # ... with 32 more rows
  
  ggplot(
    investment_annual_summary,
    aes(x = fiscal_year, y = dollars_in_millions, color = region)
  ) + geom_line() + labs(title = 'Inversión en Proyectos',x = "Año fiscal",y = 'Inversión total en millones de dólares')+theme_classic()

  

Warnings

• Si no queremos que aparezcan “Warnings” en el archivo final, agregamos el argumento warning = FALSE al inicio de cada chunk.

  • Sin Warning:
    

  

  • Con Warning (por defecto):

  

Mensajes

• Es probable que también se de información extra de las tablas que se descargaron, si no queremos que esos mensajes aparezcan, podemos agregar la opción message = FALSE

  • Con mensaje (por defecto):

  investment_services_projects <-
    read_csv(
      "https://assets.datacamp.com/production/repositories/5756/datasets/78b002735b6f620df7f2767e63b76aaca317bf8d/investment_services_projects.csv"
    )

  ## 
  ## -- Column specification --------------------------------------------------------
  ## cols(
  ##   date_disclosed = col_datetime(format = ""),
  ##   country = col_character(),
  ##   ifc_country_code = col_character(),
  ##   sector = col_character(),
  ##   project_name = col_character(),
  ##   project_number = col_double(),
  ##   company_name = col_character(),
  ##   status = col_character(),
  ##   ifc_investment_for_risk_management_million_usd = col_double(),
  ##   ifc_investment_for_guarantee_million_usd = col_double(),
  ##   ifc_investment_for_loan_million_usd = col_double(),
  ##   ifc_investment_for_equity_million_usd = col_double(),
  ##   total_ifc_investment_as_approved_by_board_million_usd = col_double()
  ## )

  • Sin mensaje:

  investment_services_projects <-
    read_csv(
      "https://assets.datacamp.com/production/repositories/5756/datasets/78b002735b6f620df7f2767e63b76aaca317bf8d/investment_services_projects.csv"
    )

Errores

• Si queremos hacer notar cuáles son los errores en algúno de los chunks que hemos creado, se usa el argumento error = TRUE. Por defecto el argumento de error es FALSE y esto impide que el archivo de R Markdown se “teja” (Knit-ea) cuando hay errores en algún chunk. Es preferible que esta opción se aplique de manera global al inicio del R Mardown para que se identifiquen y corran todos los chunks con sus respectivos errores.

Cuerpo del archivo

Si se desea hacer un cambio de color de letra en todo el “cuerpo” del documento, usamos la sintáxis:

<style>
  body{
    color: blue;
  }
</style>

Análogo al código anterior se puede agregar al “cuerpo” del documento el color de fondo, tipo de letra y tamaño de la letra. En tal caso tendremos el ejemplo siguiente:

<style>
  body{
    color: #024B3B;
    font-family: Calibri;
    background-color: #F2FCFA;
  }
</style>

Notemos que los colores no están dados de manera “regular”. Esos colores se obtuvieron de la forma hexadecimal que permite obtener una amplia gama de colores. Es importante incluir el símbolo gato “#” antes de cada código hexadecimal para que se pueda añadir dicho color.

Códigos chunk

Lo anterior es en general para el texto, pero si queremos un color especial para las líneas de código ponemos (despúes de cerrar el body) lo siguiente:

pre{
  color: #273A00;
  background-color: #E4F9BB;
}

Índice del archivo

Si se desea también cambiar el diseño del índice (tabla de contenido) agregamos (de preferencia antes del body) lo siguiente:

#TOC {
  color: #022A3D;
  font-family: Calibri;
  font-size: 16px;
  boder-color: #026696;
}

Encabezado del archivo

Si además queremos agregar propiedades particulares al encabezado (título, fecha y autor) entonces usamos (de preferencia antes de #TOC):

#header {
  color: #081137;
  background-color: #C6DBF4;
  opacity: 0.6;
  font-family: Calibri;
  font-size: 20px;
}

Si queremos tener detalle tambíen por cada parte del encabezado (el título y el autor tengan distinto diseño, por ejemplo) entonces usamos el código:

h1.title {
  color: #092547;
  background-color: #375477;
  opacity: 0.4;
  font-family: Calibri;
  font-size: 40px;`
  }
h4.author {
  color: #223F61;
  font-family: Calibri;
  }
h4.date {
  color: #7C99BB;
  font-family: Calibri;
  }

  <style>
    #TOC {
      color: #022A3D;
      font-family: Calibri;
      font-size: 16px;  
      boder-color: #026696;
      }
    h1.title {
      color: #092547;
      background-color: #375477;
      opacity: 0.4;  
      font-family: Calibri;
      font-size: 40px;
      }
    h4.author {
      color: #223F61;
      font-family: Calibri;
      }
    h4.date {
      color: #7C99BB;
      font-family: Calibri;
      }
    body{
      color: #024B3B;
      font-family: Calibri;
      background-color: #F2FCFA;  
      }
    pre{
      color: #273A00;
      background-color: #E4F9BB;
      }
  </style>

html_document:
  css: nombre_del_archivo_.css_con_extensión_css

Theme y Highlight

---
title: "R Markdown"
output:
   html_document:
    theme: default
---

---
title: "R Markdown"
output:
   html_document:
    highlight: default
---