From b296adc9459c7d9736be94080a2a24617aa90378 Mon Sep 17 00:00:00 2001 From: Maciej Kaczkowski Date: Sat, 5 Feb 2022 16:32:55 +0100 Subject: [PATCH 1/4] draft translation for /docs/pl/tutorial/index.md --- docs/pl/docs/tutorial/index.md | 81 ++++++++++++++++++++++++++++++++++ docs/pl/mkdocs.yml | 2 + 2 files changed, 83 insertions(+) create mode 100644 docs/pl/docs/tutorial/index.md diff --git a/docs/pl/docs/tutorial/index.md b/docs/pl/docs/tutorial/index.md new file mode 100644 index 0000000000000..a6d990d041892 --- /dev/null +++ b/docs/pl/docs/tutorial/index.md @@ -0,0 +1,81 @@ +# Samouczek - Instrukcja - 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ą: + +
+ +```console +$ uvicorn main:app --reload + +INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) +INFO: Started reloader process [28720] +INFO: Started server process [28722] +INFO: Waiting for application startup. +INFO: Application startup complete. +``` + +
+ +**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, autouzupełnianie, itd. + +--- + +## Instalacja FastAPI + +Jako pierwszy krok zainstaluj FastAPI. + +Na potrzeby samouczka lepiej zainstaluj ze wszystkimi opcjonalnymi zależnościami i funkcjami: + +
+ +```console +$ pip install "fastapi[all]" + +---> 100% +``` + +
+ +...wliczając w to `uvicorn`, który będzie służył jako serwer wykonujacy Twój kod. + +!!! note + You can also install it part by part. + + This is what you would probably do once you want to deploy your application to production: + + ``` + pip install fastapi + ``` + + Also install `uvicorn` to work as the server: + + ``` + pip install "uvicorn[standard]" + ``` + + And the same for each of the optional dependencies that you want to use. + +## Instrukcja dla zaawansowanych + +Jest też **Instrukcja dla zaawansowanych**, którą możesz przeczytać po lekturze tego **Samouczka - Instrukcji**. + +**Instrukcja dla zaawansowanych**, opiera się na tym samouczku, używa tych samych pojęć, żeby pokazać Ci kilka dodatkowych funkcji. + +Najpierw przeczytaj **Samouczek - Instrukcja** (czytasz to teraz). + +Samouczek jest zaprojektowany tak, że możesz stworzyć kompletną aplikację używając tylko **Samouczka - Instrukcji**, a następnie rozszerzać ją na różne sposoby, w zależności od potrzeb, używając kilku dodatkowych pomysłów z **Instrukcji dla zaawansowanych** + diff --git a/docs/pl/mkdocs.yml b/docs/pl/mkdocs.yml index 3c1351a127ae2..a216b07c0f29a 100644 --- a/docs/pl/mkdocs.yml +++ b/docs/pl/mkdocs.yml @@ -52,6 +52,8 @@ nav: - tr: /tr/ - uk: /uk/ - zh: /zh/ +- Tutorial - User Guide: + - tutorial/index.md markdown_extensions: - toc: permalink: true From b6cd0a903d7ffddb95ba07df1342dcde06e9a265 Mon Sep 17 00:00:00 2001 From: Maciej Kaczkowski Date: Sun, 6 Feb 2022 07:34:43 +0100 Subject: [PATCH 2/4] update translation: hover-on english explanation --- docs/pl/docs/tutorial/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pl/docs/tutorial/index.md b/docs/pl/docs/tutorial/index.md index a6d990d041892..0d5be5ea3f121 100644 --- a/docs/pl/docs/tutorial/index.md +++ b/docs/pl/docs/tutorial/index.md @@ -30,7 +30,7 @@ $ uvicorn main:app --reload **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, autouzupełnianie, itd. +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, automatyczne uzupełnianie, itd. --- From e0ff596c5e4dd82c0db5670aa31b62b21a966d5e Mon Sep 17 00:00:00 2001 From: Maciej Kaczkowski Date: Thu, 10 Feb 2022 11:14:00 +0100 Subject: [PATCH 3/4] changed `mkdocs.yml` to comply with other translations schema; fixes and small changes in `tutorial/index.md` --- docs/pl/docs/tutorial/index.md | 24 ++++++++++++------------ docs/pl/mkdocs.yml | 2 +- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/pl/docs/tutorial/index.md b/docs/pl/docs/tutorial/index.md index 0d5be5ea3f121..00ae0773b7622 100644 --- a/docs/pl/docs/tutorial/index.md +++ b/docs/pl/docs/tutorial/index.md @@ -1,4 +1,4 @@ -# Samouczek - Instrukcja - Wprowadzenie +# Samouczek - Wprowadzenie Ten samouczek pokaże Ci, krok po kroku, jak używać większości funkcji **FastAPI**. @@ -10,7 +10,7 @@ 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) +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ą: @@ -38,7 +38,7 @@ Użycie w Twoim edytorze jest tym, co pokazuje prawdziwe korzyści z FastAPI, po Jako pierwszy krok zainstaluj FastAPI. -Na potrzeby samouczka lepiej zainstaluj ze wszystkimi opcjonalnymi zależnościami i funkcjami: +Na potrzeby samouczka możesz zainstalować również wszystkie opcjonalne biblioteki:
@@ -53,29 +53,29 @@ $ pip install "fastapi[all]" ...wliczając w to `uvicorn`, który będzie służył jako serwer wykonujacy Twój kod. !!! note - You can also install it part by part. + Możesz również wykonać instalację "krok po kroku". - This is what you would probably do once you want to deploy your application to production: + Prawdopodobnie zechcesz to zrobić, kiedy będziesz wdrażać swoją aplikację w środowisku produkcyjnym: ``` pip install fastapi ``` - Also install `uvicorn` to work as the server: + Zainstaluj tez `uvicorn`, który będzie służył jako serwer: ``` pip install "uvicorn[standard]" ``` - And the same for each of the optional dependencies that you want to use. + Tak samo możesz zainstalować wszystkie dodatkowe biblioteki, których chcesz użyć. -## Instrukcja dla zaawansowanych +## Zaawansowany poradnik -Jest też **Instrukcja dla zaawansowanych**, którą możesz przeczytać po lekturze tego **Samouczka - Instrukcji**. +Jest też **Zaawansowany poradnik**, który możesz przeczytać po lekturze tego **Samouczka**. -**Instrukcja dla zaawansowanych**, opiera się na tym samouczku, używa tych samych pojęć, żeby pokazać Ci kilka dodatkowych funkcji. +**Zaawansowany poradnik** opiera się na tym samouczku, używa tych samych pojęć, żeby pokazać Ci kilka dodatkowych funkcji. -Najpierw przeczytaj **Samouczek - Instrukcja** (czytasz to teraz). +Najpierw jednak powinieneś przeczytać **Samouczek** (czytasz go teraz). -Samouczek jest zaprojektowany tak, że możesz stworzyć kompletną aplikację używając tylko **Samouczka - Instrukcji**, a następnie rozszerzać ją na różne sposoby, w zależności od potrzeb, używając kilku dodatkowych pomysłów z **Instrukcji dla zaawansowanych** +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 a216b07c0f29a..3538e1d81b96a 100644 --- a/docs/pl/mkdocs.yml +++ b/docs/pl/mkdocs.yml @@ -52,7 +52,7 @@ nav: - tr: /tr/ - uk: /uk/ - zh: /zh/ -- Tutorial - User Guide: +- Samouczek: - tutorial/index.md markdown_extensions: - toc: From f25414fd93565e53b879d23ffa83c3b61b6af669 Mon Sep 17 00:00:00 2001 From: Maciej Kaczkowski Date: Thu, 10 Feb 2022 11:20:01 +0100 Subject: [PATCH 4/4] typofix --- docs/pl/docs/tutorial/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pl/docs/tutorial/index.md b/docs/pl/docs/tutorial/index.md index 00ae0773b7622..1a97214af8ef5 100644 --- a/docs/pl/docs/tutorial/index.md +++ b/docs/pl/docs/tutorial/index.md @@ -61,7 +61,7 @@ $ pip install "fastapi[all]" pip install fastapi ``` - Zainstaluj tez `uvicorn`, który będzie służył jako serwer: + Zainstaluj też `uvicorn`, który będzie służył jako serwer: ``` pip install "uvicorn[standard]"