Documentação do Django¶

Primeiros passos¶

Você é novo no Django ou na programação? Este é o lugar para começar!

• Do início: Visão geral | Instalação
• Tutorial: Parte 1: Requisições e respostas | Parte 2: Modelos e o site Admin | Parte 3: Views e templates | Parte 4: Forms e views genéricas | Parte 5: Testando | Part e 6: Arquivos estáticos | Parte 7: Personalizando o site admin
• Tutoriais avançados: Como escrever aplicações reutilizáveis | Escrevendo seu primeiro patch para o Django

Obtendo ajuda¶

Está com problemas? Nós gostaríamos de ajudar!

• Tente o FAQ – para obter respostas para muitas perguntas comuns.
• Procurando por alguma informação específica? Tente o Índice, Índice do Módulo ou the tabela detalhada de conteúdos.
• Não encontrou nada ? Veja o FAQ: Obtendo ajuda para informações sobre como obter suporte e pergunte a comunidade.
• Relate bugs do Django no nosso ticket tracker.

Como a documentação é organizada¶

Django tem uma grande quantidade de documentação. Uma visão geral de como ele é organizado vai te ajudar a saber aonde procurar para certas coisas:

• Tutoriais lhe acompanha, através de uma série de passos para criar uma aplicação Web. Comece aqui se você é novo no Django ou no desenvolvimento de aplicações Web. Veja também o “Primeiros passos” abaixo.
• Guia de tópicos discute temas-chave e conceitos em um nível relativamente alto, fornece explicaçõesde modo de funcionamento e informações úteis.
• Guiaa de referências contém referência técnica para APIs e outros aspectos do maquinário do Django. Eles descrevem como isso funciona e como usá-los, mas assume que você tem um entendimento básico dos conceitos chaves.
• Guias ‘How-to’ são receitas. Eles guiam você através de passos baseados na abordagem de problemas chave e casos de uso. Eles são mais avançados que os tutoriais e assumem que você já tem algum conhecimento de como o Django trabalha.

A camada de modelo¶

Django fornece uma camada de abstração (os “modelos”) para estruturação e manipulação de dados para a sua aplicação Web. Aprenda mais sobre isso abaixo:

• Models: Introdução ao “Models” | Tipos de campos | Índices | Opções da Meta | A classe Model
• QuerySets: Fazendo consultas | Referência do método QuerySet | Expressões de pesquisa
• Instâncias de modelo: Métodos de instâncias | Acessando objetos relacionados
• Migração: Introdução a Migrações | Referência de operação | SchemaEditor | Escrevendo migrações
• Avançado: Managers | Raw SQL | Transações de dados | Agregação de dados | Campos personalizados de modelo | Multiple os bancos de dados | Pesquisa customizada | Expressões de consulta | Expressões condicionais | Funções de base de dados
• Outros: Banco de dados suportados | Bancos de dados legados | Provendo dados iniciais | Otimizando acesso ao banco de dados | Características específicas do PostgreSQL

A camada de visão¶

Django tem o conceito de “views” para encapsular a lógica responsável pelo processamento de um request de um usuário e para retornar o response. Encontre tudo que você precisa saber sobre views através dos links abaixo:

• O básico: URLconfs | Funções de view | Atalhos | Decorators | Suporte assíncrono
• Referência: Views nativas | Objetos request/response | Objetos TemplateResponse
• File uploads: Visão Geral | File objects | Storage API | Managing files | Custom storage
• Class-based views: Visão Geral | modo interno para views | edição interna para views | Usando mixins | API referência | index plana
• Avançado: Gerando CSV | Gerando PDF
• Middleware: Visão geral | Classes de Middleware embutidas

A camada de template¶

A camada de template fornece uma sintaxe amigável para designers para o processamento de informações a serem apresentadas para o usuário. Aprenda como essa sintaxe pode ser usada por designers e como ela pode ser estendida por programadores:

• O basico: Visão geral
• Para designers: Visão geral da linguagem | Tags e filtros incluídos | Humanização
• Para programadores: API de Template | Tags e filtros personalizados | Backend de template personalizado

Formulários¶

Django fornece um framework rico para facilitar a criação de formulários de a manipulacação de dados do formulário.

• O básico: Visão geral | Formulário API | Built-in fields | Widgets embutidos
• Avançado: Forms para models | integrando media | Formsets | Customizando a validação

O processo de desenvolvimento¶

Aprenda sobre os vários componentes e ferramentas para ajudá-lo no desenvolvimento e teste de aplicações Django:

• Configurações: Visão global | Lista completa de configurações
• Aplicações: Visão geral
• Exceções: Visão global
• django-admin e manage.py: Visão geral | Adicionando comandos personalizados
• Testando: Introdução | Escrevendo e rodando testes | Ferramentas de testes inclusas | Tópicos avançados
• Implantação: Visão Geral | Servidores WSGI | Implantando arquivos estáticos | Reportando códigos de erros por e-mail

O Admin¶

Encontre tudo o que você precisa para conhecer sobre a interface automatizada de administração, uma das funcionalidades mais popular do Django:

• Site Admin
• Ações do Admin
• Gerador de documentação do Admin

Segurança¶

Segurança é um tema de suma importância para o desenvolvimento de aplicações Web e Django fornece várias ferramentas e mecanismos de proteção:

• Visão geral sobre segurança
• Questões de segurança divulgadas no Django
• Proteção Clickjacking
• Proteção contra Cross Site Request Forgery
• Assinatura criptográfica
• Middleware de segurança

Internacionalização e localização¶

Django oferece um robusto framework para internacionalização e localização para a auxiliá-lo no desenvolvimento de aplicações para vários idiomas e regiões do mundo:

• Visão geral | Internacionalização | Localização | Formatação de UI Web localizada e entrada de formulário
• Fusos horários

Performance e otimização¶

Há uma variedade de técnicas e ferramentas que podem ajudar a fazer com que o seu código execute com mais eficiência - mais rápido e usando menos recursos do sistema.

• Visão geral do desempenho e otimização

Framework geográfico¶

GeoDjango pretende ser um Framework web world-class geográfico. O objetivo é torná-lo tão fácil quanto possível para construir aplicações GIS Web e aproveitar o poder da disponibilidade de dados espaciais

Ferramentas genéricas para aplicações Web¶

Django oferece várias ferramentas genéricas necessárias para o desenvolvimento de aplicações Web:

• Autenticação: Visão feral | Usando o sistemas de autenticação | gerenciamento de senhas | Autenticação personalizada | API de referencia
• Cacheamento
• Logging
• Enviando emails
• Feeds (RSS/Atom)
• Paginação
• Framework de mensagens
• Serialização
• Sessões
• Sitemaps
• Gerenciamento de arquivos estáticos
• Validação de dados

Outras funcionalidades¶

Saiba mais sobre algumas outras funcionalidades do núcleo do Django framework:

• Processamento condicional de conteúdo
• Tipos de conteúdos e relações genéricas
• Flatpages
• Redirecionamentos
• Signals
• Framework de verificação do sistema
• O framework Sites
• Unicode no Django

O projeto de código-aberto Django¶

Saiba mais sobre o processo de desenvolvimento do próprio Django e como você pode contribuir:

• Comunidade: Como participar | O processo de publicação | Organização do time | O repositório do código fonte do Django | Políticas de segurança | Listas de e-mails
• Filosofias de design: Visão geral
• Documentação: Sobre esta documentação
• Distribuição de terceiros: Visão geral
• Django ao longo do tempo: Estabilidade da AP | Notas de lançamento e instruções de atualização | Cronograma de depreciação