¿Cómo se utiliza Github pages?

GitHub es un sitio "social coding". Te permite subir repositorios de código para almacenarlo en el sistema de control de versiones Git. Tu puedes colaborar en proyectos de código, y el sistema es código abierto por defecto, lo que significa que cualquiera in el mundo puede encontrar tu código en GitHub, usarlo, aprender de el, y mejorarlo. Tú puedes hacer eso con el código de otras personas tambien! Este articulo provee una guia basica para publicar contenido usando la característica gh-pages de Github.

Publicando contenido

Github es una comunidad muy importante y útil para involucrarse, and Git/GitHub is un sistema de control de versiones muy popular — la mayoria de las compañias de tecnologia ahora lo usan en su flujo de trabajo. GitHub tiene una caracteristica muy útil llamada GitHub pages, que te permite publicar un sitio web en vivo del código en la Web.

Configuración básica de Github

1. Primero que todo, instala Git en tu máquina. Este es el software del sistema de control de versiones subyacente en el que GitHub funciona.
2. Seguido, Regístrate para una cuenta de GitHub. Es simple y fácil.
3. Una vez te hayas registrado, inicia sesión en github.com con tu nombre de usuario y contraseña.

Preparando tu código para subirlo

Tú puedes almacenar cualquier código que tu quieras en un repositorio de Github, pero para usar la característica páginas de Github con pleno efecto, tu código debe estar estructurado como un sitio web típico, por ejemplo que el punto de entrada primario sea un archivo HTML llamado index.html.

La otra cosa que necesitas hacer antes de seguir adelante es inicializar el directorio de código como un repositorio Git. para hacer esto:

1. Apunta la linea de comandos a tu directorio test-site (o como se llame el directorio que contiene tu sitio web). Para esto, usa el comando cd (Es decir "cambio de directorio"). Esto es lo que deberias digitar si has puesto tu sitio web en un directorio llamado test-site en tu escritorio:

   cd Desktop/test-site

2. Cuando la linea comandos está apuntando hacia el interior del directorio de tu sitio web, digita el siguiente comando, que le dice a la herramienta git para convertir el directorio en un repositorio git:

3. git init

An aside on command line interfaces

La mejor manera de subir tu código a Github es mediante la linea de comandos — esta es una ventana donde tú digitas comandos para hacer cosas como crear archivos y ejecutar programas, en lugar de hacer clic en el interior de una interfaz de usuario. Se verá algo como esto:

Cada sistema operativo viene con una herramienta de línea de comandos:

• Windows: Command Prompt can be accessed by pressing the Windows key, typing Command Prompt, and choosing it from the list that appears. Note that Windows has its own command conventions differing from Linux and OS X, so the commands below may vary on your machine.
• OS X: Terminal se puede encontrar en Aplicaciones > Utilidades.
• Linux: Por lo general se puede pull up una terminal con Ctrl + Alt + T. Si eso no funciona, busca Terminal en una barra de aplicaciones o menu.

Esto puede parecer un poco espantoso al principio, pero no te preocupes — que pronto conseguiras la caída de los conceptos básicos. Tú le dices a la computadora que haga algo en la terminal, digitando un comando y oprimiendo la tecla Enter, como se ha visto anteriormente.

Creando un repositorio para tu código

1. A continuación, tu necesitas crear un nuevo repositorio para colocar tus archivos en el. Has clic en el signo más (+) en la parte superior derecha de la página de inicio de GitHub, luego escoge Nuevo Repositorio.

2. En esta página, en la caja Nombre del Repositorio, digita el nombre para tu repositorio de código, por ejemplo my-repository.
3. Tambien llena una descripción para decir lo que tu repositorio va a contener. Tu pantalla debe mostrar algo como esto:
   
4. Has Clic en Crear repositorio; Esto debería llevarte a la siguiente página: 
   

Subiendo tus archivos a GitHub

1. En la página actual, tu estas interesado en la sección …or push an existing repository from the command line. Tú deberias ver dos lineas de código listado en esta sección. Copia la totalidad de la primera línea, pegala en la linea de comandos, presiona la tecla Enter. El comando deberia mostrarte algo como esto:

   git remote add origin https://github.com/chrisdavidmills/my-repository.git

2. A continuación, digita los siguientes dos comandos, presionando Enter despues de cada uno. Estos preparan el codigo para subirlo a GitHub, and ask Git to manage these files.

   git add --all
   git commit -m 'adding my files to my repository'

3. Por último, empuja el código hasta GitHub by going to the GitHub web page you're on and entering into the terminal the second of the two commands we saw the …or push an existing repository from the command line section:

   git push -u origin master

4. Ahora necesitas crear la rama gh-pages de tu repositorio; actualiza la página actual y verá una página del repositorio algo así como la de abajo. Tú necesitas presionar el boton que dice Branch: master, digita gh-pages en el campo de texto, luego presiona el boton azul que dice Create branch: gh-pages. Esto crea una rama de código especial llamada gh-pages que es publicada en una ubicación especial. La URL toma la forma username.github.io/my-repository-name, asi en mi caso de ejemplo, la URL debería ser https://chrisdavidmills.github.io/my-repository. La página mostrada es la página index.html.
   
5. Navega tu dirección web de GitHub pages en un nuevo ta del navegador, y tu deberias ver tu sitio en linea! Mandalo por correo electrónico a tus amigos y muestra tu dominio.

Un mayor conocimiento de GitHub

If you want to make more changes to your test site and upload those to GitHub, you simply need to make the change to your files just like you did before. Then, you need to enter the following commands (pressing Enter after each one) to push those changes to GitHub:

git add --all
git commit -m 'another commit'
git push

You can replace another commit with a more suitable message to describe what change you just made.

We have barely scratched the surface of Git. To learn more, start off with the GitHub Help site.