Ver el código de «Tutorial: Github y Freecad»

<center>
[[Archivo:Github-freecad-logo.png|thumb|400px|Github y Freecad]] 
</center>

== Introducción ==
[http://www.freecadweb.org/ Freecad] pertenece al '''patrimonio tecnológico de la humanidad'''. Esto abre las puertas a que cualquier persona del mundo pueda usar esta herramienta para diseñar piezas 3D. El siguiente paso es aunar esfuerzos y aumentar entre todos este patrimonio contribuyendo con nuevas piezas diseñadas. Pero esto sólo es posible si '''aprendemos a usar herramientas que nos permitan compartir, contribuir y colaborar'''. Una de ellas es [https://github.com/ github]. 

El propósito de esta serie de microtutoriales es '''enseñarte lo mínimo indispensable de github''' para que puedas contribuir con tus piezas 3D al incremento del patrimonio tecnológico de la humanidad. Este esfuerzo merecerá la pena.

Se propone un reto: "'''Crear entre todos una biblioteca de llaveros en Freecad'''". Es un experimento. Por un lado se dispondrá de un repositorio en github sobre el que se realizarán las entregas de los ejercicios propuestos en los tutoriales, y sobre el que podréis hacer pruebas y ensayos. Por otro lado podremos ver cómo va creciendo con el tiempo, la cantidad de gente que contribuye, etc.

{|
| [[Archivo:Casino-chip-key-chain-2.png|thumb|400px| Diseño del Llavero ficha de casino  (''click para ampliar'')]]
| [[Archivo:Casino-chip-key-chain-3.jpg|thumb|400px| Llavero fichero de casino impreso (''click para ampliar'')]]
|}

'''¿Por qué llaveros?''' Bueno, me parece que es algo muy genérico y que se imprime en 3D muy bien. Hay gente que los colecciona. Se pueden regalar. Y prácticamente cualquier cosa se puede convertir en llavero. Así que, ¿Por qué no? :-)

=== Claves ===
Tutorial github. Freecad. Patrimonio tecnológico de la humanidad. Piezas 3D. Biblioteca de llaveros en Freecad

== Descargas ==
{| {{tablabonita}}
| Todos los ejemplos están en el [https://github.com/Obijuan/freecad-key-chain-library repositorio de la biblioteca de llaveros] en github
|}

== PLAYLIST ==
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/playlist?list=PLmnz0JqIMEzXThALT6gTUH1rlW1gS-GzU '''PLAYLIST CON TODOS LOS VIDEOS DE LA SERIE DE MICRO-TUTORIALES''']
|}

== ¡Manos a la obra! ==

=== 1 Presentación ===
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=7JCSnGJ5kkk '''Video Tutorial 1/X''']
|}

{|
| [[Archivo:T01-presentacion-2.png|thumb|400px|  (''click para ampliar'')]]
| [[Archivo:T01-presentacion-1.png|thumb|400px|  (''click para ampliar'')]]
|}

==== Descripción ====
Presentacion de la serie de microtutoriales. La importancia de contribuir y compartir
Explicación del "efecto comunidad":

Imaginemos una mínima comunidad de 4 personas, en las que cada una hace un diseño 3D y lo comparte

{|
| [[Archivo:Community-1.png|thumb|300px| Minicomunidad de 4 usuarios. Cada uno aporta un diseño  (''click para ampliar'')]]
| [[Archivo:Community-2.png|thumb|300px| Los 4 comparten sus diseños  (''click para ampliar'')]]
|}

El balance es positivo para todos. Cada uno aporta 1 pieza, pero recibe 3. En las comunidades el conocimiento se amplifica y multiplica y siempre se recibe más de lo que se aporta.

{|
| [[Archivo:Community-3.png|thumb|300px| balance positivo para el usuario (''click para ampliar'')]]
|}

'''¡Vamos a aprender a contribuir!'''

=== 2 Git clone: bajando proyectos de Github ===
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=zLEKQzlz8bs '''Video Tutorial 2/x''']
|}

{|
| [[Archivo:Github-freecad-T2-1.png]]
|}

==== Descripción ====
Navegación web por los proyectos de github y descarga individual de ficheros. Descarga de proyectos completos en nuestros ordenadores mediante el comando git clone.

* '''Conceptos nuevos''': Cliente git, comando git clone

==== Explicación ====
Abrir el navegador y entrar en el [https://github.com/Obijuan/freecad-key-chain-library repositorio de los llaveros]. '''NO hace falta tener cuenta en github''' ni estar registrado. Podemos acceder a todos los millones de proyectos alojados de manera anónima, así como buscarlos en google. Se puede navegar por las carpetas. Vamos a entrar en la carpeta '''freecad-src''', donde están las fuentes de los llaveros en Freecad

{|
| [[Archivo:Github-freecad-T2-exp-1.png|thumb|300px| El github del repositorio de los llaveros en FreeCAD   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-2.png|thumb|300px| Dentro de la carpeta freecad-src  (''click para ampliar'')]]
|}

El repositorio está en '''inglés''' (el nombre, los mensajes de los commits, los nombres de las carpetas, etc). Eso lo he creado así aposta. La idea es que '''puedan contribuir el mayor número de personas''' a este proyecto, de todas partes del mundo y no sólo los de habla hispana. Por ello, es buena constumbre hacer el esfuerzo de escribir todo lo que se pueda en inglés. Recordad: nuestro objetivo es compartir y aprender a contribuir :-)

Si nos metemos en la '''carpeta Gallery''' y pinchamos en los ficheros se abren las imágenes. También '''se visualizan en 3D los ficheros STLs'''. Esto es muy útil para saber de qué pieza se trata. Vamos a la '''carpeta stl''' y pinchamos por ejemplo en el fichero '''obijuan-academy.stl'''. Se abre en 3D en el navegador. Al cabo de unos segundos se pone a rotar automáticamente. Podemos cambiar la cámara apretando el botón izquierdo y moviendo el ratón. También podemos hacer zoon hacia adelante / atrás con la rueda del ratón.

{|
| [[Archivo:Github-freecad-T2-exp-3.png|thumb|300px| Visualizando la imagen del llavero OSHW aportado por '''Roberto Carlos Carmona''' (rcccort)  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-4.png|thumb|300px| Visualizando en 3D el stl del llavero obijuan-academy, aportado por '''Jose Vega'''  (''click para ampliar'')]]
|}

También nos podemos bajar ficheros individuales. Vamos a bajarnos el '''OpenHw.stl''' para imprimir. En la parte de la derecha hay un botón que pone '''RAW'''. Es un enlace directo al fichero para descargarlo. Le damos al botón derecho y lo bajamos.  Para verlo, vamos a usar el programa '''Cura'''. Lo lanzamos y cargamos el fichero OpenHw.stl. Listo para imprimir! :-) 

