Manual del Banco de Codigo - Hotboards/CodeBank8 GitHub Wiki
En esta wiki explicamos de manera clara el procedimiento para poder usar las diferentes piezas de código que están disponibles de manera libre en este mismo repositorio. Si tenias dudas, aquí las resolvemos de manera clara y muy sencilla.
Antes de descargar o clonar por cualquier método el banco de código es recomendable crear un nuevo directorio en el cual se tenga el banco de código en sí y todos nuestros proyectos que desarrollemos. Una buena práctica es crear un directorio directamente en la unidad de raíz.
C:\Mis proyectos
En este directorio colocaremos nuestros proyectos junto con el banco de código y los ejemplos, de tal manera que la estructura quedaría a algo similar a esto.
C:\Mis proyectos
\CodeBank8
\Examples
\proyecto_1
\proyecto_2
....
\proyecto_n
Para aquellos que no conozcan GitHub, es un servicio de alojamiento de proyectos, el cual usa el sistema de versionado Git, que te permite ir actualizando y/o corrigiendo errores en tu proyecto sin perder tu historial de versiones.
El proceso de descargar el código de GitHub se llama clonar, tendrás que clonar el repositorio para tenerlo en tu computadora, una vez clonado ya no tendrás que volverlo a clonar cada que el código se actualize, solo tendrás que hacer una sencilla operación de sincronía llamada pull.
Lo primero que debes hacer es instalar Git en tu computadora, lo puedes descargar de la siguiente dirección: http://git-scm.com/
La instalación es muy sencilla solo deja las configuraciones por default que te aparecerán en las ventanas del instalador y solo da “Next”.
Una vez instalado Git tendrás dos maneras de clonar repositorios, la primera es usando linea de comando, para ello tendrás correr Git Bash y la segunda es usar la interfaz gráfica ejecutando Git GUI. Te recomendamos usar al linea de comandos ya que es la que documentaremos aquí. No temas a usar la consola ya veras que es la forma mas sencilla.
Busca en tu menú de inicio y da click en el icono de Git Bash, inmediatamente te aparecerá una consola donde deberás escribirás los comandos de git.
Configurar usuario y correo
No es necesario hacerlo en este momento, pero es altamente recomendable, así que de una vez. Recuerda que solo lo tendrás que hacerlo una vez, o cada que quieres modificar tus datos.
$ git config --global user.name = “jhon doe”
$ git config --global user.email = [email protected]
Directorios
Navegar entre directorios es muy sencillo, solo utiliza el comando cd <directorio>
y para desplegar el contenido del directorio solo escribe ls -l
. cuando tengas que cambiar a un directorio con un nombre que contiene espacios solo encierra el nombre entre doble comillas.
En nuestro caso tenemos una carpeta llamada /Mis proyectos
en la unidad C:
así que en la consola nos dirigimos a ese directorio de la siguiente manera
$ cd /c
$ cd "Mis proyectos”
Clonando
Una vez en el directorio, clonamos el repositorio
$ git clone https://github.com/Hotboards/CodeBank8.git
Listo si abres el directorio con el explorador de windows podrás observar que tienes el siguiente directorio en tu disco duro
C\Mis proyectos
\CodeBank8 (este es el banco de codigo)
\bsp
\middleware
\modules
types.h
LICENSE
readme.md
.gitignore
Actualizando
Cada que el código en el repositorio se actualice, ya sea por efectos de cambios, correcciones de errores o nuevas piezas de código se agreguen, deberás realizar un proceso de actualización llamado pull el cual se realiza mediante dos instrucciones.
$ git fetch origin
$ git merge origin/master
Listado de cambios
Para revisar la lista de cambios que se han realizado al banco de código con cada actualización, solo tienes que realizar un log de la siguiente manera. Presiona Q
para salir del log.
$ git log
Recuerda que deberás estar en el directorio del código de banco para ejecutar estos comandos. Ejemplo cd "C\Mis proyectos\CodeBank8"
.
Quizás al principio te cueste un poco de trabajo adoptar Git, pero el hecho es que después de que te acostumbras te darás cuenta de que es una excelente manera de trabajar y no querrás volver a como lo hacías antes.
Git y GitHub son excelentes opciones para trabajar y es un sistema que va cobrando cada vez mas popularidad a nivel mundial, te invitamos a que visites la pagina de GitHub, obtengas tu propia cuenta y empieces a subir tus proyectos.
Entrar en detalles con un curso de Git no es el objetivo de esta wiki, pues existen muchos tutoriales de como usar Git, mas detallados de lo que podríamos hacerlo nosotros, date una vuelta por los siguientes enlaces si quieres conocer mas de este magnifico sistema de versionado.