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

<refentry lang="&language;">

<refentryinfo>
<title
>Manual do Utilizador do 'meinproc5'</title>
<!-- There is no author in the meinproc.cpp file 
Also, based on the information from http://olympus.het.brown.edu/cgi-bin/man/man2html?meinproc+1

<author>
<firstname
>Matthias </firstname>
<surname
>Hoelzer-Kluepfel</surname>
<affiliation>
<address
><email
>hoelzer@kde.org</email
></address>
</affiliation>
</author>

<author>
<firstname
>Stephan</firstname>
<surname
>Kulow</surname>
<affiliation>
<address
><email
>coolo@kde.org</email
></address>
</affiliation>
</author>

<author>
<firstname
>Cornelius</firstname>
<surname
>Schumacher</surname>
<affiliation>
<address
><email
>schumacher@kde.org</email
></address>
</affiliation>
</author>
-->
<date
>2014-05-08</date>
<releaseinfo
>Plataformas 5.0</releaseinfo>
<productname
>Plataformas do KDE</productname>

</refentryinfo>

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

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

<refsynopsisdiv>
<title
>Sintaxe</title>

<cmdsynopsis
><command
>meinproc5</command
> <arg choice="opt"
>-h, --help</arg
> <arg choice="opt"
>-v, --version</arg
> <arg choice="opt"
>--cache<replaceable
> ficheiro</replaceable
></arg
> <arg choice="opt"
>--check</arg
> <arg choice="opt"
>--srcdir<replaceable
> pasta</replaceable
></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
>meinproc5</command
> converte ficheiros DocBook para HTML. </para>
</refsect1>

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

<varlistentry>
  <term
><option
>-h</option
><option
>--help</option
></term>
<listitem>
<para
>Mostra a ajuda acerca das opções. </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
>meinproc5</command
> de novo.
</screen>
</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 'kdoctools' </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
>meinproc5</command
> é tão simples como <literallayout>
<userinput
><command
>meinproc5</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
>meinproc5</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 &lt;prefixo_instalação_kdoctools&gt;/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
>kf5options</replaceable
>(7), <replaceable
>qt5options</replaceable
>(7)</para>
</refsect1>

<refsect1>
<title
>Problemas</title>
<para
>Existem provavelmente diversos erros. Use o <ulink url="http://bugs.kde.org"
>sistema de gestão de erros do KDE</ulink
> para os comunicar.</para>
</refsect1>

</refentry>



