{{{
#!rst

THIS TRANSLATION IS IN PROGRESS:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------------------------------------------------------------------------------+
|    This is an **in progress** translation document, that means there is somebody working on it. |
|    For more information on translating documents please look at `TranslateDocumentation Wiki`_. |
|    Please **do not** edit this page.                                                            |
|                                                                                                 |
| .. _TranslateDocumentation Wiki : http://code.djangoproject.com/wiki/TranslateDocumentation     |
+-------------------------------------------------------------------------------------------------+   

.. sidebar:: Escrevendo sua primeira aplicação Django, parte 1
  :subtitle: tradução para o português.

  Documento original: `Writing your first Django app, part 1`_
  
  Tradução: Rafael de Camillis Tairum `<camillistairum@gmail.com>`

.. _Writing your first Django app, part 1: http://www.djangoproject.com/documentation/tutorial1/

.. contents:: **Conteúdo do capítulo**

======================================================
Escrevendo seu primeiro aplicativo com Django, parte 1
======================================================

Este documento cobre a versão 0.95 de Django e a versão do desenvolvimento. Docs anteriores: `0.90`_, `0.91`_
----------------------------------------------------------------------------------------------------------------

.. _0.90: http://www.djangoproject.com/documentation/0_90/ 
.. _0.91: http://www.djangoproject.com/documentation/0_91/ 

Vamos aprender usando um exemplo.

Através deste tutorial vamos demonstrar os passos necessários para a criação de uma simples aplicação Web de uma pesquisa.

Ela vai consistir de duas partes:

* Um site público que irá permitir que usuários votem na pesquisa e vizualizem seus resultados.
* Um site administrativo que permitirá você adicionar, alterar e excluir pesquisas

Vamos assumir que você já tem o Django instalado. Você pode verificar se o Django está instalado abrindo o interpretador interativo Python digitando ´´import django´´. Se este comando for executado com sucesso, sem erro,  significa que o Django está instalado. 

Criando um Projeto
==================

Se esta é sua primeira vez usando o Django você precisará realizar algumas tarefas de configuração inicial.
Você terá que auto-gerar algumas linhas de código que estabelecem o projeto Django -- uma configuração própria a cada instância do Django, incluindo a configuração da base de dados, as opções específicas ao Django e as configurações específicas às aplicações. 

Na linha de comando, no diretório onde você gostaria de colocar o seu código, execute o comando 
´´django-admin.py startproject mysite´´. Isto criará no diretório atual um novo diretório chamado ´´mysite´´.

::

(NOTA)

(You'll need to avoid naming projects after built-in Python or Django components. In particular, this means you)            (should avoid using names like django (which will conflict with Django itself) or site (which conflicts with a) (built-in  Python package).)



(“django-admin.py“ deve estar em seu path se você instalou o Django usando seu utilitário setup.py. Se ele não está em seu path, você pode encontrá-lo em “site-packages/django/bin“; considere a criação de um link simbólico para ele em
algum lugar de seu path, como /usr/local/bin.)

{{{
Onde colocamos o código?

Se você conhece PHP, provavelmente está habituado a colocar o código dentro de um documento root num servidor web (num endereço como ´´/var/www´´)´. Com Django, não faça isso. Não é uma boa idéia colocar o código python dentro de um documento de servidor web, porque há o risco das pessoas verem o seu código, isto não é bom para a segurança do seu site.

Coloque o seu código fora dos diretórios do servidor, por exemplo ´´/home/mysite.´´
}}}

Vamos dar uma olhada no que o comando ´´startproject´´ criou:

{{{

mysite/
    __init__.py
    manage.py
    settings.py
    urls.py

}}}

Estes arquivos são:

* __init__.py: Um arquivo vazio que diz ao Python que este diretório deve ser considerado como um pacote do Python. (leia <a href="http://docs.python.org/tut/node8.html#packages">mais sobre pacotes</a> na documentação oficial do Python se você é iniciante em Python)
* manage.py: Un outil en ligne de commande que vous permet d'intéragir avec ce projet Django de différentes manières.
* settings.py: Fichier de configuration de ce projet Django.
* urls.py: Les déclarations d'URLs pour ce projet Django ; il s'agit d'une « table des matières » de votre site géré par Django.