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
-->
