Tres caminos para clonar/descargar un repositorio de GitHub
Para replicar las clases del curso “Taller de R: Estadística y programación” (ver repositorio del curso en GitHub aquí) o cualquier otro repositorio libre en GitHub, usted puede seguir cualquiera de estos tres caminos. Sin embargo, en cualquiera de los tres casos, es necesario que usted se registre y cree una cuenta en GitHub previamente.
- Descargar el respositorio manualmente.
La forma más sencilla de descargar un repositorio de GitHub para replicar la clase es descargar manualmente la carperta completa del repositorio. Para ello, usted debe ir al repositorio y hacer clic en 
y después hacer clic en 
.
Esto generará en su carpeta de descargas un archivo de extención .zip que debe descomprimir. Al descomprimir el archivo, usted obtiene una carpeta con todos los archivos del repositorio. Para propositos de la clase, es importante que usted lea los archivos README.html y el otro archivo .html que está en la carpeta help.
- Usando la URL del repositorio.
Podemos descargar el repositorio usando la URL del archivo .zip. Para ello, primero vamos a ir a la consola de Rstudio y generamos un script. Después seleccionamos el directorio de trabajo en el que deseamos descargar la carpeta.
Copiamos el código que se genera en la consola setwd("~/Downloads") y lo pegamos en el script.
# By: Eduard Martinez
# Date: 16-08-2020
# Vamos a establecer el directorio de trabajo
setwd("~/Downloads")
Ahora vamos al repositorio en GitHub y hacemos clic en y después hacemos clic derecho sobre para que se despliegue el siguiente menu:
Ahora, debe hacer clic sobre 
. Esto copiará la URL que contiene el archivo .zip del repositorio. Ahora vamos a descargar el repositorio usando la función download.file del paquete utils (este paquete viene por default en la instalación de R, así que no deberia tener problemas). Pegamos la URL que copiamos en el argumento url y en el argumento destfile escribimos el nombre que le queremos asignar a nuestra carpeta.
# Descargar el repositorio
download.file(url = "https://github.com/taller-R/Clase_1/archive/master.zip",
destfile = "clase_1.zip")Después de correr estas lineas, se genera en nuestro directorio de trabajo un archivo llamdo “clase_1.zip” en formato .zip con el contenido del repositorio.
Ahora vamos a descomprimir este archivo usando la función unzip del paquete utils.
# Descomprimir el archivo
unzip(zipfile = "clase_1.zip")Debemos tener en un nuestro directorio de trabajo una carpeta llamda “clase_1-master” con el contenido del repositorio.
Ya podemos fijar nuestro nuevo directorio de trabajo hasta la carpeta que descomprimimos setwd("~/Downloads/clase_1-master") e inspeccionamos los archivos que contiene list.files()
# Cambiar el directorio de trabajo
setwd("~/Downloads/clase_1-master")
# Inspeccionar archivos en el directorio
list.files()Listo ya puedes replicar este repositorio, solo debes ir a la carpeta codes y a la carpeta help para que abras el archivo Clase 1.R y el archivo Clase 1.html.
- Crear un proyecto de versión de control.
Otra forma de replicar un repositorio en GitHub, es crear un proyecto de versión de control en R. Para ello, primero tenemos que istalar git, un sistema de control de versiones. Debemos ir al siguiente en enlace y elegir el instalador que sea compatible con el sistema operativo de nuestro equipo.
3.1.1 Instalación de Git en Windows.
Si usted usa Windows, debe descargar el instalador de git bash (Git for Windows Setup de 32-bit o 64-bit), hacer clic sobre el y seguirle las instrucciones de instalación.
3.1.2 Instalación de Git en Mac.
Si usted tiene un equipo Mac, primero debe ir a la terminal de su equipo (puede hacerlo desde Rstudio) e instalar Homebrew. “Homebrew instala todo aquello que necesitas que Apple no instala de serie”. Las instrucciones de instalación puede encontrarlas en este enlace o puede copiar este codígo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" y pegarlo en la terminal de su equipo.
Después que termina de instalarse Homebrew, usted puede instalar Git copiando y pegando esta linea de código en la terminal brew install git.
3.2 Configuración inicial de Git.
Ahora vamos a configurar nuestra cuenta de GitHub desde la terminal. Esto aplica tanto para usuarios de Windows como usuarios de MAC, sin embargo, este proceso solo se debe realizar una vez, ya que la información queda guardada en la configuración de nuestro equipo.
Primero vamos a abrir la terminal del equipo (puedes usar la de R) y escribimos: git config --global user.name "Escribe tu usuario de GitHub". Luego como una forma verificar si lo hiciste bien, puedes escribir git config user.name sobre la terminal y deberías obtener el nombre del usuario que habías escrito anteriormente.
Ahora debes escribir la siguiente linea de código: git config --global user.email "Escribe tu correo de GitHub" luego escribes git config user.email para verificar que lo hiciste bien.
Finalmente debes escribir la siguiente linea de código: git config --global user.password "Escribe tu contraseña de GitHub". Con esto quedó configurado nuestra cuenta de Git en el equipo y no es necesario que hagas esto cada vez que vas a clonar un repositorio en GitHub.
3.3 Clonar el repositorio.
Ya podemos ir al repositorio de GitHub que queremos clonar. Primero vamos a hacer una bifurcación del repositorio original. Para ello, debemos ir al repositorio y hacer clic en 
. Esto debe crear un nuevo brazo del repositorio así:
Ahora debemos ir al repositorio que clonamos (el que se crea en tu bodega de repositorios de GitHub) y hacemos clic en y después hacemos clic sobre 
para copiar la url del repositorio.
3.4 Crear una versión de control en R.
Ya que tenemos la URL del repositorio, vamos a Rstudio y creamos un proyecto de versión de control. Primero hacemos clic en 
para que se despliegue el siguente menu:
depués hacemos clic en Version Control para que se despliegue el siguente menu:
ahora seleccionamos la opci’on Git para que se despliegue el siguente menu:
Ahora, en el espacio de Repository URL: vamos a pegar la URL del repositorio que habiamos copiado en el paso anterior. En Project directory name: escribimos el nombre que queremos ponerle al proyecto, es decir a la carpeta que va a contener el repositorio. Finalmente, en Create project as subdirectory of: seleccionamos la ubicación que queremos asignarle a la carpeta en nuestro equipo. Después de esto, en la parte superior de la “memoria activa” de Rstudio se debe observar un incono con el nombre del proyecto 
y se fija como directorio de trabajo, la carpeta que contiene el proyecto que acabamos de crear. Usted debería observar el contenido de la carpeta así:
3.5 Guardar los cambios en nuestro repositorio.
Finalmente, para guardar en nuestro repositorio los comentarios y los cambios que vamos haciendo sobre la clase, debemos escribir las siguientes lineas de código sobre la terminal de R.
Para subir los cambios que hemos realizado, primero debemos escribir git add -A para marcar todos los archivos que queremos subir a GitHub. Después debemos escribir git commit -m "Escribir comentario", en Escribir comentarios debe escribir el comentario que usted quiere asignarle a los cambios que realizó. Finalmente, para subir los cambios, usted debe escribir git push y listo, ya puede ir a su repositorio en la página de GitHub para revisar los cambios realizó.
Eduard F. Martínez-González
(+571) 3394949 Ext: 2430
eduard-martinez