📄 Documentación de GitHub (5 Páginas)
Página 1: Introducción a GitHub
¿Qué es GitHub?
GitHub es una plataforma en línea que permite almacenar proyectos usando Git. Además,
proporciona herramientas de colaboración como issues, pull requests y wikis.
Características principales:
● Hospedaje de código fuente.
● Control de versiones con Git.
● Colaboración en equipo.
● Seguimiento de errores y tareas.
● Automatización con GitHub Actions.
● Integración con otras plataformas (CI/CD, IDEs, etc).
Ventajas:
● Facilita el trabajo en equipo.
● Todo el código está respaldado en la nube.
● Permite contribuir a proyectos de código abierto.
Página 2: Crear y Configurar un Repositorio en GitHub
1. Crear cuenta:
Ingresar a https://github.com y crear una cuenta gratuita.
2. Crear un repositorio nuevo:
● Ir a tu perfil y hacer clic en “New repository”.
● Completar los campos:
○ Nombre del repositorio
○ Descripción (opcional)
○ Público o privado
○ Inicializar con README (opcional)
● Hacer clic en “Create repository”.
3. Conectar repositorio local con GitHub:
bash
CopiarEditar
git remote add origin https://github.com/usuario/repositorio.git
git push -u origin main
4. Clonar un repositorio desde GitHub:
bash
CopiarEditar
git clone https://github.com/usuario/repositorio.git
Página 3: Subir y Descargar Cambios
Subir archivos nuevos:
bash
CopiarEditar
git add .
git commit -m "Subiendo cambios"
git push origin main
Descargar cambios del repositorio remoto:
bash
CopiarEditar
git pull origin main
Ignorar archivos con .gitignore: Crear un archivo .gitignore y agregar las
extensiones o rutas que no deseas subir, por ejemplo:
bash
CopiarEditar
node_modules/
*.log
.env
Ver historial de cambios en GitHub:
● Entra al repositorio y haz clic en la pestaña “Commits”.
Página 4: Colaborar en Proyectos con GitHub
1. Fork (Copiar un repositorio a tu cuenta):
● En un proyecto público, haz clic en “Fork”.
● Se creará una copia en tu cuenta para que trabajes sin afectar el original.
2. Clonar tu fork y trabajar:
bash
CopiarEditar
git clone https://github.com/tuusuario/repositorio-fork.git
3. Pull Request (solicitud de cambios):
● Sube tus cambios a tu fork.
● Desde GitHub, haz clic en “Pull Request” para proponer tus cambios al proyecto
original.
● Los administradores pueden aceptar o comentar tu propuesta.
4. Issues (seguimiento de errores/tareas):
● En el repositorio, ir a la pestaña “Issues”.
● Crear un nuevo issue para reportar un bug o sugerir una mejora.
Página 5: GitHub Avanzado (Opcionales)
GitHub Pages:
● Sirve para publicar sitios web estáticos directamente desde un repositorio.
● Activar desde la configuración del repositorio en la sección “Pages”.
GitHub Actions:
● Permite automatizar tareas como pruebas, despliegue y más.
● Se definen en archivos .yml dentro de .github/workflows.
Markdown en GitHub:
● Usar Markdown para formatear README.md, issues y pull requests.
markdown
CopiarEditar
# Título
**Negrita**
_Itálica_
- Lista
[Enlace](https://github.com)
Integraciones útiles:
● VS Code: Extensión oficial de GitHub.
● Slack/Discord: Notificaciones automáticas.
● Trello/Jira: Integración de gestión de tareas.