Este es el comando db2x_xsltproc que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
db2x_xsltproc: reiniciador de invocación del procesador XSLT
SINOPSIS
db2x_xsltproc [opciones] documento xml
DESCRIPCIÓN
db2x_xsltproc invoca el procesador XSLT 1.0 para docbook2X.
Este comando aplica la hoja de estilo XSLT (generalmente proporcionada por - hoja de estilo opción) a la
Documento XML en el archivo documento xml. El resultado se escribe en la salida estándar (a menos que
cambiado con --producción).
Para leer el documento XML de origen desde la entrada estándar, especifique - como documento de entrada.
CAMPUS
--versión
Muestra la versión de docbook2X.
TRANSFORMACIÓN SALIDA CAMPUS
--producción presentar, -o presentar
Escribe la salida en el archivo dado (o URI), en lugar de la salida estándar.
FUENTE DOCUMENTO CAMPUS
--xincluir, -I
Procesar XIncluir directivas en el documento fuente.
--sgml, -S
Indique que el documento de entrada es SGML en lugar de XML. Necesitas este conjunto esto
opción si documento xml es en realidad un archivo SGML.
El análisis de SGML se implementa mediante la conversión a XML a través de sgml2xml(1) del SP
paquete (o osx(1) del paquete OpenSP). Todos los nombres de etiqueta en el archivo SGML serán
normalizado a minúsculas (es decir, el -xmenor opción de sgml2xml(1) se utiliza). IDENTIFICACIÓN
los atributos están disponibles para la hoja de estilo (es decir, la opción -xid). Además, cualquier
Las entidades ISO SDATA utilizadas en el documento SGML se convierten automáticamente a sus
Equivalentes XML Unicode. (Esto lo hace un SED filtrar.)
La codificación del documento SGML, si no es us-ascii, debe especificarse con
las variables de entorno estándar de SP: SP_CHARSET_FIXED = 1 SP_ENCODING =codificación.
(Tenga en cuenta que los archivos XML especifican su codificación con la declaración XML <?xml
versión = "1.0" encoding = "codificación " ?> en la parte superior del archivo.)
Las opciones de conversión anteriores no se pueden cambiar. Si deseas una conversión diferente
opciones, debe invocar sgml2xml(1) manualmente y luego pasar los resultados de ese
conversión a este programa.
RECUPERACIÓN CAMPUS
- catálogos archivos de catálogo, -C archivos de catálogo
Especificar catálogos XML adicionales para usar para resolver identificadores públicos formales o
URI. Los catálogos SGML no son compatibles.
Estos catálogos son no utilizado para analizar un documento SGML bajo el --sgml .
Usa la variable de entorno SGML_CATALOG_FILES en lugar de especificar los catálogos para
analizar el documento SGML.
--la red, -N
db2x_xsltproc normalmente se negará a cargar recursos externos de la red, por
razones de seguridad. Si desea cargar desde la red, configure esta opción.
Por lo general, desea tener instalados localmente las DTD relevantes y otros archivos, y
configurar catálogos para ellos, en lugar de cargarlos automáticamente desde la red.
HOJA DE ESTILOS CAMPUS
- hoja de estilo presentar, -s presentar
Especifique el nombre de archivo (o URI) de la hoja de estilo que se utilizará. El hombre de valores especiales y
texi se aceptan como abreviaturas, para especificar que documento xml está en DocBook y
debe convertirse a páginas man o Texinfo (respectivamente).
--param nombre =expr, -p nombre =expr
Agregue o modifique un parámetro a la hoja de estilo. nombre es un nombre de parámetro XSLT y
expr es una expresión XPath que evalúa el valor deseado para el parámetro.
(Esto significa que las cadenas deben estar entrecomilladas, in adición a la cita habitual de shell
argumentos; usar --string-param para evitar esto.)
--string-param nombre =cadena, -g nombre =cadena
Agregue o modifique un parámetro con valores de cadena a la hoja de estilo.
La cadena debe estar codificada en UTF-8 (independientemente de la codificación de caracteres de la configuración regional).
DEPURACIÓN Y PERFILANDO
--depurar, -d
Mostrar, hasta el error estándar, registros de lo que está sucediendo durante el XSL
transformación.
- límite de anidación n, -D n
Cambie el número máximo de llamadas anidadas a plantillas XSL, que se utilizan para detectar
bucles infinitos potenciales. Si no se especifica, el límite es 500 (el valor predeterminado de libxslt).
--perfil, -P
Mostrar información de perfil: el número total de llamadas a cada plantilla en el
hoja de estilo y el tiempo necesario para cada uno. Esta información se envía a estándar
error.
--procesador xslt procesador, -X procesador
Seleccione el procesador XSLT subyacente utilizado. Las posibles opciones para procesador son:
libxslt, sajón, xalan-j.
El procesador predeterminado es el que se configuró cuando se creó docbook2X. libxslt es
recomendado (porque es delgado y rápido), pero SAXON es mucho más robusto y
ser más útil al depurar hojas de estilo.
Todos los procesadores tienen habilitado el soporte de catálogos XML. (docbook2X lo requiere).
Pero tenga en cuenta que no todas las opciones anteriores funcionan con procesadores que no sean libxslt
uno.
MEDIO AMBIENTE
XML_CATALOG_FILES
Especifique catálogos XML. Si no se especifica, el catálogo estándar (/ etc / xml / catalog) es
cargado, si está disponible.
DB2X_XSLT_PROCESADOR
Especifique el procesador XSLT que se utilizará. El efecto es el mismo que el --procesador xslt
opción. El uso principal de esta variable es permitirle probar rápidamente diferentes
Procesadores XSLT sin tener que agregar --procesador xslt a cada script o archivo make
en su sistema de construcción de documentación.
CONFORME A
Lenguaje de hoja de estilo XML - Transformaciones (XSLT), versión 1.0 ⟨http://www.w3.org/TR/xslt⟩
, una recomendación del W3C.
NOTAS
En sus versiones anteriores (<0.8.4), docbook2X requería extensiones XSLT para ejecutarse y
db2x_xsltproc era un procesador especial basado en libxslt que tenía estas extensiones compiladas.
Cuando se eliminó el requisito de extensiones XSLT, db2x_xsltproc se convirtió en un script de Perl
que traduce las opciones a db2x_xsltproc para ajustarse al formato aceptado por el
en stock xsltproc(1) que viene con libxslt.
La razón principal de la existencia de este script es la compatibilidad con versiones anteriores de cualquier
scripts o crear archivos que invoquen docbook2X. Sin embargo, también se volvió fácil agregar
soporte para invocar otros procesadores XSLT con una interfaz de línea de comandos unificada. En efecto,
no hay nada especial en este script para docbook2X, o incluso para DocBook, y puede ser
se utiliza para ejecutar otro tipo de hojas de estilo si lo desea. Ciertamente el autor prefiere
usando este comando, porque su formato de invocación es sensato y fácil de usar. (por ejemplo, no
escribiendo nombres de clase largos para los procesadores basados en Java!)
Utilice db2x_xsltproc en línea utilizando los servicios de onworks.net
