🌐 Add Polish translation for `docs/pl/docs/tutorial/index.md` (#4516)

Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>

diff --git a/docs/pl/docs/tutorial/index.md b/docs/pl/docs/tutorial/index.md
new file mode 100644 (file)
index 0000000..1a97214
--- /dev/null
+++ b/docs/pl/docs/tutorial/index.md
@@ -0,0 +1,81 @@
+# Samouczek - Wprowadzenie
+
+Ten samouczek pokaże Ci, krok po kroku, jak używać większości funkcji **FastAPI**.
+
+Każda część korzysta z poprzednich, ale jest jednocześnie osobnym tematem. Możesz przejść bezpośrednio do każdego rozdziału, jeśli szukasz rozwiązania konkretnego problemu.
+
+Samouczek jest tak zbudowany, żeby służył jako punkt odniesienia w przyszłości.
+
+Możesz wracać i sprawdzać dokładnie to czego potrzebujesz.
+
+## Wykonywanie kodu
+
+Wszystkie fragmenty kodu mogą być skopiowane bezpośrednio i użyte (są poprawnymi i przetestowanymi plikami).
+
+Żeby wykonać każdy przykład skopiuj kod to pliku `main.py` i uruchom `uvicorn` za pomocą:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+**BARDZO zalecamy** pisanie bądź kopiowanie kodu, edycję, a następnie wykonywanie go lokalnie.
+
+Użycie w Twoim edytorze jest tym, co pokazuje prawdziwe korzyści z FastAPI, pozwala zobaczyć jak mało kodu musisz napisać, wszystkie funkcje, takie jak kontrola typów, <abbr title="auto-complete, autocompletion, IntelliSense">automatyczne uzupełnianie</abbr>, itd.
+
+---
+
+## Instalacja FastAPI
+
+Jako pierwszy krok zainstaluj FastAPI.
+
+Na potrzeby samouczka możesz zainstalować również wszystkie opcjonalne biblioteki:
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[all]"
+
+---> 100%
+```
+
+</div>
+
+...wliczając w to `uvicorn`, który będzie służył jako serwer wykonujacy Twój kod.
+
+!!! note
+    Możesz również wykonać instalację "krok po kroku".
+
+    Prawdopodobnie zechcesz to zrobić, kiedy będziesz wdrażać swoją aplikację w środowisku produkcyjnym:
+
+    ```
+    pip install fastapi
+    ```
+
+    Zainstaluj też `uvicorn`, który będzie służył jako serwer:
+
+    ```
+    pip install "uvicorn[standard]"
+    ```
+
+    Tak samo możesz zainstalować wszystkie dodatkowe biblioteki, których chcesz użyć.
+
+## Zaawansowany poradnik
+
+Jest też **Zaawansowany poradnik**, który możesz przeczytać po lekturze tego **Samouczka**.
+
+**Zaawansowany poradnik** opiera się na tym samouczku, używa tych samych pojęć, żeby pokazać Ci kilka dodatkowych funkcji.
+
+Najpierw jednak  powinieneś przeczytać **Samouczek** (czytasz go teraz).
+
+Ten rozdział jest zaprojektowany tak, że możesz stworzyć kompletną aplikację używając tylko informacji tutaj zawartych, a następnie rozszerzać ją na różne sposoby, w zależności od potrzeb, używając kilku dodatkowych pomysłów z **Zaawansowanego poradnika**.
+

diff --git a/docs/pl/mkdocs.yml b/docs/pl/mkdocs.yml
index 67b41fe538aa70a75e193ddb4df3cc81fcd42b11..932a43da470d62f10d4c64a8acf57fcc8853b866 100644 (file)
--- a/docs/pl/mkdocs.yml
+++ b/docs/pl/mkdocs.yml
@@ -54,6 +54,8 @@ nav:
   - tr: /tr/
   - uk: /uk/
   - zh: /zh/
+- Samouczek:
+  - tutorial/index.md
 markdown_extensions:
 - toc:
     permalink: true