[django-l10n-portuguese commit] r39 - trunk/docs
codesite...@google.com
Date: Fri Jul 11 20:42:45 2008
New Revision: 39
Modified:
trunk/docs/url_dispatch_pt-br.txt
Log:
Tratando URLconf como masculino (o módulo) e finalizando textos não traduzidos
Modified: trunk/docs/url_dispatch_pt-br.txt
==============================================================================
--- trunk/docs/url_dispatch_pt-br.txt (original)
+++ trunk/docs/url_dispatch_pt-br.txt Fri Jul 11 20:42:45 2008
@@ -70,7 +70,7 @@
Exemplo
=======
-Aqui está uma URLconf de exemplo::
+Aqui está um URLconf de exemplo::
from django.conf.urls.defaults import *
@@ -132,7 +132,7 @@
``(?P<nome>padrão)``, onde ``nome`` é o nome do grupo e ``padrão`` é algum
padrão a ser correspondido.
-Segue a URLconf do exemplo acima, reescrita para utilizar grupos nomeados::
+Segue o URLconf do exemplo acima, reescrita para utilizar grupos nomeados::
urlpatterns = patterns('',
(r'^articles/2003/$', 'news.views.special_case_2003'),
@@ -152,8 +152,8 @@
* Uma requisição para ``/articles/2003/03/3/`` chama a função
``news.views.article_detail(request, year='2003', month='03', day='3')``.
-Na prática, isto significa que suas URLconfs são um pouco mais explícitas e
-menos propensas a bugs de ordem de argumentos -- e você pode reordenar os
+Na prática, isto significa que seus URLconfs são um pouco mais explícitos e
+menos propensos a bugs de ordem de argumentos -- e você pode reordenar os
argumentos nas definições de funcão de view. Obviamente, estes benefícios são
obtidos ao custo da brevidade; alguns desenvolvedores acham a sintaxe
de grupos nomeados feia e tediosa.
@@ -196,7 +196,7 @@
``django.conf.urls.defaults.patterns()``. Sempre use ``patterns()`` para criar
a vaiável ``urlpatterns``.
-A convenção é usar ``from django.conf.urls.defaults import *`` no topo de sua
+A convenção é usar ``from django.conf.urls.defaults import *`` no topo de seu
URLconf. Isto dá ao módulo acesso a estes objetos:
patterns
@@ -283,8 +283,8 @@
include
-------
-Uma função que recebe o caminho completo para a importação Python de outra
-URLconf que deve ser "incluída" neste local. Veja `Incluindo outras URLconfs`_
+Uma função que recebe o caminho completo para a importação Python de outro
+URLconf que deve ser "incluído" neste local. Veja `Incluindo outros URLconfs`_
abaixo.
Notas na captura de texto em URLs
@@ -393,14 +393,14 @@
(r'^tag/(?P<tag>\w+)/$', 'tag'),
)
-Incluindo Outras URLconfs
+Incluindo outros URLconfs
=========================
-At any point, your ``urlpatterns`` can "include" other URLconf modules. This
-essentially "roots" a set of URLs below other ones.
+Em qualquer ponto, seu ``urlpatterns`` pode "incluir" outros módulos URLconf.
+Isso essencialmente "inclui" um conjunto de URLs abaixo de outras.
-For example, here's the URLconf for the `Django website`_ itself. It includes a
-number of other URLconfs::
+Por exemplo, eis o URLconf para o próprio `website do Django`_. Ele inclui um
+número de outros URLconfs::
from django.conf.urls.defaults import *
@@ -410,77 +410,77 @@
(r'^comments/', include('django.contrib.comments.urls.comments')),
)
-Note that the regular expressions in this example don't have a ``$``
-(end-of-string match character) but do include a trailing slash. Whenever
-Django encounters ``include()``, it chops off whatever part of the URL matched
-up to that point and sends the remaining string to the included URLconf for
-further processing.
+Note que as expressões regulares neste exemplo não tem um ``$`` (caracter que
+corresponde ao final de string) mas incluem a barra final. Sempre que o Django
+encontra ``include()``, ele recorta qualquer parte da URL correspondida até
+aquele ponto e envia a string restante ao URLconf incluído para processamento
+adicional.
-.. _`Django website`: http://www.djangoproject.com/
+.. _`website do Django`: http://www.djangoproject.com/
-Captured parameters
--------------------
+Parâmetros capturados
+---------------------
-An included URLconf receives any captured parameters from parent URLconfs, so
-the following example is valid::
+Um URLconf incluído recebe quaisquer parâmetros capturados do URLconf pai,
+então o sequinte exemplo é válido::
- # In settings/urls/main.py
+ # Em settings/urls/main.py
urlpatterns = patterns('',
(r'^(?P<username>\w+)/blog/', include('foo.urls.blog')),
)
- # In foo/urls/blog.py
+ # Em foo/urls/blog.py
urlpatterns = patterns('foo.views',
(r'^$', 'blog.index'),
(r'^archive/$', 'blog.archive'),
)
-In the above example, the captured ``"username"`` variable is passed to the
-included URLconf, as expected.
+No exemplo acima, a variável ``"username"`` capturada é passada para o URLconf,
+como esperado.
Passando opções adicionais para funções de view
===============================================
-URLconfs have a hook that lets you pass extra arguments to your view functions,
-as a Python dictionary.
+URLconfs têm um gancho que deixa você passar argumentos adicionais para suas
+funções de view, como um dicionário Python.
-Any URLconf tuple can have an optional third element, which should be a
-dictionary of extra keyword arguments to pass to the view function.
+Qualquer tupla URLconf pode ter um terceiro elemento opcional, que deve ser um
+dicionário de agrumentos nomeados adicionais para passar para a função de view.
-For example::
+Por examplo::
urlpatterns = patterns('blog.views',
(r'^blog/(?P<year>\d{4})/$', 'year_archive', {'foo': 'bar'}),
)
-In this example, for a request to ``/blog/2005/``, Django will call the
-``blog.views.year_archive()`` view, passing it these keyword arguments::
+Neste exemplo, uma requisição para ``/blog/2005/``, O Django chamará a view
+``blog.views.year_archive()``, passando estes argumentos nomeados::
year='2005', foo='bar'
-This technique is used in `generic views`_ and in the `syndication framework`_
-to pass metadata and options to views.
+Esta técnica é utilizada em `views genéricas`_ e em `syndication framework`_
+para passar metadados e opções para as views.
-.. _generic views: ../generic_views/
+.. _views genéricas: ../generic_views/
.. _syndication framework: ../syndication_feeds/
-.. admonition:: Dealing with conflicts
+.. admonition:: Lidando com conflitos
- It's possible to have a URL pattern which captures named keyword arguments,
- and also passes arguments with the same names in its dictionary of extra
- arguments. When this happens, the arguments in the dictionary will be used
- instead of the arguments captured in the URL.
+ É possível ter um padrão de URL que captura argumentos nomeados, e também
+ passa argumentos com os mesmos nomes no seu dicionário de argumentos
+ adicionais. Quando isso acontece, os argumentos no dicionário serão usados
+ ao invés dos argumentos capturados na URL.
-Passing extra options to ``include()``
---------------------------------------
+Passando opções adicionais para ``include()``
+---------------------------------------------
-Similarly, you can pass extra options to ``include()``. When you pass extra
-options to ``include()``, *each* line in the included URLconf will be passed
-the extra options.
+Do mesmo modo, você pode passar opções adicionais para ``include()``. Quando
+você passa opções adicionais para ``include()``, elas serão passadas para *cada*
+linha no URLconf incluído.
-For example, these two URLconf sets are functionally identical:
+Por exemplo, estes dois conjuntos URLconf são funcionalmente idênticos:
-Set one::
+Conjunto um::
# main.py
urlpatterns = patterns('',
@@ -493,7 +493,7 @@
(r'^about/$', 'mysite.views.about'),
)
-Set two::
+Conjunto dois::
# main.py
urlpatterns = patterns('',
@@ -506,19 +506,20 @@
(r'^about/$', 'mysite.views.about', {'blogid': 3}),
)
-Note that extra options will *always* be passed to *every* line in the included
-URLconf, regardless of whether the line's view actually accepts those options
-as valid. For this reason, this technique is only useful if you're certain that
-every view in the the included URLconf accepts the extra options you're passing.
-
-Passing callable objects instead of strings
-===========================================
-
-Some developers find it more natural to pass the actual Python function object
-rather than a string containing the path to its module. This alternative is
-supported -- you can pass any callable object as the view.
+Note que as opções adicionais serão *sempre* passadas para *cada* linha no
+URLconf incluído, independentemente se a view da linha aceita as opções como
+válidas. Por este motivo, esta técnica somente é útil se você está seguro de
+que cada view no URLconf incluído aceita as opções adicionais que você está
+passando.
+
+Passando objetos que podem ser chamados ao invés de strings
+===========================================================
+
+Alguns desenvolvedores acham mais natural passar o próprio objeto de função
+Python do que a string contendo o caminho para seu módulo. Esta alternativa é
+suportada -- você pode passar qualquer objeto que pode ser chamado como a view.
-For example, given this URLconf in "string" notation::
+Por exemplo, dado este URLconf na notação de "string"::
urlpatterns = patterns('',
(r'^archive/$', 'mysite.views.archive'),
@@ -526,8 +527,8 @@
(r'^contact/$', 'mysite.views.contact'),
)
-You can accomplish the same thing by passing objects rather than strings. Just
-be sure to import the objects::
+Você pode obter a mesma coisa passando objetos ao invés de strings. Apenas
+assegure-se de importar os objetos::
from mysite.views import archive, about, contact
@@ -537,9 +538,9 @@
(r'^contact/$', contact),
)
-The following example is functionally identical. It's just a bit more compact
-because it imports the module that contains the views, rather than importing
-each view individually::
+O exemplo seguinte é funcionalmente idêntico. Somente um pouco mais compacto
+porque importa o módulo que contém as views, ao ivés de importar acada view
+individualmente::
from mysite import views
@@ -549,100 +550,102 @@
(r'^contact/$', views.contact),
)
-The style you use is up to you.
+O estilo que você usa fica por sua conta.
-Note that if you use this technique -- passing objects rather than strings --
-the view prefix (as explained in "The view prefix" above) will have no effect.
+Note que se você usa esta técnica -- passando objetos ao invés de strings --
+o prefixo da view (como explicado em "O prefixo da view" acima) não terá efeito.
Nomeando padrões de URL
=======================
-**New in Django development version**
+**Novidade na versão de desenvolvimento do Django**
-It's fairly common to use the same view function in multiple URL patterns in
-your URLconf. For example, these two URL patterns both point to the ``archive``
-view::
+É bastante comum usar a mesma função de view em múltiplos padrões de URL em seu
+URLconf. Por exemplo, estes dois padrões de URL apontam para a view
+``archive``::
urlpatterns = patterns('',
(r'/archive/(\d{4})/$', archive),
(r'/archive-summary/(\d{4})/$', archive, {'summary': True}),
)
-This is completely valid, but it leads to problems when you try to do reverse
-URL matching (through the ``permalink()`` decorator or the ``{% url %}``
-`template tag`_). Continuing this example, if you wanted to retrieve the URL for
-the ``archive`` view, Django's reverse URL matcher would get confused, because
-*two* URLpatterns point at that view.
-
-To solve this problem, Django supports **named URL patterns**. That is, you can
-give a name to a URL pattern in order to distinguish it from other patterns
-using the same view and parameters. Then, you can use this name in reverse URL
-matching.
+Isto é complemente válido, mas ocasiona problemas quando você tenta fazer uma
+correspondência de URL reversa (através do decorator ``permalink()`` ou a
+`template tag`_ ``{% url %}``). Continuando este exemplo, se você quisesse
+recuperar a URL para a view ``archive``, o mecanismo de correspondência de URL
+reverso do Django ficaria confuso, pois *dois* padrões de URL apontam para esta
+view.
+
+Para resolver este problema, o Django suporta **padrões de URL nomeados**.
+Ou seja, você pode dar nomes para um padrão de URL afim de distinguí-lo de
+outros padrões usando a mesma view e parâmetros. Então, você pode usar este nome
+na correspondência reversa de URL.
-Here's the above example, rewritten to used named URL patterns::
+Veja o exemplo acima, reescrito para utilizar padrões de URL nomeados::
urlpatterns = patterns('',
url(r'/archive/(\d{4})/$', archive, name="full-archive"),
url(r'/archive-summary/(\d{4})/$', archive, {'summary': True}, "arch-summary"),
)
-With these names in place (``full-archive`` and ``arch-summary``), you can
-target each pattern individually by using its name::
+Com estes nomes no lugar (``full-archive`` and ``arch-summary``), você pode
+apontar cada padrão individualmente utilizando seu nome::
{% url arch-summary 1945 %}
{% url full-archive 2007 %}
-Even though both URL patterns refer to the ``archive`` view here, using the
-``name`` parameter to ``url()`` allows you to tell them apart in templates.
+Apesar de ambos padrões de URL referirem-se a view ``archive``, ao usar o
+parâmetro ``name`` de ``url()`` lhe permite separá-los em templates.
-The string used for the URL name can contain any characters you like. You are
-not restricted to valid Python names.
+A string usada para o nome da URL pode conter quaisquer caracteres que você
+queira. Você não está restrito a nomes válidos em Python.
.. note::
- When you name your URL patterns, make sure you use names that are unlikely
- to clash with any other application's choice of names. If you call your URL
- pattern ``comment``, and another application does the same thing, there's
- no guarantee which URL will be inserted into your template when you use
- this name.
-
- Putting a prefix on your URL names, perhaps derived from the application
- name, will decrease the chances of collision. We recommend something like
- ``myapp-comment`` instead of ``comment``.
+ Quando você nomeia seus padrões de URL, certifique-se de que esta utilizando
+ nomes que não tem chances óbvias de colidir com nomes escolhidos em outras
+ aplicações. Se você chama seu padrão de URL ``comment``, e outra aplicação
+ faz a mesma coisa, não há garantias de qual URL será inserida no seu
+ template quando você usa este nome.
+
+ Colocar um prefixo nos nomes de suas URLs, talvez derivado do nome da
+ aplicação, diminuirá as chances de colisão. Recomendamos algo como
+ ``myapp-comment`` ao invés de ``comment``.
.. _template tag: ../templates/#url
-Utility methods
-===============
+Métodos utilitários
+===================
reverse()
---------
-If you need to use something similar to the ``{% url %}`` `template tag`_ in
-your code, Django provides the ``django.core.urlresolvers.reverse()``. The
-``reverse()`` function has the following signature::
+Se você precisa usar algo similar a `template tag`_ ``{% url %}`` no seu código,
+o Django provê ``django.core.urlresolvers.reverse()``. A função ``reverse()``
+tem a seguinte assinatura::
reverse(viewname, urlconf=None, args=None, kwargs=None)
-``viewname`` is either the function name (either a function reference, or the
-string version of the name, if you used that form in ``urlpatterns``) or the
-`URL pattern name`_. Normally, you won't need to worry about the
-``urlconf`` parameter and will only pass in the positional and keyword
-arguments to use in the URL matching. For example::
+``viewname`` é o nome da função (podendo ser uma referência para a função, ou
+o nome dela como uma string, se foi utilizado desta forma em ``urlpatterns``)
+ou o `Nome do padrão de URL`_. Normalmente, você não precisa se preocupar com o
+parâmetro ``urlconf`` e irá passar somente os argumentos posicionais e nomeados
+para serem usados na correspondência de URL. Por exemplo::
from django.core.urlresolvers import reverse
def myview(request):
return HttpResponseRedirect(reverse('arch-summary', args=[1945]))
-.. _URL pattern name: `Nomeando padrões de URL`_
+.. _Nome do padrão de URL: `Nomeando padrões de URL`_
permalink()
-----------
-The ``permalink()`` decorator is useful for writing short methods that return
-a full URL path. For example, a model's ``get_absolute_url()`` method. Refer
-to the `model API documentation`_ for more information about ``permalink()``.
+O decorator ``permalink()`` é útil para escrever métodos curtos que retornam o
+caminho inteiro da URL. Por exemplo, o método ``get_absolute_url()`` do modelo.
+Consulte `documentação da API de modelo`_ para mais informações sobre
+``permalink()``.
-.. _model API documentation: ../model-api/#the-permalink-decorator
+.. _documentação da API de modelo: ../model-api/#the-permalink-decorator