db2x_xsltproc - Online na nuvem

PROGRAMA:

NOME

db2x_xsltproc - Wrapper de chamada do processador XSLT

SINOPSE

db2x_xsltproc [opções] documento xml

DESCRIÇÃO

db2x_xsltproc invoca o processador XSLT 1.0 para docbook2X.

Este comando aplica a folha de estilo XSLT (geralmente fornecida pelo --folha de estilo opção) para o
Documento XML no arquivo documento xml. O resultado é gravado na saída padrão (a menos que
mudou com --resultado).

Para ler o documento XML de origem da entrada padrão, especifique - como o documento de entrada.

OPÇÕES

--versão
Exibir a versão docbook2X.

TRANSFORMAÇÃO SAÍDA OPÇÕES
--resultado lima, -o lima
Grave a saída no arquivo fornecido (ou URI), em vez da saída padrão.

FONTE DOCUMENTO OPÇÕES
--xinclude, -I
Diretivas do processo XInclude no documento de origem.

--sgml, -S
Indique que o documento de entrada é SGML em vez de XML. Você precisa deste conjunto
opção se documento xml é na verdade um arquivo SGML.

A análise SGML é implementada por conversão para XML via sgml2xml(1) do SP
pacote (ou osx(1) do pacote OpenSP). Todos os nomes de tag no arquivo SGML serão
normalizado para minúsculas (ou seja, o -xbaixo opção de sgml2xml(1) é usado). EU IRIA
atributos estão disponíveis para a folha de estilo (ou seja, opção -xid) Além disso, qualquer
Entidades ISO SDATA usadas no documento SGML são automaticamente convertidas para seus
Equivalentes XML Unicode. (Isso é feito por um sede filtro.)

A codificação do documento SGML, se não for us-ascii, deve ser especificada com
as variáveis ​​de ambiente SP padrão: SP_CHARSET_FIXED = 1 SP_ENCODING =codificação.
(Observe que os arquivos XML especificam sua codificação com a declaração XML <?xml
versão = "1.0" encoding = "codificação" ?> na parte superior do arquivo.)

As opções de conversão acima não podem ser alteradas. Se você deseja uma conversão diferente
opções, você deve invocar sgml2xml(1) manualmente e, em seguida, passe os resultados desse
conversão para este programa.

RECUPERAÇÃO OPÇÕES
--catálogos arquivos de catálogo, -C arquivos de catálogo
Especifique catálogos XML adicionais a serem usados ​​para resolver identificadores públicos formais ou
URIs. Catálogos SGML não são suportados.

Esses catálogos são não usado para analisar um documento SGML sob o --sgml opção.
Use a variável de ambiente SGML_CATALOG_FILES em vez de especificar os catálogos para
analisar o documento SGML.

--rede, -N
db2x_xsltproc normalmente se recusará a carregar recursos externos da rede, por
razões de segurança. Se você deseja carregar da rede, defina esta opção.

Normalmente, você deseja ter instalado localmente os DTDs relevantes e outros arquivos, e
configure catálogos para eles, em vez de carregá-los automaticamente da rede.

FOLHA DE ESTILO OPÇÕES
--folha de estilo lima, -s lima
Especifique o nome do arquivo (ou URI) da folha de estilo a ser usada. Os valores especiais, homem e
texi são aceitos como abreviações, para especificar que documento xml está em DocBook e
deve ser convertido para páginas de manual ou Texinfo (respectivamente).

--param nome=expr, -p nome=expr
Adicione ou modifique um parâmetro à folha de estilo. nome é um nome de parâmetro XSLT e
expr é uma expressão XPath que avalia o valor desejado para o parâmetro.
(Isso significa que as strings devem estar entre aspas, in Adição para a citação usual de shell
argumentos; usar --string-param para evitar isso.)

--string-param nome=corda, -g nome=corda
Adicione ou modifique um parâmetro com valor de string à folha de estilo.

A string deve ser codificada em UTF-8 (independentemente da codificação do caractere local).

DEPURAÇÃO E PERFIL
--depurar, -d
Exibir, para erro padrão, logs do que está acontecendo durante o XSL
transformação.

--limite de aninhamento n, -D n
Altere o número máximo de chamadas aninhadas para modelos XSL, usados ​​para detectar
loops infinitos em potencial. Se não for especificado, o limite é 500 (padrão da libxslt).

--perfil, -P
Exibir informações de perfil: o número total de chamadas para cada modelo no
folha de estilo e o tempo gasto para cada uma. Esta informação é enviada para o padrão
erro.

--xslt-processador processador, -X processador
Selecione o processador XSLT subjacente usado. As escolhas possíveis para processador são:
libxslt, saxão, xalan-j.

O processador padrão é o que foi definido quando docbook2X foi construído. libxslt é
recomendado (porque é enxuto e rápido), mas SAXON é muito mais robusto e seria
ser mais útil ao depurar folhas de estilo.

Todos os processadores têm suporte a catálogos XML ativado. (docbook2X requer isso.)
Mas note que nem todas as opções acima funcionam com outros processadores além do libxslt
um.

MEIO AMBIENTE

XML_CATALOG_FILES
Especifique Catálogos XML. Se não for especificado, o catálogo padrão (/ etc / xml / catalog) é
carregado, se disponível.

DB2X_XSLT_PROCESSOR
Especifique o processador XSLT a ser usado. O efeito é o mesmo que o --xslt-processador
opção. O principal uso desta variável é permitir que você teste rapidamente diferentes
Processadores XSLT sem ter que adicionar --xslt-processador para cada script ou arquivo de criação
em seu sistema de compilação de documentação.

CONFORME TO

Linguagem de folha de estilo XML - transformações (XSLT), versão 1.0 ⟨http://www.w3.org/TR/xslt⟩
, uma recomendação do W3C.

NOTAS

Em suas versões anteriores (<0.8.4), docbook2X exigia extensões XSLT para ser executado e
db2x_xsltproc era um processador especial baseado em libxslt que tinha essas extensões compiladas.
Quando o requisito para extensões XSLT foi abandonado, db2x_xsltproc tornou-se um script Perl
que traduz as opções para db2x_xsltproc em conformidade com o formato aceito pelo
estoque xsltproc(1) que vem com libxslt.

A principal razão para a existência deste script é a compatibilidade com versões anteriores com qualquer
scripts ou criar arquivos que invocam docbook2X. No entanto, também se tornou fácil adicionar
suporte para chamar outros processadores XSLT com uma interface de linha de comando unificada. De fato,
não há nada de especial neste script para docbook2X, ou mesmo para DocBook, e pode ser
usado para executar outros tipos de folhas de estilo, se desejar. Certamente o autor prefere
usando este comando, porque seu formato de invocação é lógico e fácil de usar. (por exemplo, não
digitando nomes de classe longos para os processadores baseados em Java!)

Use db2x_xsltproc online usando serviços onworks.net