Esta guía completa te guiará a través de la configuración de SourceTree y Git para tu blog Astro Modular, habilitando flujos de trabajo de control de versiones y despliegue fluidos.

Requisitos Previos

Antes de comenzar, asegúrate de tener:

• Una cuenta de GitHub
• Tu proyecto de blog Astro Modular listo
• Comprensión básica de conceptos de control de versiones

Paso 1: Instalar Git

Windows

1. Descarga Git desde git-scm.com
2. Ejecuta el instalador con configuración predeterminada
3. Verifica la instalación: Abre Símbolo del sistema y ejecuta git --version

macOS

1. Instala Xcode Command Line Tools: xcode-select --install
2. O descarga desde git-scm.com
3. Verifica la instalación: Abre Terminal y ejecuta git --version

Linux

```bash

Ubuntu/Debian

sudo apt update
sudo apt install git

CentOS/RHEL

sudo yum install git

Verificar instalación

git —version
```

Paso 2: Configurar Git

Configura tu identidad de Git:

```bash
git config —global user.name “Tu Nombre”
git config —global user.email “tu.email@ejemplo.com”
```

Opcional: Configurar claves SSH para GitHub

1. Generar clave SSH: ssh-keygen -t ed25519 -C "tu.email@ejemplo.com"
2. Agregar al agente SSH: ssh-add ~/.ssh/id_ed25519
3. Copiar clave pública: cat ~/.ssh/id_ed25519.pub
4. Agregar a GitHub: Settings → SSH and GPG keys → New SSH key

Paso 3: Instalar SourceTree

Descargar e Instalar

1. Visita sourcetreeapp.com
2. Descarga la versión gratuita
3. Instala con configuración predeterminada
4. Inicia sesión con tu cuenta de Atlassian (gratuita)

Configuración del Primer Lanzamiento

1. Elige “I don’t have a repository yet”
2. Conecta tu cuenta de GitHub
3. Autoriza a SourceTree a acceder a tus repositorios

Paso 4: Inicializar tu Repositorio de Blog

Opción A: Crear Nuevo Repositorio en GitHub

1. Ve a GitHub.com → New Repository
2. Nómbralo nombre-de-tu-blog
3. Hazlo público o privado
4. No inicialices con README (lo haremos localmente)

Opción B: Usar Repositorio Existente

Si ya tienes un repositorio, salta al Paso 5.

Paso 5: Clonar Repositorio en SourceTree

1. Abre SourceTree
2. Haz clic en el botón “Clone”
3. Ingresa la URL de tu repositorio:
   • HTTPS: https://github.com/usuario/nombre-de-tu-blog.git
   • SSH: git@github.com:usuario/nombre-de-tu-blog.git
4. Elige carpeta local para tu proyecto
5. Haz clic en “Clone”

Paso 6: Configurar tu Blog de Astro

Copiar tus Archivos de Blog

1. Copia todos tus archivos de Astro Modular en la carpeta del repositorio clonado
2. Asegúrate de tener:
   • Directorio src/ con tu contenido
   • package.json y pnpm-lock.yaml
   • astro.config.mjs
   • Todos los demás archivos necesarios

Commit Inicial

1. En SourceTree, verás todos tus archivos listados como “Unstaged files”
2. Haz clic en “Stage All” para agregar todos los archivos al staging
3. Escribe un mensaje de commit: “Configuración inicial del blog”
4. Haz clic en “Commit”
5. Haz clic en “Push” para subir a GitHub

Paso 7: Configurar Despliegue

Para Netlify

1. Ve a netlify.com
2. Conecta tu cuenta de GitHub
3. Selecciona tu repositorio de blog
4. Configuración de compilación:
   • Comando de compilación: pnpm run build
   • Directorio de publicación: dist
5. ¡Despliega!

Para Vercel

1. Ve a vercel.com
2. Importa tu repositorio de GitHub
3. Preset de framework: Astro
4. ¡Despliega!

