===============
gvSIG Educa
===============

-------------------------------------------------
Adaptación de gvSIG con fines educativos
-------------------------------------------------

Descripción
==============

Este fichero contiene información para generar un paquete de instalación de gvSIG personalizado que puede instalarse en el sistema operativo *Sugar* de los OLPC.

Contenido del directorio
===========================

* *profiles* : Directorio con configuraciones de entorno de ejecución para usar en la creación de la actividad

* *resource*: Recursos que son utilizados en la generación de la activida

* *skeleton*: Esqueleto de la activida, incluye los fichero de información, estructura de directorio y scrits de ejecución de la actividad.

* *README.rst* *LEEME.rst*: Este fichero

* *Sugerencias_de_configuracion.rst*: Documento con sugerencias para preparar gvSIG 2.0 para empaquetar

Requisitos
==============

* *Sistema operativo Linux*: Por ser *Sugar* un sistema operativo basado en Linux-base (*Fedora 9*)

Generar el paquete de instalación
=====================================

Esta sección explica como generar un paquete de *activida* (fichero ``.xo``).

Instalar gvSIG 2.0
---------------------

Es necesario instalar gvSIG v2.0 en el sistema para poder usarla como base de plugins y configuraciones que deseamos tener en la distribución para el OLPC.

Para más información sobre que paquetes/complementos instalar en gvSIG ver el fichero *Sugerencias_de_configuracion.rst*.

Limpiar compilación previa
----------------------------

Para limpiar una ejecución previa solo es necesario borrar el directorio de trabajo *target* o ejecutar el script *clean.sh* ::

   bash$ ./clean.sh


Preparar el paquete
---------------------

En este paso prepararemos el directorio temporal para general el paquete. Para ello ejecutar el script *prepare-bundle.sh*. Este script soporta los siguiente parámetros:

* ``-g {path}``:  *[obligatorio]* Directorio donde está la instalación de gvSIG 2.0 a usar como base.
* ``-p {profile}``:  *[opcional, standard por defecto]* Profile a usar para configura el entorno de ejecucion de gvSIG en el OLPC.
* ``-v {pkgVersion}``: *[obligatorio][entero]* Versión para el paquete generado.
* ``-t``: *[optional]* Incluir los mapas temáticos instalados en el directorio del usuario.

Un ejemplo de ejecución::

   bash$ ./prepare-bundle.sh -g "/tmp/gvSIG-2.0" -v 3

Este script, dentro de su proceso, ejecuta el script *resources/customize-gvSIG.sh* que ajusta gvSIG para el funcionamiento en el OLPC.

El script genera un directorio *target* que contiene el contenido que se usará para generar el *bundle*. Puede realizar, después de la ejecución del script, cualquier modificación que necesite hacer a mano.

El parámetro ``-t`` incluye todos los *mapas temáticos* que estén instalados en el directorio local de gvSIG (localizados en el directorio *~/gvSIG/plugins/org.gvsig.educa.thematicmap.app.viewer*).

Generar el paquete
--------------------

En este paso se genera el fichero ``.xo``` de la actividad. Únicamente es necesario ejecutar el script *generate-bundle.sh* ::

   bash$ ./generate-bundle.sh