{|
| [[Archivo:Github-freecad-T2-exp-5.png|thumb|300px| Bajando el fichero OpenHw.stl (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-6.png|thumb|300px| Fichero OpenHw abierto en Cura para imprimirlo (''click para ampliar'')]]
|}

Nos podemos ''' bajar un proyecto completo''' pinchando en el botón '''Download ZIP'''. Se nos generará automáticamente un fichero .zip con todo el proyecto y se comenzará la descarga. Luego lo descomprimimos y listo!!! Todo esto sin haber tenido que crearnos cuentas ni instalar nada en nuestro ordenador.

{|
| [[Archivo:Github-freecad-T2-exp-7.png|thumb|300px| Descargando el proyecto de los llaveros a nuestro ordenador  (''click para ampliar'')]]
|}

Para '''bajarnos''' un proyecto completo de github '''necesitamos instalar''' en nuestro ordenador '''un cliente de git'''. Esto dependerá del sistema operativo que estemos usando (Linux, Mac, Windows). El más usado es el propio [http://git-scm.com/ Página oficial de git ], que funciona en la línea de comandos. Los usuarios de Mac y Windows podéis instalaros clientes de git desde este enlace: [http://gitimmersion.com/ git inmmersion]. También tenéis esta aplicación: [http://www.sourcetreeapp.com/ SourceTree] y si buscáis en google encontraréis muchos más

En este portátil tengo instalado '''Ubuntu/Linux 14.10'''. La instalación se realiza muy rápidamente mediante este comando:

 $ sudo apt-get install git

'''Usaremos git desde la línea de comandos'''. Pero...  '''¡No os asustéis!'''. El proceso es muy sencillo. Para constribuir realmente son necesarios muy pocos comandos. Primero aprended a contribuir y luego os instaláis clientes gráficos. Los principios de funcionamiento son los mismos

Una vez instalado el cliente, comprobad que se ejecuta correctamente con este comando (que muestra la versión):

  $ git --version

{|
| [[Archivo:Github-freecad-T2-exp-8.png|thumb|300px| Instalación del cliente git en Ubuntu 14.10  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-9.png|thumb|300px| Comprobando que git está instalado correctamente en Ubuntu 14.10  (''click para ampliar'')]]
|------------------
| [[Archivo:Github-freecad-T2-exp-9-bis.png|thumb|300px| Ejecutando ''git --version'' desde un terminal en Windows. Gracias a Juanma Roldan Gomez (Exodous)  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-9-bis-mac.png|thumb|300px| Ejecutando ''git --version'' desde un terminal en Mac. Gracias a Salvador Litris  (''click para ampliar'')]]
|}



Vamos a '''bajarnos''' el repositorio de los llaveros. Esta operación se llama '''clonar''' y la realizamos mediante el comando '''git clone'''. Nos vamos al repositorio en la web y copiamos la URL que pone en la parte inferior izquierda (ver figura). Luego desde el terminal ejecutamos el siguiente comando:

  $ git clone https://github.com/Obijuan/freecad-key-chain-library.git

{|
| [[Archivo:Github-freecad-T2-exp10.png|thumb|300px| Copiar la URL para clonar el proyecto   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-11.png|thumb|300px| Ejecutando el comando ''git clone'' para clonar el respositorio  (''click para ampliar'')]]
|--------------
| [[Archivo:Github-freecad-T2-exp-11-bis.png|thumb|300px| Ejecutando ''git clone'' en la terminal de windows. Gracias a Juanma Roldan Gomez (Exodous) (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-11-bis-mac.png|thumb|300px| Ejecutando ''git clone'' en la terminal de Mac. Gracias a Salvador Litris (''click para ampliar'')]]
|}

Al cabo de unos segundos ya tendremos el proyecto clonado en nuestro ordenador. Se nos habrá creado la '''carpeta freecad-key-chain-library'''. Vamos al directorio freecad-key-chain-library/freecad-src y abrimos con freecad uno de los llaveros, por ejemplo el OpenHw.fcstd de Roberto Carlos Carmona

{|
| [[Archivo:Github-freecad-T2-exp-12.png|thumb|300px| El proyecto de los llaveros en nuestro ordenador  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-exp-13.png|thumb|300px| El llavero OpenHw de Roberto Carlos Carmona abierto en Freecad  (''click para ampliar'')]]
|}

==== Ejercicios propuestos ====
* '''Ejercicio 1:'''
** Instalar el cliente git para vuestro Sistema Operativo
** Clonar el [https://github.com/Obijuan/freecad-key-chain-library repo de los llaveros]
** Navegar en local y y abrir algunos llaveros en freecad
{|
| [[Archivo:Github-freecad-T2-ej1-2.png|thumb|300px| Llavero con el logo de Obijuan Academy, por Jose Vega (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-ej1-1.png|thumb|300px| Llavero con la letra A  (''click para ampliar'')]]
|}

* '''Ejercicio 2:''' 
** Clonar el [https://github.com/yorikvanhavre/FreeCAD-library repositorio de la biblioteca de piezas de Freecad]
** Navegar en local y abrir algunas piezas

{|
| [[Archivo:Github-freecad-T2-ej2-1.png|thumb|300px| Pallet europeo: FreeCAD-library/Shipping Containers/Pallet_EUR_1.FCStd  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-ej2-2.png|thumb|300px| Portapilas: FreeCAD-library/Electrical Parts/Batteries/battery-holder-4-AAA.fcstd  (''click para ampliar'')]]
|}

* '''Ejercicio 3:''' 
** Clonar el [https://github.com/bq/printbots repositorio de printbots de bq]
** Navegar en local y abrir los ensambles de los robots Renacuajo y Bettle

{|
| [[Archivo:Github-freecad-T2-ej3-1.png|thumb|300px| Ensamble 3D del robot Renacuajo de bq: printbots/Renacuajo/freecad/renacuajo-assembly.fcstd    (''click para ampliar'')]]
| [[Archivo:Github-freecad-T2-ej3-2.png|thumb|300px| Ensamble 3D del robot Beetle de bq: printbots/Beetle/freecad/Assembly.fcstd  (''click para ampliar'')]]
|}

=== 3 Git pull: ¡dame novedades! ===
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=GVfjUfY1NBk '''Video Tutorial 3/X''']
|}

{|
| [[Archivo:Github-freecad-T3-1.png]]
|}

==== Descripción ====

El comando '''git clone''' sólo se ejecuta la primera vez para bajarse una copia local del proyecto. Mediante el comando '''git pull''' se nos bajan los cambios nuevos desde la última actualización. 

* '''Conceptos nuevos''': comando git pull

==== Explicación ====
El repositorio de los llaveros de freecad está en el github (que está en la nube). Cualquiera se lo puede "clonar" para tener una copia local en su ordenador. Esto se hace con el comando '''git clone'''. Este comando sólo se ejecuta una vez, para crear la copia del repositorio.

{|
| [[Archivo:Github-freecad-T3-exp-1.png|thumb|300px| Repositorio de llaveros con 3 piezas   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T3-exp-2.png|thumb|300px| Un usuario se lo clona en su ordenador local  (''click para ampliar'')]]
|}

Imaginemos que otros '''dos usuarios realizan la clonación'''. Puede tratarse del mismo usuario que clona en diferentes ordenadores, o incluso el mismo usuario que clona en carpetas diferentes. Todo ello sin tener que registrarse. Todos ellos tienen la última versión de los llaveros.

{|
| [[Archivo:Github-freecad-T3-exp-3.png|thumb|300px| Otro usuario clona el repositorio  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T3-exp-4.png|thumb|300px| y otro más que lo clona  (''click para ampliar'')]]
|}

Uno de esos usuarios '''diseña un llavero nuevo y lo añade localmente'''. Supongamos que ese usuario es obijuan, y como '''tiene permisos de escritura''' en el respositorio, lo sube (usando el comando ''git push'' que veremos más adelante). Ahora el repo de obijuan y el de github están actualizados, pero el del resto de usuarios no

{|
| [[Archivo:Github-freecad-T3-exp-5.png|thumb|300px| el usuario obijuan crea un llavero nuevo en su ordenador  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T3-exp-6.png|thumb|300px| Como obijuan tiene permisos de escritura sube la pieza al repo. El resto de usuarios no la tiene todavía  (''click para ampliar'')]]
|}

Cualquier usuario puede '''actualizarse a la última versión''' ejecutando el comando '''git clone'''. Automáticamente todos los cambios nuevos se le enviarán y su repositorio local estará actualizado con respecto al de github.

En este escenario, '''sólo los usuarios que tienen permisos pueden subir piezas'''. El resto se van actualizando. Este modelo es muy común, ya que la mayoría de las veces utilizas proyectos de la comunidad, pero no contribuyes, sólo los usas. Con git pull siempre tendrás la última versión.

{|
| [[Archivo:Github-freecad-T3-exp-7.png|thumb|300px| Los usuarios ejecutan git pull y se actualizan  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T3-exp-8.png|thumb|300px| Esquema de trabajo. Sólo los que tienen permisos pueden subir piezas. El resto se actualizan  (''click para ampliar'')]]
|}

Nos vamos al repositorio local de los llaveros y ejecutamos el comando git pull para ver las novedades

 $ git pull

{|
| [[Archivo:Github-freecad-T3-exp-9.png|thumb|300px| Carpeta tutorial antes de actualizar  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T3-exp-10.png|thumb|300px| Actualizando el repo. Aparece la carpeta T3-gitpull  (''click para ampliar'')]]
|}

Si volvemos a ejecutar el comando, nos aparece el mensaje: "'''Already up-to-date'''" para indicarnos que ya está todo actualizado. Es decir, que no hay nada nuevo que bajar.  '''El comando git pull siempre hay que ejecutarlo antes de trabajar con un proyecto, para asegurarnos de que estamos en la última versión.'''

{|
| [[Archivo:Github-freecad-T3-exp-11.png|thumb|300px| No hay más novedades  (''click para ampliar'')]]
|}

==== Ejercicios propuestos ====
* '''Ejercicio 1:''': Bajarse las novedades del repositorio de los [https://github.com/Obijuan/freecad-key-chain-library llaveros de freecad]. Los que estéis siguiendo el tutorial en directo, veréis cómo han aparecido ficheros nuevos. Si lo estás siguiendo en diferido y lo acabas de clonar en el tutorial anterior, no se te bajará nada nuevo.

{|
| [[Archivo:Github-freecad-T4-ej1-1.png|thumb|300px| Ejecución del comando ''git pull'' en Windows. Gracias a Juanma Roldan Gomez (Exodous)   (''click para ampliar'')]]
|}

* '''Ejercicio 2:''' Lo mismo con repositorio de las [https://github.com/yorikvanhavre/FreeCAD-library piezas de freecad]

* '''Ejercicio 3:''' Lo mismo con el repositorio de los [https://github.com/bq/printbots printbots de bq]

=== 4 Fork me on github! ===
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=21npTcqaOyU '''Video Tutorial 4/x''']
|}

{|
| [[Archivo:Github-freecad-T4-1.png]]
|}

==== Descripción ====

Plantilla wiki para crear nuevos tutoriales

* '''Conceptos nuevos''': 

==== Explicación ====

Partimos del escenario que dejamos en el tutorial anterior: el repositorio de llaveros, que le '''pertenece al usuario Obijuan''', que tiene permisos para añadir llaveros (permisos de escritura). El resto de usuarios sólo lo pueden clonar y actualizar, pero no pueden escribir en él.

El usuario '''chanquete''' quiere contribuir con un llavero al repositorio. para ello tiene que '''crearse una cuenta en github'''. Antes las operaciones eran "anónimas", pero para crear un repositorio tenemos que registrarnos.

{|
| [[Archivo:Github-freecad-T4-exp-1.png|thumb|300px| Escenario original del respositorio de llaveros  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T4-exp-2.png|thumb|300px| El usuario chanquete quiere contribuir al proyecto  (''click para ampliar'')]]
|}

Ahora '''Chanquete''' realiza un "'''fork'''" del repositorio original de llaveros. Es una copia del proyecto original, pero que '''pertenece a chanquete'''. Tiene permisos de escritura en él.

{|
| [[Archivo:Github-freecad-T4-exp-3.png|thumb|300px| '''Chanquete''' realiza un ''fork'' del repositorio de llaveros  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T4-exp-4.png|thumb|300px| '''Chanquete''' clona su repositorio de llaveros para trabajar  (''click para ampliar'')]]
|}

'''Chanquete''' puede añadir llaveros localmente y subirlos con ''git push'' (porque tiene permisos en su repositorio). También puede usar ''git pull'' para actualizarse por si hubiese otros usuarios con permisos de escritura en su repositorio. Finalmente, para contribuir al repositorio de llaveros original tiene que emitir una operación "'''pull request'''" que veremos más adelante.

{|
| [[Archivo:Github-freecad-T4-exp-5.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T4-exp-6.png|thumb|300px|   (''click para ampliar'')]]
|}

'''Vamos a realizar nuestro primer fork'''. Lo primero es '''crearnos una cuenta'''. En este ejemplo se ha creado un usuario ficticio que se llama '''obijuan-test'''. Una vez hemos entrado con nuestro usuario, nos aparece la pantalla que aparece en la figura. En la parte superiore derecha podemos ver nuestro nombre de usuario. Si lo pinchamos nos lleva a nuestra cuenta principal de github. Ahí vemos las contribuciones que llevamos hechas, que hasta ahora son 0.

{|
| [[Archivo:Github-freecad-T4-exp-7.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T4-exp-8.png|thumb|300px|   (''click para ampliar'')]]
|}

Si pinchamos en la pestaña de "repositories" nos indica los repositorios que tenemos creados. De momento ninguno.

{|
| [[Archivo:Github-freecad-T4-exp-9.png|thumb|300px|   (''click para ampliar'')]]
|}

Nos vamos a la URL del [https://github.com/Obijuan/freecad-key-chain-library repositorio de los llaveros]. Tenemos que estar ''logeados'' (nuestro nombre de usuario debe aparecer en la parte superior derecha). Le damos al botón de "'''FORK'''" (situado en la parte superior derecha también). En unos segundos se nos empezará a copiar el repositorio original en nuestra cuenta.

{|
| [[Archivo:Github-freecad-T4-exp-10.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T4-exp-11.png|thumb|300px|   (''click para ampliar'')]]
|}

Si ahora nos vamos a nuestra página de usuario (pinchando en nuestro nombre de usuario) y vamos otra vez a la pestaña de los repositorios, nos aparecerá un nuevo repositorio que se llamará: "'''Obijuan-test/freecad-key-chain-library'''". En la parte inferior pondrá: "'''forked from Obijuan/freecad-key-chain-library'''", para indicarnos que originalmente este repositorio ha derivado del de los llaveros de obijuan. Si pinchamos en el respositorio nos llevará a la página principal del repositorio
"

{|
| [[Archivo:Github-freecad-T4-exp-12.png|thumb|300px|   (''click para ampliar'')]]
|}

Ahora ya sólo nos queda clonarlo en nuestro ordenador local y empezar a trabajar con él.

==== Ejercicios propuestos ====
* '''Ejercicio 1:'''
** Crearos vuestra cuenta en github
** Hacer un fork del repositorio de los llaveros
** Clonar el repositorio

* '''Ejercicio 2:''' Idem con el respositorio de piezas de freecad

* '''Ejercicio 3:''' Idem con el respositorio de printbots de bq

=== 5 Creando el llavero "hola mundo" ===

{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=SB3Ec9TWlkQ '''Video Tutorial 5/x''']
|}

{|
| [[Archivo:Github-freecad-T5-1.png]]
|}

==== Descripción ====

Vamos a crear nuestro llavero "hola mundo" que será el que subiremos al repositorio de llaveros.

==== Explicación ====

Hay dos repositorios de llaveros. El original, que podemos clonar en nuestro ordenador, y el fork que hemos hecho. Son dos repositorios totalmente independientes, pero tu fork te pertenece a tí y tú eres el único con permisos para escribir en él.

Vamos a la carpeta '''tutorial/exercises''' de tu fork, que lo tienes clonado en tu ordenador. Ahí '''crea una nueva carpeta con tu nombre de usuario de github'''. Esta será donde grabarás el llavero hola mundo y donde podrás hacer pruebas para subirlas al repo y practicar

{|
| [[Archivo:Github-freecad-T5-exp-1.png|thumb|300px| En la carpeta tutorial/exercises de NUESTRO fork local del repo de llaveros   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-2.png|thumb|300px| Creando nuestra carpeta donde colocar el llavero hola mundo  (''click para ampliar'')]]
|}

Vamos ahora a la carpeta '''freecad-src''' (en el mismo repo, el del fork) y abrimos el llavero '''casino-chip.fcstd''' con freecad. Con la opción '''file/save as''' lo grabamos con el nuevo nombre '''T5-ej1.fcstd''' en la carpeta que acabamos de crear.

{|
| [[Archivo:Github-freecad-T5-exp-3.png|thumb|300px| Llavero "hola mundo" casino-chip.fcstd abierto en freecad   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-4.png|thumb|300px| Grabar el llavero en tutorial/exercise/<tu-usuario>/T5-ej1.fcstd  (''click para ampliar'')]]
|}

Al abrir el llavero en freecad vemos que hay dos carpetas en la izquierda. Una contiene las '''piezas para hacer el ensamblaje''': el llavero con la llave y una anilla. Es para hacernos una idea del tamaño del llavero.  La otra carpeta contiene '''las fuentes de la propia ficha de casino'''. Hacemos invisible el ensamblaje y visualizamos la ficha de casino.

{|
| [[Archivo:Github-freecad-T5-exp-5.png|thumb|300px| Llave y anilla de referencia para el llavero  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-6.png|thumb|300px| Ficha de casino sobre la que hacer nuestro llavero hola mundo  (''click para ampliar'')]]
|}

Desde el banco de trabajo "'''part design'''" seleccionamos la '''cara superior de la ficha de casino''' y creamos un boceto nuevo sobre ella.

{|
| [[Archivo:Github-freecad-T5-exp-7.png|thumb|300px| Seleccionar cara superior de la ficha de casino desde el entorno part-design   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-8.png|thumb|300px| Crear un sketch nuevo sobre esa cara   (''click para ampliar'')]]
|}

Hacemos un triángulo mediante la herramienta de multi-línea. El vértice superior lo hacemos coincidir con el eje y. La base del triángulo la hacemos horizontal. Creamos una circunferencia auxiliar centrado en el origen. Hacemos coincidir los tres vértices del triángulo con el perímetro de la circunferencia.

{|
| [[Archivo:Github-freecad-T5-exp-9.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-10.png|thumb|300px|   (''click para ampliar'')]]
|}

Damos un radio de 11mm a la circunferencia y hacemos que la base sea igual a uno de los lados del triángulo. Ya tenemos el boceto definido. Ahora aplicamos un vaciado y ya tenemos nuestro llavero hola mundo!! Lo grabamos.

{|
| [[Archivo:Github-freecad-T5-exp-11.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-exp-12.png|thumb|300px|   (''click para ampliar'')]]
|}

==== Ejercicios propuestos ====
* '''Ejercicio 1:''' Hacer el llavero hola mundo, a partir del llavero ficha de casino. Con un triángulo en el interior

{|
| [[Archivo:Github-freecad-T5-ej-1.png|thumb|300px| Ejercicio 1: Llavero Hola mundo   (''click para ampliar'')]]
|}

* '''Ejercicio 2:''' Hacer el llavero smily. Lo podéis hacer a partir del llavero chasino-chip2.fcstd que está en el repositorio oficial (puede que en vuestro fork no esté, dependiendo de cuando hicistéis el fork). Grabarlo en la carpeta tutorial/exercises/<tu usuario> con el nombre T5-ej2.fcstd

{|
| [[Archivo:Github-freecad-T5-ej-2-smily-1.png|thumb|300px| Ejercicio 2: llavero smily  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-ej-2-smily-2.png|thumb|300px| Boceto del llavero smily  (''click para ampliar'')]]
|}

* '''Ejercicio 3:''' Hacer  el llavero botón de encendido. Grabarlo en la carpeta tutorial/exercises/<tu usuario> con el nombre T5-ej3.fcstd


{|
| [[Archivo:Github-freecad-T5-ej-3-power-on-1.png|thumb|300px| Ejercicio 3: Llavero de botón de encendido   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T5-ej-3-power-on-2.png|thumb|300px| Boceto del llavero de botón de encendido  (''click para ampliar'')]]
|}

* Entregas

{|
| [[|thumb|300px|   (''click para ampliar'')]]
| [[|thumb|300px|   (''click para ampliar'')]]
|}

{|
| [[|thumb|300px|   (''click para ampliar'')]]
| [[|thumb|300px|   (''click para ampliar'')]]
|}

==== Ficheros ====
{| {{tablabonita}}
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/freecad-src/casino-chip.fcstd casino-chip.fcstd]
| Llavero ficha de casino. Hacer el llavero hola mundo a partir de él
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/freecad-src/casino-chip2.fcstd casino-chip2.fcstd]
| Llavero ficha de casino, tipo 2. Usado para hacer los ejercicios 2 y 3
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/freecad-src/casino-chip-triangle.fcstd casino-chip-triangle.fcstd]
| Llavero hola mundo. Fuentes en freecad
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/stl/casino-chip-triangle.stl casino-chip-triangle.stl]
| Llavero hola mundo. STL
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/step/casino-chip-triangle.step casino-chip-triangle.step]
| Llavero hola mundo. STEP
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/freecad-src/smily.fcstd smily.fcstd]
| Llavero Smily. Fuentes en freecad
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/stl/smily.stl smily.stl]
| Llavero smily. STL
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/step/smily.step smily.step]
| Llavero smily. STEP
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/freecad-src/power-on-button.fcstd power-on-button.fcstd]
| Llavero boton de encendido. Fuentes en freecad
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/stl/power-on-button.stl power-on-button.stl]
| Llavero botón de encendido. STL
|-----
| [https://github.com/Obijuan/freecad-key-chain-library/raw/master/step/power-on-button.step power-on-button.step]
| Llavero botón de encendido. STEP
|-----
|}

