<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY % Portuguese "INCLUDE"
><!-- change language only here -->
]>

<refentry>

<refentryinfo>
<title
>Manual do Utilizador do &kde;</title>
<date
>2008-10-03</date
> <releaseinfo
>0.01.01</releaseinfo
> </refentryinfo>

<refmeta>
<refentrytitle
><command
>meinproc4</command
></refentrytitle>
<manvolnum
>8</manvolnum>
</refmeta>

<refnamediv>
<refname
><command
>meinproc4</command
></refname>
<refpurpose
>Tradutor do &kde; para XML</refpurpose>
</refnamediv>

<refsynopsisdiv>
<title
>Sintaxe</title>

<cmdsynopsis
><command
>meinproc4</command
> <arg choice="opt"
>--help</arg
> <arg choice="opt"
>Opções-genéricas</arg
> <arg choice="opt"
>opções-do-Qt</arg
> <arg choice="opt"
>opções-do-KDE</arg
> <arg choice="opt"
>--cache<replaceable
> ficheiro</replaceable
></arg
> <arg choice="opt"
>--check</arg
> <arg choice="opt"
>--htdig</arg
> <arg choice="opt"
>--srcdir</arg
> <arg choice="opt"
>--param <replaceable
>chave</replaceable
>=<replaceable
>valor</replaceable
></arg
> <group
> <group
> <arg
>-o</arg
> <arg
>--output</arg
> </group
> <replaceable
> ficheiro</replaceable
> </group
> <arg choice="opt"
>--stdout</arg
> <arg choice="opt"
>--stylesheet<replaceable
> xsl</replaceable
></arg
> <arg choice="plain"
>ficheiro-docbook</arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>O <command
>meinproc4</command
> converte ficheiros DocBook para HTML. </para>
</refsect1>

<refsect1>
<title
>Opções genéricas</title>
<para>
<variablelist>

<varlistentry>
<term
><option
>--author</option
></term>
<listitem>
<para
>Mostra informações sobre o autor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--help</option
></term>
<listitem>
<para
>Mostra a ajuda acerca das opções. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--help-all</option
></term>
<listitem>
<para
>Mostra todas as opções. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--help-kde</option
></term>
<listitem>
<para
>Mostra opções específicas do KDE. </para>


</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--help-qt</option
></term>
<listitem>
<para
>Mostra as opções específicas do Qt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--license</option
></term>
<listitem>
<para
>Mostra informações acerca da licença. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-v</option
><option
>--version</option
></term>
<listitem>
<para
>Mostra a versão. </para>
</listitem>
</varlistentry>

</variablelist>
</para>
</refsect1>

<refsect1>
<title
>Opções da Aplicação</title>
<variablelist>

<varlistentry>
<term
><option
>--cache</option
> <parameter
>ficheiro</parameter
></term>
<listitem>
<para
>Criar um ficheiro de 'cache' para o documento </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--check</option
></term>
<listitem>
<para
>Verificar a validade do documento</para>
<screen
>O resultado poderá ser bastante exaustivo, dado que um pequeno erro poderá gerar uma enorme cascata de erros.
O truque é olhar para o primeiro erro, corrigi-lo, gravar o ficheiro e executar o <command
>meinproc4</command
> de novo.
</screen>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--htdig</option
></term>
<listitem>
<para
>Criar um índice compatível com o ht://dig</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-o</option
>, <option
>--output</option
><parameter
> ficheiro</parameter
></term>
<listitem>
<para
>Envia o documento inteiro para o <parameter
>ficheiro</parameter
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stdout</option
></term>
<listitem>
<para
>Envia todo o documento para o 'stdout' (ecrã). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stylesheet</option
> <parameter
>xsl</parameter
></term>
<listitem>
<para
>A folha de estilo a usar </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--srcdir</option
> <parameter
>pasta</parameter
></term>
<listitem>
<para
>Configure a pasta de topo onde procurar as 'kdelibs' </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--param</option
> chave=valor</term>
<listitem>
<para
>Define os parâmetros a passar à folha de estilo. </para>
</listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>
<title
>Utilização</title>
<para
>A forma mais comum de executar o <command
>meinproc4</command
> é tão simples como <literallayout>
<userinput
><command
>meinproc4</command
> <replaceable
>ficheiro-docbook</replaceable>
</userinput>
</literallayout
>, onde o <replaceable
>ficheiro-docbook</replaceable
> é normalmente 'index.docbook'. Este comando cria páginas HTML a partir do ficheiro DocBook. Lembre-se que estas páginas só são visíveis em navegadores baseados no KDE (como o Konqueror). </para>
<para
>Se precisar de ver o resultado em HTML noutro navegador (por exemplo, se o quiser pôr 'online'), use <literallayout>
<userinput
><command
>meinproc4</command
> --stylesheet <replaceable
>nome-folha-estilo</replaceable
> <replaceable
>ficheiro-docbook</replaceable>
</userinput>
</literallayout
>, onde o <replaceable
>nome-folha-estilo</replaceable
> é a localização completa de uma das folhas de estilo em $KDEDIR/share/apps/ksgmltools/customization. Para produzir um resultado adequado para a Web, poderá usar o <command
>kde-web.xsl</command
> ou o <command
>kde-chunk-online.xsl</command
>. Veja o ficheiro README dessa pasta para mais detalhes. </para>

</refsect1>

<refsect1>
<title
>Veja Também</title>
<para
><replaceable
>opções-do-kde</replaceable
>(7), <replaceable
>opções-do-qt</replaceable
>(7)</para>
</refsect1>

<refsect1>
<title
>Problemas</title>
<para
>Existem provavelmente bastantes erros. Use o <ulink url="http://bugs.kde.org"
>bugs.kde.org</ulink
> para os comunicar.</para>
</refsect1>

</refentry>



