docbook-2-pdf - Online na nuvem

PROGRAMA:

NOME

sgml2x - Formata facilmente documentos SGML / XML usando folhas de estilo DSSSL

SINOPSE

sgml2x [opções] [arquivo sgml | arquivo xml ]

docclass-2-formato de destino [opções] [arquivo sgml | arquivo xml ]

Descrição

sgml2x permite formatar facilmente um documento SGML ou XML usando folhas de estilo DSSSL, e
fornece os seguintes recursos:

· Múltiplas folhas de estilo possíveis por classe de documento

· Fácil especificação de folhas de estilo usando aliases, com suporte para parâmetro
herança

· Fácil integração de novas folhas de estilo, adicionando um novo arquivo de definição simples em um
diretório de configuração

· O chamador pode especificar uma lista de diretórios de configuração do tipo PATH, padronizando para
um diretório de configuração de todo o sistema, por usuário e por projeto

· Seleção automática de uma folha de estilo padrão a ser usada, com base na atribuição
prioridades

· Passe opções arbitrárias para jade(1)

A classe de documento usada para procurar as folhas de estilo e o formato de saída é por agora
derivado apenas do nome com o qual o programa é chamado, então você vai querer chamá-lo
programa através de links simbólicos como docbook-2-pdf.

sgml2x é implementado como um invólucro de shell em torno jade(1) (ou, de preferência, jade aberto(1),
embora usemos o nome genérico jade ao longo desta documentação), jadetex(1) e outro
ferramentas.

Se não há jadetex.cfg arquivo próximo ao documento, um padrão é copiado, o que permite
produção de favoritos em PDF.

Opções

-c|--Catálogo catálogo
Use o catálogo SGML especificado em vez do padrão do sistema.

-C|--confdirs lista de dir
Use uma lista (separada por espaços em branco) de diretórios de configuração. Esta opção é
cumulativo, ou seja, você pode usar vários -C opções e as listas serão
concatenado.

Os elementos da lista devem ser ordenados da configuração mais genérica (por exemplo, em todo o sistema)
para o mais específico (por exemplo, em todo o projeto).

Se qualquer diretório for fornecido por meio desta opção, a lista de diretórios padrão será
ignorado.

-D|--dssslproc processador dsssl
Use processador dsssl para aplicar a folha de estilo, em vez da padrão. Esse
o processador tem que suportar jade-como opções, como -V.

Quando esta opção não está presente, a primeira encontrada no dsslproc arquivos de confdirs são
ocupado. Ver "Arquivos" para mais detalhes.

-h|--Socorro Exiba uma mensagem de ajuda e saia.

-j|--jade processador dsssl
Sinônimo obsoleto para --dssslproc.

--jadetexfilter filtro perl
Pós-processe a saída do jadetex usando um filtro perl.

Isso pode ser útil para forçar quebras de página em alguns lugares específicos para superar a folha de estilo
problemas, ou para forçar hifenizações onde TeX não tem padrões suficientes, ou faz qualquer
outra transformação inteligente em que você pensaria.

veja a exemplos / linhas de comando arquivo para possíveis usos.

-n|- no-act
Comandos de impressão em vez de executá-los. Útil para aprender sobre o nível inferior
ferramentas e para depurar a linha de comando.

-o|--openjade
Esta opção is obsoleto. jade aberto agora é o padrão quando disponível. Usar
--dssslproc ou um dsslproc arquivo de configuração para forçar um processador específico.

Esta opção costumava usar jade aberto(1) como um processador DSSSL em vez de jade(1).

-O|--jadeopts opções de jade
Opções adicionais para passar para jade(1). Esta opção é cumulativa, você pode
especificar vários deles, as opções fornecidas serão concatenadas.

-q|--quieto
Definir verbosidade para calma

-r|- observações
Renderizar o conteúdo das observações do documento no documento (comentário elementos em
Documento 4, comentar elementos no DocBook 3), tornando a saída produzida um
somente para uso interno documento, imprimindo um aviso em negrito na capa.

Este é um recurso específico de docclass e de folha de estilo, e nem todas as folhas de estilo usarão
esta.

-s|--estilo estilo
Selecione um estilo de saída para substituir o padrão (eventualmente derivado do documento).

Os estilos atualmente disponíveis para uma classe de documento específica e para cada formato de saída são
depende do conteúdo dos diretórios de configuração e pode ser exibido com o
--Socorro opção.

Observe que é uma boa prática especificar esta opção em um procedimento de construção, para que você obtenha
resultados reproduzíveis independentemente das folhas de estilo disponíveis.

-v|--verbose
Aumente a verbosidade. Esta opção pode ser especificada várias vezes.

--verbosidade N
Definir verbosidade para N. Os níveis de verbosidade são definidos da seguinte forma:

calma Apenas erros de impressão

omissão Imprimir apenas erros e avisos

detalhado Também imprimir avisos

traçar Também imprime comandos significativos à medida que são executados (como - no-act faz).

depurar Também imprime mensagens de depuração

-V|--versão
Imprima a versão do programa e saia.

Configuração

sgml2x usa uma árvore de diretório de configuração em vez de um arquivo de configuração, para que seja
fácil para outros pacotes se conectarem com baixo risco de quebrar uma configuração existente.

Hierarquias de estilos estão localizadas em diretórios denominados estilos em cada configuração
diretório. Versões antigas deste programa costumavam colocar essas hierarquias diretamente no
diretórios de configuração.

Um diretório de configuração contém um diretório para cada classe de documento conhecida, nomeado com
um apelido de classe de documento (por exemplo livro de documentos) Esses diretórios docclass contêm um sub-
diretório para cada classe de formato de saída (atualmente, apenas html e impressão são suportados).

