Imagen de https://undraw.co

Cómo dar vida a tus proyectos en GitHub con GitHub Pages

En sólo 3 pasos! 🎯

Alejandro Narvaja
3 min readApr 28, 2020

--

Muchos de nosotros tenemos proyectos y ejercicios montados en GitHub, ese hermoso repositorio donde poner nuestros experimentos y compartirlos con el resto de la comunidad.

Pero muchas veces dejamos el código ahí y ya está. Esperando que la persona que quiera verlo en acción se descargue el repo, lo monte localmente y lo despliegue. Cosa que no siempre sucede.

Una forma muy fácil y sencilla que nos proporciona GitHub para compartir el resultado final del código que tenemos en el repo es a través de GitHub Pages. Con unos simples pasos que mostraré a continuación, tendrás una URL lista para pasar a quien quieras y que pueda ver tu proyecto vivito y coleando.

Al lío.

Pasos para montar tus proyectos en GitHub Pages

1. Ir a la pestaña Settings

2. Bajar hasta la sección GitHub Pages

3. Elegir la raíz de la rama master o la carpeta docs si es que metimos nuestro proyecto ahí ( suelo elegir la raíz)

Listo! Ya tenemos nuestra URL 🎉

Como ven, es muy sencillo y suma bastante cuando queremos compartir nuestro GitHub con alguien y que puedan ver al instante los proyectos que están ahí compartidos.

Algunos tips

  • Como pueden ver en mi proceso, el dominio que me genera GitHub Pages es personalizado. Si quieren puedo explicar en otro artículo qué pasos seguir para tener tu propio dominio apuntando hacia tus proyectos de GitHub.
  • Facilita mucho que esta URL pueda ser vista al instante cuando alguien entra a nuestro proyecto. Podemos incluírla en el archivo README.md o mismo en la cabecera del proyecto. Si van al paso 1 verán que a la derecha hay un botón que dice “Edit” y nos permite agregar una descripción y una URL.
  • Tengan en cuenta que el nombre del repositorio será el nombre que aparezca en la URL, así que intenten no poner nombres demasiado complicados de escribir o recordar.

Y eso es todo!
Gracias como siempre por leer y por cualquier tipo de feedback 🙃

Saludos!
Ale
https://alejandronarvaja.com ( adivinan? sí, esta URL también es un proyecto de GitHub )

--

--