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:
- Models: Introdução ao “Models” | Tipos de campos | Índices | Opções da Meta | A classe Model
- QuerySets: Making queries | QuerySet method reference | Lookup expressions
- 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.
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:
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