21:40:46 #startmeeting Taller de Git 21:40:46 Meeting started Wed Feb 2 21:40:46 2011 UTC. The chair is tezcatl. Information about MeetBot at http://wiki.debian.org/MeetBot. 21:40:46 Useful Commands: #action #agreed #halp #info #idea #link #topic. 21:41:14 #meetingname Taller de uso de Git para colaboradores de la Revista Fedora Latam 21:41:14 The meeting name has been set to 'taller_de_uso_de_git_para_colaboradores_de_la_revista_fedora_latam' 21:42:00 Bienvenido todos compa�s colaboradores de la Revista Fedora Latam 21:42:11 interesados y lurks tambi�;) 21:43:28 ! 21:43:38 Dale V1K1N60 21:43:43 solo mencionar los requisitos para la class 21:43:57 #link http://rpmdev.proyectofedora.org/issues/461#note-2 21:44:09 no tengo peticiones pendientes en el grupo 21:44:10 eof 21:44:11 * tezcatl propone que en �a ocasi�nos saltemos formalidades 21:44:22 Gracias V1K1N60 21:44:50 Cuando tengan una duda, pregunta, comentario o cualquier cosa que quieran decir, simplemente escr�nlo 21:44:58 no vamos a pedir la palabra en �a sesi� 21:45:34 Me comenta gomix que algunos caracteres se ven extranhos en los clientes, 21:45:46 de modo que voy a tratar de evitar los acentos por esta ocasion 21:46:02 * tezcatl tendra que ver este detalle con los operadores del canal 21:46:14 #info Agenda de la sesion 21:46:59 #info Obtener una copia local del repositorio de trabajo 21:47:28 #info Enviar una colaboracion para la Revista al repositorio 21:47:51 #info Revisar y hacer correcciones a articulos en el repositorio 21:48:32 #info Montar articulos en Scribus para la preparacion de la publicacion final 21:49:18 #topic Obtener una copia local del repositorio de trabajo 21:50:23 #link https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam Es el grupo de colaboradores con acceso de escritura al repositorio. 21:51:28 #info Sponsors que pueden aprobar ingreso al grupo son Maria Gracia Leandro (Tatica), Mauricio Moreno (V1K1N60) y su servidor (tezcatl) 21:52:32 #info Los miembros del grupo (como gomix), pueden a�r directamente colaboraciones y editar los archivos 21:54:11 #idea el objetivo del repositorio es agilizar las contribuciones permitiendo a los colaboradores acceder, revisar y corregir los articulos y el maquetado directamente, sin mediar enviar los archivos por correo electronico y esperar a que sean copiados a otra parte 21:54:33 * tezcatl LOL que linea mas larga!!! :D 21:54:46 �dudas hasta aqui? 21:56:03 Les recuerdo que en esta sesion no necesitan pedir la palabra, para agilizar resolver dudas, etc. 21:57:21 Ok, entonces proseguimos. 21:58:07 #info Para conseguir una copia del repositorio de trabajo que tenemos en fedorahosted, usaremos uno de los siguientes comandos: 21:58:22 #info git clone git://git.fedorahosted.org/git/revista-fedora-latam.git 21:59:26 #info Este comando les traera una copia del repositorio, aunque no hayan ingresado aun al grupo de colaboradores en FAS 22:00:27 #action Los colaboradores de la revista, que aun no estan en el grupo en FAS, soliciten unirse por favor 22:02:44 #info Para obtener una copia del repositorio, ya configurada para que ustedes envien directamente sus colaboraciones, el comando cambia un poco: 22:03:44 #info git clone ssh://{usuario-FAS}@git.fedorahosted.org/git/revista-fedora-latam.git 22:05:07 #info Noten la diferencia entre las URL's; git:// (suficiente para obtener una copia simple) y ssh:// (especificando su usuario en FAS, para facilitarles la colaboracion) 22:05:58 * tezcatl usa por ejemplo: git clone ssh://tezcatl@git.fedorahosted.org/git/revista-fedora-latam.git 22:06:50 �dudas hasta aqui? 22:08:54 No duden en hacer uso de la palabra en cualquier momento, no estamos usando el protocolo ! -> eof ;) 22:09:01 continuemos 22:09:49 #topic Enviar una colaboracion para la Revista al repositorio 22:10:21 Una vez que hemos obtenido una copia del repositorio, podemos comenzar a trabajar en este 22:10:48 #info Podemos crear nuevos articulos (o esbozos, borradores, drafts, como quieran llamarle) 22:11:08 #info Podemos agregar imagenes y otros dise�para las ilustraciones de la Revista 22:11:42 #info Podemos revisar y hacer correcciones tanto a los articulos individualmente, como al maquetado de la Revista 22:13:55 El flujo de trabajo mas sencillo con el repositorio es el siguiente. 22:14:39 #topic A�r un articulo al repositorio 22:15:27 #info No importa si el articulo esta en etapa de borrador (o lo estamos copiando de otro sitio pero esta pendiente de revision) 22:16:23 Simplemente creamos el archivo dentro del directorio revista-fedora-latam/pool/ 22:16:59 puede ser con gedit, con vi, con emacs, con leafpad, o hasta con {open,libre}office 22:17:27 #info 1.- Solo guarden el archivo dentro del directorio pool, con formato de texto simple 22:18:14 Sin embargo hasta este momento, solo esta en el directorio, pero aun no es parte del repositorio (ni local, ni remoto, ni de nadie). 22:18:53 Para a�rlo al indice de archivos que git toma en cuenta (para sincronizar los repositorios llegado el momento), 22:19:19 tenemos que decirle a git que a� (add) este archivo que acabamos de crear. 22:19:48 #info 2.- git add archivo-recien-creado 22:21:33 #info con �git status� podemos observar el cambio que acabamos de hacer 22:23:13 Pero aun no esta en el repositorio de los demas... 22:23:52 Digamos que los cambios (nuevos archivos, eliminar otros ya innecesarios, ediciones) 22:24:17 son el equivalente a la "previsualizacion" que hacemos en el wiki antes de guardar la pagina 22:25:00 no exactamente, pero ayuda a entender porque si nosotros ya comenzamos a trabajar en un articulo aun no aparece en el repositorio de los demas 22:25:57 Para continuar, necesitamos agregar este cambio al indice de contribuciones que git tiene que preparar para enviar al repositorio comun 22:26:38 #info 3.- git commit -m 'Comentario descriptivo de los cambios' 22:27:55 #info Esto es equivalente al comentario que tenemos que hacer cuando editamos paginas en el wiki, para ayudar a los que revisan el historial de cambios en el repositorio 22:29:38 #info se recomienda "hacer commit" frecuentemente, para administrar mejor la historia del repositorio y aislar mas facilmente errores y poder deshacerlos sin dolor :) 22:30:55 **Pero despues de hacer commit, ya tenemos guardados los cambios en nuestro repositorio, pero no aparecera en el de los demas** 22:31:30 Para enviar al repositorio original (origin) tenemos que empujar los cambios hacia este (hacer push) 22:31:52 #info 4.- git push 22:37:41 #info Si el push fue exitoso, veremos algo como: "ff46e29..24e1167 master -> master" 22:38:20 simplemente indica el cambio en el repositorio. 22:42:04 #link https://fedorahosted.org/revista-fedora-latam/browser Pueden ver la estructura del repositorio actual y el ultimo cambio ;) 22:42:30 #topic Agregar imagenes al repositorio 22:43:06 #info Para agregar imagenes al repositorio, se siguen los mismos pasos que para a�r articulos. 22:43:41 #info la unica diferencia es que los agregaremos al directorio pool/pics 22:43:57 esto es algo totalmente convencional y podria cambiar en otro momento 22:44:30 por ahora es la estructura que acordamos V1K1N60 y su servidor 22:45:58 #info Resumiendo (ejemplo): 1.- git add imagen_cool_para_portada.svg -> 2.- git commit -m 'Envio imagen para portada de numero 6' -> 3. git push 22:47:16 Continuemos entonces con Revisiones/Correcciones 22:47:23 #topic Revisar y hacer correcciones a articulos en el repositorio 22:49:11 #info El flujo de trabajo para revisores/correctores, cambia simplemente en que en lugar de a�r un articulo primero al repositorio, vamos a editar primero el articulo en cuestion con nuestro editor favorito 22:49:22 Se recomienda: 22:50:00 Una vez hechos los cambios al articulo 22:52:00 #info ejecutamos git status para verificar que git esta registrando nuestra edicion 22:52:43 #info en caso de que git no este al tanto de que hemos modificado el articulo, ejecutamos git add articuloencuestion.txt (ejemplo) 22:53:39 #info a continuacion hacemos git commit -m 'Revision del articulo ____ (en progreso/listo/etc.)' 22:53:46 y finalmente: 22:53:52 #info git push 22:55:32 Se recomienda avisar por la lista de correos, cuando el articulo ya este listo para que los dise�res lo incluyan en el maquetado de la revista. 22:55:59 Terminemos entonces, con el maquetado en Scribus. 22:56:21 #topic Montar articulos en Scribus para la preparacion de la publicacion final 22:57:45 #info Scribus guarda sus archivos (los .sla) en formato de texto plano, por ello es perfecto para que git registre los cambios. 22:58:24 De este modo, si hay algun error en el maquetado de cierto articulo, otro dise�r puede trabajar en el maquetado 22:58:45 sin esperar a que se terminen las revisiones de los articulos restantes 22:59:14 y en caso de que se cometiese algun error, se pueden revertir los cambios (como siempre hemos mencionado). 22:59:51 La secuencia de cambios que tiene que seguir un dise�r, es practicamente la misma que 23:00:10 para agregar articulos o imagenes al repositorio: 23:01:18 #info Ejemplo: 1.- git add revista-0006.sla -> 2.- git commit -m 'Comienzo a montar articulos de proxima edicion' -> 3.- git push 23:01:39 y para continuar trabajando sobre un maquetado ya creado por otro dise�r 23:02:55 #info Ejemplo: 1.- git status (verificamos los cambios que guardamos en Scribus). -> 2.- git commit -m 'Agrego articulo de seccion RPM' -> 3.- git push 23:06:06 #info No olviden siempre vincular las imagenes con las que ilustran el archivo, en el directorio pool/pics del repositorio 23:06:29 Y... con esto yo termino mi participacion en esta sesion. 23:06:57 Espero sus comentarios, opiniones, ideas y preguntas. 23:08:51 #link https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam No olviden solicitar su ingreso, para facilitar recibir sus contribuciones 23:10:42 #link http://proyectofedora.org/mailman/listinfo/revista_proyectofedora.org Lista de correos de colaboradores en la infra de Latam. 23:13:17 #link https://fedorahosted.org/mailman/listinfo/revista-fedora-latam Lista auxiliar (automaticamente se envian commit a esta lista, ademas). 23:13:39 * tezcatl les agradece a todos su interes y participaciones :D 23:13:58 Nos seguimos leyendo por la lista y en RPMDEV. 23:14:03 Buenas tardes y noches. 23:14:08 #endmeeting