ETVL-R-6-markdown-rstudio.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<center>\n",
    "# R -- Creación de documentos dinámicos en RStudio "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Autor.**\n",
    "> <img src=\"../firma_github.png\" width=\"500\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Bibliografía**.\n",
    "\n",
    "> Webinar RStudio [Reproducible Reporting](https://www.rstudio.com/resources/webinars/reproducible-reporting/)  \n",
    "Webinar RStudio  [Interactive Reporting](https://www.rstudio.com/resources/webinars/interactive-reporting/)  \n",
    "Webinar RStudio [Getting Started with R Markdown](https://www.rstudio.com/resources/webinars/getting-started-with-r-markdown/)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Generación del documento"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "RStudio permite la creación de reportes y presentaciones en markdown que contienen código en R. Eso hace que el código se ejecute cada vez que el documento se genera. El contenido de estos documentos en markdown solo difiere en la forma en que se dan las opciones para ejecutar el código interno. A continuación se describe el proceso de creación de un documento dinámico en RStudio."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Paso 1.\n",
    "\n",
    "Seleccione el menu `File/New File/R Markdown...`."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"images/rstudio-dyn-01.png\" width=\"500\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Paso 2\n",
    "\n",
    "En este paso, el usuario puede elegir entre `Document` y `Presentation`. De un título al documento y seleccione el tipo de formato de salida. En el ejemplo presentado se seleccionó PDF. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"images/rstudio-dyn-02.png\" width=\"500\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Paso 3\n",
    "\n",
    "RStudio genera un documento con un texto de ejemplo mostrando las principales funcionalidades de Markdown para RStudio. El ejemplo incluye tanto textos como código ejecutable."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"images/rstudio-dyn-03.png\" width=\"600\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Paso 4\n",
    "\n",
    "Para generar el documento en PDF seleccione el botón `Knit PDF` en la barra de botones del editor."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"images/rstudio-dyn-04.png\" width=\"500\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Paso 5\n",
    "\n",
    "Como resultado del paso anterior, se abre el visor de documentos de RStudio y se presenta en pantalla el documento generado."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"images/rstudio-dyn-05.png\" width=\"600\" align='left'>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Particularidades del RStudio Markdown"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Existen algunas diferencias entre el Markdown usado en Jupyter y las introducidas en los documentos dinámicos de RStudio, las cuales están relacionadas con la forma en que se ejecuta el código en R. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Para ilustrarlas, a continuación se discute el código generado automáticamente por RStudio."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* La parte superior indica el título del documento  y el tipo de salida.:\n",
    "\n",
    "```\n",
    "---\n",
    "title: \"demo\"\n",
    "output: pdf_document\n",
    "---\n",
    "``` \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* El siguiente código indica que se está realizando la configuración  y la opción `include=FALSE` que este bloque de código no aparece en el documento final.\n",
    "\n",
    "\n",
    "    ```{r setup, include=FALSE}\n",
    "    knitr::opts_chunk$set(echo = TRUE)\n",
    "    ```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* Los hipervínculos se hacen con `<` y `>` como en   `<http://rmarkdown.rstudio.com>`"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* Los comandos de Markdown para indicar formatos funcionan igual."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* El siguiente bloque de código indica que se usa el dataset `cars`. Todo el código entre \\```     y  \\```  se ejecuta normalmente.\n",
    "\n",
    "      ```{r cars}\n",
    "      summary(cars)\n",
    "      ```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* La opción `echo=FALSE` indica que el código se ejecuta pero no se imprime el código en el documento final:\n",
    "\n",
    "      ```{r pressure, echo=FALSE}\n",
    "      plot(pressure)\n",
    "      ```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Presentaciones en RStudio\n",
    "\n",
    "* Operación similar a la anterior.\n",
    "* Los títulos generan una nueva diapositiva.\n",
    "* Para introducir una nueva diapositiva se usan tres guiones seguidos `---`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.5.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}