Documentación técnica y de usuario

Soporte para capas geoRSS

Jorge Gaspar Sanz Salinas

Este documento se distribuye bajo una licencia Creative Commons SA versión 3.0. Ver Apéndice C, Licencia: Creative Commons 3.0 SA .

Todos los nombres propios de programas, sistemas operativos, equipo hardware, etc., que aparecen en este documento son marcas registradas de sus respectivas compañías u organizaciones.

Copyright 2007 http://www.geomaticblog.net

Historial de revisiones
Revisión 0.113-agosto-2007jsanz

Creación del documento

Revisión 0.515-agosto-2007jsanz

Primera versión con documentación de usuario

Revisión 0.68-noviembre-2008jsanz

Revisión de bugs, cambio de hosting y cambio de framework para la construcción de la documentación.

Resumen

Documentación técnica y de usuario del proyecto Soporte para capas geoRSS. Este plugin de gvSIG permite añadir capas de noticias de forma sencilla, incluso aunque no dispongan inicialmente del estándar geoRSS.

Puedes acceder a los ficheros binarios y código fuente en la web de la forja de javahispano. Igualmente este proyecto está en el catálogo de extensiones de gvSIG.


1. Introducción

La idea tras este plugin es principalmente aprender. Es decir, no surge de una necesidad en un proyecto profesional concreto (al menos no directamente, porque todo esto lo he podido aplicar a posteriori en el trabajo) sino más bien de la necesidad general de conocer un poco más la arquitectura de gvSIG, su organización interna y diferentes partes del proyecto que todavía no conocía muy bien, como la persistencia de datos, los orígenes de datos, etc.

Además, me ha servido para experimentar con dos bibliotecas que quería probar (y nada mejor que un proyecto real para ello):

  • Una biblioteca de parseo de documentos XML: [jdom]

  • Una biblioteca que permite insertar contenido HTML dentro una aplicación Java: [cobra]

Otro objetivo era practicar con DocBook como sistema de generación de documentación de usuario y documentación técnica del proyecto. Creo en este sentido que DocBook tiene mucho que ofrecer al proyecto gvSIG en general ya que la adopción del mismo podría favorecer enormemente la difusión del mismo al generar documentación tanto en formato HTML como en PDF y demás.

He separado este documento en dos partes principales, una primera parte es una pequeña documentación de usuario, suficiente para el que no esté interesado en desarrollar extensiones con gvSIG. Es corta a la fuerza, no hay tanto desarrollado :P. La segunda creo que es más interesante porque en ella intentaré recoger todo aquello que crea que puede ser interesante sobre el diseño de la extensión, partes implicadas, etc. No prometo grandes alardes ya que esto lo estoy haciendo con la extensión acabada y con animo de «cerrar» este pequeño proyecto.

[Aviso]Aviso

En general, salvo que el contexto indique otra cosa, la palabra extensión es análoga a la de plugin. Esto es cierto en toda la documentación de usuario. En la documentación técnica será necesario hacer la distinción entre ambos conceptos, tal y como aclara la definición de plugin en el Apéndice B, Definiciones.