Paso 8: Flujo de Trabajo Diario con SourceTree

Realizar Cambios

1. Edita el contenido de tu blog en Obsidian o tu editor
2. Abre SourceTree
3. Revisa los cambios en la pestaña “Working Directory”
4. Stage archivos específicos o “Stage All”
5. Escribe mensaje de commit descriptivo
6. Haz clic en “Commit”
7. Haz clic en “Push” para sincronizar con GitHub

Mejores Prácticas

• Commit frecuentemente: Los commits pequeños y enfocados son mejores
• Escribe mensajes claros: “Agregar nuevo post de blog sobre X” no “Actualizar archivos”
• Pull antes de push: Siempre extrae los últimos cambios primero
• Usa branches: Crea branches de características para cambios importantes

Paso 9: Flujos de Trabajo Avanzados de Git

Crear Branches

1. En SourceTree, haz clic en “Branch” → “New Branch”
2. Nómbralo descriptivamente: feature/nuevo-tema o fix/correccion-typo
3. Realiza tus cambios
4. Commit y push del branch
5. Crea Pull Request en GitHub

Fusionar Cambios

1. Cambia al branch principal
2. Extrae los últimos cambios
3. Fusiona tu branch de característica
4. Elimina el branch de característica

Resolver Conflictos

1. SourceTree mostrará marcadores de conflicto
2. Edita archivos para resolver conflictos
3. Stage archivos resueltos
4. Commit de la resolución

Paso 10: Respaldo y Recuperación

Respaldos Regulares

• Tu código se respalda automáticamente en GitHub
• Considera respaldos adicionales de tu contenido
• Usa el historial incorporado de Git para recuperación

Recuperarse de Errores

• Deshacer último commit: Clic derecho en commit → “Reset current branch to this commit”
• Revertir cambios: Clic derecho en archivo → “Discard changes”
• Ver historial: Haz clic en cualquier commit para ver qué cambió

Solución de Problemas Comunes

Problemas de Autenticación

• HTTPS: Usa Personal Access Token en lugar de contraseña
• SSH: Asegúrate de que la clave SSH esté agregada a la cuenta de GitHub

Conflictos de Fusión

• ¡No entres en pánico! Los conflictos son normales
• Lee los marcadores de conflicto cuidadosamente
• En caso de duda, pide ayuda

Archivos Grandes

• Git no está diseñado para archivos binarios grandes
• Usa Git LFS para imágenes y videos
• O almacena activos externamente (CDN, etc.)

Tamaño del Repositorio

• Usa .gitignore para excluir archivos innecesarios
• Limpia el historial si el repositorio se vuelve demasiado grande

Integración con Obsidian

Integración de Git en Obsidian

1. Instala el plugin “Obsidian Git”
2. Configura ajustes de auto-commit
3. Los cambios de tu bóveda de Obsidian se comprometerán automáticamente

Flujo de Trabajo

1. Escribe en Obsidian
2. Obsidian Git auto-compromete cambios
3. SourceTree extrae y empuja a GitHub
4. Netlify/Vercel auto-despliega

Próximos Pasos

Una vez que tengas Git y SourceTree configurados:

1. Explora características de SourceTree: Aprende sobre stashing, cherry-picking y rebasing
2. Configura CI/CD: Automatiza tu pipeline de despliegue
3. Colabora: Invita a otros a contribuir a tu blog
4. Estrategias de respaldo: Implementa soluciones de respaldo adicionales

Obtener Ayuda

• Documentación de SourceTree: confluence.atlassian.com
• Documentación de Git: git-scm.com/doc
• Ayuda de GitHub: docs.github.com

Recuerda: Git y SourceTree son herramientas poderosas que harán que gestionar tu blog sea mucho más fácil. Tómate el tiempo para aprender lo básico, ¡y no dudes en experimentar primero en un repositorio de prueba!