=== 6 Subiendo el llavero hola mundo: git push ===

{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=m0g1Pzfoo1g '''Video Tutorial 6/x''']
|}

{|
| [[Archivo:Github-freecad-T6-1.png]]
|}

==== Descripción ====

Meter nuestra aportación del llavero hola mundo en el repositorio local y subirlo al repositorio de github

* '''Conceptos nuevos''': comandos '''git config''', '''git status''', '''git add''', '''git commit''' y '''git push'''

==== Explicación ====

Tenemos dos repositorios, el original de los llaveros y el fork del usuario '''chanquete'''. Este último chanquete se lo ha bajado a su ordenador (lo ha clonado) y ha creado el '''llavero hola mundo que quiere compartir'''. Primero lo tiene que introducir en el repositorio clonado y después mediante el comando '''git push''' se envía al repositorio. El repositorio de chanquete en github recibe el nombre de '''origin''' y por defecto siempre se trabaja en la rama '''master''', así que lo identificamos con el nombre '''origin/master'''.

{|
| [[Archivo:Github-freecad-T6-exp-1.png|thumb|300px| Repositorios iniciales   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T6-exp-2.png|thumb|300px| El usuario chanquete sube su contribución al repo origin / master  (''click para ampliar'')]]
|}

Ahora el repo de chanquete tiene un llavero que NO está en el repositorio original de obijuan. Son dos repos independientes. Para que el llavero se incluya en este repo tendrá que hacer una solicitud (un '''pull request''').

