(Este correo es interesante solamente para los colaboradores del proyecto: leer esto por gusto es un rollazo)
Aquí está el extenso listado de todas las tareas pendientes, ordenadas conforme al índice de capítulos y secciones. Hay capítulos o parte de ellos que hay que copiar al wiki, y otros que hay que redactar desde cero. En http://es.gnome.org/Documentacion/Desarrollo/CoordinacionDeTareas tenemos una lista con todos los capítulos, con un código de color: - rojo si falta por redactar - amarillo si está redactado ya en el libro (html), y solamente falta copiar al wiki - azul si ya está copiado al wiki (de momento los que yo he escrito) - verde si está revisado y finalizado La idea es: - Fase 1 "no yelow": pasar todo lo que se pueda del libro html al wiki (eliminar todo el color amarillo de la tabla y centrarnos a trabajar en el wiki) - Fase 2 "no red": redactar todo lo que falte del libro (eliminar todo el color rojo de la tabla). - Fase 3 "Green End" (revisemos todo y terminemos por fin) En la tabla de tareas, podéis ir apuntando vuestros nombres en los apartados que queráis copiar desde el html hasta el wiki, y si puede ser indicar una fecha prevista. Si editar la tabla lo veis complicado (cosa normal pues es un monstruo), enviad a la lista la tarea que os adjudicáis con su referencia XXYY (para que nadie más la tome) y ya lo pongo yo en la tabla. El capítulo de Glade me lo he adjudicado yo, así acabo de revisar algunas cosas que me quedaron en el tintero cuando lo escribí. NOTA.- Si hay errores de visualización en el libro (imágenes que no están, código fuente que no se ve, etc), avisadme. NOTA 2.- Cuando tengamos esto más o menos controlado, las partes del libro que no se han usado las pondremos como tutoriales independientes en la sección de documentación. ---------------------------------- Introducción al desarrollo de aplicaciones GNOME HECHO BLOQUE I: Desarrollo de proyectos Recursos disponibles para proyectos de desarrollo HECHO Preparación del entorno /0301 Introducción copiar http://webs.ono.com/gonav/librognome-html/c435.html /0302 Estructura de un proyecto GNU /0303 +Archivos de información de un proyecto /0304 +Archivos de programas y configuración copiar http://webs.ono.com/gonav/librognome-html/x466.html /0305 Las herramientas autotools (redactar desde cero) /0306 Lenguajes de programación (redactar desde cero) /0307 Paquetes necesarios para la compilación (redactar desde cero) La idea es explicar aquí: 1) cual es la estructura de directorios de un proyecto y describir cada uno de los ficheros, 2) herramientas autotools para general automáticamente dicha estructura, y 3) qué hay que tener instalado para compilar y ejecutar los programas. * De autotools no explicaría demasiado tan pronto, solamente lo necesario para entender los conceptos y saber cómo se construyen los ficheros configure.in y Makefile.am. El subapartado "Las herramientas a través de un ejemplo" lo quitaría de aquí y lo llevaría a los ejemplos del final, que es dónde se van a utilizar. http://webs.ono.com/gonav/librognome-html/x545.html * Los subapartados sobre Migración de aplicaciones a Gnome 2 (Cambios a autogen.sh, Pkg-config, Cambios al configure.in, Cambios en Makefile.am, Requerimientos para compilar los módulos, Otros paquetes necesarios para ejecutar GNOME 2) pueden aprovecharse para completar los puntos 2) y 3). http://webs.ono.com/gonav/librognome-html/a11648.html Herramientas de desarrollo /0401 Línea de comandos: gcc /0402 Uso de Anjuta como IDE /0403 +Crear un proyecto /0404 +Compilación y construcción de paquetes /0405 Glade: desarrollo de interfaces gráficas /0406 DevHelp: guía de referencia (redactar todo desde cero) * Explicar aquí un poco cómo usar las herramientas: gcc en linea de comandos, crear proyectos con anjuta, y uso de la herramienta DevHelp. * Sería interesante mencionar glade en este capítulo brevemente, sin perder de vista que hay un capítulo completo después sobre GLADE. BLOQUE II. Programación básica: Bibliotecas base Bibliotecas de la plataforma GNOME (redactar desde cero) /0501 +Bibliotecas básicas /0502 +Perspectiva general: gráfico de dependencias * Para empezar, es buena idea hacer un repaso de las librerías que existen para Gnome. Algunas se estudiarán con detalle después (Glib, GTK, etc), otras se utilizarán de forma indirecta (por ejemplo Cairo en gtk-print), y otras no se verán en todo el libro. De esta forma evitamos tener que hacer un inciso en algún capítulo para explicar brevemente una biblioteca que necesitemos utilizar. * Como una imagen vale más que mil palabras, vamos a incluir los gráficos de dependencias de Gnome: http:// live.gnome.org/GnomeArchitecture/Overview?highlight=%28gnome%29 (está disponible en formato .dia). * Se puede reutilizar parte del capítulo del apartado "Las bibliotecas de la plataforma" del antiguo anexo "Cómo migrar aplicaciones a la plataforma Gnome 2.0" * Otras fuentes para extraer información son: http://www.es.gnome.org/documentacion/articulos/curso-gnome/curso-gnome/ http://wiki.gnome.cl/GnomeAmor Glib (copiar tal cual todos los apartados de http://webs.ono.com/gonav/librognome-html/c756.html) Sistema de objetos de Glib (copiar tal cual de http://webs.ono.com/gonav/librognome-html/c4227.html) /0710 Parámetros y valores. (falta por redactar) GTK+ (copiar tal cual de http://webs.ono.com/gonav/librognome-html/c4524.html) GtkTreeView: Árboles y listas en GTK+ (copiar tal cual de http://webs.ono.com/gonav/librognome-html/c6320.html) /0918 Cortar y pegar en GtkTreeView (falta por redactar) GtkTextView: manejo de texto /1001 Editor de texto multilínea /1002 +Manipulación de texto (copiar de http://webs.ono.com/gonav/librognome-html/c6734.html) * El capítulo "Minieditor de texto" se divide en dos: un capítulo teórico sobre GtkTextView, y la parte del ejemplo va al final de todo. GtkTextView tiene entidad para tener un capítulo solo, igual que GtkTreeView. http://webs.ono.com/gonav/librognome-html/x6745.html GTK+ avanzado (copiar desde http://webs.ono.com/gonav/librognome-html/c6753.html) "Creación de un widget personalizado" (estará relacionado con lo que se explique en el apartado de Objetos de Glib). /1116 Creación de un widget personalizado: reloj digital (¿sugerencias?) (falta por redactar desde cero) Impresión en GTK+ /1201 Uso de Gtk-print (falta redactar desde cero) * Se necesitan algunos conceptos de Cairo, que se deberán haber explicado en el capítulo "Descripción de las bibliotecas de la plataforma GNOME". gnome-vfs /1301 URIs (Uniform Resource Identifier) /1302 Operaciones básicas /1303 E/S Asíncrona /1304 Módulos para GNOME-VFS (copiar desde http://webs.ono.com/gonav/librognome-html/c11148.html) Interfaces de usuario con Glade y libglade (copiar de http://webs.ono.com/gonav/librognome-html/c7728.html) (el ejemplo de implementación del minieditor de textos que hay en http://webs.ono.com/gonav/librognome-html/x8340.html se traslada al capítulo final) /1424 Desarrollo avanzado con Glade /1425 +Integración de GtkTreeView /1426 +Utilización de Diálogos (GtkDialog) /1427 +Desarrollo de aplicaciones GnomeApp /1428 +Trabajo con widgets individualmente /1429 +Creación de un widget personalizado: reloj digital /1430 Integración de Glade con Anjuta (estos apartados faltan por redactar) * El subapartado "Creación de un widget personalizado", esta vez usando Glade, será complementario al capítulo de "GTK avanzado". BLOQUE III: Programación avanzada: arquitectura Gconf, el sistema de configuración (copiar desde http://webs.ono.com/gonav/librognome-html/c11045.html) Pango (copiar desde http://webs.ono.com/gonav/librognome-html/c4421.html) XML en GNOME (copiar desde http://webs.ono.com/gonav/librognome-html/c10872.html) BLOQUE IV: Normas para el correcto desarrollo de aplicaciones Situada al final del libro, cuando ya sabemos cómo programar, esta parte tiene el objetivo de sentar unas bases comunes sobre cuál es la forma correcta de desarrollar las aplicaciones y qué elementos deben contener (accesibilidad, estilos, etc). Internacionalización /1801 Internacionalización de aplicaciones /1802 +intltool (copiar desde http://webs.ono.com/gonav/librognome-html/c655.html) /1803 Internacionalización de las interfaces en glade (falta por redactar desde cero) Pautas para el diseño de interfaces gráficas (falta redactar desde cero) * En este capítulo interesa resumir las partes más importantes del HIG (Human Interfaces Guidelines, http://developer.gnome.org/projects/gup/hig/2.0/). * Para ampliar informacion enlazar al texto de referencia. Accesibilidad en GNOME /2001 Accesibilidad en Gtk+ /2002 Accesibilidad en Glade (redactar desde cero) Estilo correcto de programación * Resumir las partes más importantes de la Guía de programación de GNOME que Germán ha traducido (http://www.ubiobio.cl/~gpoo/documentos/programming-guidelines/). * Para ampliar informacion enlazar al texto de referencia. Escribir documentación para aplicaciones GNOME * Documentar una aplicación y crear ficheros de ayuda para integrar con yelp. /2201 Documentos de ayuda /2202 +Visor de ayuda Yelp (redactar desde cero) /2203 Documentación con DockBook /2204 +Estructura de un archivo XML /2205 +Programas necesarios /2206 +Generación de formatos (adaptar la información de http://webs.ono.com/gonav/librognome-html/c11447.html) * El apartado "Documentación con DocBook" está enfocado a los redactores del libro y no a los lectores, por lo tanto desaparece como tal. Se elimina todo lo referente a SGML y DTD, y se reutiliza la parte de DocBook y xml para explicar el tema de documentación. BLOQUE V: Aplicaciones de ejemplo En esta última parte se van a desarrollar varias aplicaciones completas, a modo de ejemplo, que constituye el cierre perfecto para que el libro sea lo más didáctico posible. Se crearán las interfaces usando GTK y usando Glade, para que se vea la diferencia. Luego vendrá la internacionalización y la accesibilidad de la aplicación. Y por último, se crea la documentación y archivos de ayuda, y se escriben los ficheros configure.in y Makefile.am. Con esto se trabajan de forma práctica todos los conceptos explicados en el libro. El tema de autotools es complicado. Se va a explicar en el capítulo 2 lo suficiente para poder hacer aquí los ejemplos, y además debe ser fácilmente asimilable por el lector. Si a alguien se le ocurre alguna forma mejor de reorganizar autotools que lo diga. Desarrollo de una aplicación completa * Ejemplo 1: Minieditor de texto. Nuestro viejo conocido, que ya está implementado en gtk y glade, y le falta accesibilidad, internacionalización, documentación y autotools. Nos va a servir para explicar entre otros el uso del control GtkTextView. /2301 Ejemplo 1: Minieditor de texto /2302 +Mini editor de texto (gtk) (copiar desde http://webs.ono.com/gonav/librognome-html/x6745.html) /2303 +Implementación usando Glade del minieditor de textos (copiar desde http://webs.ono.com/gonav/librognome-html/x8340.html) /2304 +Accesibilidad /2305 +Internacionalizacion /2306 +Documentación /2307 +Creación del paquete con autotools (falta por redactar) * Ejemplo 2: sería ideal un ejemplo para explicar el uso del control GtkTreeView, especialmente interesante desde Glade donde no basta con insertar el control. _______________________________________________ Gnome-hispano-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gnome-hispano-list
