Vamos aprender por um exemplo.
\nAtravés deste tutorial, nós vamos caminhar através da criação de uma aplicação básica de enquetes.
\nEla irá consistir de duas partes:
\nUma página pública que permitirá que pessoas vejam as enquetes e votem nelas.
Um site de administração que permite adicionar, alterar e deletar enquetes.
Assumiremos que você já tem o Django instalado . Você pode verificar se o Django está instalado e em qual versão rodando o seguinte comando em um prompt shell (indicado pelo prefixo $):
\n$ python -m django --version\nSe o Django estiver instalado, você verá a versão de suas instalçaõ. Se não estiver, você receberá uma mensagem de erro dizendo “No module named django”.
\nThis tutorial is written for Django 2.0, which supports Python 3.4 and\nlater. If the Django version doesn’t match, you can refer to the tutorial for\nyour version of Django by using the version switcher at the bottom right corner\nof this page, or update Django to the newest version. If you’re using an older\nversion of Python, check Qual versão do Python eu posso usar com Django? to find a compatible\nversion of Django.
\nVeja Como instalar o Django para recomendação sobre como remover versões antigas do Django e instar uma mais recente.
\n\nSe esta é a primeira vez em que você está utilizando o Django, você terá que preocupar-se com algumas configurações iniciais. Isto é, você precisará auto-gerar um código para iniciar um projeto Django – uma coleção de configurações para uma instância do Django, incluindo configuração do banco de dados, opções específicas do Django e configurações específicas da aplicação.
\nA partir da linha de comando, cd para o diretório onde você gostaria de armazenar seu código, então execute o seguinte comando:
$ django-admin startproject mysite\nThis will create a mysite directory in your current directory. If it didn’t\nwork, see Problemas ao rodar o django-admin.
Vamos ver o que o startproject criou:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n wsgi.py\nEsses arquivos são:
\nO arquivo mysite/ exterior é apenas um contêiner para o seu projeto. Seu nome não importa para Django; você pode renomeá-lo para qualquer nome que você quiser.
manage.py: Um utilitário de linha de comando que permite a você interagir com esse projeto Django de várias maneiras. Você pode ler todos os detalhes sobre o manage.py em django-admin and manage.py.
O arquivo mysite/ interior é o pacote Python para o seu projeto. Seu nome é o nome do pacote Python que você vai precisar usar para importar coisas do seu interior (por exemplo, mysite.urls).
mysite/__init__.py: Um arquivo vazio que diz ao Python que este diretório deve ser considerado um pacote Python. Se você é um iniciante Python, leia mais sobre pacotes na documentação oficial do Python.
mysite/settings.py: Configurações para este projeto Django. Configurações do Django Irá revelar para você tudo sobre o funcionamento do settings.
mysite/urls.py: As declarações de URLs para este projeto Django; um “índice” de seu site movido a Django. Você pode ler mais sobre URLs em Despachante de URL.
mysite/wsgi.py: Um ponto de integração para servidores WEB compatíveis com WSGI usado para servir seu projeto. Veja Como implementar com WSGI para mais detalhes.
Vamos verificar se ele funciona. Vá para o diretório mysite, se você ainda não estiver nele, e rode os seguintes comando:
$ python manage.py runserver\nVocê vera a seguinte saída na sua linha de comando:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n09 ago. 2026 - 15:50:53\nDjango version 2.0, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
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\ncoisas 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.
\nAgora é uma boa hora para notar: não use esse servidor em nada relacionado a um ambiente de produção. Seu objetivo é ser utilizado apenas durante o desenvolvimento. (Nós estamos na atividade de criação de frameworks Web, não de servidores Web.)
\nNow that the server’s running, visit http://127.0.0.1:8000/ with your Web\nbrowser. You’ll see a “Congratulations!” page, with a rocket taking off.\nIt worked!
\n\n\nAgora que seu ambiente – um “projeto” – está configurado, você está pronto para começar o trabalho.
\nCada aplicação que você escreve no Django consiste de um pacote Python que segue 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 em vez de ficar criando diretórios.
\n\nSeus “apps” podem ficar em qualquer lugar dentro do seu Python path. Neste tutorial, iremos criar nossa “app” de enquete bem ao lado do arquivo manage.py para que possa ser importado como um módulo de nível superior dentro do projeto, ao invés de ser um sub-módulo de mysite.
Para criar sua aplicação, certifique-se de que esteja no mesmo diretório que manage.py e digite o seguinte comando:
$ python manage.py startapp polls\nQue irá criar o diretório polls com a seguinte estrutura:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nEsta estrutura de diretório irá abrigar a aplicação de enquete.
\nHora de criar a primeira view. Abra o arquivo polls/views.py e ponha o seguinte código em Python dentro dele:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nEsta é a view mais simples possível no Django. Para chamar a view, nós temos que mapear a URL - e por isto nós precisamos da URLconf;
\nPara criar uma URLconf no diretório polls, Crie uma aquivo chamado urls.py. Agora seu diretório da aplicação deve ficar como:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nNo aquivo polls/urls.py inclua o seguinte código:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path('', views.index, name='index'),\n]\nThe next step is to point the root URLconf at the polls.urls module. In\nmysite/urls.py, add an import for django.urls.include and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path('polls/', include('polls.urls')),\n path('admin/', admin.site.urls),\n]\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded URLconf for further processing.
The idea behind include() is to make it easy to\nplug-and-play URLs. Since polls are in their own URLconf\n(polls/urls.py), they can be placed under “/polls/”, or under\n“/fun_polls/”, or under “/content/polls/”, or any other path root, and the\napp will still work.
Você agora tem uma view index no URLconf. Vamos verificar se está funcionando, execute o comando:
$ python manage.py runserver\nAcesse http://localhost:8000/polls/ no seu browser, e deverá ver o texto “Hello, world. You’re at the polls index.”, o qual foi definido na “view” ìndex`.
\nThe path() function is passed four arguments, two required:\nroute and view, and two optional: kwargs, and name.\nAt this point, it’s worth reviewing what these arguments are for.
path() argument: routeLink para este cabeçalho#route is a string that contains a URL pattern. When processing a request,\nDjango starts at the first pattern in urlpatterns and makes its way down\nthe list, comparing the requested URL against each pattern until it finds one\nthat matches.
Patterns don’t search GET and POST parameters, or the domain name. For example,\nin a request to https://www.example.com/myapp/, the URLconf will look for\nmyapp/. In a request to https://www.example.com/myapp/?page=3, the\nURLconf will also look for myapp/.
path() argument: viewLink para este cabeçalho#When Django finds a matching pattern, it calls the specified view function with\nan HttpRequest object as the first argument and any\n“captured” values from the route as keyword arguments. We’ll give an example\nof this in a bit.
path() argument: kwargsLink para este cabeçalho#Argumentos nomeados arbitrários podem ser passadas em um dicionário para a view de destino. Nós não vamos usar este recurso do Django neste tutorial.
\npath() argument: nameLink para este cabeçalho#Nomear sua URL permite que você referencie ela de forma inequívoca de qualquer lugar no Django especialmente nos templates. Este poderoso recurso permite que você faça alterações globais nos padrões de URL de seu projeto enquanto modifica um único arquivo.
\nQuando estiver confortável com o básico da sequência de request e response, leia part 2 of this tutorial para começar a trabalhar com banco de dados.
\n