Práctica Control de Versiones

Author
Affiliation

Antonio J. Pérez-Luque

Instituto de Ciencias Forestales (CIFOR) | INIA-CSIC (Madrid)

Published

January 21, 2025

Introducción

1 Objetivos

  • Aprender a realizar control de versiones de un proyecto tanto de forma individual como colaborativa.

2 Actividades

  • Cada alumno ha de hacer las actividades 1 y 2 (nivel básico), y si lo desea realizar la actividad 3 que combina control de versiones y documentos reproducibles (nivel experto)

2.1 Actividad 1. Control de Versiones de un proyecto

  1. Instalar Git en tu ordenador.

  2. Crear un repositorio llamado ecoinf_nombre Ejemplo:

ecoinf_antonioperez

  1. Genera un documento de texto plano (.txt) o un script (.R).

  2. Realiza varios cambios en el documento y registra cada cambio.

  3. Haz un control de versiones.

  4. Crea un repositorio en GitHub.

  5. Conecta ambos repositorios (repositorio local y repositorio remoto) y sincronízalos.

Entrega

Cada alumno ha de enviar la url del repositorio creado en github.

2.2 Actividad 2. Control de Versiones (Colaboración)

  1. Crea un fork del repositorio https://github.com/ajpelu/teach_git_ejemplo

  2. Clona el repositorio en tu equipo para tener una copia local.

  3. Escribe algo en el documento miarchivo.txt (además de tu nombre y tus apellidos, algo original: un poema, una canción, un refrán, un mensaje, una receta, … ).

  4. Registra los cambios y haz un control de versiones.

  5. Sincroniza con tu repositorio remoto.

  6. Haz un pull request.

Tip

Si tienes alguna duda consulta puedes leer este tutorial

Entrega

No es necesario realizar entrega, puesto que me llegarán los pull requests de cada alumno

2.3 Actividad 3. Control de Versiones de Documentos Reproducibles

  1. Crea un documento reproducible con .Rmd y exportalo en el formato que mas te guste (pdf, word, etc.). El documento debe contener al menos texto, imágenes, código, tablas, etc.

  2. Realiza cambios en el documento:

  • Personaliza con el encabezado YAML
  • Incluye texto
  • Modifica el código

  1. Registra los cambios en el documento mediante el control de versiones de forma local y en remoto.

  2. Usa el repositorio del la Actividad 1.

Entrega

Cada alumno ha de enviar la url del repositorio creado en github así como un archivo comprimido (.zip) con una copia de su repositorio local.

2.4 Recursos

Para la realización de este ejercicio práctico consulta las diapositivas y el temario que se ha dado en clase así como algunos de los recursos incluidos, como por ejemplo: