[gnome-hispano] Librognome: Tareas pendientes fase 1 "no yellow"

[Domingo González <gonav ono com>]

(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.