[django-l10n-portuguese commit] r55 - trunk/docs
codesite...@google.com
Date: Fri Jul 25 14:17:30 2008
New Revision: 55
Modified:
trunk/docs/tutorial01_pt-br.txt
Log:
Corrigidos typos
Modified: trunk/docs/tutorial01_pt-br.txt
==============================================================================
--- trunk/docs/tutorial01_pt-br.txt (original)
+++ trunk/docs/tutorial01_pt-br.txt Fri Jul 25 14:17:30 2008
@@ -106,12 +106,12 @@
Esses arquivos são:
- * ``__init__.py``: Um arquivo vazio que diz ao python que esse diretório deve
+ * ``__init__.py``: Um arquivo vazio que diz ao Python que esse diretório deve
ser considerado como um pacote Python. (Leia `mais sobre pacotes`_ na
documentação oficial do Python se você for iniciante em Python.)
* ``manage.py``: Um utilitário de linha de comando que permite a você
interagir com esse projeto Django de várias maneiras.
- * ``settings.py``: Definições/configuração para esse projeto Django.
+ * ``settings.py``: Definições/configurações para esse projeto Django.
* ``urls.py``: As declarações de URLs para esse projeto Django; uma "tabela de
conteúdos" para o seu site movido a Django.
@@ -133,7 +133,7 @@
Você iniciou o servidor de desenvolvimento do Django, um servidor Web leve escrito
puramente em Python. Nós incluímos ele com o Django, então você pode desenvolver
-coisas rapidamente, sem ter que lidar com a configuração de um servidor web de
+coisas rapidamente, sem ter que lidar com a configuração de um servidor Web de
produção -- como o Apache -- até que você esteja pronto para a produção.
Agora é uma boa hora para anotar: NÃO use esse servidor em nada relacionado a um
@@ -144,13 +144,14 @@
Agora que o servidor está rodando, visite http://127.0.0.1:8000/ com seu navegador
Web. Você irá ver a página "Welcome to Django", em agradáveis tons de azul claro
pastel.
+
Ele funcionou!
.. admonition:: Mudando a porta
Por padrão, o comando ``runserver`` inicia o servidor de desenvolvimento na
porta 8000. Se você quer mudar a porta do servidor, passe ela como um argumento
- na linha de comando. Por exemplo, esse comando iniciará o servidor na porta
+ na linha de comando. Por exemplo, este comando iniciará o servidor na porta
8080::
python manage.py runserver 8080
@@ -187,13 +188,13 @@
criado o banco de dados a partir desse ponto. Faça isso com "``CREATE DATABASE
database_name;``" a partir do prompt interativo do seu banco de dados.
-Enquanto você estiver editando o ``settings.py``, note a configuração do
+Enquanto você estiver editando o ``settings.py``, observe a configuração do
``INSTALLED_APPS`` próximo ao final do arquivo. Aquela variável possui os nomes de
todas as aplicações Django que estiverem ativadas para essa instância do Django.
Aplicações podem ser usadas em múltiplos projetos, e você pode empacotá-las e
distribuí-las para uso de outros em seus projetos.
-Por padrão, o ``INSTALLED_APPS`` contém as seguintes aplicações, que vem com o
+Por padrão, o ``INSTALLED_APPS`` contém as seguintes aplicações, que vêm com o
Django:
* ``django.contrib.auth`` -- Um sistema de autenticação.
@@ -207,16 +208,15 @@
Cada uma dessas aplicações faz uso de pelo menos uma tabela no banco de dados,
assim sendo, nós precisamos criar as tabelas no banco de dados antes que possamos
-usá-las, para isso rode o seguinte comando::
+usá-las. Para isso rode o seguinte comando::
python manage.py syncdb
-O comando ``syncdb`` verifica a configuração do ``INSTALLED_APPS`` e cria todas as
+O parâmetro ``syncdb`` verifica a configuração do ``INSTALLED_APPS`` e cria todas as
tabelas necessárias de acordo com a configuração do banco de dados no seu arquivo
``settings.py``. Você irá ver uma mensagem para cada tabela do banco de dados que
-ele criar, e você irá receber um prompt perguntando a você se gostaria de
-criar uma conta de super-usuário para o sistema de autenticação. Vá em frente e
-faça isso.
+ele criar, e você irá receber um prompt perguntando se gostaria de criar uma conta
+de super-usuário para o sistema de autenticação. Vá em frente e faça isso.
Se você estiver interessado, rode o cliente de linha de comando do seu banco de
dados e digite ``\dt`` (PostgreSQL), ``SHOW TABLES;`` (MySQL), ou ``.schema``
@@ -239,7 +239,7 @@
Cada aplicação que você escreve no Django consiste de um pacote Python, em algum
lugar no seu `caminho do Python`_, que seguirá uma certa convenção. O Django vem
com um utilitário que gera automaticamente a estrutura básica de diretório de uma
-aplicação, então você pode se concentrar apenas em escrever código ao invés de
+aplicação, então você pode se concentrar apenas em escrever código em vez de
ficar criando diretórios.
.. admonition:: Projetos vs. aplicações
@@ -252,8 +252,8 @@
múltiplos projetos.
Nesse tutorial nós iremos criar nossa aplicação de enquete no diretório ``mysite``,
-para simplificar. Como conseqüência, a aplicação irá ser acoplada ao projeto --
-assim sendo, o código Python interno da aplicação da enquete irá se referir a
+para simplificar. Como conseqüência, a aplicação irá ser acoplada ao projet.
+Assim sendo, o código Python interno da aplicação da enquete irá se referir a
``mysite.polls``. Posteriormente, nesse tutorial, nós iremos discutir como
desacoplar suas aplicações para distribuição.
@@ -319,7 +319,7 @@
O código é auto-explicativo. Cada modelo é representado por uma classe derivada da
classe ``django.db.models.Model``. Cada modelo tem um número de variáveis de
-classe, as quais por sua vez representam um campo de banco de dados no modelo.
+classe, as quais por sua vez representam os campos de banco de dados no modelo.
Cada campo é representado por uma instância de uma classe ``models.*Field`` --
ex.: ``models.CharField`` para campos do tipo caractere e ``models.DateTimeField``
@@ -330,19 +330,19 @@
seu código Python, e seu banco de dados irá usá-lo como nome de coluna.
Você pode usar um argumento na primeira posição de um ``Field`` para designar um
-nome legível para humanos. O qual será usado em uma série de partes introspectivas
-do Django, e ele também servirá como documentação. Se esse campo não for
-fornecido, o Django irá usar o nome legível para a máquina. Nesse exemplo nós
-definimos um nome legível para humanos apenas para ``Poll.pub_date``. Para todos os
+nome legível para humanos, o qual será usado em uma série de partes introspectivas
+do Django, e também servirá como documentação. Se esse campo não for fornecido,
+o Django irá usar o nome legível para a máquina. Nesse exemplo nós definimos um
+nome legível para humanos apenas para ``Poll.pub_date``. Para todos os
outros campos nesse modelo o nome legível para a máquina servirá como nome legível
para humanos.
-Algumas classes ``Field`` possuem elementos obrigatórios. O ``CharField``, por
+Algumas classes ``*Field`` possuem elementos obrigatórios. O ``CharField``, por
exemplo, requer que você informe a ele um ``max_length``. Isso é usado não apenas
no esquema do banco de dados, mas na validação, como nós veremos em breve.
-Finalmente, note a definição de um relacionamento, usando ``models.ForeignKey``.
-Que diz ao Django que cada Choice (Escolha) está relacionada a uma única Poll
+Finalmente, note a definição de um relacionamento, usando ``models.ForeignKey``,
+que diz ao Django que cada Choice (Escolha) está relacionada a uma única Poll
(Enquete). O Django suporta todos os relacionamentos de banco de dados comuns:
muitos-para-um, muitos-para-muitos e um-para-um.
@@ -364,10 +364,10 @@
.. admonition:: Filosofia
Aplicações Django são "plugáveis": Você pode usar uma aplicação em múltiplos
- projetos, e você pode distribuir aplicações, porque elas não tem que ser
+ projetos, e você pode distribuir aplicações, porque elas não têm que ser
atreladas a uma determinada instalação do Django.
-Edite o arquivo ``settings.py`` novamente, e altere a configuração
+Edite o arquivo ``settings.py`` novamente e altere a configuração
``INSTALLED_APPS`` para incluir a string ``'mysite.polls'``. Então ela irá parecer
com isso::
@@ -426,13 +426,13 @@
usando aspas duplas ou aspas simples. O autor desse tutorial rodava
PostgreSQL, então o saída do exemplo está na sintaxe do PostgreSQL.
- * O comando ``sql`` atualmente não roda o SQL no seu banco de dados - ele
- apenas mostra-o na tela para que você possa ver qual SQL o Django acha que
+ * O comando ``sql`` na realidade não roda o SQL no seu banco de dados - ele
+ apenas o exibe na tela para que você saiba qual SQL o Django acha que
é necessário. Se você quiser, você pode copiar e colar esse SQL no prompt
do seu banco de dados. Entretanto, como nós iremos ver em breve, o Django
fornece uma maneira mais fácil de submeter o SQL ao banco de dados.
-Se você tiver interesse, também rode os seguintes comandos:
+Se você tiver curiosidade, também rode os seguintes comandos:
* ``python manage.py validate`` -- Verifica por quaisquer erros na construção
dos seus modelos.
@@ -451,7 +451,7 @@
comandos 'sql', 'sqlcustom', e 'sqlindexes'.
Olhar para a saída desses comandos irá ajudar a entender o que está acontecendo
-por baixo do pano.
+por baixo dos panos.
Agora, rode o ``syncdb`` novamente para criar essas tabelas de modelos no seu
banco de dados::
@@ -479,12 +479,12 @@
python manage.py shell
-Nós usaremos isso ao invés de simplesmente digitar "python", porque o
+Nós usaremos isso em vez de simplesmente digitar "python", porque o
``manage.py`` configura o ambiente de projeto para você. "A configuração do
ambiente" envolve duas coisas:
* Colocar o ``mysite`` no ``sys.path``. Buscando flexibilidade, várias partes
- do Django referem-se aos projetos usando a notação pontuada do Python (ex.:
+ do Django referem-se aos projetos usando a notação pontuada do Python (ex:
``'mysite.polls.models'``). Para que isso funcione, o pacote ``mysite``
precisa estar no ``sys.path``.
@@ -498,7 +498,7 @@
Se você optar por não usar o ``manage.py``, não há problemas. Apenas
certifique-se de que o ``mysite`` está no nível raíz do caminho do Python
- (ex.: ``import mysite`` funciona) e configure a variável de ambiente
+ (ex: ``import mysite`` funciona) e configure a variável de ambiente
``DJANGO_SETTINGS_MODULE`` para ``mysite.settings``.
Para mais informações sobre tudo isso, veja a `documentação do django-admin.py`_.
@@ -519,7 +519,7 @@
# Salve o objeto na base de dados. Você tem que chamar o save() explicitamente.
>>> p.save()
- # Agora ela tem uma ID. Note que ele irá mostrar "1L" ao invés de "1",
+ # Agora ele tem uma ID. Note que ele irá mostrar "1L" em vez de "1",
# dependendo de qual banco de dados você está usando. Não é nada demais; isso
# apenas significa que o backend do seu banco de dados prefere retornar
# inteiros como objetos inteiros longos do Python.
@@ -557,15 +557,15 @@
.. admonition:: Se o ``__unicode__()`` parecer não funcionar
- Se você adicionar o método ``__unicode__()`` aos seus modelos e não ver nenhuma
+ Se você adicionar o método ``__unicode__()`` aos seus modelos e não observar nenhuma
mudança na forma com que eles são representados, você deve estar usando uma
- versão antiga do Django. (Essa versão do tutorial foi escrita para a última
+ versão antiga do Django. (Esta versão do tutorial foi escrita para a última
versão de desenvolvimento do Django.) Se você estiver usando um checkout do
Subversion do Django (veja `a documentação de instalação`_ para mais
informações), você não deveria estar tendo nenhum problema.
Se você quiser seguir com uma versão antiga do Django, você deverá mudar para
- `o tutorial do Django 0.96`_, porque esse tutorial cobre vários recursos que
+ `o tutorial do Django 0.96`_, porque este tutorial cobre vários recursos que
existem apenas na versão de desenvolvimento do Django.
.. _a documentação de instalação: ../instalar/
@@ -573,7 +573,7 @@
É importante adicionar métodos ``__unicode__()`` aos seus modelos, não apenas para
sua própria sanidade quando estiver lidando com o prompt interativo, mas também
-porque representações de objetos são usadas em toda administração gerada
+porque representações de objetos são usadas em toda a administração gerada
automaticamente pelo Django.
.. admonition:: Por que ``__unicode__()`` e não ``__str__()``?
@@ -584,7 +584,7 @@
por padrão. Todos os dados armazenados nos seus bancos de dados são
convertidos para Unicode quando são retornados.
- Os modelos do Django tem um método padrão ``__str__()`` que chama o
+ Os modelos do Django têm um método padrão ``__str__()`` que chama o
``__unicode__()`` e converte os resultados para uma bytestring UTF-8. Isso
significa que ``unicode(p)`` irá retornar uma string Unicode, e que ``str(p)``
irá retornar uma string normal, com caracteres codificados como UTF-8.
@@ -622,9 +622,9 @@
>>> Poll.objects.filter(question__startswith='What')
[<Poll: What's up?>]
- # Pegue a enquete cujo ano é 2007. Claro que, se você estiver seguindo esse
+ # Pegue a enquete cujo ano é 2008. Claro que, se você estiver seguindo esse
# tutorial em outro ano, mude como for apropriado.
- >>> Poll.objects.get(pub_date__year=2007)
+ >>> Poll.objects.get(pub_date__year=2008)
<Poll: What's up?>
>>> Poll.objects.get(id=2)
@@ -666,8 +666,8 @@
# A API segue automaticamente os relacionamentos da forma como você precisa.
# Use ``underscores`` duplos para separar relacionamentos.
# Isso funciona em tantos níveis abaixo quando você quiser; não há limite.
- # Encontre todas as opções (``choices``) para uma enquete cuja ``pub_date`` é em 2007.
- >>> Choice.objects.filter(poll__pub_date__year=2007)
+ # Encontre todas as opções (``choices``) para uma enquete cuja ``pub_date`` é em 2008.
+ >>> Choice.objects.filter(poll__pub_date__year=2008)
[<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]
# Vamos deletar uma das escolhas. Use delete() para isso.