andre_ae Wed May 1 14:52:04 2002 EDT
Added files:
/phpdoc/pt_BR/appendices about.xml
Log:
initial translation
Index: phpdoc/pt_BR/appendices/about.xml
+++ phpdoc/pt_BR/appendices/about.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.11 Maintainer: andre_ae Status: ready -->
<!--
TODO: add manual conventions section (eg. how to read
function usage parts, what is fixed width, what is
bold, what is linked
add some tips about combining the versions (online-
offline), and using "http://anymirror.php.net/funcname";
-->
<appendix id="about">
<title>Sobre o manual</title>
<sect1 id="about.formats">
<title>Formatos</title>
<para>
O manual do PHP é fornecido em vários formatos. Esses formatos podem ser divididos
em dois grupos: de leitura online e em pacotes para download.
</para>
<note>
<para>
Algumas editoras tornaram disponíveis versões impressas desse manual. Nós
não podemos recomendar nenhum deles, pois eles se tornam desatualizados
rapidamente.
</para>
</note>
<para>
Você pode ler o manual online em <ulink url="&url.php;">&url.php;</ulink>
e em numerosos mirrors. Para melhor performance, escolha o
mirror localizado mais fisicamente próximo a você. Você pode visualizar o manual no
formato HTML simples ou em um formato HTML que se assemelha ao próprio
look and feel do site do PHP
</para>
<para>
A vantagem do manual online para a maioria dos formatos offline é a sua
integração com os <link linkend="about.notes">comentários
dos usuários</link>. A desvantagem óbvia é que você precisa estar online para
ler o manual.
</para>
<para>
Existem vários formatos offline do manual, e o formato mais apropriado
para você depende do seu sistema operacional de seu estilo pessoal de
leitura. Para informações de como esse manual é gerado e quais são esses
formatos, veja a seção <link linkend="about.generate">'Como nós criamos os
formatos'</link> deste apêndice.
</para>
<para>
As versões mais independentes de plataforma são o HTML e o texto simples.
O formato HTML é fornecido em um único arquivo e também como
um pacote de arquivos individuais para cada seção (o que resulta numa
coleção de vários milhares de arquivos). Os formatos HTML e texto simples
são condensados com o tar e comprimidos usando o bzip2.
</para>
<para>
Outro formato popular independente de plataforma, e que ainda fornece suporte
a impressão, é o PDF (também conhecido como Adobe Acrobat). Mas antes de você
baixar o manual neste formato e apertar o botão Imprimir, esteja avisado que o
ele tem por volta de 2000 páginas, e está sendo constantemente revisado.
</para>
<note>
<para>
Se você ainda não tem um programa capaz de visualizar arquivos PDF,
você precisará baixar o <ulink url="&url.adobe.acrobat;">Adobe
Acrobat Reader</ulink>.
</para>
</note>
<para>
For owners of Palm-compatible handhelds, the Palm document and iSilo
formats are ideal for this platform. You can bring your handheld with you
on your daily commute and use a <ulink url="&url.palm.doc;">DOC</ulink>
or <ulink url="&url.palm.isilo;">iSilo</ulink> reader to brush up on your
PHP knowledge, or just use it as a quick reference.
</para>
<para>
Para a plataforma Windows, a versão HTML Help do manual condensa os originais
no formato HTML para o uso com o HTML Help. Esse
formato tem busca de textos, índice completo e marcadores. Vários
ambientes de desenvolvimento populares do PHP em Windows se integram com
esse formato da documentação para facilitar o acesso a documentação.
</para>
<note>
<para>
O Visual Basic for Linux é um projeto em fase de planejamento, que incluirá
o desenvolvimento de um gerador e visualizador de CHMs para Linux. Acompanhe o
projeto em sua
<ulink url="&url.vb4linux;">página na SourceForge</ulink> se você estiver
interessado.
</para>
</note>
</sect1>
<sect1 id="about.notes">
<title>Sobre as notas de usuários</title>
<para>
Os comentários de usuários são uma importante presença no desenvolvimento
deste manual. Permitindo aos usuários do manual a contribuir com exemplos
e outros esclarecimentos através de seus browsers, nós podemos
incorporar esse feedback no corpo do manual. E até que as
notas sejam incorporadas, os comentários podem ser visualizados na versão
online e em alguns formatos offline.
</para>
<note>
<para>
As contribuições dos usuários não são moderadas antes da sua publicação online,
então
a qualidade desses textos e exemplos ou a veracidade e origem dessas
contribuições não pode ser garantida. (Not that there is any guarantee of
the quality or accuracy of the manual text itself.)
</para>
</note>
</sect1>
<sect1 id="about.more">
<title>Como encontrar mais informações sobre o PHP</title>
<para>
Esse manual não fornece instruções sobre práticas gerais
de programação. Se esse é seu primeiro contato, ou se ainda está iniciando em
programação, você poderá encontrar dificuldade em aprender a programar em PHP apenas
usando esse manual. Você precisa procurar textos destinados a orientar os
iniciantes. Você pode encontrar uma lista de livros relacionados ao PHP em <ulink
url="&url.php.books;">&url.php.books;</ulink>.
</para>
<para>
Há também um grande número de listas de discussão ativas para todos os aspectos da
programação com o PHP. Se você se deparar com um problema que por si só
não consegue solucionar, você poderá obter ajuda
nestas listas. Uma relação dessas listas pode ser encontrada em <ulink
url="&url.php.support;">&url.php.support;</ulink>, como também links para
os arquivos dessas listas de discussão e outras fontes de suporte online. Em
<ulink url="&url.php.links;">&url.php.links;</ulink> há uma relação de
sites com artigos, fóruns e galerias de código PHP.
</para>
</sect1>
<sect1 id="about.howtohelp">
<title>Como ajudar a melhorar a documentação</title>
<para>
Há maneiras de você contribuir a melhorar essa documentação.
</para>
<para>
Se você encontrar erros no manual, em qualquer língua, notifique-os
utilizando o rastreamento de bugs em <ulink
url="&url.php.bugs;">&url.php.bugs;</ulink>.
Classifique o problema com um "Documentation Problem". Você também pode submeter
problemas
específicos dos formatos do manual nesse endereço.
</para>
<note>
<para>
Por favor, não abuse do rastreamento de bugs para solicitar ajuda. Use as
listas de discussão ou as comunidades mencionadas anteriormente.
</para>
</note>
<para>
Você pode também contribuir com comentários, fornecendo exemplos adicionais,
caveats e
esclarecimentos para outros leitores. Mas não envie notificações de bugs usando o
sistema de comentários. Você pode ler mais sobre os comentários na seção <link
linkend="about.notes">'Sobre os comentários de usuários'</link> deste
apêndice.
</para>
</sect1>
<sect1 id="about.generate">
<title>Como nós geramos os formatos</title>
<para>
Este manual é escrito em <acronym>XML</acronym>, utilizando o <ulink
url="&url.docbook.xml;">DocBook XML DTD</ulink> e usando <ulink
url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
Style and Semantics Specification Language) para formatação.
Experimentalmente <ulink url="&url.xslt;"><acronym>XSLT</acronym>
</ulink> (Extensible Stylesheet Language Transformations)
para manutenção e formatação.
</para>
<para>
Utilizando <acronym>XML</acronym> como meta dado nos
permite gerar vários outros formatos a partir dos arquivos
fonte, ao mesmo tempo que a manutenção é feita em um único lugar para todas as
versões.
As ferramentas utilizadas para criar as versões <acronym>HTML</acronym> e
<acronym>TeX</acronym> são o
<ulink url="&url.jade;">Jade</ulink>, escrito por <ulink
url="&url.jclark;">James Clark</ulink>, e <ulink
url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>,
escrito por <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
Nós utilizamos o <ulink url="&url.winhelp;">Microsoft HTML Help
Workshop</ulink> para criar o formato HTML Help
e, é claro, o próprio PHP para fazer algumas
conversões adicionais.
</para>
<para>
Você pode obter o manual em várias línguas e
formatos, incluindo texto simples, <acronym>HTML</acronym>,
<acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo e
Windows HTML Help, a partir do
<ulink url="&url.php.docs;">&url.php.docs;</ulink>.
Os manuais são automaticamente atualizados quando da alteração dos fontes.
</para>
<para>
Para maiores informações sobre como obter os fontes
<acronym>XML</acronym> desta documentação,
veja em <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. A
documentação é guardada no módulo <literal>phpdoc</literal>.
</para>
</sect1>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
