Documentación FirebirdDocumentación para escritores de FirebirdCómo obtener y construir el módulo "manual" de Firebird → Construir los documentos de Firebird
Firebird home Firebird home Anterior: Obtener el módulo Firebird manual de SourceForgeInicio: Documentación FirebirdSubir: Cómo obtener y construir el módulo "manual" de FirebirdSiguiente: Mantener su módulo manual actualizado

Construir los documentos de Firebird

Adónde obtener Java 2
Cómo configurar el entorno para la construcción
Generar los documentos HTML y PDF

El módulo manual viene con una herramienta de construcción llamada Ant para producir los documentos HTML y PDF desde el fuente DocBook XML. Ant es una herramienta Java; necesita una versión reciente de Java 2 instalada en su sistema.

En las siguientes subsecciones le mostraremos:

  1. Adónde obtener Java 2

  2. Cómo configurar un entorno para el proceso de construcción

  3. Cómo generar los documentos HTML y PDF

Si Ud. ya tiene instalada una versión reciente de Java 2, puede omitir el primer paso.

Adónde obtener Java 2

Descargue e instale sólo uno de los siguientes:

  • Java 2 Runtime Environment, Standard Edition (Entorno de ejecución Java 2, edición estándar) - frecuentemente abreviada como J2RE SE.

    Navegue a http://www.java.com/ y siga los enlaces a las páginas de descarga. Obtenga la versión que corresponda a su SO. Pinchar en los enlaces "Download" (Descargar) o "Get it now" (Obténgalo ahora) puede hacer que aparezca una nueva ventana, preguntando si está bien que Sun Microsystems instale cosas en su computadora. Si Ud. está de acuerdo, prácticamente todo será instalado automáticamente. Si eso le hace sentir incómodo, puede descargar el programa de instalación manualmente y ejecutarlo por su cuenta.

  • Java 2 Software Development Kit, Standard Edition (paquete de desarrollo de software, edición estándar) - o J2SDK SE.

    Este es un paquete mucho más grande, y también contiene el J2RE SE. Si lo que desea es el SDK, vaya a http://java.sun.com/j2se/ y obtenga la última versión estable. Cuando tenga que elegir entre JRE y SDK, seleccione el SDK (si, también puede obtener el J2RE de aquí, pero puede hacerlo más fácil y rápido desde el enlace de la primera opción). Descargue el programa de instalación y ejecútelo.

Si Ud. no entiende la diferencia entre los dos, seleccione la primera opción: Java 2 Runtime Environment. No necesita el SDK para generar los documentos de Firebird.

Cómo configurar el entorno para la construcción

Los scripts de construcción necesitan una variable de entorno JAVA_HOME apuntando al directorio de instalación de Java 2.

  • En Windows, típicamente se trata de algo de la forma C:\Archivos de programa\Java\j2re1.4.2_01. Para estar seguro, verifique si hay un directorio llamado bin dentro de él, y si este subdirectorio bin contiene el archivo java.exe

  • En Linux, puede ser /usr/lib/java/jre or /usr/java/j2sdk, o... bueno, puede tomar un montón de formas diferentes. Algunas comprobaciones: debe haber un subdirectorio bin bajo él conteniendo un archivo ejecutable java (sin el .exe esta vez).

Si tiene suerte, la variable de entorno JAVA_HOME existe y es correcta. Si no, tiene que darle valor Ud. mismo, por ejemplo bajo Windows con set JAVA_HOME=C:\Archivos de programa\Java\j2re1.4.2_01 o bajo Linux/bash con export JAVA_HOME=/usr/lib/java/jre (nota: estas rutas son sólo ejemplos; pueden o no ser iguales a las suyas).

Sugerencia: haga permanente la variable de entorno JAVA_HOME para que no tenga que configurarla una y otra vez. Cómo hacer esto depende de su SO. Consulte la documentación si es necesario.

Generar los documentos HTML y PDF

Si ha llegado hasta aquí en una pieza, está finalmente listo para generar los documentos de Firebird. Esto es lo que hay que hacer:

  1. Si no lo ha hecho todavía, este es el momento para leer el archivo ReadMe que se encuentra en el directorio manual. Puede contener información importante no incluída (todavía) en esta guía.

  2. Si Ud. está en un entorno gráfico, abra una ventana de comandos.

  3. A menos que el ReadMe le indique otra cosa, posiciónese en la carpeta manual\src\build y ejecute el comando

    build (en Windows), o

    ./build.sh (en Linux)

    si todo fue configurado correctamente, obtendrá una cantidad de líneas de salida que terminan con BUILD SUCCESSFUL (Generación exitosa), y mencionan algunos build targets (objetivos de generación, cosas que puede construir).

  4. Ahora puede generar algo más sustancial, por ejemplo

    build html o

    build pdf o

    build docs

    Lo que sea que genere irá a parar a una carpeta bajo manual\dist.

    Nota: si genera el PDF, recibirá toneladas de mensajes de error. Puede ignorarlos con seguridad, mientras una de las últimas líneas diga BUILD SUCCESSFUL.

  5. Hay un par de opciones útiles para usar en la generación de documentos específicos:

    -Drootid=id_del_documento (root id, identificador base) indica a la herramienta de construcción que genere solamente el documento cuyo identificador es id_del_documento

    -Dsfx=identificador_de_lenguaje (suffix, sufijo) indica a la herramienta de construcción que genere los documentos del lenguaje especificado. Algunos identificadores reconocidos son los siguientes:

    es: español

    fr: francés

    Si no se especifica el parámetro -Dsfx, se construirán los documentos en inglés.

    Estos parámetros se pueden combinar. Por ejemplo, para generar el pdf de la Guia de Arranque Rápido en castellano usaríamos

    build pdf -Drootid=qsg15-es -Dsfx=es

Esto es todo -Ud. es ahora un constructor certificado de documentos Firebird. ¡Felicitaciones!

Si Ud. desea escribir documentos propios para el proyecto Firebird, lea también la Guía de escritores Firebird.

Anterior: Obtener el módulo Firebird manual de SourceForgeInicio: Documentación FirebirdSubir: Cómo obtener y construir el módulo "manual" de FirebirdSiguiente: Mantener su módulo manual actualizado
Documentación FirebirdDocumentación para escritores de FirebirdCómo obtener y construir el módulo "manual" de Firebird → Construir los documentos de Firebird