# Django 5.2.8 - dokumentacja

# Dokumentacja Django

Wszystko, co powinieneś wiedzieć o 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 | Część 8: Dodawanie pakietów od osób trzecich

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

## Uzyskiwanie pomocy

Masz kłopoty? Chcemy pomóc!

- Wypróbuj FAQ – zawiera ono odpowiedzi na wiele często zadawanych pytań.

- Szukasz konkretnej informacji? Wypróbuj indeks ogólny, indeks modułów lub szczegółowy spis treści.

- Nic nie znalazłeś? W Często zadawane pytania: Uzyskiwanie pomocy znajdziesz informacje na temat zasięgania pomocy i zadawania pytań społeczności.

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

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

## 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 | Wsparcie asynchroniczności

- 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 | Własny backend szablonów

## 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

- Deployment: Przegląd | Serwery WSGI | Serwery ASGI | Pliki statyczne | Śledzenie błędów kodu przez email | Checklista deploymedntu

## Panel administracyjny

Dowiedz się wszystkiego na temat zautomatyzowanego interfejsu administracyjnego - jednej z najpopularniejszych funkcji Django.

- Panel administracyjny

- Akcje w panelu administracyjnym

- Generator dokumentacji panelu administracyjnego

## Bezpieczeństwo

Bezpieczeństwo jest tematem najwyższej wagi podczas tworzenia aplikacji webowych. Django dostarcza wielu narzędzi ochronnych i mechanizmów:

- Omówienie bezpieczeństwa

- Ujawnione błędy bezpieczeństwa w Django

- Ochrona przed atakami typu clickjacking

- Ochrona przed atakami typu CSRF

- Podpisywanie kryptograficzne

- Middleware bezpieczeństwa

## 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:

- Przegląd | Internacjonalizacja | Lokalizacja | Zlokalizowane formatowanie interfejsu webowego i wejście formularzy

- Strefy czasowe

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

- Omówienie wydajności i optymalizacji

## 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:

- Warunkowe przetwarzanie zawartości

- Typy zawartości i relacje generyczne

- Flatpages

- Przekierowania

- Sygnały

- Framework sprawdzania poprawności działania

- Framework „witryn”

- Unicode w Django

## Open-source’owy projekt Django

Dowiedz się o procesie rozwoju projektu Django i o tym jak możesz go współtworzyć:

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

- 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