po4a-build: en línea en la nube

PROGRAMA:

NOMBRE

po4a-build - compila documentación traducida

SINOPSIS

po4a-construir [-f | --expediente ARCHIVO] [- solo maceta]

po4a-construir [-? | -h | --ayuda | --versión]

DESCRIPCIÓN

po4a-construir tiene como objetivo facilitar la producción de documentación traducida.
para producir el contenido actual sin traducir.

Cuándo po4a prepara el contenido traducido como POD o DocBook XML, la documentación final
luego se puede construir usando po4a-construir. Tanto el contenido traducido como no traducido está construido
como un solo proceso, actualizando los archivos POT al mismo tiempo.

Las instrucciones de compilación existentes se reemplazan por una única llamada a po4a-construir y un simple
El archivo de configuración se usa para decirle po4a-construir cómo construir cada elemento y qué binario
Los paquetes incluirán el contenido traducido y no traducido.

Una vez construido, el contenido estará en directorios específicos del paquete debajo del DIRBASE
especificado en el archivo de configuración. Para un paquete binario foo, con traducciones a
Alemán y francés, esto resultaría en:

BASEDIR / foo / man / man1 / foo.1
BASEDIR / foo / man / de / man1 / foo.1
BASEDIR / foo / man / fr / man1 / foo.1

Esto facilita la inclusión de todo el contenido generado en el paquete binario con un
ubicación de instalación única:

doc / foo / man / *./ usr / share / man /
doc / foo / html / * ./usr/share/doc/foo/

No será necesario actualizar esta regla cuando se agreguen nuevas traducciones y se agregue una segunda
binary package (bar) permite que el contenido de ese paquete se mantenga separado.

Soportado formatos
Actualmente, po4a-construir admite las siguientes combinaciones:

1. DocBook XML para la sección 1.

2. DocBook XML para la sección 3.

3. DocBook XML para HTML.

4. POD para la sección 1.

5. POD para la sección 3.

6. POD para la sección 5.

7. POD para la sección 7.

Todos los formatos admitidos, en todas las combinaciones admitidas, se pueden manejar en un solo
archivo de configuración po4a-build.conf y en una sola llamada a po4a-construir. Vea po4a-
construir.conf(5).

CONFIGURACIÓN

po4a-construir usa un archivo de configuración predeterminado, po4a-build.conf, que debería estar en la parte superior
directorio de nivel de su paquete VCS. (Utilizar el -f opción para especificar un archivo diferente).
po4a-build.conf(5).

Ejemplo 1. (aqui) configuración presentar

Hay un archivo de configuración de ejemplo disponible en:

/usr/share/doc/po4a/ejemplos/po4a-build.conf.ejemplo

configuración presentar diseño
El archivo de configuración consta de varias secciones, general, compatibilidad con XML / XSL, compatibilidad con POD
y soporte HTML.

General incluye el nombre y la ubicación del archivo de configuración po4a (probablemente sea mejor dejar
esto como po4a.config), el directorio po que contiene los archivos PO de documentación (a menudo
doc / po), el nombre completo del archivo POT utilizado para crear las traducciones, el BASEDIR para
la salida generada, si el paquete contiene páginas de manual en la sección 3 en lugar de solo
sección 1 y los nombres de los paquetes binarios que deben contener la salida generada.

El soporte XML / XSL incluye especificar cuál de los paquetes binarios usa el soporte XSL en el
Variable XMLPACKAGES, el archivo DocBook de nivel superior al que pasar xsltproc y la ubicación de
los archivos XML o DocBook. El XSLFILE se puede anular, si es necesario.

La compatibilidad con POD incluye especificar cuál de los paquetes binarios utiliza la compatibilidad con POD en el
Variable PODPACKAGES y el nombre completo del archivo POD.

El soporte HTML especifica el subdirectorio que se creará debajo de BASEDIR para los
contenido HTML traducido y el archivo DocBook para generar el HTML. El archivo HTMLXSL se puede
anulado, si es necesario.

COMANDOS

- solo maceta
Solo actualiza los archivos POT. - solo maceta está destinado a admitir paquetes que incluyen
todos los archivos POT en el origen del paquete. Los paquetes que utilizan Autotools pueden agregar fácilmente el POT
archivo a través de EXTRA_DIST pero los paquetes solo usan un Makefile o ciertos ayudantes de compilación de VCS
puede resultarle incómodo agregar el archivo POT (que es un archivo generado) sin poner
el archivo POT en el VCS. Para evitar este trabajo feo e innecesario, po4a-construir can
actualice el (los) archivo (s) POT al inicio de la compilación, de modo que dpkg-fuente los incluye
en el tarball de origen.

Ejemplo 2. paquete de compilación svn (aqui)

paquete de compilación svn tiene soporte explícito para este tipo de adición, utilizando el
usarNativeDist Propiedad SVN y la nativo-dist Haz objetivo.

# agrega el archivo POT al tarball de origen
nativo-dist: Makefile
po4a-build --solo bote

$ svn conjunto de propiedades useNativeDist 1 debian

-h|--ayuda
imprima el mensaje de uso y salga.

--versión
imprima el mensaje de uso y salga.

OPCIONES

-f|--expediente ARCHIVO
Anular el po4a-construir archivo de configuración predeterminado (po4a-build.conf) y proporcione su
propio.

Use po4a-build en línea usando los servicios de onworks.net