Escobar

subir-proyecto-jekyll-a-github

Se lee en 2 min

Subir un proyecto Jekyll a un repositorio de GitHub

Guía rápida para conectar un proyecto local (ya inicializado con git init) a un repositorio remoto creado en GitHub.

1. Verificar el estado del repositorio local

git status

2. Agregar los archivos al staging

git add .

Si el proyecto Jekyll genera una carpeta _site (salida compilada), conviene tener un .gitignore para no subirla:

echo "_site/
.jekyll-cache/
.bundle/
vendor/" > .gitignore

3. Hacer el primer commit

git commit -m "Primer commit: proyecto Jekyll"

4. Conectar el repositorio local con el de GitHub

Copiar la URL del repositorio en GitHub (HTTPS o SSH) y ejecutar:

git remote add origin https://github.com/tu-usuario/tu-repositorio.git

Reemplazar tu-usuario y tu-repositorio con los datos reales.

Verificar que quedó bien configurado:

git remote -v

5. Verificar el nombre de la rama principal

git branch

Si la rama se llama master pero se quiere usar main (estándar actual de GitHub):

git branch -M main

6. Subir el proyecto (push)

git push -u origin main

Si la rama sigue llamándose master:

git push -u origin master

⚠️ Cosas a tener en cuenta

  • Si el repositorio en GitHub ya tiene archivos (por ejemplo, creado con README o licencia), el push puede fallar por historiales divergentes. Opciones:

    • Traer esos cambios primero: 
      git pull origin main --allow-unrelated-histories
      Resolver conflictos si aparecen, y luego hacer push.
    • O, si se quiere que la versión local sea la definitiva (sobrescribe lo que haya en GitHub): 
      git push -u origin main --force

  • Autenticación con HTTPS: GitHub ya no acepta contraseña normal. Se necesita un token de acceso personal o tener configurado SSH.

📌 Resumen de comandos (flujo completo)

git status
git add .
git commit -m "Primer commit: proyecto Jekyll"
git remote add origin https://github.com/tu-usuario/tu-repositorio.git
git branch -M main
git push -u origin main

Vista Gráfica