Documentação do Django¶
Tudo o que você precisa saber sobre 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.
Busque informações nos arquivos da lista de e-mails |usuários-django| ou publique uma pergunta.
Faça uma pergunta no canal de IRC #django, ou procure nos logs do IRC para ver se esta pergunta já não foi respondida anteriormente.
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.
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
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:
Modelos: Introdução à modelos | Tipos de campos | Opções de Meta | Classes de Modelo
QuerySets: Executando consultas | Referência dos métodos de 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 | View functions | Atalhos | Decorators
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 customizados
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:
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:
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:
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.
Compatibilidade com o Python¶
Django pretente ser compatível com vários sabores e versões diferentes do Python:
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:
Outras funcionalidades¶
Saiba mais sobre algumas outras funcionalidades do núcleo do Django framework:
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 se envolver | O processo de publicação | Organização da equipe | Encontre a equipe | Regras correntes | O repositório de código do Django | Políticas de segurança | listas de e-mail
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