GitHub es una plataforma de social coding que te permite subir repositorios de código que se alojan en un sistema de control de versiones Git. Este sistema te ofrece la posibilidad de colaborar en otros proyectos y crear los tuyos propios. La plataforma es de código abierto por defecto, por lo que cualquier persona puede utilizar tu código y tú también puedes ver el código de otros proyectos. Este artículo es una guía básica para publicar contenido usando GitHub y SourceTree.
12. Usar Github y SourceTree para publicar contenido
- Accede a https://github.com/ y crea una cuenta. Selecciona el plan personal gratuito con repositorio público. No te olvides de terminar la verificación mediante correo electrónico.
- Crea un proyecto en la opción “Create a Proyect”. Incluye el nombre de tu repositorio y selecciona la opción “Create repository”. No cierres esta ventana porque vas a necesitar algunos de los datos que ahí se muestran para clonar el repositorio mediante URL. (Si por error cierras esta página, puedes volver a entrar mediante una url con el siguiente aspecto: https://github.com/tunombredeusuario/nombredeturepositorio/ (en mi caso es la siguiente: https://github.com/eniun/diw/).
- Descarga SourceTree para clonar el repositorio que acabamos de crear a nuestra computadora.
- Crea una cuenta en Bitbucket y accede a SouceTree mediante esa cuenta.
- En el apartado «install tools» debes seleccionar la opción «Set Global author details from Git and Mercurial».
- En SourceTree selecciona la opción nuevo / clonar repositorio. Copia y pega la URL de origen que encontrarás en la ventana de github que dejaste abierta en el punto 2. Selecciona una ruta de destino, por ejemplo una carpeta que crees en el escritorio de tu computadora. Te pedirá tu cuenta de Github, pon el usuario y la contraseña de github (si te equivocas te dará el error fatal: Authentication failed for…” y tendrás que acceder a C:\Users\USERNAME\AppData\Local\Atlassian\SourceTree y eliminar el passwd file).
- Utiliza tu editor de código favorito para crear un archivo index.html. Súbelo en la carpeta de proyecto creada en el punto 5.
- Accede SouceTree. Verás que aparece el archivo index.html. Selecciónalo y dale a “anotar”.
- Vuelve a tu proyecto github (ventana que dejaste abierta en el punto 2) y actualiza. Verás que aparece un nuevo archivo.
- En GitHub dale a “Settings / Source y selecciona “Master Branch”.
- Visualiza tu web. La URL de visualización tendrá el siguiente aspecto: https://nombredetucuenta/github.io/nombredeturepositorio/ (La página mostrada es la página index.html). En mi caso es la siguiente: https://eniun.github.io/diw/
- Si quieres seguir aprendiendo funcionalidades de Github puedes comenzar haciendo el siguiente tutorial: https://guides.github.com/activities/hello-world/.
12.1. Solución errores Github y SourceTree
12.1.1. Errores en la configuración de la cuenta Github en SourceTree
Para agregar nuestra cuenta de Github en SourceTree accedemos a Tools/Options/Authentication seleccionamos «add» e incluimos los datos de nuestra cuenta Github tal y como puedes ver en la siguiente captura. En la opción «Authentication» en vez de «OAuth» tienes que seleccionar «basic».
Además, deberás seleccionar la cuenta por defecto en la opción «set as default».
Comprueba que puedes ver tu cuenta de usuario en el panel de control de SourceTree. Puede ser que sea necesario que reinicies el equipo para poder ver los cambios correctamente.
12.1.2. Error de configuración de usuario
Para solucionar el error de usuario en SourceTree debemos instalar GIT e indicar por línea de comandos nuestro usuario e email. Por ejemplo pondríamos lo siguiente:
$ git config --global user.name "eniun" $ git config --global user.email info@eniun.com
12.1.3. Otros errores en la configuración de Github con SourceTree
Si los errores persisten puede que te interese realizar la integración de Github en Visual Studio Code.