16 Proyecto nuevo, primero GitHub

Se crea un nuevo proyecto, con la secuencia preferida “GitHub primero, luego RStudio”. ¿Por qué se prefiere esto? Porque este método de copiar el proyecto de GitHub a su computadora también configura el repositorio local de Git para hacer push y pull inmediatamente. Bajo el capó, estamos haciendo git clone.

Realmente ha hecho esto antes durante la configuración (capítulo 13). Se está haciendo de nuevo, pero ahora con sentimiento.

16.1 Haga un repositorio en GitHub

Haga esto una vez por cada nuevo proyecto.

Vaya a https://github.com y asegúrese de estar logueado.

Haga clic en el botón verde “New repository”. O bien, si está en su propia página de perfil, haga clic en “Repositories” y, a continuación, haga clic en el botón verde “New”.

Nombre de repositorio: myrepo (o lo que desee) Public YES Inicialice este repositorio con un README

Haga clic en el botón verde grande “Create repository”.

Copie la URL del clon HTTPS en su portapapeles a través del botón verde “Clone or Download”. O copie la URL SSH si escogió configurar las claves SSH.

16.2 Nuevo proyecto de RStudio via git clone

En RStudio, inicie un nuevo proyecto:

  • File > New Project > Version Control > Git. En el “repository URL” pegue el URL de su nuevo repositorio GitHub. Será algo así https://github.com/jennybc/myrepo.git.
  • Sea intencional sobre dónde creará este Proyecto.
  • Se le sugiere “Open in new session”.
  • Haga click en “Create Project” para crear un nuevo directorio, que será todas estas cosas:
    • un directorio o “carpeta” en su computadora
    • un repositorio de Git, vinculado a un repositorio remoto de GitHub
    • un Proyecto de RStudio
  • En ausencia de otras restricciones, se le sugiere que todos sus proyectos R tengan exactamente esta configuración.

Esto debería descargar el archivo README.md que se creó en GitHub en el paso anterior. Busque en el panel del explorador de archivos de RStudio el archivo README.md.

Hay una gran ventaja para el flujo de trabajo de “Primero GitHub , luego RStudio”: el repositorio remoto de GitHub es ahora el “upstream” para su repositorio local. Este es un punto técnico pero importante sobre Git. La implicación práctica es que ahora están preparados para hacer push y pull. No hay necesidad de sufrir alrededor de la configuración de los controles remotos de Git en la línea de comandos o en otro cliente de Git.

16.3 Haga cambios locales, guarde, haga commit

Haga esto cada vez que termine un pedazo valioso de trabajo, probablemente muchas veces al día.

Desde RStudio, modifique el archivo README.md, por ejemplo, agregando la línea “Esto es una línea de RStudio”. Guarde los cambios.

Haga commit a estos cambios en su repositorio local. ¿Cómo?

  • Haga clic en la pestaña “Git” en el panel superior derecho
  • Compruebe la casilla “Staged” para los archivos cuya existencia o modificaciones les desea hacer commit.
    • Para ver más detalles sobre lo que ha cambiado en el archivo desde el último commit, haga clic en “Diff” para una ventana emergente de Git
  • Si aún no está en la ventana emergente de Git, haga clic en “Commit”
  • Escriba un mensaje en “Commit message”, como “Commit desde RStudio”.
  • Haga clic en “Commit”

16.4 Haga push de sus cambios locales a GitHub

Haga esto varias veces al día, pero posiblemente menos a menudo de lo que usted hace commit.

Usted tiene un nuevo trabajo en su repositorio local de Git, pero los cambios no están todavía en línea.

Esto parecerá contraintuitivo, pero primero deténgase y descargue de GitHub.

¿Por qué? ¡Establezca este hábito para el futuro! Si realiza cambios en el repositorio en el navegador o en otra máquina o (un día) un colaborador ha hecho push, se sentirá más feliz si hace pull de estos cambios antes de intentar hacer push.

Haga clic en el botón azul “Pull” en la pestaña “Git” en RStudio. Quizás no suceda nada, es decir, obtendrá el mensaje “Ya está actualizado”. Esto es sólo para establecer un hábito.

Haga clic en el botón verde “Push” para enviar sus cambios locales a GitHub. Usted debe ver un mensaje parecido a lo que se ve en estas líneas.

16.5 Confirme el cambio local extendido al control remoto de GitHub

Vuelva al navegador. Se supone que todavía está viendo su nuevo repositorio de GitHub.

Refresque la página del navegador.

Debe ver la nueva “Esta es una línea de RStudio” en el README.

Si hace clic en “commits”, debería ver uno con el mensaje “Commit desde RStudio”.

16.6 Hacer un cambio sobre GitHub

Haga clic en README.md en la lista de archivos de GitHub.

En la esquina superior derecha, haga clic en el lápiz para “Editar este archivo”.

Agregue una línea a este archivo, como “Línea agregada desde GitHub”.

Edite el commit message en “Commit changes” o acepte el valor predeterminado.

Haga clic en el botón verde grande “Commit changes”.

16.7 Pull desde GitHub

De vuelta en RStudio localmente …

Inspeccione su README.md. NO debe tener la línea “Línea agregada desde GitHub”. Debería estar como la dejó. Compruébelo.

Haga clic en el botón azul Pull.

Vea el README.md de nuevo. Ahora debería ver la nueva línea allí.

16.8 Finalmente

Ahora sólo … repita. Trabaje en cualquier parte. Haga commit. Haga push o pull dependiendo de dónde lo hizo, pero obtenga “sincronización” local y remota. Repítalo.

  • Tenga en cuenta que en general (y especialmente en el futuro al colaborar con otros desarrolladores) usualmente tendrá que hacer pull de los cambios desde el mando a distancia (GitHub) antes de hacer push de los cambios locales que haya hecho. Por esta razón, es una buena idea tratar de adquirir el hábito de hacer pull antes de intentar hacer push.