1 Lea sobre blogdown

Le recomiendo que lea lo siguiente:

• blogdown: Creating Websites with R Markdown de Yihui Xie y Amber Thomas. Este es el material por excelencia de documentación de blogdown.

• Getting Started with blogdown de M. Edward (Ed) Borasky. Un post sobre la creación de un sitio web con blogdown.

También existe este artículo de Eric Nantz, el creador de R-Podcast, en la sección de issues de Github rbind/support que puede ser de ayuda:

• https://github.com/rbind/support/issues/12

2 Advertencias, descargos de responsabilidad, etc.

Incluso con los espectaculares recursos que enumeré arriba, comenzar a usar blogdown conllevó algunos intentos, así que este post transmite lo que terminó funcionando para mí. Sin embargo, la distancia y el esfuerzo recorrido pueden variar, dependiendo del sistema operativo y su pretensión. Por mi parte: soy usuario de macOS, uso R, RStudio y Git (a través de Github)(https://github.com), y la terminal algunas veces, por lo que me estoy familizarizando con todo esto. Si no es su caso, aquí hay unos sitios para comenzar:

• Git: Happy Git with R de Jenny Bryan et al. Material de referencia obligado para el inicio en control de versiones. Hice una traducción al español que está en continua revisión en Git y GitHub para el usuario de R
• RStudio: DataCamp’s Working with the RStudio IDE (free) de Garrett Grolemund
• Terminal: The Command Line Murder Mystery de Noah Veltman, y The UNIX Workbench de Sean Kross

También tengo Xcode y Homebrew instalados- probablemente necesitará esto para descargar Hugo. Si no tiene ninguno pero está en un mac, este enlace puede ayudar:

• ¿Cómo instalar Xcode, Homebrew, Git, RVM, Ruby & Rails en Mac OS X

Para más información sobre cosas de interés que se usan, podría consultar:

• “Teniendo en cuenta el costo y la amabilidad de los principiantes, actualmente recomendamos Netlify.”.
• “Si no está familiarizado con nombres de dominios o no quiere aprender más al respecto, una opción para su consideración es un subdominio gratuito *.rbind.io ofrecido por RStudio, Inc.”.

En este post presentaré dos formas de crear un web site desde blogdown.

3 PRIMERA FORMA

4 En GitHub

1. Vaya a su cuenta de GitHub, y cree un nuevo repositorio (Dele check para inicializarlo con un README. Para bautizar su repositorio, considere su futuro plan de publicación:

• Si va a utilizar Netlify para alojar la página, ¡puede nombrar el repositorio como quiera!

{{% alert note %}} Puede ver algunos de los nombres de los repositorios usados por miembros de la organización rbind aquí. {{% /alert %}}

• Si quiere alojar su sitio como una GitHub Page, debería nombrar su repositorio como sunombredeusuariodegithub.github.io (así que el mío hubiera sido martin.github.io). Si va por esta ruta, le sugiero que siga las instrucciones de Amber. Sin embargo, más adelante hablaremos de eso.

2. Vaya a la página principal de su nuevo repositorio y, debajo del nombre del repositorio, haga clic en el botón verde Clone or download.

3. En la sección Clone with HTTPS, haga clic en el ícono del portapapeles para copiar el URL clonado de su nuevo repositorio. Pegue este texto en la terminal en la siguiente sección.

5 En el terminal

Ahora clone su repositorio remoto y cree una copia local en su computadora para que pueda sincronizar entre las dos ubicaciones (usando el terminal o su herramienta de línea de comandos alternativa para un computador). Recuerde ubicarse en la carpeta de su elección para la clonación de su repositorio.

1. Use cd para navegar dentro del directorio donde usted quiere que su repositorio esté

2. Una vez esté ahí, digite: git clone [paste]. Entonces mi comando sería así:

git clone https://github.com/mamaciasq/martin.git

Y esto es lo que imprimió en mi ventana de terminal:

Cloning into 'martin'...
remote: Counting objects: 3, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
Checking connectivity... done.

3. Cierre el terminal, ya todo está listo.

6 En RStudio

1. Instale blogdown desde su consola de RStudio. Si usted ya ha instalado devtools como yo lo hice, solo necesita la segunda línea de las que se listan a continuación:

if (!requireNamespace("devtools")) install.packages("devtools")
devtools::install_github("rstudio/blogdown")

2. Instale Hugo usando la función de ayuda del paquete blogdown:

blogdown::install_hugo()
# o
library(blogdown)
install_hugo()

{{% alert note %}} Aquí es donde mis instrucciones divergen de las de Ed: él afirma que blogdown no creará un sitio web en su carpeta raíz porque el archivo README.md ya está allí. No encontré que ese fuera el caso, también lo probé con un sitio nuevo. Si una de las formas no funciona para usted, pruebe la otra. {{% /alert %}}

3. Use los botones del menú de arriba en RStudio para seleccionar File -> New Project -> Existing Directory, luego vaya al directorio en su computadora donde esté su repositorio de GitHub y haga click en el botón Create Project.

4. Ahora debería estar “dentro” de su proyecto en RStudio. Si está usando git para control de versiones, edite su archivo *gitignore. Este archivo debería estar visible en su panel visor de archivos en RStudio.

.Rproj.user
.Rhistory
.RData
.Ruserdata
blogdown
.DS_Store # si es un usuario de windows, use Thumbs.db
public/ # si está usando Netlify

7 Construya su sitio en RStudio

Ahora puede finalmente coonstruir su sitio usando la función blogdown::new_site(). Pero primero debería al menos pensar en los temas…

# por ejemplo, cree un sitio nuevo con el tema academic-theme
blogdown::new_site(theme = "gcushen/hugo-academic", theme_example = TRUE)

library(blogdown)
new_site() # el tema por defecto es lithium
# debe dejar de servir para poder usar la consola nuevamente
install_theme("gcushen/hugo-academic", theme_example = TRUE, update_config = TRUE)

baseurl = "https://example.com/"
baseurl = "/"

Started building sites ...
ERROR 2017/06/08 16:22:34 failed to parse page metadata for home/about.md: (18, 6): missing comma
Error: Error building site: Errors reading pages: Error: failed to parse page metadata for home/about.md: (18, 6): missing comma for about.md

blogdown::new_post()
blogdown::new_post(rmd = FALSE) # false está por defecto!

new_post(title, kind = "default", open = interactive(), 
@@ -282,28 +279,28 @@ new_post(title, kind = "default", open = interactive(),

blogdown::new_post(rmd = TRUE) # false is the default!

---
title: "My Awesome Post"
author: "John Doe"
date: "2017-02-14"
output:
  blogdown::html_page:
    toc: true
    toc_depth: 1
    number_sections: true
    fig_width: 6
---

![my-image](/img/my-image.png)

8 Publicación en Netlify

La publicación en Netlify a través de GitHub es sencilla. Yihui y Amber dan algunas instrucciones para principiantes, pero Netlify es muy fácil, le recomiendo que omita arrastrar su carpeta public y en su lugar automatice el proceso a través de GitHub.

1. Cuando esté listo para publicar, haga commit a sus cambios y súbalos a GitHub, luego vaya en línea a Netlify.
2. Haga clic en el botón Sign up e inscríbase usando su cuenta existente de GitHub (no es necesario crear otra cuenta)
3. Inicie sesión y seleccione: New site from Git -> Continuous Deployment: GitHub.
4. Desde allí, Netlify le permitirá seleccionar de sus repositorios GitHub existentes. Escogerá el repositorio con el que ha estado trabajando con blogdown, luego configurará su compilación. Esto implica especificar dos cosas importantes: el comando de compilación y el directorio de publicación (que debe ser public).

• Más acerca del comando de compilación de Netlify: “Para hosting de Hugo, hugo construirá y publicará con la versión 0.17 de hugo. Puede especificar una versión de hugo como esta: hugo_0.15. Actualmente las versiones 0.13, 0.14, 0.15, 0.16, 0.17, 0.18 y 0.19 están soportadas. Para la version 0.20 y superiores, necesitará crear un ambiente de construcción llamado HUGO_VERSION y configurarlo a la versión de su elección.” Yo opté por la primera opción, y especifiqué hugo_0.19.

Puede verificar su versión de hugo en el terminal usando el comando hugo version. Así es como se veía mi salida, así que podría ejecutar la versión 0.20 si quisiera a través de Netlify, pero opté por 0.19 y funciona muy bien.

$ hugo version
Hugo Static Site Generator v0.20.7 darwin/amd64 BuildDate: 2017-05-08T18:37:40-07:00

Netlify publicará su sitio y le asignará un nombre de subdominio aleatorio del formulario random-word-12345.netlify.com. El mío fue particularmente desafortunado, con la palabra al azar garbage-collector-janice. Debe saber que puede cambiar esto; Cambié el mío a martin.netlify.com.

{{% alert note %}} Cada vez que cambie el nombre de su subdominio, debe actualizar baseurl en su archivo config.toml (así que cambié el mío a baseurl = “https://martin.netlify.com/”). {{% /alert %}}

En este punto, debería estar en funcionamiento con blogdown, GitHub y Netlify, pero aquí hay algunas ideas si quiere ir más lejos…

9 Yendo más lejos

# Enlaza CSS y JS personalizados
#   (relative to /static/css and /static/js respectively)
custom_css = ["blue.css"]

<form action="https://formspree.io/your@email.com" method="POST">
<label for="name">Your name: </label>
<input type="text" name="name" required="required" placeholder="here"><br>
<label for="email">Your email: </label>
<input type="email" name="_replyto" required="required" placeholder="here"><br>
<label for="message">Your message:</label><br>
<textarea rows="4" name="message" id="message" required="required" class="form-control" placeholder="I can't wait to read this!"></textarea>
<input type="hidden" name="_next" value="/html/thanks.html" />
<input type="submit" value="Send" name="submit" class="btn btn-primary btn-outline">
<input type="hidden" name="_subject" value="Website message" />
<input type="text" name="_gotcha" style="display:none" />
</form>