Dokumentacja Django¶
Wszystko, co powinieneś wiedzieć o Django.
Uzyskiwanie pomocy¶
Masz kłopoty? Chcielibyśmy pomóc!
- Wypróbuj FAQ – zawiera ono odpowiedzi na wiele często zadawanych pytań.
- Szukasz konkretnej informacji? Wypróbuj Indeks, Indeks modułów lub szczegółowy spis treści.
- Poszukaj informacji w archiwach listy mailingowej django-users albo zadaj pytanie.
- Zadaj pytanie na kanale IRC #django lub przeszukaj logi IRC, by sprawdzić, czy nie zostało zadane wcześniej.
- Zgłoś błędy w Django w naszym systemie zgłoszeń.
O strukturze dokumentacji¶
Django ma dużo dokumentacji. Ogólny przegląd, jak jest zorganizowana, pomoże ci wiedzieć, gdzie szukać poszczególnych rzeczy:
- Samouczki prowadzą cię za rękę przez kolejne kroki tworzenia aplikacji webowej. Zacznij tutaj, jeśli jesteś nowy w Django lub w tworzeniu aplikacji internetowych. Spójrz też na „Pierwsze kroki” poniżej.
- Przewodniki tematyczne omawiają kluczowe tematy i pojęcia na dość wysokim poziomie oraz zawierają przydatne informacje ogólne i wyjaśnienia.
- Podręczniki zawierają dokumentację techniczną dla interfejsów API i innych aspektów machinerii Django. Opisują, jak to działa i jak tego używać, ale zakładają podstawowe rozumienie kluczowych pojęć.
- Przewodniki „Jak to zrobić” są instrukcjami. Prowadzą cię przez kolejne kroki składające się na rozwiązanie kluczowych problemów i przypadków użycia. Są bardziej zaawansowane niż poradniki i zakładają trochę wiedzy o tym, jak działa Django.
Pierwsze kroki¶
Jesteś nowy w Django lub w programowaniu? Tu powinieneś zacząć!
- Od podstaw: Przegląd | Instalacja
- Samouczek: Część 1: Żądania i odpowiedzi | Część 2: Modele i panel administracyjny | Część 3: Widoki i szablony | Część 4: Formularze i widoki generyczne | Część 5: Testowanie | Część 6: Pliki statyczne | Część 7: Dostosowywanie panelu administracyjnego
- Zaawansowane samouczki: Jak pisać aplikacje wielokrotnego użytku | Pisanie pierwszej poprawki do Django
Warstwa modelu¶
Django udostępnia warstwę abstrakcji („modele”) do strukturyzacji i manipulowania danymi twojej aplikacji WWW. Dowiedz się więcej poniżej:
- Modele: Wprowadzenie do modeli | Typy pól | Indeksy | Opcje meta | Klasa Model
- QuerySety: Tworzenie zapytań | Dokumentacja metod w QuerySet | Wyrażenia wyszukiwania
- Instancje modeli: Metody instancji | Dostęp do obiektów powiązanych
- Migracje: Wprowadzenie do migracji | Dokumentacja operacji | SchemaEditor | Pisanie migracji
- Zaawansowane: Managery | Surowy SQL | Transakcje | Agregacja | Wyszukiwanie | Własne pola | Wiele baz danych | Własne wyszukiwania | Wyrażenia w zapytaniach | Wyrażenia warunkowe | Funkcje bazodanowe
- Inne: Obsługiwane bazy danych | Bazy danych starszego typu | Określanie danych początkowych | Optymalizowanie dostępu do bazy danych | Specyficzne funkcjonalności PostgreSQL
Warstwa widoku¶
Django używa idei „widoków” do hermetyzacji logiki odpowiedzialnej za przetwarzanie zapytań użytkownika i zwracania odpowiedzi. Wszystko, co potrzebujesz wiedzieć o widokach znajdziesz klikając w linki poniżej:
- Podstawy: Konfigurowanie URL-i | Funkcje widoków | Skróty | Dekoratory
- Dokumentacja: Wbudowane widoki | Obiekty zapytania/odpowiedzi | Obiekty TemplateResponse
- Wgrywanie plików: Przegląd | Obiekty File | Storage API | Zarządzanie plikami | Własny storage plików
- Widoki oparte na klasach: Przegląd | Wbudowane klasy wyświetlania | Wbudowane klasy edycji | Używanie mixinów | Dokumentacja API | Uproszczony spis
- Zaawansowane: Generowanie CSV | Generowanie PDF
- Middleware: Przegląd | Wbudowane klasy middleware
Warstwa szablonu¶
Warstwa szablonów udostępnia przyjazną dla projektantów składnię renderowania informacji prezentowanych użytkownikowi. Dowiedz się, jak ta składnia może być użyta przez projektantów i jak programiści mogą rozszerzać ją o dodatkowe funkcje:
- Podstawy: Przegląd
- Dla projektantów: Przegląd języka | Wbudowane tagi i filtry | Humanizacja
- Dla programistów: API Szablonów | Własne tagi i filtry
Formularze¶
Django oferuje rozbudowany framework ułatwiający tworzenie formularzy i manipulacje na wpisanych danych.
- Podstawy: Przegląd | API formularzy | Wbudowane pola | Wbudowane widżety
- Zaawansowane: Formularze dla modeli | Integracja z mediami | Zbiory formularzy | Dostosowanie walidacji
Proces rozwoju¶
Więcej informacji na temat poszczególnych komponentów i narzędzi, które pomogą ci w rozwoju i testowaniu aplikacji Django:
- Ustawienia: Przegląd | Pełna lista ustawień
- Aplikacje: Przegląd
- Wyjątki: Przegląd
- django-admin i manage.py: Przegląd | Dodawanie własnych komend
- Testowanie: Wprowadzenie | Pisanie i uruchamianie testów | Dołączone narzędzia testowania | Tematy zaawansowane
- Wdrażanie: Przegląd | Serwery WSGI | Pliki statyczne | Śledzenie błędów kodu przez email
Panel administracyjny¶
Dowiedz się wszystkiego na temat zautomatyzowanego interfejsu administracyjnego - jednej z najpopularniejszych funkcji Django.
Bezpieczeństwo¶
Bezpieczeństwo jest tematem najwyższej wagi podczas tworzenia aplikacji Webowych. Django dostarcza wielu narzędzi ochronnych i mechanizmów:
Internacjonalizacja i lokalizacja¶
Django posiada rozbudowany framework do internacjonalizacji i lokalizacji, aby ułatwić rozwijanie aplikacji dla wielu języków i regionów świata:
Wydajność i optymalizacja¶
Istnieje wiele różnych technik i narzędzi, które pomogą Ci uruchamiać kod szybciej i z użyciem mniejszej ilości zasobów.
Framework geograficzny¶
GeoDjango aspiruje do bycia światowej klasy geograficznym frameworkiem webowym. Jego celem jest ułatwianie, jak tylko jest to możliwe, budowania webowych aplikacji GIS i wykorzystywanie potencjału danych przestrzennych.
Powszechne narzędzia dla aplikacji Webowych¶
Django oferuje wiele powszechnych narzędzi potrzebnych do tworzenia aplikacji Webowych:
- Uwierzytelnianie: Przegląd | Korzystanie z systemu uwierzytelniania | Zarządzanie hasłami | Dostosowywanie uwierzytelniania | Dokumentacja API
- Cache’owanie
- Logowanie zdarzeń
- Wysyłanie emaili
- Syndykacja treści (RSS/Atom)
- Paginacja
- Framework powiadomień
- Serializacja
- Sesje
- Mapy strony
- Zarządzanie plikami statycznymi
- Walidacja danych
Inne podstawowe funkcjonalności¶
Dowiedz się więcej o innych podstawowych funkcjonalnościach frameworka Django:
Open-source’owy projekt Django¶
Dowiedz się o procesie rozwoju projektu Django i o tym jak możesz go współtworzyć:
- Społeczność: Jak się zaangażować | Proces wydawania nowych wersji | Organizacja zespołu | Repozytorium kodu źródłowego Django | Polityki bezpieczeństwa | Listy mailingowe
- Filozofie projektowania: Przegląd
- Dokumentacja: O tej dokumentacji
- Dystybucje stron trzecich: Przegląd
- Django na przestrzeni czasu: Stabliność API | Informacje o wydaniach i instrukcje uaktualnień | Oś czasu przestarzałych funkcji