xmlto - Online na nuvem

PROGRAMA:

NOME

xmlto - aplica uma folha de estilo XSL a um documento XML

SINOPSE

xmlto [-o diretório_saída] [-x custom_xsl] [-m xsl_fragmento] [-v] [-p postprocessor_opts]
[--extensões] [--caminho de pesquisa caminho] [--skip-validação]
[--stringparam nome do parâmetro=valor de parâmetro] [--noclean] [--noautosize] [--noextensions]
[--perfil] [--com-fop] [--com-dblatex] {formato} {lima}

xmlto {[--ajuda] | [--versão]}

DESCRIÇÃO

A finalidade do xmlto é converter um XML lima para o desejado formato usando quaisquer meios
necessário. Isso pode envolver duas etapas:

1. A aplicação de uma folha de estilo XSL apropriada usando um processador XSL-T.

2. Processamento posterior com outras ferramentas. Esta etapa pode não ser necessária.

Para decidir qual folha de estilo usar e o que, se houver, precisa ser feito para pós-processar o
resultado, xmlto faz uso de scripts de formato, que são scripts de shell simples que xmlto chamadas
durante a conversão.

O script de formato apropriado é selecionado com base no tipo de arquivo XML e o formato desejado
Formato de saída. xmlto vem com alguns scripts de formato para converter arquivos DocBook XML em um
variedade de formatos. Você pode especificar seu próprio formato de script usando um nome de arquivo absoluto
para formato na linha de comando.

Em primeiro lugar, se xmlto não foi informado explicitamente qual folha de estilo usar (com o -x
opção), o script de formato será chamado com $1 definido como folha de estilo. O ambiente
variável XSLT_PROCESSOR contém o nome base do executável que será usado para
execute a transformação XSL-T (por exemplo xsltproc). O script de formato deve escrever
o nome da folha de estilo para usar como saída padrão e sair com sucesso ou sair com um
código de retorno diferente de zero se não houver folha de estilo apropriada para usar (por exemplo, se o
apenas a folha de estilo disponível não funciona com o processador XSL-T que será
usado). Se nada for gravado na saída padrão, mas o script for encerrado com sucesso, não
A transformação XSL-T será executada.

Em segundo lugar, depois que um processador XSL-T foi executado usando a folha de estilo, o script de formato
será chamado novamente, desta vez com $1 definido para pós-processamento. O script de formato deve
execute todas as etapas necessárias para converter a saída processada de XSL-T para o desejado
formato de saída, incluindo a cópia da saída para o diretório de saída desejado. Para
pós-processamento, o script de formato é executado em um diretório temporário contendo apenas o
saída processada (cujo nome é armazenado em XSLT_PROCESSED e cujo nome base é o do
arquivo XML original com qualquer extensão de nome de arquivo substituída por .proc). ARQUIVO DE ENTRADA está definido para
o nome do arquivo XML original, SAÍDA_DIR é definido com o nome do diretório que o
saída (e apenas a saída) deve terminar em, e CAMINHO DE PESQUISA é definido como um dois pontos separados
lista de diretórios de fallback nos quais procurar entrada (para imagens, por exemplo). Se este
a etapa não teve êxito, o script de formato deve sair com um código de retorno diferente de zero.

OPÇÕES

-v
Seja prolixo (-vv para muito detalhado).

-x folha de estilo
Use folha de estilo em vez de pedir ao script de formato para escolher um.

-m fragmento
Use o XSL fornecido fragmento para modificar a folha de estilo.

-o anuário
Coloque a saída no especificado anuário em vez do diretório de trabalho atual.

-p postprocessor_opts
Passar postprocessor_opts para as etapas de processamento após a aplicação da folha de estilo (por exemplo, lynx
ou links ao passar de HTML para texto, ou xmltex ao passar de TeX para
DVI). Se -p é especificado uma segunda vez, as opções especificadas serão passadas para
pós-processamento de segundo estágio; atualmente, isso só é aplicável ao passar por
xmltex e dvips para PostScript.

