Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

馃寪 Add Polish translation for docs/pl/docs/tutorial/index.md #4516

Merged
merged 5 commits into from May 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
81 changes: 81 additions & 0 deletions 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.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<abbr title="auto-complete, autocompletion, IntelliSense"></abbr> tag is a nice addon I liked it, indeed I found very few browser search engine results for "automatyczne uzupe艂nianie", and hardly any is related with "autocompletion".

Anyway I would go for
U偶ycie w Twoim edytorze jest tym, co pokazuje prawdziwe korzy艣ci z FastAPI, pozwala zobaczy膰 jak ma艂o kodu musisz napisa膰 oraz wszystkie jego 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**.

2 changes: 2 additions & 0 deletions docs/pl/mkdocs.yml
Expand Up @@ -54,6 +54,8 @@ nav:
- tr: /tr/
- uk: /uk/
- zh: /zh/
- Samouczek:
- tutorial/index.md
markdown_extensions:
- toc:
permalink: true
Expand Down