Vamos a subir el llavero hola mundo a nuestro repositorio '''origin / master'''. Nos vamos a la carpeta '''tutorial / exercises''' y abrimos un terminal

{|
| [[Archivo:Github-freecad-T6-exp-3.png|thumb|300px| Haciendo una solicitud para incluir el llavero (pull request)   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T6-exp-4.png|thumb|300px| Carpeta tutorial / exercises de nuestro repo local  (''click para ampliar'')]]
|}

Hay que configurar primero el '''repositorio local''', para indicar nuestros datos. Usamos el comando '''git config''' para especificar nuestro nombre de usuario y el correo. Git los necesita para asociarlos a nuestras contribuciones.  Como mi usuario de ejemplo es '''obijuan-test''', ejecuto los comandos así:

 git config user.email "obijuan.cube@gmail.com"
 git config user.name "obijuan-test"

Ahora ejecutamos el comando '''git status''' para ver el estado del repositorio local

 git status

Se nos indica que el fichero '''obijuan-test/T5-ej1.fcstd''' no pertenece al repositorio. Claro, lo hemos añadido nosotros

{|
| [[Archivo:Github-freecad-T6-exp-5.png|thumb|300px| Configurando el usuario del repositorio local   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T6-exp-6.png|thumb|300px| Ejecundo el comando git status  (''click para ampliar'')]]
|}

