Tu primer archivo con Git

En esta actividad vas a:

1️⃣ Ubica tu carpeta en el proyecto

“Ah, veo que Git está escribiendo un archivo… Déjame meterme a sincronizarlo justo ahora” → Y pum: destruye todo.

Por eso aparecen:

  • .lock por todos lados

  • merges imposibles

  • archivos .Rproj.user reventados

  • fatal: cannot lock ref HEAD

  • errores aleatorios que ni Linus Torvalds entiende

Y uno queda así:

“¿POR QUÉ? ¡Si solo hice pull!” 😭

💡 La regla de oro absoluta:

⭐ NUNCA trabajar un repositorio dentro de Google Drive, OneDrive o iCloud.

Git y los servicios de sincronización son enemigos naturales.

Git: “Déjame escribir un archivo pequeño”.

Google Drive: “Déjame copiarlo a 14 servidores mientras lo usas”.

Resultado: 💥🐱‍👤💥

💚 La solución definitiva:

Clonar SIEMPRE en un sitio local como:

~/Documents/Repos/

o

~/Projects/

Y luego, si quieres, sincronizas SOLO los archivos finales (PDF, QMD renderizados, etc.) con Drive.

Dentro del proyecto clonado mi-red-car, verás carpetas como:

Est1/\
Est2/\
Est3/\
...\
Est10/

Tu profesora te dirá cuál es tu carpeta asignada.
Ejemplo: si eres la Estudiante 3, trabajas en:

Est3/

📌 Regla: solo trabajas dentro de tu carpeta.
No modifiques carpetas de otras personas.

2️⃣ Crear tu primer archivo .qmd

  1. En RStudio, abre tu carpeta (por ejemplo Est3/).
  2. Crea un archivo nuevo:
File → New File → Quarto Document
  1. Guárdalo dentro de tu carpeta como:

intro.qmd

Debe quedar así:


Est3/\
└── intro.qmd

3️⃣ Insertar una imagen

  1. Guarda cualquier imagen dentro de tu carpeta.
    Ejemplo:

Est3/\
├── intro.qmd\
└── foto.png
  1. En tu archivo intro.qmd, inserta la imagen con:
![](foto.png)
  1. Debajo, escribe unas 2–3 líneas sobre ti o tu proyecto.

Ejemplo:

## Mi primera página

Esta es mi primera prueba usando Git y Quarto dentro del proyecto.

4️⃣ Previsualizar tu página

En RStudio:

Render → Render Document

O por consola:

quarto render

Esto genera tu HTML local.

5️⃣ Guardar tus cambios con Git

Cuando termines tu archivo, haz tu primer registro en Git.

➤ Ver qué cambió

En RStudio → pestaña Git
o por terminal:

git status

Debe aparecer algo como:

modified: Est3/intro.qmd
new file: Est3/foto.png

➤ Agregar tus archivos

Desde la interfaz de Git en RStudio:

  • Marca las casillas

  • Clic en Stage

O en terminal:

git add Est3/intro.qmd
git add Est3/foto.png

➤ Hacer commit

En RStudio:

  1. Git → Commit

  2. Mensaje sugerido:

Creo mi primer archivo intro.qmd

En terminal:

git commit -m "Creo mi primer archivo intro.qmd"

➤ Subir a GitHub (push)

En RStudio:

  • Botón Push

En terminal:

git push

La primera vez te pedirá el usuario y tu token.

6️⃣ (Opcional) Renombrar tu carpeta con Git

Sí, se puede renombrar la carpeta.
Hazlo así:

  1. En RStudio: clic derecho → Rename…
    Ejemplo:
Est3 → CamilaRodriguez
  1. Luego registra los cambios:
git add -A
git commit -m "Renombro mi carpeta personal"
git push

📌 No renombres carpetas de otras personas.

✅ ¡Listo!

Ya tienes:

  • una carpeta personal

  • tu archivo intro.qmd

  • una imagen

  • tu primer commit

  • y tus cambios publicados en GitHub

Con esto ya puedes comenzar a construir tu sección en el sitio del proyecto.

🔒 SOLO LA PROFE HACE: Publicar el sitio web

Aunque cada estudiante puede trabajar en su carpeta, editar su archivo intro.qmd, agregar imágenes y hacer add → commit → push, la publicación del sitio web completo SOLO la hace la profesora.

Esto se debe a que GitHub Pages no ejecuta Quarto automáticamente.

Para que los cambios aparezcan en:

[https://dannacruz.github.io/mi-red-car/]

la profesora debe reconstruir el sitio completo y subir los archivos HTML dentro de la carpeta docs/.

A continuación se describe el proceso que realiza la profesora:

1️⃣ Descargar los cambios de los estudiantes

Cuando un estudiante termina y hace push, la profesora baja la versión más reciente del repositorio:

git pull

2️⃣ Renderizar todo el sitio con Quarto

Esto genera todos los archivos HTML actualizados dentro de docs/:

quarto render

3️⃣ Subir el sitio renderizado a GitHub Pages

GitHub Pages publica automáticamente lo que hay dentro de docs/, así que la profesora registra y envía los cambios:

git add docs
git commit -m "Renderizo y actualizo el sitio web"
git push

💡 ¿Por qué SOLO la profe publica?

  • El repositorio usa output-dir: docs

  • GitHub Pages solo publica archivos HTML ya generados

  • Los estudiantes no deben renderizar el sitio completo

  • Una sola persona debe encargarse de la versión final del sitio para evitar errores de compilación

✔️ ¿Qué hacen los estudiantes entonces?

Los estudiantes SÍ pueden:

  • editar su carpeta (Ej.: Est3/intro.qmd)

  • agregar imágenes

  • guardar sus cambios con:

  git add
  git commit
  git push

Los estudiantes NO publican el sitio.

La profesora lo hace para garantizar que todo compile y funcione correctamente.