Atualmente, os problemas de implementação impõem uma limitação de apelidos para classes de documentos
e folhas de estilo: eles podem conter apenas caracteres alfanuméricos e sublinhados. Esse
limitação pode ser eliminada em uma versão futura, mas isso não vai acontecer antes deste
o script é reescrito em outro idioma.

Cada um desses diretórios contém um arquivo por estilo disponível. Os nomes desses arquivos
pode conter apenas caracteres alfanuméricos e são usados ​​como apelidos para os estilos. Esse
arquivo contém linhas com um chave: valor padrão, com as seguintes chaves sendo atualmente
suportado:

Id O identificador público para a folha de estilo

Desc Uma breve descrição dos estilos, a serem exibidos na mensagem de ajuda

pdfSubstituir, psSubstituir,
rtfSubstituir, mifSubstituir"10 Um símbolo dsssl da folha de estilo de impressão a ser definido
para #t (ou um símbolo=valor par, adequado como argumento para jade's -V opção),
a ser usado para o formato de impressão fornecido.

Apenas um símbolo por linha de sobreposição é permitido. Para definir valores para vários símbolos, use
várias linhas.

Herda O apelido de uma folha de estilo da qual este herda, para evitar
duplicação de definições de estilo.

Atualmente, isso só causa a herança do *Sobrepor parâmetros.

Prioridade Um número inteiro positivo para ajudar a selecionar o estilo padrão quando um não pode ser
derivados do documento. Valores mais altos têm maior chance de serem considerados
predefinição. Tome cuidado ao usar baixas prioridades para estilos hiperespecializados para um
tipo de documento genérico, para que não seja usado por erro.

Por exemplo, a política atual recomendada para as folhas de estilo DocBook derivadas de
O de Norman Walsh é o seguinte (e pode mudar se a experiência provar que é inadequado).

10 As folhas de estilo básicas, que geralmente devem ser personalizadas.

0 Qualquer folha de estilo que foi escrita para uma finalidade hiperespecializada (por exemplo
ficha de produto de marketing).

1000 Um estilo padrão para todos os documentos produzidos por uma organização. Normalmente um
customização de luz, apresentando preferências de layout, a organização
logotipo, ou coisas assim.

10-100 Personalizações genéricas diversas das folhas de estilo básicas.

Quando você escreve uma versão melhorada de uma folha de estilo com prioridade n, tu
geralmente deseja selecionar uma prioridade mais alta.

Arquivos

/ etc / sgml / sgml2x /

~ / .sgml2x /

./sgml2x/ Os diretórios de configuração padrão, nos quais os arquivos de configuração são
procurou por. Veja a documentação para --confdirs para mais detalhes.

confdir/estilo/
A hierarquia que define os estilos utilizáveis. Ver "Configuração" para mais
Detalhes.

confdir/ dssslproc
Um arquivo contendo uma lista ordenada de processadores dsssl a serem procurados, separados por
novas linhas e / ou espaços em branco. Linhas começando com um # personagem são tratados como
comentários. Os valores comuns incluem jade aberto e jade.

Os processadores DSSSL especificados aqui devem aceitar o -V e -D compatível com jade
opções de linha de comando.

Os diretórios de configuração são procurados começando pelo mais específico
um, de modo que, com os confdirs padrão, as configurações do projeto podem substituir o usuário
configurações, que por sua vez podem substituir as configurações do sistema.

O valor especial falso pode ser usado para interromper a pesquisa e evitar olhar para
diretórios mais genéricos. Se, por exemplo, um projeto deve usar o
openjade-1.4devel comando e nenhum outro, ele pode especificar openjade-1.4devel falso
na sua dsslproc arquivo.

Advertências

Ao usar openjade-1.4devel como processador DSSSL, você verá uma reclamação sobre o
objeto de fluxo de nível gerado por doctype.dsl, e determinação automática do documento
tipo irá falhar. De outra forma, esse erro é inofensivo. Idéias de como lidar com isso, ou
confirmação de que openjade-1.4devel é muito rigoroso, será apreciado :)

A futuro

Os recursos planejados para versões futuras incluem:

· Integração de um gerador de índice

· Integração de um mecanismo de impressão bonita para exemplos de código

· Especificação das transformações a serem encadeadas

· Declaração de subconjunto docclasses para permitir o uso com qualquer docclass do estilo-
planilhas que se aplicam a seus docclasses de superconjunto.

· Trabalhe em um local temporário, de modo a não poluir o diretório de trabalho com
arquivos temporários. Isso não é tão fácil quanto parece, porque quebra um documento
refere-se a arquivos de imagem usando caminhos relativos. Isso pode ser visto como um bug de jade,
no entanto.

Navegue pela lista TODO completa e envie-nos mais ideias!

Direitos de Autor

Copyright © 2001-2003 Alcove & Yann Dirson.

sgml2x está licenciado pela GNU General Public License, versão 2.

Esta documentação está licenciada pela GNU Free Documentation License, versão 1.

Contato us

sgml2x faz parte do AlcovaLivro projeto (ligação para URL http://www.alcove-
labs.org/en/software/alcovebook/) . Por favor use o AlcovaLivro correspondência listas (ligação para URL
https://savannah.gnu.org/mail/?group_id=533) para entrar em contato com desenvolvedores e usuários.

A lista de bugs e solicitações de recursos está disponível NFT`s a Web interface (ligação para URL
https://savannah.gnu.org/support/?group_id=533) . Use-o para enviar problemas e
idéias.

See tb

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

sgml2x(1)

Use docbook-2-pdf online usando serviços onworks.net