Gua rpida para utilizar Github

Este tutorial es una gua rpida para instalar y utilizar GitHub. Aqu se
explica cmo crear un repositorio local, cmo conectar este repositorio
local al repositorio remoto de Github (donde todo el mundo lo puede
ver), cmo confirmar los cambios y finalmente cmo empujar todo el
contenido del repositorio local hacia GitHub, entre otras tareas comunes.
Antes de empezar, es importante tener en cuenta que este tutorial
supone un conocimiento bsico de los trminos utilizados en Git:
empujar (push), jalar (pull), guardar los cambios (commit), repositorio
(repository), etc. Tambin requiere el registro previo en GitHub.

Instalacin
En Debian/Ubuntu y derivados:
sudo apt-get install git
En Fedora y derivados:
sudo yum install git
En Arch y derivados:
sudo pacman -S git

Configuracin inicial
Una vez que la instalacin se ha completado con xito, el siguiente paso
es configurar los detalles de configuracin del usuario GitHub. Para ello,
hay que utilizar los siguientes comandos sustituyendo nombre_usuario
con tu nombre de usuario GitHub y email_id con la direccin de correo
electrnico utilizada para crear la cuenta de GitHub.
git config --global user.name "nombre_usuario"
git config --global user.email "email_id"

Creacin de un repositorio local

Lo primero es crear una carpeta en tu computadora, que servir como
un repositorio local. Para ello, basta ejecutar el siguiente comando:
git init Mytest
Este comando crea la carpeta MyTest. A su vez, la sub-carpeta .init hace
que MyTest sea reconocido como un repositorio local de Git.
Si se crea el repositorio con xito, aparecer una lnea similar a la
siguiente:
Initialized empty Git repository in
/home/tu_usuario/Mytest/.git/
Acto seguido, hay que entrar a la carpeta MyTest:
cd Mytest

Creacin de un archivo README para describir el

repositorio
El archivo README se utiliza generalmente para describir lo que el
repositorio contiene o lo que el proyecto se trata. Para crear uno, basta
ejecutar:
gedit README
Una vez que hayas ingresado la descripcin del repositorio, no olvides
guardar los cambios.

Adicin de los archivos del repositorio a un ndice

Este es un paso importante. Antes de poder subir los cambios a Github u
otro servidor compatible con Git, hay que indexar todos los archivos
contenidos en el repositorio local. Este ndice contendr los archivos

nuevos as como los cambios a los archivos existentes en el repositorio

local.
En nuestro caso, nuestro repositorio local ya contiene un nuevo archivo:
el README. Por lo tanto, vamos a crear otro archivo con un programa C
simple y al cual llamaremos ejemplo.c. Los contenidos del mismo sern:
#include
int main()
{
printf("hello world");
return 0;
}
As que, ahora tenemos 2 archivos en nuestro repositorio local: README
y ejemplo.c.
El siguiente paso es agregar estos archivos al ndice:
git add README
git add smaple.c
El comando git add se puede utilizar para agregar cualquier nmero de
archivos y carpetas al ndice. Para agregar todos los cambios, sin
especificar el nombre de los archivos, es posible ejecutar git add . (con
un punto al final).

Guardar los cambios realizados en el ndice

Una vez aadidos todos los archivos, es posible dejar un registro de
estos cambios haciendo lo que en la jerga se llama un commit. Esto
significa que ya se ha terminado de agregar o modificar archivos y que
los cambios pueden ser subidos al repositorio remoto de Github. Para
ello, hay que ejecutar el siguiente comando:
git commit -m "mensaje"
mensaje puede ser cualquier mensaje que describa brevemente los
cambios en cuestin, por ejemplo: agregu tal funcionalidad o correg
tal cosa, etc.

Creacin de un repositorio en GitHub

El nombre del repositorio debe ser el mismo que el repositorio del
sistema local. En este caso, ser MyTest. Para ello, antes que nada,
hay que iniciar sesin en Github. Luego, hay que hacer clic en el signo
ms (+) en la esquina superior derecha de la pgina y seleccionar la
opcin crear nuevo repositorio. Finalmente, hay que rellenar los datos
y hacer clic en el botn crear repositorio.
Una vez hecho esto se crear el repositorio y ser posible subir el
contenido del repositorio local en el repositorio GitHub. Para conectarse
al repositorio remoto en GitHub hay que ejecutar el comando:
git remote add origin https://github.com/user_name/Mytest.git
[info]No olvides reemplazar nombre_usuario y MyTest con tu nombre
de usuario y carpeta correspondientes.[/info]

Empujar archivos del repositorio local al repositorio

GitHub
El paso final es empujar el contenido del repositorio local hacia el
repositorio remoto, mediante el comando:
git push origin master
Slo resta introducir las credenciales de inicio de sesin (nombre de
usuario y contrasea).
Esto subir todo el contenido de la carpeta MyTest (repositorio local) a
GitHub (repositorio externo). Para los proyectos subsiguientes ya no
har falta seguir estos pasos desde cero. En cambio, podrs empezar
desde el paso 3 directamente. Por ltimo, no te olvides que los cambios
estarn disponibles desde la pgina web de Github.

Creacin de una rama (branch)

Cuando los desarrolladores quieren corregir errores o agregar nuevas

funciones a menudo crean una rama (branch) o copia del cdigo de
modo que puedan realizar commits en forma separada, sin afectar el
proyecto original. Luego, cuando hayan terminado pueden fusionar esta
rama de vuelta en la rama principal (master).
Para crear una nueva rama hay dos opciones:
Opcin larga:
git branch mirama # crea una nueva rama llamada mirama
git checkout mirama - pasa a utilizar la rama mirama.
Opcin corta:
git checkout -b mirama - crea y pasa a utilizar la rama
mirama
Una vez realizados los cambios, hay que agregarlos al ndice de la rama
y hacer el commit correspondiente:
git add .
git commit -m "cambios en mirama"
Luego, hay que volver a la rama principal y tomar los cambios realizados
en mirama:
git checkout master
git merge mirama
Finalmente, hay que borrar mirama (ya que los cambios fueron
incorporados en master):
git branch -d mirama
Y subir master a Github:
git push origin master

Creacin de un repositorio Git derivado (fork)

Gracias a Git y a la existencia de las grandes libreras de repositorios
pblicos, como Github, gran parte de las veces no es necesario

comenzar a programar nuestro proyecto desde cero. En esos casos, es

posible tomar este cdigo de base para crear un nuevo proyecto.
Para ello, lo primero que hay que hacer es un fork de un repositorio
existente, o sea, un proyecto derivado del mismo que tome como base
el cdigo del proyecto original. En Github, eso se consigue haciendo clic
en el botn correspondiente, como se ve en la captura a continuacin.

Luego, lo que hay que hacer es clonar el repositorio de este nuevo

proyecto en nuestra computadora. A modo de ejemplo, podemos utilizar
mi repositorio de Ankifox, una extensin para Firefox que permite
agregar palabras a Anki, el cual se encuentra disponible en Github:
git clone https://github.com/usemoslinux/Ankifox.git
No olvides reemplazar https://github.com/usemoslinux/Ankifox.git por la
URL correspondiente a tu proyecto. Obtener esta direccin es muy fcil,
como se ve en la imagen a continuacin.

Este comando crear un directorio llamado Ankifox, inicializar el

directorio .git dentro de l, y bajar todos los datos de ese repositorio, a
fin de trabajar con la ltima versin.