Prefacio

En el verano de 2012, Yihui Xie hizo su internado en los laboratorios de investigación AT&T, donde asistió a una charla de Carlos Scheidegger (https://cscheid.net), y Carlos dijo algo asó como que “si no tienes un sitio web, hoy en día, no existes”. Luego lo parafraseé como:

“Hago web, por ende soy spiderman.”

Las palabras de Carlos sonaron muy bien, aunque fueron un poco exageradas. Un sitio web bien diseñado y mantenido puede ser extremadamente útil para que otras personas lo conozcan, y usted no necesita esperar oportunidades adecuadas en conferencias u otras ocasiones para presentarse en persona a los demás. Por otro lado, un sitio web también es muy útil para que usted realice un seguimiento de lo que ha hecho y ha pensado. A veces puede regresar a una determinada publicación anterior suya para volver a aprender los trucos o métodos que una vez dominó en el pasado pero que olvidó.

En este libro, se presenta un paquete de R, blogdown, para enseñarle cómo crear sitios web usando R Markdown y Hugo. Si tiene experiencia en la creación de sitios web, naturalmente puede preguntarse sobre cuáles son los beneficios de usar R Markdown y cómo blogdown es diferente de las plataformas de sitios web populares existentes, como WordPress. Hay dos aspectos principales de blogdown:

  1. Produce un sitio web estático, lo que significa que el sitio web solo consta de archivos estáticos como HTML, CSS, JavaScript e imágenes, etc. Puede alojar el sitio web en cualquier servidor web (consulte el Capítulo ?? para obtener más información). El sitio web no requiere scripts del lado del servidor como PHP o bases de datos como WordPress. Es solo una carpeta de archivos estáticos. Se explicarán más beneficios de los sitios web estáticos en el Capítulo 2, cuando se presente el generador de sitios web estáticos Hugo.

  2. El sitio web se genera a partir de documentos R Markdown (R es opcional, es decir, puede usar documentos de Markdown sin fragmentos de código R). Esto brinda una gran cantidad de beneficios, especialmente si su sitio web está relacionado con el análisis de datos o la programación (en R). Poder utilizar Markdown implica simplicidad y, lo que es más importante, portabilitdad (por ejemplo, se está dando la oportunidad de convertir sus publicaciones de blog a formato PDF y publicarlas en revistas o incluso libros en el futuro). R Markdown le brinda los beneficios de los documentos dinámicos — todos sus resultados, tales como tablas, gráficos y valores en línea, se pueden calcular y representar dinámicamente desde el código en R, por lo tanto, es más probable que los resultados que presente en su sitio web sean reproducibles. Un beneficio adicional pero importante de usar R Markdown es que podrá escribir documentos técnicos fácilmente, debido a que blogdown hereda el formato de salida HTML de bookdown (Xie 2016). Por ejemplo, es posible escribir ecuaciones matemáticas LaTeX, citas en BibTeX e incluso teoremas y pruebas si lo desea.

No se deje engañar por la palabra “blog” en el nombre del paquete: blogdown es para sitios web de propósito general, y no solo para blogs. Por ejemplo, todos los autores de este libro tienen sus sitios web personales, donde puede encontrar información sobre sus proyectos, blogs, documentación de paquetes, etc.1 Todas sus páginas están compiladas a partir de blogdown y Hugo.

Si no prefiere usar Hugo, también existen otras opciones. El capítulo 5 presenta posibilidades para usar otros generadores de sitios web, tales como Jekyll y el generador por defecto de rmarkdown.

Este libro ha sido publicado por Chapman & Hall/CRC. La versión en línea de este libro está licenciada bajo Licencia Internacional Creative Commons Attribution-NonCommercial-ShareAlike 4.0.

Referencias

Xie, Yihui. 2016. Bookdown: Authoring Books and Technical Documents with R Markdown. Boca Raton, Florida: Chapman; Hall/CRC. https://github.com/rstudio/bookdown.

  1. La página principal de Yihui está en https://yihui.name. Escribe entradas de blog en chino (https://yihui.name/cn/) e inglés (https://yihui.name/en/), y documenta sus paquetes de software como knitr (https://yihui.name/knitr/) y animation (https://yihui.name/animation/). De vez en cuando también escribe artículos como https://yihui.name/rlp/ cuando encuentra temas interesantes, pero no se molesta con un envío formal de un diario. La página principal de Amber está en https://amber.rbind.io, donde puede encontrar su blog y páginas de proyectos. El sitio web de Alison está en https://alison.rbind.io, que utiliza un tema académico en este momento.↩