= Python Doc =
Projeto de tradução da [[http://www.python.org/doc/|documentação oficial]] do Python para o português.
||Coordenador ||PedroWerneck ||
||Tradutores ||AlexandreNalon, FelipeLessa, OsvaldoSantanaNeto, RafaelAlmeida, RenataPalazzo, RodrigoSenra, PedroDeMedeiros ||
||Revisores ||PedroWerneck, OsvaldoSantanaNeto ||
||Página do Projeto ||http://www.codigolivre.org.br/projects/pythondoc/ ||




/!\ Uma prévia da tradução da referência e do tutorial estão disponíveis aqui em formato pdf A4 (o problema da codificação na referência já foi corrigido).  [[attachment:ref.pdf]] [[attachment:tut.pdf]].

<<TableOfContents>>

== Inscrição no Projeto ==
 * Inscreva-se no http://www.codigolivre.org.br

 * Entre em contato com o coordenador do projeto em pedro.werneck@terra.com.br informando seu nome de usuário, disponibilidade de horas semanais e função (tradutor e/ou revisor, discriminando entre revisão semântica e revisão gramatical, se for o caso)

 * Assine a lista de discussão em: http://server.codigolivre.org.br/mailman/listinfo/pythondoc-dev

== Obtendo os Arquivos do Projeto ==
{{{
cvs -d:pserver:USUARIO@cvs.pythondoc.codigolivre.org.br:/home/cvsroot login
}}}
 * Se esta for a primeira vez que você estiver entrando, baixe os arquivos:

{{{
cvs -d:pserver:USUARIO@cvs.pythondoc.codigolivre.org.br:/home/cvsroot co pythondoc
}}}
 * Sincronize seus arquivos locais com o repositório:

{{{
cvs -d:pserver:USUARIO@cvs.pythondoc.codigolivre.org.br:/home/cvsroot update
}}}
 * Enviar suas correções/alterações para o repositório (para executar esta operação é necessário estar dentro do diretório {{{pythondoc}}}):

{{{
cvs -d:pserver:USUARIO@cvs.pythondoc.codigolivre.org.br:/home/cvsroot commit NOMEDOARQUIVO
}}}
 * Desconectar do repositório:

{{{
cvs -d:pserver:USUARIO@cvs.pythondoc.codigolivre.org.br:/home/cvsroot logout
}}}
== Lista de Discussão ==
Os arquivos da lista de discussão do projeto encontram-se em: http://codigolivre.org.br/pipermail/pythondoc-brasil/

== Dicionário de Termos ==
O dicionário com as traduções de termos técnicos encontra-se em [[Dicionario]] e no arquivo DICIONARIO do código fonte da documentação.

== Nomes dos Manuais Traduzidos ==
||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Nomes dos Manuais''' ||
||'''Diretório''' ||'''Título Original''' ||'''Título Traduzido''' ||
||api ||Python/C API Reference Manual ||Manual de Referência da API Python/C ||
||ext ||Extending and Embedding the Python Interpreter ||Estendendo e Embutindo o Interpretador Python ||
||lib ||Python Library Reference ||Referência da Biblioteca Python ||
||ref ||Python Reference Manual ||Manual de Referência Python ||
||tut ||Python Tutorial ||Tutorial Python ||
||||||<style="text-align: center;">* Falta a definição dos outros títulos ||


== Arquivos ==
Ao começar a trabalhar na tradução de um arquivo, siga os seguintes passos:

 * Adicione o nome do arquivo no campo '''Arquivo''' da tabela, caso ele ainda não exista;

 * Altere a cor do campo '''Status''' para amarelo (FFFF80) e mantenha-o atualizado com a sua tradução;

 * Coloque seu nome (''wikiname'', apontando para sua página no PythonBrasil) no campo '''Responsável''';

 * Altere a cor do campo '''Início''' para amarelo (FFFF80) e coloque a data do início da tradução no formato dd/mm/aaaa;

 * Altere a cor do campo '''Entrega Prevista:''' para amarelo (FFFF80) e coloque uma estimativa da data em que você acredita que o arquivo estará pronto.

Quando terminar a tradução de um arquivo, siga os seguintes passos:

 * Altere a cor do campo '''Status''' para verde (80FF80) e seu valor para 100%;

 * Altere a cor dos campos '''Início''' e '''Entrega Prevista''' para verde (80FF80). Substitua a data do campo '''Entrega Prevista''' pelo ícone {{{(./)}}};

Ao começar a trabalhar na revisão de um arquivo, siga os seguintes passos:

 * Adicione o nome do arquivo no campo '''Arquivo''' da tabela, caso ele ainda não exista;

 * Altere a cor do campo '''Status''' da revisão sendo realizada (semântica ou gramatical) para amarelo (FFFF80) e mantenha-o atualizado com a sua tradução;

 * Coloque seu nome (''wikiname'', apontando para sua página no PythonBrasil) no campo '''Responsável''' apropriado.

/!\ Cuidado para não alterar a formatação das tabelas durante a edição.

=== Prioridades ===
{1} Revisão dos arquivos do ''Manual de Referência Python'' e do ''Tutorial Python''

{2} Tradução da ''Referência da Biblioteca Python''

==== Tradução ====
XXXX

==== Revisão Semântica ====
Pede-se aos revisores tomar um cuidado especial com os seguintes detalhes:

 * Coerência dos termos traduzidos com os termos presentes no arquivo DICIONARIO.

 * Se possível, revisar o arquivo acompanhando o arquivo original. [[attachment:pythondoc_original.tar.gz]]

 * O código Tex. Por exemplo, apenas os títulos de seções são traduzidos, não suas referências (por isso é importante ter o original por perto).

 * Termos em inglês. Termos em inglês usados corriqueiramente (como "string") devem acompanhar sua tradução entre parênteses na primeira aparição no arquivo. Termos usados esporadicamente devem estar enfatizados (usando \emph{termo}).

 * Termos em inglês cuja tradução em português soe estranha ou muito fora do comum para programadores experientes devem vir acompanhados na primeira aparição no arquivo do original enfatizado e entre colchetes, por exemplo: compreensão de lista [\emph{list comprehension}].

==== Revisão Gramatical ====
XXXX

=== Manual de Referência Python ===
||||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Tradução''' ||
||'''Arquivo''' ||'''Status''' ||'''Responsável''' ||'''Início''' ||'''Entrega Prevista:''' ||
||ref/ref.tex ||<#80ff80>100% ||OsvaldoSantanaNeto ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref1.tex ||<#80ff80>100% ||OsvaldoSantanaNeto ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref2.tex ||<#80ff80>100% ||PedroWerneck ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref3.tex ||<#80ff80>100% ||JoaoPauloSilva ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref4.tex ||<#80ff80>100% ||RafaelAlmeida ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref5.tex ||<#80ff80>100% ||RenataPalazzo ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref6.tex ||<#80ff80>100% ||PedroWerneck ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref7.tex ||<#80ff80>100% ||PedroWerneck ||<#80ff80> (./) ||<#80ff80> (./) ||
||ref/ref8.tex ||<#80ff80>100% ||PedroWerneck ||<#80ff80> (./) ||<#80ff80> (./) ||


||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Revisão                                        ''' ||
||<style="text-align: center;" |2>'''Arquivo''' ||||<style="text-align: center;">'''Revisão Semântica''' ||||<style="text-align: center;">'''Revisão Gramatical''' ||
||'''Status''' ||'''Responsável''' ||'''Status''' ||'''Responsável''' ||
||ref/ref.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref1.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref2.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref3.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref4.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref5.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref6.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref7.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref8.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||


=== Tutorial Python ===
||||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Tradução''' ||
||'''Arquivo''' ||'''Status''' ||'''Responsável''' ||'''Início''' ||'''Entrega Prevista:''' ||
||tut/glossary.tex ||<#80ff80>100% ||PedroWerneck ||<#80ff80> ||- ||
||tut/tut.tex ||<#80ff80>100% ||RodrigoSenra ||<#80ff80> ||- ||


||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Revisão                                        ''' ||
||<style="text-align: center;" |2>'''Arquivo''' ||||<style="text-align: center;">'''Revisão Semântica''' ||||<style="text-align: center;">'''Revisão Gramatical''' ||
||'''Status''' ||'''Responsável''' ||'''Status''' ||'''Responsável''' ||
||tut/glossary.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||tut/tut.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||


=== Referência da Biblioteca Python ===
||||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Tradução''' ||
||'''Arquivo''' ||'''Status''' ||'''Responsável''' ||'''Início''' ||'''Entrega Prevista:''' ||
||lib/asttable.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/compiler.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/distutils.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/email.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/email-dir.py ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/email-mime.py ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/email-simple.py ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/email-unpack.py ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/emailcharsets.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/emailencoders.tex ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/emailexc ||<#80ff80>100% ||AlexandreNalon ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/lib.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libaifc.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libal.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/liballos.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libamoeba.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libanydbm.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libconsts.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libexcs.tex ||<#ffff80>52% ||- ||<#ff8080> (./) ||<#ffff80> /!\ ||
||lib/libfuncs.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libintro.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libobjs.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||
||lib/libstdtypes.tex ||<#80ff80>100% ||FelipeLessa ||<#80ff80> (./) ||<#80ff80> (./) ||


||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Revisão                                        ''' ||
||<style="text-align: center;" |2>'''Arquivo''' ||||<style="text-align: center;">'''Revisão Semântica''' ||||<style="text-align: center;">'''Revisão Gramatical''' ||
||'''Status''' ||'''Responsável''' ||'''Status''' ||'''Responsável''' ||
||lib/asttable.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/compiler.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/distutils.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/email.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/email-dir.py ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/email-mime.py ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/email-simple.py ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/email-unpack.py ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/lib.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/libaifc.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/libal.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/liballos.tex ||<#80ff80>100% ||PedroWerneck ||<#ff8080>0% ||- ||
||lib/libamoeba.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/libanydbm.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/libconsts.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/libexcs.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/libfuncs.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||lib/libintro.tex ||<#80ff80>100% ||OsvaldoSantanaNeto ||<#80ff80>100% ||OsvaldoSantanaNeto ||
||lib/libobjs.tex ||<#80ff80>100% ||OsvaldoSantanaNeto ||<#80ff80>100% ||OsvaldoSantanaNeto ||
||lib/libstdtypes.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ref/ref5.tex ||<#ffff80>44% ||RenataPalazzo ||<#ff8080>0% ||- ||
||lib/libexcs.tex ||<#ff8080>0% ||FelipeLessa ||<#ff8080>0% ||- ||


=== Estendendo e Embutindo o Interpretador Python ===
||||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Tradução''' ||
||'''Arquivo''' ||'''Status''' ||'''Versão''' ||'''Responsável''' ||'''Início''' ||'''Entrega Prevista:''' ||
||ext/ext.tex ||<#80ff80>100% ||PedroDeMedeiros ||<#80ff80> (./) ||<#80ff80> (./) ||
||ext/building.tex ||<#80ff80>100% ||PedroDeMedeiros ||<#80ff80> (./) ||<#80ff80> (./) ||
||ext/embedding.tex ||<#80ff80>100% ||PedroDeMedeiros ||<#80ff80> (./) ||<#80ff80> (./) ||
||ext/extending.tex ||<#80ff80>100% ||PedroDeMedeiros ||<#80ff80> (./) ||<#80ff80> (./) ||
||ext/newtypes.tex ||<#ff8080>0% ||PedroDeMedeiros ||<#ffff80>01/05/2004 ||<#ffff80> /!\ ||
||ext/windows.tex ||<#80ff80>100% ||PedroDeMedeiros ||<#80ff80> (./) ||<#80ff80> (./) ||


||||||||||<tablewidth="100%"#c0c0c0 style="text-align: center;">'''Status da Revisão                                        ''' ||
||<style="text-align: center;" |2>'''Arquivo''' ||||<style="text-align: center;">'''Revisão Semântica''' ||||<style="text-align: center;">'''Revisão Gramatical''' ||
||'''Status''' ||'''Responsável''' ||'''Status''' ||'''Responsável''' ||
||ext/ext.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ext/building.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ext/embedding.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ext/extending.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ext/newtypes.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||
||ext/windows.tex ||<#ff8080>0% ||- ||<#ff8080>0% ||- ||


== Comentários e Observações dos Tradutores ==
''Revisores, por favor me avisem de erros meus. :) -- FelipeLessa''

''Acho que existe um erro na ref4: "It is illegal to unbind a name that is referenced by an enclosing scope; the compiler will report a !SyntaxError.". Se alguém tiver mais informações, me avise. -- RafaelAlmeida''

''Talvez alguma palavra-chave do LaTeX tenha sido traduzida por engano. -- FelipeLessa''

''Felipe, eu conheço LaTeX sim. Quando eu disse pra usarem {{{\emph{}}}} é porque é a forma correta de se fazer isso. -- OsvaldoSantanaNeto''

''Não tive resposta no #python-br, então pergunto aqui: aquelas BNFnotations que tem no ref5, elas devem ser traduzidas? Ou melhor, o que deve ser traduzido e o que não deve? -- RafaelAlmeida''

''Eu acho que em trechos de código ou 'verbatim' a gente deve traduzir apenas os comentários e mais nada. Mantemos as mensagens e nomes de variáveis intactos. No caso das BNFs, seria interessante mantê-las como estão -- OsvaldoSantanaNeto''

''Como traduzir Python? Às vezes o texto se refere a linguagem Python (a qual eu chamo de "a Python"), noutras, o interpretador Python (o qual eu chamo de "o Python"). Mas geralmente eu coloco isso por extenso ("o interpretador Python" ou "a linguagem Python"), só fazendo essas abreviações quando estiver ficando redundante demais -- PedroDeMedeiros''

''"Embutido" não soa muito bem em alguns contextos, especialmente quando o texto simplifica o termo colocando só "Embedding" ao invés de especificar o que, onde e como. Quando o texto faz isso, eu prefiro substituir o termo por "acoplamento", que soa mais natural -- PedroDeMedeiros''

''''

----
AlexandreNalon<<BR>> FelipeLessa<<BR>> GuilhermeManika<<BR>> JoaoPauloSilva<<BR>> OsvaldoSantanaNeto<<BR>> PedroDeMedeiros<<BR>> PedroWerneck<<BR>> RafaelAlmeida<<BR>> RenataPalazzo<<BR>> RudaMoura<<BR>> e outros