---
title: "Co czytać dalej"
version: 5.1
locale: pl
source: https://docs.djangoproject.com/pl/5.1/intro/whatsnext/
canonical: https://djangodocs.dev/pl/5.1/intro/whatsnext/
---
# Co czytać dalej

Więc przeczytałeś cały [materiał wprowadzający](/pl/5.1/intro/) i zdecydowałeś, że chciałbyś dalej używać Django. Tym wprowadzeniem tylko musnęliśmy powierzchnię (w rzeczywistości jeśli przeczytałeś każde słowo, przeczytałeś około 5% całej dokumentacji).

Więc co dalej?

Cóż, zawsze byliśmy wielkimi fanami nauki przez robienie. W tym miejscu powinieneś wiedzieć wystarczająco dużo, aby rozpocząć własny projekt i zacząć się wygłupiać. Kiedy będziesz potrzebował nauczyć się nowych trików, wróć do dokumentacji.

Włożyliśmy wiele wysiłku w uczynienie dokumentacji Django użyteczną, przejrzystą i możliwie wyczerpującą. Reszta tego dokumentu wyjaśnia więcej jak działa dokumentacja, abyś mógł z niej dostać jak najwięcej.

(Tak, to jest dokumentacja dokumentacji. Bądź spokojny – nie mamy planów pisać dokumentu o tym, jak czytać dokument o dokumentacji.)

## Odnajdywanie dokumentacji

Django ma *obszerną* dokumentację – prawie 450 000 słów i więcej – więc odnalezienie tego, co potrzebujesz, może czasem być zawiłe. Dobrym miejscem do startu jest [Indeks](/pl/5.1/genindex/). Polecamy też użycie wbudowanej funkcji wyszukiwania.

Lub możesz po prostu przeglądać zawartość!

## Jak zorganizowana jest dokumentacja

Główna dokumentacja Django jest rozbita na kawałki zaprojektowane, by spełniać różne potrzeby:

- [Materiał wprowadzający](/pl/5.1/intro/) jest zaprojektowany dla ludzi nowych w Django – lub ogólnie w web-dewelopmencie. Nie omawia nic szczegółowo, lecz daje przegląd na wysokim poziomie abstrakcji „jak to jest” dewelopować w Django.
- [Przewodniki tematyczne](/pl/5.1/topics/) z drugiej strony zanurzają się głęboko w poszczególne części Django. Są tu pełne przewodniki po [systemie modeli](/pl/5.1/topics/db/), [silniku szablonów](/pl/5.1/topics/templates/), [frameworku formularzy](/pl/5.1/topics/forms/) Django i wiele więcej.

  To prawdopodobnie miejsce, gdzie będziesz chciał spędzić większość swojego czasu;  jeśli przepracujesz na swój sposób te przewodniki, powinieneś wyjść wiedząc praktycznie wszystko, co można wiedzieć o Django.
- Web dewelopment jest często szeroki, nie głęboki – problemy rozciągają się na wiele domen. Napisaliśmy zestaw [przewodników how-to](/pl/5.1/howto/), które odpowiadają na częste pytania „Jak to zrobić?”. Znajdziesz tu informacje o [generowaniu PDF-ów z Django](/pl/5.1/howto/outputting-pdf/), [pisaniu własnych tagów szablonów](/pl/5.1/howto/custom-template-tags/) i więcej.

  Odpowiedzi na naprawdę powszechne pytania znajdują się też w [FAQ](/pl/5.1/faq/).
- Przewodniki i przewodniki how-to nie omawiają każdej klasy, funkcji i metody dostępnej w Django – byłoby to przytłaczające podczas prób nauki. Zamiast tego szczegóły na temat poszczególnych klas, funkcji, metod i modułów są trzymane w [dokumentacji](/pl/5.1/ref/). To tu będziesz się zwracał, aby znaleźć szczegóły wybranej funkcji lub czegokolwiek będziesz potrzebował.
- Jeśli jesteś zainteresowany deplojowaniem projektu do publicznego użytku, nasze docs mają parę przewodników\</howto/depolyment/index\> dla różnych konfiguracji deploymentowych jak i [checklistę deploymentu](/pl/5.1/howto/deployment/checklist/) z kilkoma rzeczami, o których będziesz musiał pomyśleć.
- Ostatecznie, jest trochę „wyspecjalizowanej” dokumentacji zazwyczaj nieistotnej dla większości deweloperów. Zawierają się w niej [informacje o wydaniach](/pl/5.1/releases/) i [dokumentacja wewnętrzna](/pl/5.1/internals/) dla tych, którzy chcą dodać kod do samego Django i [kilka innych rzeczy, które nie pasują nigdzie indziej](/pl/5.1/misc/).

## Jak dokumentacja jest aktualizowana

Tak jak baza kodu Django jest rozwijana i ulepszana na co dzień, nasza dokumentacja jest stale ulepszana. Ulepszamy dokumentację z kilku powodów:

- Aby robić poprawki treści, takie jak gramatyczno-literówkowe korekty.
- Aby dodawać informacje i/lub przykłady do istniejących sekcji, które powinny być rozszerzone.
- Aby dokumentować funkcje Django, które jeszcze nie są udokumentowane. (Lista takich funkcji kurczy się, niemniej jednak istnieje.)
- Aby dodawać dokumentację nowych funkcjonalności gdy są dodawane albo kiedy API lub zachowanie Django się zmieniają.

