Linux repositories inspector
Plataformas do KDE Plataformas
2014-05-08

kdoctools

various tools for accessing application documentation

kdoctools5

Tools to generate documentation in various formats from DocBook

kf5-kdoctools

KDE Frameworks 5 Tier 2 addon for generating documentation

kdoctools-lang

Translations for package kdoctools

kdoctools-git

Documentation generation from docbook

NOME

meinproc5 - Tradutor do KDE para XML

SINTAXE

meinproc5 [-h, --help] [-v, --version] [--cache ficheiro] [--check] [--srcdir pasta] [--param chave=valor] [[[-o] | [--output]] ficheiro] [--stdout] [--stylesheet xsl] ficheiro-docbook

DESCRI\(,C\(~AO

O meinproc5 converte ficheiros DocBook para HTML.

OP\(,C\(~OES GEN\(’ERICAS

-h--help
Mostra a ajuda acerca das op\(,c\(~oes.
-v--version
Mostra a vers\(~ao.

OP\(,C\(~OES DA APLICA\(,C\(~AO

--cache ficheiro
Criar um ficheiro de cache para o documento
--check
Verificar a validade do documento
O resultado poder\(’a ser bastante exaustivo, dado que um pequeno erro poder\(’a gerar uma enorme cascata de erros.
O truque \(’e olhar para o primeiro erro, corrigi-lo, gravar o ficheiro e executar o meinproc5 de novo.
-o, --output ficheiro
Envia o documento inteiro para o ficheiro.
--stdout
Envia todo o documento para o stdout (ecr\(~a).
--stylesheet xsl
A folha de estilo a usar
--srcdir pasta
Configure a pasta de topo onde procurar as kdoctools
--param chave=valor
Define os par\(^ametros a passar \(‘a folha de estilo.

UTILIZA\(,C\(~AO

A forma mais comum de executar o meinproc5 \(’e t\(~ao simples como
meinproc5 ficheiro-docbook

, onde o ficheiro-docbook \(’e normalmente index.docbook. Este comando cria p\(’aginas HTML a partir do ficheiro DocBook. Lembre-se que estas p\(’aginas s\(’o s\(~ao vis\(’iveis em navegadores baseados no KDE (como o Konqueror).
Se precisar de ver o resultado em HTML noutro navegador (por exemplo, se o quiser p\(^or online), use
meinproc5 --stylesheet nome-folha-estilo ficheiro-docbook

, onde o nome-folha-estilo \(&#146;e a localiza\(,c\(~ao completa de uma das folhas de estilo em <prefixo_instala\(,c\(~ao_kdoctools>/share/apps/ksgmltools/customization. Para produzir um resultado adequado para a Web, poder\(&#146;a usar o kde-web.xsl ou o kde-chunk-online.xsl. Veja o ficheiro README dessa pasta para mais detalhes.

VEJA TAMB\(’EM

PROBLEMAS

Existem provavelmente diversos erros. Use o \m[blue]sistema de gest\(~ao de erros do KDE\m[][1] para os comunicar.

NOTAS

1. sistema de gest\(~ao de erros do KDE http://bugs.kde.org
⇧ Top