Documentação do Django¶

Primeiros passos¶

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

• From scratch: Overview | Installation

• Tutorial: Part 1: Requests and responses | Part 2: Models and the admin site | Part 3: Views and templates | Part 4: Forms and generic views | Part 5: Testing | Part 6: Static files | Part 7: Customizing the admin site | Part 8: Adding third-party packages

• Advanced Tutorials: How to write reusable apps | Writing your first contribution to Django

Obtendo ajuda¶

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

• Try the FAQ – it’s got answers to many common questions.

• Looking for specific information? Try the Índice, Índice do Módulo or the detailed table of contents.

• Not found anything? See FAQ: Obtendo ajuda for information on getting support and asking questions to the community.

• 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 conduzem você pela mão 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”.

• 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¶

O Django fornece uma camada de abstração (os “modelos”) para estruturar e manipular os dados de sua aplicação web. Saiba mais sobre isso abaixo:

• Models: Introduction to models | Field types | Indexes | Meta options | Model class

• QuerySets: Making queries | QuerySet method reference | Lookup expressions

• Model instances: Instance methods | Accessing related objects

• Migrations: Introduction to Migrations | Operations reference | SchemaEditor | Writing migrations

• Advanced: Managers | Raw SQL | Transactions | Aggregation | Search | Custom fields | Multiple databases | Custom lookups | Query Expressions | Conditional Expressions | Database Functions

• Other: Supported databases | Legacy databases | Providing initial data | Optimize database access | PostgreSQL specific features

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:

• The basics: URLconfs | View functions | Shortcuts | Decorators | Asynchronous Support

• Reference: Built-in Views | Request/response objects | TemplateResponse objects

• File uploads: Overview | File objects | Storage API | Managing files | Custom storage

• Class-based views: Overview | Built-in display views | Built-in editing views | Using mixins | API reference | Flattened index

• Advanced: Generating CSV | Generating PDF

• Middleware: Overview | Built-in middleware classes

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:

• The basics: Overview

• For designers: Language overview | Built-in tags and filters | Humanization

• For programmers: Template API | Custom tags and filters | Custom template backend

Formulários¶

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

• The basics: Overview | Form API | Built-in fields | Built-in widgets

• Advanced: Forms for models | Integrating media | Formsets | Customizing validation

O processo de desenvolvimento¶

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

• Settings: Overview | Full list of settings

• Applications: Overview

• Exceptions: Overview

• django-admin and manage.py: Overview | Adding custom commands

• Testing: Introduction | Writing and running tests | Included testing tools | Advanced topics

• Deployment: Overview | WSGI servers | ASGI servers | Deploying static files | Tracking code errors by email | Deployment checklist

O Admin¶

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

• Admin site

• Admin actions

• Admin documentation generator

Segurança¶

A segurança é um tema de suma importância no desenvolvimento de aplicações web e o Django oferece múltiplas ferramentas e mecanismos de proteção:

• Security overview

• Disclosed security issues in Django

• Clickjacking protection

• Cross Site Request Forgery protection

• Cryptographic signing

• Middleware de segurança

• Content Security Policy

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:

• Overview | Internationalization | Localization | Localized web UI formatting and form input

• 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.

• Performance and optimization overview

Framework geográfico¶

GeoDjango intends to be a world-class geographic web framework. Its goal is to make it as easy as possible to build GIS web applications and harness the power of spatially enabled data.

Ferramentas comuns de aplicação web¶

O Django oferece várias ferramentas comumente necessárias no desenvolvimento de aplicações web:

• Authentication: Overview | Using the authentication system | Password management | Customizing authentication | API Reference

• Caching

• Logging

• Tasks framework

• Sending emails

• Syndication feeds (RSS/Atom)

• Pagination

• Messages framework

• Serialization

• Sessions

• Sitemaps

• Static files management

• Data validation

Outras funcionalidades¶

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

• Conditional content processing

• Content types and generic relations

• Flatpages

• Redirects

• Signals

• System check framework

• The sites framework

• Unicode in Django

O projeto de código-aberto Django¶

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

• Community: Contributing to Django | The release process | Team organization | The Django source code repository | Security policies | Mailing lists and Forum

• Design philosophies: Overview

• Documentation: About this documentation

• Third-party distributions: Overview

• Django over time: API stability | Release notes and upgrading instructions | Deprecation Timeline