Añadimos el fichero a nuestra aportación con el comando '''git add'''

  git add obijuan-test/T5-ej1.fcstd

Ejecutamos otra vez el comando '''git status''' y nos aparece el fichero marcado, indicándonos que está en nuestra aportación. Podríamos añadir más ficheros antes de meter la aportación en nuestro repositorio local.

Hacemos la aportación con el comando git commit.  Es obligatorio poner siempre un comentario a las aportaciones. El comando típico para hacer estas aportaciones es:

 git commit -m "Mi fichero hola mundo"

{|
| [[Archivo:Github-freecad-T6-exp-7.png|thumb|300px| Fichero obijuan-test/T5-ej1.fcstd añadido a la aportación  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T6-exp-8.png|thumb|300px| Realizando la aportación en el repositorio local  (''click para ampliar'')]]
|-----
| [[Archivo:Github-freecad-T6-exp-7-windows.png|thumb|300px| Añadiendo la aportación en windows. Gracias a Juanma Roldan Gomez (Exodous)  (''click para ampliar'')]]
|  
|}

Ahora enviamos la aportación al repositorio origin/master con el comando:

  git push origin master

Nos pedirá el usuario y la clave. ¡¡Nuestra contribución ya está en el github disponible para todos!!

{|
| [[Archivo:Github-freecad-T6-exp-9.png|thumb|300px| Subiendo la aportación al repo con git push  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T6-exp-10.png|thumb|300px| Nuestro llavero en el repo de github  (''click para ampliar'')]]
|}

{|  style="border: 1px solid darkgray; width:100%" 
|- 
|
'''Resumen''', una vez configurado todo, el ciclo de trabajo es el siguiente:

* Añadir los ficheros que queremos meter en la aportación con '''git add'''
* Hacer la aportación en el repo local, con '''git commit -m "Mi comentario"'''
* Enviar la aportación al repositorio de github con '''git push origin master'''
|}


{|
| [[Archivo:Github-freecad-T6-exp-11.png|thumb|500px|   (''click para ampliar'')]]
|}


==== Ejercicios propuestos ====
* '''Ejercicio 1:''' Subir el llavero hola mundo a vuestro repo

* '''Ejercicio 2:''' Subir el llavero smily

* '''Ejercicio 3:''' Subir el llavero botón de encendido

=== 7 Contribuyendo: pull request ===

{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=pBrUS9aPO38 '''Video Tutorial 7/x''']
|}

{|
| [[Archivo:Github-freecad-T7-1.png]]
|}

==== Descripción ====

Haremos '''nuestra primera contribución al repositorio oficial de llaveros'''. El primer paso es hacer una '''solicitud''' (''pull request''). El segundo es '''esperar a que nos la acepten'''. Todo se hace desde la propia web de github. No es necesario ejecutar comandos en nuestro repositorio local.

* '''Conceptos nuevos''': pull request

==== Explicación ====

Para '''contribuir''' a un proyecto desde nuestro fork tenemos que '''lanzar una solicitud''' (''pull request'') desde la propia '''web de github'''. Esta solicitud quedará registrada en el proyecto y podrá ser atendida por cualquiera que tenga permisos de escritura en ese repositorio. '''Es decisión de los desarrolladores aceptarla o no'''. También, es muy común que antes de aceptarla se pongan comentarios de cosas que tienen que ser modificadas antes de poderse integrar.

{|
| [[Archivo:Github-freecad-T7-exp-1.png|thumb|300px| Solicitud emitida hacia el repositorio de llaveros de obijuan   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T7-exp-2.png|thumb|300px| Solicitud aceptada. ¡Nuestra primera contribución!  (''click para ampliar'')]]
|}

