Meta de hoy: En este tutorial aprenderás los rudimentos básicos para usar Github para crear tu sitio web, para administrar desde tu computador tus proyectos de sitios web usando Github Desktop y a publicarlos en la web. También aprenderás la jerga de Github, necesaria para entender sus herramientas de administración y publicación.
Como ya dijimos Github es el equivalente a un Dropbox para proyectos de código, datos y web. Permite mantener una versión de tu proyecto en tu computador (local) y otra en Github (en sus servidores: "la nube") para sincronizar cambios y mantener un registro de todos los cambios del proyecto. Así si te equivocas puedes volver atrás. Github está construido sobre Git, un sistema de control de versiones usado por programadores. Pero como es un poco complicado al principio, iremos por el camino fácil.
Ok. Partamos.
Anda a Github y crea tu nombre de usuario y pasword. Usa un nombre fácil de recordar, en minúsculas y sin espacios. Algo como juanperez. Nada de JuAn32pEreZ1. Prohibido.
Una vez registrado verás una pantalla igual o similar a la que se ve acá abajo. Busca el botón "New repository" y púlsalo para crear tu primer repositorio. Como dijimos, Github usa su propio lingo para nombrar las cosas. Repositorio es igual a proyecto o a carpeta (dentro de la cual tendrás los archivos y más carpetas de tu proyecto). Más adelante veremos como acceder y guardar otros proyectos, clonándolos (copiándolos) o haciendo un fork (algo así como tomar un pedazo de carne con un tenedor y llevarlo a nuestra plato). ¿Ya pulsaste en "New repository"?
- Nombra tu repositorio en minúsculas, sin espacios ni símbolos extraños.
- Incluye una descripción breve.
- Define si el repositorio será público o privado.
- Haz check en la caja de "Initialize this repository with a README"
- Ahora podrás pulsar el botón “Create repository”.
Lo vas a copiar a tu computador. Antes, anda a tu computador y lee el siguiente paso.
Realizar proyectos digitales requiere que seas ordenado y definas dónde guardarás este y otros proyectos. En mi caso, tengo una carpeta madre en la cual guardo todos los repositorios de clases y otros proyectos. La llamo para no olvidarme: repos.
- Crea tu carpeta repos así todos sabremos siempre dónde tienes tus repositorios y no lo olvidarás
- Cuando copies tu repositorio desde Github a tu computador, guarda el repositorio dentro de repos.
¿Recuerdas cuando aprendiste a usar una aplicación de subida de archivos a servidor vía FTP como File Zilla para publicar tu sitio web?
Bueno Github Desktop sirve el mismo propósito en Github. Es la herramienta más rápida y fácil de comenzar a trabajar con repositorios para subirlos y bajarlos de los servidores de Github.
- Descarga Github Desktop e instálalo. Muévelo a tu carpeta de Aplicaciones o Applications.
- Haz click sobre el ícono de Github Desktop (el octogato) y cuando se abra la aplicación, anda al menú superior izquierdo y pulsa sobre Preferencias o Preferences.
Si tienes dudas, más adelante revisa las guías de ayuda de la aplicación.
- En la ventana de Preferences selecciona Accounts.
- Ingresa tu nombre de usuario en login y tu contraseña y haz click en Sign In.
- Ya estás adentro.
- En la barra lateral izquierda de Github Desktop debieras ver en la lista de repositorios el repositorio que creaste.
- Si no lo ves, como es mi caso, sigue los pasos que se ven en la imagen de abajo y haz click en "Clone micasa"
Si tienes dudas, más adelante revisa las guías de ayuda de la aplicación.
Al clonar y guardar el repositorio en tu carpeta madre repos lo que estás haciendo es bajar a tu computador una copia de tu repositorio que estaba alojado en Github.com.
Git y Github llevan un registro de todos los cambios que haces en tu repositorio (editaste texto, agregaste una foto, etc).
El objetivo es que tu puedas conocer e identificar todos los cambios importantes que hagas y tener a mano las distintas versiones. Algo así como llevar un registro de cambios de todos los borradores que escribes hasta que tu reportaje es publicado.
Peeeero... para que te sea fácil identificar los cambios debes contarle a Github que los hiciste y publicarlos. Esto se llama "Commit changes" ("cometer cambios" o hacer cambios). En corto "Commit".
La regla de oro es que hagas commits muy frecuentemente y que expliques brevemente qué cambios hiciste.
Reitero: La regla de oro es que hagas commits muy frecuentemente y que expliques brevemente qué cambios hiciste.
- Abre tu repositorio con tu editor de texto de preferencia (Sublime, Atom, etc.), escribe un mensaje tipo (el que quieras), guarda el archivo como index.html dentro del repositorio (carpeta).
- Anda a Github Desktop y revisa la parte superior de Commited o Uncommited Changes. ¿Qué ves?
- Haz tu segundo commit.
- Ir a https://pages.github.com/
- Haz click en User or organization site
- Anda a GitHub y crea un nuevo repositorio que se llame username.github.io, donde username es tu tu nombre de usuario en Github.
Si tienes dudas más adelante revisa las guías de ayuda de la aplicación.
Ejercicio 2: Crea una página web y súbela a tu repositorio tunombredeusuario.github.io haciendo "Commit"
Incluye:
- Index.html
- Carpeta de archivos de imágenes y dentro, las imágenes.
- Carpeta de archivos de css y dentro, el o los archivos .css
Ojo: Puedes usar una página web que ya hayas hecho.
- Copia los archivos (Index.html y las carpetas de imágenes y de css) y pégalos dentro de la carpeta o repositorio tunombredeusuario.github.io en tu computador.
- Recuerda: la carpeta o repositorio tunombredeusuario.github.com está dentro de la carpeta madre repos. que ya creaste.
- Ahora abre en Github Desktop la carpeta o repositorio tunombredeusuario.github.com y haz un commit detallando los cambios.
https://craft2es.github.io/ Algo rápido que hice en HTML y CSS en lo cual probé a usar Tachyons CSS, un framework de CSS pequeño y muy poderoso que estoy aprendiendo (por lo que el sitio puede tener errores).
- Haz click en https://github.com/craft2es/githubparaperiodistas
- Pulsa el botón **Fork **ubicado en la parte superior derecha de la página del repositorio
- Hacer un Fork significa crear una copia de un proyecto de otra persona en tu Github. En este caso haes fork de githubparaperiodistas y se crea la copia en tu sitio github.com/tunombredeusuario.
- Verás la copia en github.com/tunombredeusuario/githubparaperiodistas
- Pulsa el botón verde Clone or download y luego click en Open in Desktop.
- Guarda el repositorio en tu carpeta repos
- Abre Github Desktop: verás en tu computador una versión local del repositorio githubparaperiodistas. Ya puedes hacer lo que quieras con él.
- Anda a https://github.com/craft2es/githubparaperiodistas y abre un Issue:
- En título pon Mi primer issue. En el cuerpo del Issue incluyan la dirección de su cuenta de usuario en Github (github.com/sunombredeusuario), la dirección de su sitio web en Github (sunombredeusuario.github.io) y escriba qué cosas no le quedaron claras.
- Pulsa el botón verde Submit an issue.
https://github.com/showcases/open-journalism
**Desafío: **Haz fork de los repositorios que te gustan y ve qué pasa.
Si llegaste hasta aquí y no eres uno de mis estudiantes, te invito a conocer el programa bilingüe (Inglés y Español) de la Maestría de Periodismo de CUNY.