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 | Pisane pierwszej poprawki do Django
Warstwa modelu¶
Django udostępnia warstwę abstrakcji („modeli”) do strukturyzacji i manipulowania danymi twojej aplikacji WWW. Dowiedz się więcej poniżej:
Modele: Wprowadzenie do modeli | Typy pól | Opcje meta | Klasa Model
QuerySety: Wykonywanie 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.
Kompatybilność Pythona¶
Celem Django kompatybilność z wieloma różnymi odmianami i wersjami Pythona:
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
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 | Poznaj zespół Django | Bieżące role | 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