Apéndice C. Instalación
Anterior |  | Siguiente

## Apéndice C. Instalación

En el sitio de desarrollo de `sigue` en Internet: http://structio.sourceforge.net/sigue es posible obtener las fuentes, así como un paquete precompilado para sistemas OpenBSD en plataforma x86. Este paquete puede instalarse de la manera estándar en sistemas OpenBSD (con pkg_add).

A continuación se presentan instrucciones para compilar las fuentes en sistemas tipo Unix.

## Requerimientos

- Un sistema tipo Unix (Se ha probado especialmente con OpenBSD http://www.openbsd.org).

- Ocaml 3.x (se ha probado especialmente con 3.07). Puede obtener las fuentes en: http://caml.inria.fr/ocaml/. Hay paquetes precompilados de este lenguaje para diversas plataformas (e.g OpenBSD, Debian, Windows).

- make, sed, grep y un interprete de comandos (e.g pdksh, bash).

- La librería `Markup` instalada. Está disponible en: http://www.ocaml-programming.de/markup/

- El programa `repasa` instalado. Está disponible en: http://structio.sourceforge.net/repasa

- Opcional: Corrector de ortografía ispell y diccionario en español.

- Opcional: Si desea emplear la interfaz PHP, requerirá el servidor web Apache (>=1.3) preferiblemente con SSL y PHP (>= 4.1) en el computador donde está la información. Se ha probado especialmente con Apache 1.3.27 y PHP 5

- Opcional: Para respaldar y tener la posibilidad de rastrear modificaciones se recomienda emplear CVS.

## Compilación

Primero desempaquete y configure con:

          tar xvfz sigue-1.2.tar.gz
          cd sigue-1.2
          ./conf.sh

si desea especificar una ruta de instalación (por defecto es `/usr/local`), emplee el parámetro `-p` del script conf.sh, por ejemplo:

          ./conf.sh -p /home/juan/

Este proceso buscará los programas requeridos en algunos sitios y hará algunas pruebas. Si algún componente requerido no es encontrado usted podrá indicar la ubicación cuando conf.sh lo solicite o puede cancelar la configuración y editar directamente confv.sh para después ejecutar nuevamente conf.sh.

Cuando complete la configuración compile con:

    make

o si Ocaml en su plataforma soporta compilación nativa:

    make opt

## Pruebas de regresión

Permiten verificar que los programas que compiló pasan diversas pruebas en su plataforma. Aunque no es indispensable ejecutarlas antes de instalar, es sugerido. Después de compilar puede ejecutarlas desde el directorio de fuentes con:

          cd regr
          ./test.sh

o si compiló nativamente:

          cd regr
          ./test.sh -opt

Si alguna prueba falla la ejecución se detendrá para indicarlo, y deberá presionar ENTER para continuar. Después de completar estas pruebas, tanto en caso de que fallen como en caso de que no fallen solicitamos enviarnos el archivo `test.log` en un correo dirigido a `<structio-info@lists.sourceforge.net>`. Así podremos determinar en que plataformas se ha podio compilar `sigue` (para soportarla mejor) y si hubo fallas podremos corregirlas e informarle.

## Instalación

Una vez compile puede instalar en algunos directorios dentro del directorio prefijo (especificado al configurar) con:

    	    make instala

o

    	    make instala.opt

Si conserva las fuentes o las configura de la misma forma que al instalar, podrá desinstalar posteriormente con:

          make desinstala

Para conservar las fuentes ahorrando espacio (eliminando código objeto producido durante la compilación y binarios no instalados):

          make limpia

o para eliminar también la configuración que haya hecho:

          make limpiadist

## Documentación

Puede consultarla o descargarla de Internet en diversos formatos desde: http://structio.sourceforge.net/sigue

Junto con las fuentes de `sigue` se incluyen:

- Documentación para usuario en formato HTML en el directorio `doc/usuario/html`

- Fuentes en DocBook de la documentación para usuario en el directorio `doc/usuario`. Para generarla consulte `doc/usuario/Leame.txt`. Si colabora en el desarrollo puede generar diversos archivos de documentación para usuarios (e.g archivo Instala.txt, Derechos.txt, documentación de `doc/usuario`) con make doc.

- Páginas `man` de los formatos y programas, que por defecto son instaladas al instalar `sigue`.

- Si emplea Ocaml 3.06 o posterior y desea generar la documentación técnica de las fuentes en HTML, después de compilar ejecute:

      	    mkdir doc/technical
      	    mkdir doc/technical/srcdoc
      	    make srcdoc

Anterior |  | Siguiente
Apéndice B. Derechos | Inicio | Documentación de referencia de formatos