docbook-2-pdf - En línea en la nube

PROGRAMA:

NOMBRE

sgml2x: formatea fácilmente documentos SGML / XML utilizando hojas de estilo DSSSL

SINOPSIS

sgml2x [opciones] [archivo sgml | archivo xml ]

clase de doc-2-formato de destino [opciones] [archivo sgml | archivo xml ]

Descripción

sgml2x permite formatear fácilmente un documento SGML o XML utilizando hojas de estilo DSSSL, y
proporciona las siguientes características:

· Varias hojas de estilo posibles por clase de documento

· Fácil especificación de hojas de estilo usando alias, con soporte para parámetros
herencia

· Fácil integración de nuevas hojas de estilo agregando un nuevo archivo de definición simple en un
directorio de configuración

· La persona que llama puede especificar una lista de directorios de configuración similar a PATH, por defecto
directorios de configuración de todo el sistema, por usuario y por proyecto

· Selección automática de una hoja de estilo predeterminada que se utilizará, según la asignación
prioridades

· Pasar opciones arbitrarias a jade(1)

La clase de documento utilizada para buscar las hojas de estilo y el formato de salida es por ahora
solo derivado del nombre con el que se llama al programa, por lo que querrá llamar a esto
programa a través de enlaces simbólicos como docbook-2-pdf.

sgml2x se implementa como un envoltorio de shell jade(1) (o, preferiblemente, abiertojade(1),
aunque usamos el nombre genérico jade a lo largo de esta documentación), jadetex(1) así como de otros
herramientas.

Si no hay jadetex.cfg archivo cerca del documento, se copia uno predeterminado, que permite
producción de marcadores PDF.

Opciones

-c|--catalogar catalogar
Utilice el catálogo SGML especificado en lugar del predeterminado del sistema.

-C|--confirma lista-dir
Utilice la lista (separada por espacios en blanco) de directorios de configuración. Esta opcion es
acumulativo, es decir, puede utilizar varios -C opciones y las listas serán
concatenados.

Los elementos de la lista deben ordenarse desde la configuración más genérica (por ejemplo, en todo el sistema)
al más específico (por ejemplo, a nivel de proyecto).

Si se proporciona algún directorio a través de esta opción, la lista de directorios predeterminada será
ignorado

-D|--dssslproc procesador-dsssl
Uso procesador-dsssl para aplicar la hoja de estilo, en lugar de la predeterminada. Esta
el procesador tiene que soportar jade-como opciones, como -V.

Cuando esta opción no está presente, la primera que se encuentra en el dssslproc archivos de confdirs es
tomado. Ver "Archivos" para más información.

-h|--ayuda Muestre un mensaje de ayuda y salga.

-j|--jade procesador-dsssl
Sinónimo obsoleto de --dssslproc.

--filtrojadetex filtro de perl
Postprocese la salida jadetex usando un filtro perl.

Esto puede ser útil para forzar saltos de página en algunos lugares específicos para superar la hoja de estilo.
problemas, o forzar guiones donde TeX no tiene suficientes patrones, o hacer cualquier
otra transformación inteligente en la que pensarías.

Consulte las ejemplos / líneas de comando archivo para posibles usos.

-n|--no actuar
Imprime comandos en lugar de ejecutarlos. Útil para aprender sobre niveles inferiores
herramientas y para depurar la línea de comandos.

-o|--jade abierto
Este opción is obsoleto. abiertojade ahora es el predeterminado cuando está disponible. Usar
--dssslproc o un dssslproc archivo de configuración para forzar un procesador específico.

Esta opción solía usar abiertojade(1) como procesador DSSSL en lugar de jade(1).

-O|--jadeopts opciones de jade
Opciones adicionales para pasar a jade(1). Esta opción es acumulativa, puede
especificar varios de ellos, las opciones proporcionadas se concatenarán.

-q|--tranquilo
Establecer verbosidad en tranquilo

