# Django 4.2.9.dev20231204082947 - 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
- Zaawansowane samouczki: Jak pisać aplikacje wielokrotnego użytku | Pisanie pierwszej poprawki do 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ć:

- Społeczność: Jak się zaangażować | Proces wydawania nowych wersji | Organizacja zespołu | Repozytorium kodu źródłowego Django | Polityki bezpieczeństwa | Listy mailingowe i 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