--extensões
Ative as extensões da folha de estilo para a cadeia de ferramentas em uso (use.extensões está ligado).
As variáveis ​​ativadas são aquelas usadas pelas folhas de estilo DocBook XSL de Norman Walsh.

--caminho de pesquisa caminho
Adicione a lista de diretórios separada por dois pontos em caminho como diretórios alternativos para
incluindo entrada.

--skip-validação
Pule a etapa de validação que normalmente é executada.

--stringparam nome do parâmetro=valor de parâmetro
Passe um parâmetro nomeado nome do parâmetro com valor valor de parâmetro para a folha de estilo a partir do comando
linha.

--noclean
Os arquivos temporários não são excluídos (seus nomes são exibidos e mantidos no diretório tmp). Isto
pode ajudar a analisar problemas.

--noautosize
Por padrão, algumas variáveis ​​XSL são substituídas pela autodetecção (largura da página e
página.altura para uso de paperconf (libpaper), tipo de papel para com base na localidade (LC_PAPER)
seleção). Com esta opção, xmlto não usa esta detecção automática e o usuário é capaz de
modificar os padrões por si mesmo (por meio da modificação do param.xsl padrão ou por definição do usuário
Fragmento XSL).

--noextensions
Por padrão, o xmlto habilita parâmetros XSL passivatex.extensions para passivetex backend e
fop.extensões e fop1.extensões para fop backend. Isso geralmente produz melhor
resultados. Se você por algum motivo não quiser usar esses parâmetros, basta desabilitá-los
usando esta opção.

--perfil
Pré-processe o documento XML com a folha de estilo de criação de perfil.

--com-fop
Use fop para formatar. É uma opção experimental, espera fop em específico
local (detectado no tempo configurado), pode ser alterado manualmente em xmlto roteiro de
modificação de FOP_PATH

--com-dblatex
Use dblatex para formatação. É uma opção experimental, espera dblatex em específico
local (detectado no tempo configurado), pode ser alterado manualmente em xmlto roteiro de
modificação de DBLATEX_PATH

--Socorro
Exibe uma mensagem curta de uso. Ele descreverá as opções do xmlto e os
formatos de saída.

--versão
Exibe o número da versão do xmlto.

MEIO AMBIENTE

XSLT_PROCESSOR
Nome base do executável que será usado para realizar a transformação XSL-T
(padrão: xsltproc(1)).

TMPDIR
Diretório, onde criar folhas de estilo temporárias (padrão: / Tmp).

DIAGNÓSTICO

0
Correu tudo bem. Este é o código de saída esperado.

1
xmlto foi chamado com argumentos insuficientes.

2
mktemp(1) falha ao criar um arquivo / diretório. Certificar-se de que / Tmp or TMPDIR é gravável.

3
xmlto falhou em encontrar algum binário no local configurado. Certifique-se de que tudo é necessário
os pacotes são instalados e os caminhos no script xmlto são definidos corretamente.

10+ (validação diferente de zero erro código)
xmlto tentou validar um documento xml, mas a validação falhou. Para um melhor diagnóstico,
saída de validação e código de saída xmllint são fornecidos. Considere consertar seu
documento ou usando --skip-validação.

EXEMPLOS

Para converter um documento DocBook XML em PDF, use:

xmlto pdf meudoc.xml

Para converter um documento DocBook XML em HTML e armazenar os arquivos HTML resultantes em um
uso do diretório:

xmlto -o html-dir html meudoc.xml

Para converter um documento DocBook XML em um único arquivo HTML, use:

xmlto html-nochunks meudoc.xml

Para modificar a saída usando um fragmento XSL, use:

xmlto -m ulink.xsl pdf meudoc.xml

Para especificar qual folha de estilo usar (sobrescrevendo aquela que o script de formato iria
escolha) use:

xmlto -x minhafolhadeestilo.xsl pdf meudoc.xml

AUTORES

Tim rir <[email protegido]>
Autor original, mantenedor até 0.0.18

Ondrej Vasík <[email protegido]>
Mantido desde 0.0.19

DIREITOS AUTORAIS

Use xmlto online usando serviços onworks.net