-r|--observaciones
Representar el contenido de las observaciones del documento en el documento (comentario elementos en
libro de documentos 4, comentario elementos en DocBook 3), haciendo que la salida producida sea un
solo para uso interno documento, imprimiendo una advertencia en negrita en la portada.

Esta es una característica específica de la clase de documento y la hoja de estilo, y no todas las hojas de estilo utilizarán
esta.

-s|--estilo papa
Seleccione un estilo de salida para anular el predeterminado (eventualmente derivado del documento).

Los estilos actualmente disponibles para una clase de documento específica y para cada formato de salida son
depende del contenido de los directorios de configuración, y se puede mostrar con el
--ayuda .

Tenga en cuenta que es una buena práctica especificar esta opción en un procedimiento de compilación, de modo que obtenga
resultados reproducibles independientemente de las hojas de estilo disponibles.

-v|--verboso
Aumenta la verbosidad. Esta opción se puede especificar varias veces.

--verbosidad N
Establecer verbosidad en N. Los niveles de verbosidad se definen de la siguiente manera:

tranquilo Solo errores de impresión

tu préstamo estudiantil Imprima solo errores y advertencias

verboso También imprime avisos

rastrear También imprima comandos importantes a medida que se ejecutan (como --no actuar hace).

depurar También imprime mensajes de depuración

-V|--versión
Imprima la versión del programa y salga.

Configuración

sgml2x utiliza un árbol de directorio de configuración en lugar de un archivo de configuración, por lo que es
fácil para que otros paquetes se conecten con un bajo riesgo de romper una configuración existente.

Las jerarquías de estilos se encuentran en directorios denominados estilos en cada configuración
directorio. Las versiones antiguas de este programa solían poner esas jerarquías directamente en el
directorios de configuración.

Un directorio de configuración contiene un directorio para cada clase de documento conocida, nombrada con
un apodo de clase de documento (p. ej. libro de documentos). Esos directorios de clase de documento contienen una sub-
directorio para cada clase de formato de salida (actualmente, solo html y Imprimir son compatibles).

Actualmente, los problemas de implementación imponen una limitación en los apodos para las clases de documentos.
y hojas de estilo: solo pueden contener caracteres alfanuméricos y subrayados. Esta
La limitación puede eliminarse en una versión futura, pero eso no sucederá antes de esta
El guión se reescribe en otro idioma.

Cada uno de esos directorios contiene un archivo por estilo disponible. Los nombres de estos archivos
solo pueden contener caracteres alfanuméricos y se utilizan como apodos para los estilos. Esta
el archivo contiene líneas con un llave: propuesta de patrón, con las siguientes teclas actualmente
apoyado:

Id El identificador público de la hoja de estilo

desc Una breve descripción de los estilos, que se mostrará en el mensaje de ayuda.

anular pdf, anular ps,
anular rtf, anulación mif"10 Un símbolo dsssl de la hoja de estilo de impresión que se va a configurar
a #t (O un símbolo=propuesta de par, adecuado como argumento para jade's -V opción),
que se utilizará para el formato de impresión dado.

Solo se permite un símbolo por línea de anulación. Para definir valores para varios símbolos, use
varias líneas.

Hereda El apodo de una hoja de estilo de la que éste hereda, para evitar innecesariamente
duplicación de definiciones de estilo.

Actualmente, esto solo provoca la herencia del *Anular parámetros.

Prioridad Un número entero positivo para ayudar a seleccionar el estilo predeterminado cuando no se puede
derivado del documento. Los valores más altos tienen una mayor probabilidad de ser tomados como
defecto. Tenga cuidado de usar prioridades bajas para estilos hiperespecializados para un
tipo de documento genérico, para que no se utilice por error.

Por ejemplo, la política recomendada actual para las hojas de estilo DocBook derivadas de
El de Norman Walsh es el siguiente (y puede cambiar si la experiencia demuestra que es inadecuado).