Vamos a la web de github, a '''nuestro repositorio de los llaveros'''. Pinchamos en el icono [[Archivo:Icon-pull-req-1.png]] que está en la parte superior izquierda. Nos aparecerán las contribuciones que hemos hechos nosotros y que '''NO''' están en el repositorio original. En nuestro caso sólo hay 1 contribución: el llavero hola mundo.  Para comenzar el proceso de emitir una solicitud (pull request) pinchamos en el botón verde que dice "'''Create pull request'''" [[Archivo:Icon-create-pull-request.png]].


{|
| [[Archivo:Github-freecad-T7-exp-3.png|thumb|300px| Nuestro repositorio en github   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T7-exp-4.png|thumb|300px| Mostrando los cambios con respecto al repositorio original  (''click para ampliar'')]]
|}

Ponemos un título y '''explicamos en los comentarios cual es nuestra aportación''', para que la lea el dueño del repo y decida si aceptarla o no.
Luego pichamos en "Create pull request".  Ya está creado. Es el número #9 (en este ejemplo). ¡tu primera contribución ha sido enviada! Ahora ya sólo te toca esperar a que te la acepten

{|
| [[Archivo:Github-freecad-T7-exp-5.png|thumb|300px| Preparando la solicutd de aportación (pull request)   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T7-exp-6.png|thumb|300px| Pull request creado (#9)  (''click para ampliar'')]]
|}

'''Vamos a verlo desde el otro lado'''. Cuando haces un pull request, los usuarios con permisos reciben una notificación. Al conectarse a la página del repositorio se indicará en la parte superior derecha el número de pull request pendientes. En este caso hay sólo uno. Al pinchar se abre el pull request. Pinchamos para verlo. Nos aparecen los comentarios.

{|
| [[Archivo:Github-freecad-T7-exp-7.png|thumb|300px| Pull request pendientes de validar  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T7-exp-8.png|thumb|300px| Pull request #9: Mi llavero hola mundo  (''click para ampliar'')]]
|}

En este caso se acepta el pull request directamente pulsando en "'''Merge pull request'''". Desde la página principal se ve que ya no queda ninguno pendiente.

{|
| [[Archivo:Github-freecad-T7-exp-9.png|thumb|300px| Pull request #9 aceptado!   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T7-exp-10.png|thumb|300px| Ya no hay pull requests pendientes  (''click para ampliar'')]]
|}

En vuestro perfil aparecerá en qué proyecto habéis contribuido

{|
| [[Archivo:Github-freecad-T7-exp-11.png|thumb|300px| La contribución aparece en el perfil de obijuan-test  (''click para ampliar'')]]
|}

==== Ejercicios propuestos ====
* '''Ejercicio 1:''' Emitir pull request de vuestros llaveros hola mundo

* '''Ejercicio 2:''' Crear un llavero nuevo, y aportarlo directamente a la biblioteca. Hacer un pull request del fichero freecad, del stl, del step y de una imagen. Cada uno se debe colocar en su carpeta correspondiente: freecad-src, step, stl y gallery

==== '''Entregas''' ====

* '''Carlos García Saura''' (Carlosgs): Primer pull request recibido

{|
| [[Archivo:Delivery-carlosgs-T5-ej1.png|thumb|300px| Ejercicio 1 de '''Carlos García Saura'''  (''click para ampliar'')]]
| [[Archivo:Delivery-carlosgs-T5-ej2.png|thumb|300px| Ejercicio 2 de '''Carlos García Saura'''   (''click para ampliar'')]]
|-------
| [[Archivo:Delivery-carlosgs-T5-ej3.png|thumb|300px| Ejercicio 3 de '''Carlos García Saura'''  (''click para ampliar'')]]
| [[Archivo:Cheese.png|thumb|300px| Llavero Trozo de queso, de '''Carlos García Saura'''  (''click para ampliar'')]]

|}

* '''Salvador Liris''': Segundo pull request recibido (Litris) 

{|
| [[Archivo:Delivery-litris-T5-ej1.png|thumb|300px| Ejercicio 1 de '''Salvador Litris'''   (''click para ampliar'')]]
|}

* '''Jose Ignacio Alonso''' (jialonso333): Tercer pull request recibido

{|
| [[Archivo:Delivery-jialonso333-T5-ej1.png|thumb|300px|Ejercicio 1 de '''Jose Ignacio Alonso'''   (''click para ampliar'')]]
| [[Archivo:Delivery-jialonso333-T5-ej2.png|thumb|300px|Ejercicio 2 de '''Jose Ignacio Alonso'''  (''click para ampliar'')]]
|-------
| [[Archivo:Delivery-jialonso333-T5-ej3.png|thumb|300px|Ejercicio 3 de '''Jose Ignacio Alonso'''  (''click para ampliar'')]]
| [[Archivo:Logo-GitHub-keychain.jpg|thumb|200px|Llavero con el logo de github, por '''Jose Ignacio Alonso'''  (''click para ampliar'')]]
|}

=== ¡8 Sincronízate! ===
{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [https://www.youtube.com/watch?v=muuMfhgP250 '''Video Tutorial 8/x''']
|}

{|
| [[Archivo:Github-freecad-T8-1.png]]
|}

==== Descripción ====

Como más gente ha hecho aportaciones al repositorio oficial de llaveros, nuestro repo se ha quedado desincronizado. Las aportaciones de los demás no están en nuestro repo. Tenemos que sincronizarlo.

* '''Conceptos nuevos''': upstream, git remote, git fetch, git checkout, git merge

==== Explicación ====

En el escenario actual tenemos el '''repositorio inicial con todas las contribuciones''' recibidas de la gente, a partir de sus repositorios. Así, por ejemplo, '''carlosgs''' ha contribuido con su llavero queso, '''movilujo''' con el llavero de TEDx, etc...  Si bien en el repo inicial están todas las contribuciones, los forks hechos por la gente están '''desincronizados'''. 

El repositorio inicial lo denominamos '''upstream/master'''. El repositorio del usuario chanquete (origin / master) no está sincronizado con el upstream. Hay llaveros en el upstream que no están en el repo de chanquete. 

{|
| [[Archivo:Github-freecad-T8-exp-1.png|thumb|300px| Escenario actual: muchos forks desde los que se han enviado contribuciones al repo principal   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-2.png|thumb|300px| El repositorio del chanquete NO está sincronizado   (''click para ampliar'')]]
|}

Para sincronizarle tiene que '''configurar''' su repositorio local para establecer el '''upstream'''. Luego mediante el comando '''git fetch''' se baja el reporitorio upstream. Ahora tiene los dos repositorios en local. El repositorio activo es el último que se ha bajado. Se indica con una flecha en el dibujo. Queremos que el activo sea el nuestro local. Cambiamos a él mediante el comando '''git checkout'''. 

{|
| [[Archivo:Github-freecad-T8-exp-3.png|thumb|300px| Bajando el repositorio upstram con git fetch  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-3-bis.png|thumb|300px| Poniendo el repo local como activo  (''click para ampliar'')]]
|}

Con el comando '''git merge''' se mezclan los dos repositorios. '''¡El repositorio local queda sincronizado!'''

{|
| [[Archivo:Github-freecad-T8-exp-4.png|thumb|300px| Mezclando los dos repositorios con git merge  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-5.png|thumb|300px| Repositorio local sincronizado   (''click para ampliar'')]]
|}

Ahora lo enviamos al github con el comando '''git push''', de modo que el repositorio origin/master también queda sincronizado

{|
| [[Archivo:Github-freecad-T8-exp-6.png|thumb|300px| Repositorio origin sincronizado  (''click para ampliar'')]]
|}

¡Pasamos a la acción! '''Vamos a sincronizar nuestro repositorio''' para tener las constribuciones del resto de usuario. Nos vamos a la web de github, a nuestro repositorio. En la figura se muestra el del usuario de prueba obijuan-test, que está 100 contribuciones por detrás del repo oficial. 

Nos vamos ahora al github del repositorio [https://github.com/Obijuan/freecad-key-chain-library upstream] y '''copiamos su dirección''' (lo mismo que cuando lo clonamos). La necesitaremos para configurar el upstream en nuestro repositorio local.

{|
| [[Archivo:Github-freecad-T8-exp-7.png|thumb|300px| El repositorio del usuario de pruebas obijuan-test tiene 100 contribuciones menos que el oficial   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-8.png|thumb|300px| Copiando la dirección del repositorio upstream  (''click para ampliar'')]]
|}

Configuramos el upstream mediante el comando '''git remote add''':

 git remote add upstream https://github.com/Obijuan/freecad-key-chain-library.git

Podemos comprobar que está configurado correctamente con:

 git remote -v

Nos bajamos el repositorio upstream con '''git fetch upstream''':

 git fetch upstream

{|
| [[Archivo:Github-freecad-T8-exp-9.png|thumb|300px| Configuración del repositorio upstream  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-10.png|thumb|300px| Bajando el repositorio upstream  (''click para ampliar'')]]
|}

Cambiamos al repositorio local, a la rama master:

 git checkout master

y fusionamos el repositorio upstream/master:

 git merge upstream/master

Comprobamos con git status, y en este ejemplo vemos que hay 100 aportaciones nuevas

Por último subimos las aportaciones al repositorio origin/master con '''git push''':

 git push origin master

 '''¡Ya estamos sincronizados!'''

{|
| [[Archivo:Github-freecad-T8-exp-11.png|thumb|300px|Cambiando al repositorio local y fusionándolo con upstream/master  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T8-exp-12.png|thumb|300px|Comprobando con status. Hay 100 aportaciones nuevas  (''click para ampliar'')]]
|------
| [[Archivo:Github-freecad-T8-exp-13.png|thumb|300px|Subiendo las aportaciones al repositorio origin/master   (''click para ampliar'')]]
|}

Si ahora miramos nuestro repo en la web de github, vemos en la parte superior izquierda que ahora '''nuestro repo está a la par que el inicial de obijuan'''.

{|
| [[Archivo:Github-freecad-T8-exp-14.png|thumb|300px| ¡Repo sincronizado!   (''click para ampliar'')]]
|}

Como '''resumen''', una vez que se tiene configurada la dirección del repositorio upstream, los comandos que hay que ejecutar para sincronizar el repo son los siguientes:

{|
| [[Archivo:Github-freecad-T8-exp-15.png|thumb|500px| (''click para ampliar'')]]
|}

Pantallazos de la '''sincronización en Mac''':

{|
| [[Archivo:Github-freecat-T8-exp16-mac.png|thumb|300px| Cortesía de Salvador Litris. ¡Gracias! (''click para ampliar'')]]
| [[Archivo:Github-freecat-T8-exp17-mac.png|thumb|300px| Cortesía de Salvador Litris. ¡Gracias! (''click para ampliar'')]]
|--------
| [[Archivo:Github-freecat-T8-exp18-mac.png|thumb|300px| Cortesía de Salvador Litris. ¡Gracias! (''click para ampliar'')]]
|
|}

Pantallazos de la '''sincronización en Windows''':

{|
| [[Archivo:Github-freecat-T8-exp19-windows.png|thumb|300px| Cortesía de Juanma Roldán (Exodous). ¡Gracias! (''click para ampliar'')]]
| [[Archivo:Github-freecat-T8-exp20-windows.png|thumb|300px| Cortesía de Juanma Roldán (Exodous). ¡Gracias! (''click para ampliar'')]]
|--------
| [[Archivo:Github-freecat-T8-exp21-windows.png|thumb|300px| Cortesía de Juanma Roldán (Exodous). ¡Gracias! (''click para ampliar'')]]
|
|}


==== Ejercicios propuestos ====
* '''Ejercicio 1:''' Sincronizarse con el repositorio de llaveros

=== 9 JUEGO: contribuciones a ciegas ===

{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [ '''Video Tutorial 9/x''']
|}

{|
| [[Archivo:Github-freecad-T9-exp-1.png|400px]]
|}

==== Descripción ====

Se plantea el juego de "'''las contribuciones a ciegas'''" para aprender a crear repositorios, recibir contribuciones y practicar un poco más las aportaciones a otros

* '''Conceptos nuevos''': Crear repositorio, aceptar pull request

==== Explicación ====

Para jugar al '''juego de las contribuciones a ciegas''' tenemos que crear un repositorio en nuestra cuenta de github. Entramos en github y en la parte superior derecha desplegamos el '''icono que tiene un +'''. Seleccionamos la opción '''new repository'''. Rellenamos los datos para crear el repositorio:
* Nombre del repositorio: '''contribucion-a-ciegas'''
* Descripción: ''Repositorio para jugar al juego de las contribuciones a ciegas''

Marcamos la casilla que dice "'''Initialize this repository with a README'''" y pulsamos el botón verde "'''create repository'''"

{|
| [[Archivo:Github-freecad-T9-exp-2.png|thumb|300px| Crear un repositorio nuevo desde nuestra cuenta de github  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-3.png|thumb|300px| Introduciendo datos para crear el repositorio contribucion-a-ciegas  (''click para ampliar'')]]
|}

'''¡Ya tenemos un repositorio nuevo!''' Y nosotros somos los dueños, con permisos de escritura, para subir cualquier fichero o realizar modificaciones. Si miramos en nuestra lista de repositorios, nos aparecerá el nuevo, junto con el que ya teníamos de los llaveros

{|
| [[Archivo:Github-freecad-T9-exp-4.png|thumb|300px| Repositorio recién creado  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-5.png|thumb|300px| Lista de nuestros repositorios  (''click para ampliar'')]]
|}

Ahora '''clonamos''' el repositorio en nuestro ordenador con '''git clone'''. Si nos metemos en la carpeta veremos que sólo contiene el fichero README.md

{|
| [[Archivo:Github-freecad-T9-exp-6.png|thumb|300px| Clonando el repositorio contribucion-a-ciegas   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-7.png|thumb|300px| El repo sólo contiene el fichero README  (''click para ampliar'')]]
|}

Creamos dos carpetas, llamadas '''contribuciones''' y '''visitas'''. En cada una de ellas creamos un fichero README.md. 
En el de contribuciones ponemos: 
 Sube aquí tus contribuciones :-)
y en el de visitas: 
 Deja tu firma en el libro de visitas!!
 Crea un fichero tu_nick.txt y deja tu mensaje!!

Hacemos un git status y vemos que las carpetas están en rojo porque no las hemos añadido todavía. No aparecen los README porque las carpetas NO están añadidas.

{|
| [[Archivo:Github-freecad-T9-exp-8.png|thumb|300px| Carpetas contribuciones y visitas creadas  (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-9.png|thumb|300px| Las carpetas están sin añadir todavía  (''click para ampliar'')]]
|}

Añadimos los ficheros README (las carpetas se añaden automáticamente):

 git add contribuciones/README.md
 git add visitas/README.md

Hacemos la contribución local:

 git commit -m "Creadas carpetas contribuciones y visitas y añadidos ficheros README"

y la subimos al repositorio de github:

 git push origin master

{|
| [[Archivo:Github-freecad-T9-exp-10.png|thumb|300px|   (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-11.png|thumb|300px|   (''click para ampliar'')]]
|}

Comprobamos en la web de github que tenemos nuestra contribución subida. ¡Listos para jugar!

{|
| [[Archivo:Github-freecad-T9-exp-12.png|thumb|300px|   (''click para ampliar'')]]
|}


==== El juego ====
El juego es muy sencillo. Una vez creado tu repo "contribucion-a-ciegas", tendrás que buscar a otros usuarios que también lo tengan creado y '''hacerles una contribución''' a su repo. Puede ser cualquier cosa: una imagen, una figura, un texto, una foto... '''¡Sorpréndeles!'''. Al hacer una contribución (en el directorio contribuciones) hay que escribir algo también en el '''libro de visitas'''. Sube un fichero ''tu_nick.txt'' con tu texto en el directorio visitas.

Hay una regla:  '''Si alguien te hace una contribución, tu le tienes que hacer otra en su repo'''. 

Para buscar potenciales usuarios a los que hacerles contribuciones, mirar la lista de contribuidores en el repositorio oficial de los llaveros en github, pinchando en la parte superior izquierda donde pone '''contributors'''. Ir a sus perfiles y mirar si tienen creado el repositorio '''contribución-a-ciegas'''. Si es así, hazles una contribución. Y ellos tendrán que hacerte una a tí :-)

{|
| [[Archivo:Github-freecad-T9-exp-13.png|thumb|300px|Pulsar en la lista de contribuidores para buscar jugadores (''click para ampliar'')]]
| [[Archivo:Github-freecad-T9-exp-14.png|thumb|300px|Lista de contribuidores al repositorio de los llaveros   (''click para ampliar'')]]
|}

¿Qué contribuciones te harán? ¿Cuantos ''pull request'' recibirás? :-)

=== 10 Final: Hasta el github y más allá ===

{|  style="border: 1px solid darkgray; width:100%" 
|- style="background: #cedff2;"
! [ '''Video Tutorial x/x''']
|}

{|
| [[|thumb|300px| (''click para ampliar'')]]
| [[|thumb|300px| (''click para ampliar'')]]
|}

==== Descripción ====

Plantilla wiki para crear nuevos tutoriales

* '''Conceptos nuevos''': 

==== Explicación ====

{|
| [[|thumb|300px|   (''click para ampliar'')]]
| [[|thumb|300px|   (''click para ampliar'')]]
|}

{|
| [[|thumb|300px|   (''click para ampliar'')]]
| [[|thumb|300px|   (''click para ampliar'')]]
|}

== Repositorio ==

Los ficheros fuentes están en este repositorio:

* [https://github.com/Obijuan/freecad-key-chain-library https://github.com/Obijuan/freecad-key-chain-library]

== Enlaces ==
* [http://rogerdudler.github.io/git-guide/index.es.html Git, la guía sencilla]

== Autor ==
* [[Juan Gonzalez:Main | Juan González]] (Obijuan)

== Licencia ==
{|{{tablabonita}}
| [[Archivo:By-sa.png|200px|]] This work is licensed under a [http://creativecommons.org/licenses/by-sa/3.0/es/ Creative commons Attributions Sharealike].
|}

== Créditos ==

* '''Roberto Carlos Carmono''' (rcccord): Llavero con el logo del hardware libre. ¡Gracias!
* '''Jose Vega''': Llavero con el logo de la Obijuan Academy. ¡Gracias!
* '''Pablo Clemente''' (Paclema). Consejos y ayuda sobre github en Windows. ¡Gracias!
* '''Juanma Roldan Gomez''' (Exodous). Pantallazos de git en Windows. ¡Gracias!
* '''Salvador Litris'''. Pantallazos de git en Max y llavero THX. ¡Gracias!
* '''Antonio Ruiz Cuellar'''. Pantallazos de git en Windows. ¡Gracias!
* '''LLuis Vilarubies''': Llavero de Octoprint. ¡Gracias!
* '''Jose Luis Villarejo''': Llavero de TEDx. ¡Gracias!
* '''Carlos García Saura''': Llavero de Queso. ¡Gracias!
* '''Jon (b1-66er)''': Llavero León. ¡Gracias!
* '''AngelLM''': Pokellavero. ¡Gracias!
* '''furanshishouco''': Llavero con el logo de freecad. ¡Gracias!

== Sobre este tutorial ==

Este tutorial está realizado '''exclusivamente usando herramientas libres'''.

{|{{tablabonita}}
| 
* '''Sistema Operativo''': [http://www.ubuntu.com/ Ubuntu Linux] 14.10
* '''Freecad''': [http://www.freecadweb.org/ Freecad] 0.14.3702
* '''Retoque imagenes''': [http://www.gimp.org/ gimp] 2.8.10
* '''Dibujos''': [https://inkscape.org/es/ inkscape] 0.48.5
* '''Grabación escritorio''': Kazam 1.4.5
* '''Edición de vídeos''': [http://www.openshotvideo.com/ Openshot] 1.4.3
* '''Visualización de las pulsaciones del ratón''': keymon 1.17
|}

== Enlaces ==






{| class="wikitable"
|-
| 
[[Archivo:Clone-Wars-logo.png|border|120px|link=http://www.reprap.org/wiki/Proyecto_Clone_Wars|Proyecto Clone wars]]
| [http://www.reprap.org/wiki/Proyecto_Clone_Wars Proyecto Clone wars]: Construye tu impresora 3D opensource!
|----
| 
<center>[[Archivo:RepRap1.png|border|85px|link=http://reprap.org/ RepRap|Proyecto Reprap]]</center>
| [http://reprap.org/ Proyecto RepRap]: Impresoras 3D auto-replicantes. El origen de la revolución de las impresoras 3D opensource
|-----
| 
<center>[[Archivo:Logo-obijuan-academy-white-back.png|100px|link=Obijuan Academy|Obijuan Academy]] </center>
| [[Obijuan Academy]], Tu academia rebelde! ;-)
|----
|}





[[Categoría:Robots imprimibles]]
[[Categoría:Charlas y Conferencias]]
[[Categoría: Robótica]]
[[Categoría:Obijuan Academy]]