Dokumentacja Django jest trzymana w tym samym systemie kontroli źródeł co jego kod. Jest umieszczona w katalogu [docs](https://github.com/django/django/blob/stable/5.1.x/docs) naszego repozytorium Git. Każdy dokument online jest oddzielnym plikiem tekstowym w repozytorium.

## Gdzie ją zdobyć

Możesz czytać dokumentację Django na parę sposobów. Są to, w kolejności priorytetów:

### W internecie

Najnowsza wersja dokumentacji Django jest umieszczona w <https://docs.djangoproject.com/en/dev/>. Te strony HTML są generowane automatycznie z plików tekstowych w repozytorium. To znaczy, że odzwieciedlają one to, co „najnowsze i najlepsze” w Django – zawierają najbardziej świeże korekty i dodatki i omawiają najnowsze funkcjonalności Django, które mogą być tylko dostępne dla użytkowników developerskiej wersji Django. (Porównaj [Różnice pomiędzy wersjami](#differences-between-doc-versions) poniżej.)

Zachęcamy cię do pomocy w ulepszaniu dokumentacji przez wysyłanie zmian, korekt i sugestii przez [ticket system](https://code.djangoproject.com/). Deweloperzy Django aktywnie monitorują system zgłoszeń i skorzystają z twojego feedbacku, aby ulepszyć dokumentację dla wszystkich.

Note, however, that tickets should explicitly relate to the documentation,
rather than asking broad tech-support questions. If you need help with your
particular Django setup, try the [Django Forum](https://forum.djangoproject.com/) or the
[Django Discord server](https://chat.djangoproject.com) instead.

### Czystym tekstem

Do czytania offline lub po prostu dla wygody, możesz czytać dokumentację Django „czystym tekstem”.

Jeśli używasz oficjalnego wydania Django, zzipowany pakiet (tarball) kodu zawiera katalog `docs/`, który zawiera z kolei całą dokumentację dla tego wydania.

Jeśli używasz wersji deweloperskiej Django (vel brancha main), katalog `docs/` zawiera całą dokumentację. Możesz zaktualizować swój gitowy checkout, aby pobrać ostatnie zmiany.

Jednym nisko-poziomowym sposobem na wykorzystanie testowej dokumentacji jest użycie uniksowego narzędzia `grep` do wyszukania frazy w całej dokumentacji. Na przykład to pokaże ci każdą wzmiankę frazy „max\_length” w każdym dokumencie Django:

```console
$ grep -r max_length /path/to/django/docs/
```

*Windows*

```doscon
...\> grep -r max_length \path\to\django\docs\
```

### Jako HTML, lokalnie

Możesz uzyskać lokalną kopię dokumentacji HTML w kilku krokach:

- Dokumentacja Django używa systemu o nazwie [Sphinx](https://www.sphinx-doc.org/) do konwersji z czystego tekstu do HTML. Będziesz musiał zainstalować Sphinksa pobierając lub instalując pakiet ze strony Sphinksa lub przy użyciu `pip`a:

  ```console
  $ python -m pip install Sphinx
  ```

  *Windows*

  ```doscon
  ...\> py -m pip install Sphinx
  ```
- Następnie użyj dostępnego `Makefile`a, aby przerobić dokumentację na HTML:

  ```console
  $ cd path/to/django/docs
  $ make html
  ```

  Będziesz potrzebował do tego zainstalowanego [GNU Make](https://www.gnu.org/software/make/).

  Jeśli używasz Windows, możesz użyć alternatywnie dostępnego pliku batch:

  ```bat
  cd path\to\django\docs
  make.bat html
  ```
- Dokumentacja HTML zostanie umieszczona w `docs/_build/html`.

## Różnice pomiędzy wersjami

Tekstowa dokumentacja na branchu main naszego repozytorium Git zawiera „najnowsze i najlepsze” zmiany i dodatki. W tych zmianach zawiera się dokumentacja nowych funkcjonalności przeznaczonych do następnego [wydania feature](/pl/5.1/internals/release-process/#term-Feature-release) Django. Z tego powodu warto zwrócić uwagę na naszą politykę wyróżniania ostatnich zmian i dodatków do Django.

Realizujemy taką politykę:

- Dokumentacja deweloperska pod adresem <https://docs.djangoproject.com/en/dev/> jest z brancha main. Ta dokumentacja odpowiada ostatniemu wydaniu feature oraz wszystkim funkcjonalnościom, które zostały dodane/zmienione we frameworku od tamtej pory.
- Dodając funkcjonalności do wersji deweloperskiej Django, aktualizujemy dokumentację w tej samej transakcji commit w Gicie.
- Aby odróżnić zmiany/dodawanie funkcjonalności w dokumentacji, używamy wyrażenia: „New in Django Development version” dla wersji Django, która jeszcze nie została wydana, lub „New in version X.Y” dla wydanych wersji.
- Poprawki i ulepszenia dokumentacji mogą zostać zbackportowane do gałęzi ostatniego wydania, według osądu osoby mergującej, jednakże kiedy wersja Django [przestaje być wspierana](/pl/5.1/internals/release-process/#supported-versions-policy), ta wersja dokumentacji nie dostanie żadnych dalszych aktualizacji.
- [Główna strona dokumentacji](maindocumentationWebpage) zawiera linki do dokumentacji w poprzednich wersjach. Upewnij się, że używasz wersji dokumentacji odpowiadającej używanej przez ciebie wersji Django!