10 Las hojas de estilo base, que normalmente deben personalizarse.

0 Cualquier hoja de estilo que fue escrita con un propósito hiperespecializado (p. Ej.
ficha de producto de marketing).

1000 Un estilo predeterminado para todos los documentos producidos por una organización. Por lo general, un
personalización ligera, con preferencias de diseño, la organización
logo, o cosas por el estilo.

10-100 Personalizaciones genéricas diversas de las hojas de estilo base.

Cuando escribe una versión mejorada de una hoja de estilo con prioridad n,
Por lo general, desea seleccionar una prioridad más alta.

archivos

/ etc / sgml / sgml2x /

~ / .sgml2x /

./sgml2x/ Los directorios de configuración predeterminados, en los que se encuentran los archivos de configuración
buscado para. Ver documentación para --confirma para más información.

confiar/estilo/
La jerarquía que define los estilos utilizables. Ver "Configuración"
Detalles.

confiar/ dssslproc
Un archivo que contiene una lista ordenada de procesadores dsssl para buscar, separados por
nuevas líneas y / o espacios en blanco. Líneas que comienzan con un # los personajes son tratados como
comentarios. Los valores comunes incluyen abiertojade y jade.

Los procesadores DSSSL especificados aquí deben aceptar la -V y -D compatible con jade
opciones de la línea de comandos.

Los directorios de configuración se buscan empezando por los más específicos.
uno, de modo que, con las configuraciones predeterminadas, la configuración del proyecto puede anular al usuario
configuración, que a su vez puede anular la configuración del sistema.

El valor especial false se puede utilizar para detener la búsqueda y evitar buscar en
directorios más genéricos. Si, por ejemplo, un proyecto debe utilizar la
openjade-1.4devel comando y ningún otro, puede especificar openjade-1.4devel false
en su dssslproc archivo.

Advertencias

Cuando usas openjade-1.4devel como procesador DSSSL, verá una queja sobre los principales
objeto de flujo de nivel generado por tipo de documento.dsl, y determinación automática del documento-
el tipo fallará. De lo contrario, este error es inofensivo. Ideas de cómo lidiar con esto, o
confirmación de que openjade-1.4devel es demasiado estricto, se agradecerá :)

El futuras

Las características planificadas para versiones futuras incluyen:

· Integración de un generador de índices

· Integración de un bonito motor de impresión para ejemplos de código

· Especificación de transformaciones a encadenar

· Declaración de subconjunto de clases de documento para permitir el uso con cualquier clase de documento del estilo.
hojas que se aplican a sus clases de documento de superconjunto.

· Trabajar en una ubicación temporal para no contaminar el directorio de trabajo con
archivos temporales. Esto no es tan fácil como parece, porque rompe un documento
se refiere a archivos de imágenes que utilizan rutas relativas. Eso puede verse como un error de jade,
sin embargo.

¡Explore la lista completa de TODO y envíenos más ideas!

Derechos de Autor

Copyright © 2001-2003 Alcove y Yann Dirson.

sgml2x tiene la licencia GNU General Public License, versión 2.

Esta documentación tiene la licencia de documentación libre GNU, versión 1.

Contacto us

sgml2x es parte del AlcobaReservar proyecto (enlazar a Enlance http://www.alcove-
labs.org/en/software/alcovebook/) . Por favor use el AlcobaReservar envío liza (enlazar a Enlance
https://savannah.gnu.org/mail/?group_id=533) para ponerse en contacto con desarrolladores y usuarios.

La lista de errores y solicitudes de funciones está disponible a a Webtracking interfaz. (enlazar a Enlance
https://savannah.gnu.org/support/?group_id=533) . Úselo para enviar problemas y
ideas.

See también

abiertojade(1), jade(1), jadetex(1), collateindex.pl(1).

sgml2x(1)

Use docbook-2-pdf en línea usando los servicios de onworks.net