diff --git a/13/README-pl.md b/13/README-pl.md index 0c1a784..1339aae 100644 --- a/13/README-pl.md +++ b/13/README-pl.md @@ -150,6 +150,6 @@ Mniej ekstremalnym przykładem tej techniki jest następujący kod, w którym za
-Zakrzywienie współrzędnych tekstury za pomocą szumu może być bardzo użyteczne, daje dużo frajdy, ale jest diabelnie trudne do opanowania. Jest to potężne narzędzie, ale potrzeba sporo doświadczenia, aby dobrze je wykorzystać. Przydatnym narzędziem do tego jest przemieszczanie współrzędnych za pomocą pochodnej (gradientu) szumu. [Na tym pomyśle opiera się słynny artykuł Kena Perlina i Fabrice'a Neyreta o nazwie "flow noise"](http://evasion.imag.fr/Publications/2001/PN01/). Niektóre nowoczesne implementacje szumu Perlina zawierają wariant, który oblicza zarówno funkcję, jak i jej analityczny gradient. Jeśli "prawdziwy" gradient nie jest dostępny dla proceduralnej funkcji, zawsze możesz obliczyć skończone różnice, aby ją przybliżyć, chociaż jest to mniej dokładne i wymaga więcej pracy. +Zakrzywianie współrzędnych tekstury za pomocą szumu może być bardzo użyteczne, daje dużo frajdy, ale jest diabelnie trudne do opanowania. Jest to potężne narzędzie, ale potrzeba sporo doświadczenia, aby dobrze je wykorzystać. Przydatnym narzędziem do tego jest przemieszczanie współrzędnych za pomocą pochodnej (gradientu) szumu. [Na tym pomyśle opiera się słynny artykuł Kena Perlina i Fabrice'a Neyreta o nazwie "flow noise"](http://evasion.imag.fr/Publications/2001/PN01/). Niektóre nowoczesne implementacje szumu Perlina zawierają wariant, który oblicza zarówno funkcję, jak i jej gradient. Jeśli gradient nie jest istnieje, zawsze możesz obliczyć skończone różnice (różnica między sąsiadującymi pikselami), aby go przybliżyć, chociaż jest to mniej dokładne i wymaga więcej pracy. diff --git a/README-pl.md b/README-pl.md index 70b23b4..6898e47 100644 --- a/README-pl.md +++ b/README-pl.md @@ -56,7 +56,7 @@ * Reflect and refract * [Dodatek:](appendix/) Inne sposoby korzystania z tej książki - * [Jak korzystać z tej książki offline?](appendix/00/) + * [Jak mogę korzystać z tej książki offline?](appendix/00/) * [Jak uruchomić przykłady na Raspberry Pi?](appendix/01/) * [Jak wydrukować tę książkę?](appendix/02/) * [Jak mogę pomóc?](appendix/03/) diff --git a/appendix/00/README-pl.md b/appendix/00/README-pl.md new file mode 100644 index 0000000..0e67325 --- /dev/null +++ b/appendix/00/README-pl.md @@ -0,0 +1,41 @@ +## Jak mogę korzystać z tej książki offline? + +Powiedzmy, że masz przed sobą długą podróż i chcesz ją wykorzystać do nauczenia się kilku shaderów. W takim przypadku możesz zrobić lokalną kopię tej książki na swoim komputerze i uruchomić lokalny serwer. + +Do tego potrzebujesz tylko PHP, Pythona 3 i Git'a. Na komputerach z systemem macOS i Raspberry Pi Python jest zainstalowany domyślnie, ale musisz jeszcze zainstalować PHP i klienta Git. W tym celu: + + + +Na **MacOSX** musisz mieć zainstalowane [homebrew](http://brew.sh/) by następnie w terminalu uruchomić: + +```bash +brew update +brew upgrade +brew install git php +``` + +Na **Raspberry Pi** potrzebujesz [Raspbian](https://www.raspberrypi.org/downloads/raspbian/), opartej na Debianie dystrybucji Linuxa, by następnie uruchomić: + +```bash +sudo apt-get update +sudo apt-get upgrade +sudo apt-get install git-core glslviewer php +``` + +Gdy masz już wszystko zainstalowane wystarczy uruchomić: + + + +```bash +cd ~ +git clone --recursive https://github.com/patriciogonzalezvivo/thebookofshaders.git +cd thebookofshaders +git submodule foreach git submodule init && git submodule update +php -S localhost:8000 +``` + +Następnie otwórz swoją przeglądarkę na [`http://localhost:8000/`](http://localhost:8000/) diff --git a/appendix/01/README-pl.md b/appendix/01/README-pl.md new file mode 100644 index 0000000..fbd7475 --- /dev/null +++ b/appendix/01/README-pl.md @@ -0,0 +1,28 @@ +## Jak uruchomić przykłady na Raspberry Pi? + +Jeszcze kilka lat temu założenie, że każdy ma komputer z procesorem graficznym było dalekie od prawdy. Teraz większość komputerów ma GPU, ale to wciąż wysoka poprzeczka. + +Dzięki [Fundacji Raspberry Pi](http://www.raspberrypi.org/) nowy typ małych i tanich komputerów nowej generacji (około 35 dolarów za sztukę) trafił do sal lekcyjnych. Co ważniejsze dla celów tej książki, [Raspberry Pi](http://www.raspberrypi.org/) jest wyposażone w przyzwoity procesor graficzny Broadcom, do którego można uzyskać dostęp bezpośrednio z konsoli. Stworzyłem [elastyczne narzędzie do kodowania GLSL na żywo o nazwie **glslViewer**](https://github.com/patriciogonzalezvivo/glslViewer), które uruchamia wszystkie przykłady zawarte w tej książce. Program ten automatycznie się odswieża, gdy użytkownik zapisze zmiany w swoim kodzie. Co to oznacza? Możesz edytować shader i za każdym razem, gdy go zapiszesz, shader zostanie ponownie skompilowany i wyrenderowany za Ciebie. + + + +Robiąc lokalną kopię repozytorium tej książki (zobacz poprzedni rozdział) i mając [zainstalowany `glslViewer`](https://github.com/patriciogonzalezvivo/glslViewer), użytkownicy mogą uruchamiać przykłady za pomocą `glslviewer`. Dodając flagę `-l` mogą oni renderować przykład w rogu ekranu, podczas gdy modyfikują go za pomocą dowolnego edytora tekstu (jak `nano`, `pico`, `vi`, `vim` lub `emacs`). Działa to również przy połączeniu przez ssh/sftp. + +Aby zainstalować i skonfigurować to wszystko na Raspberry Pi, po zainstalowaniu [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) (dystrybucja Linuksa oparta na Debianie, stworzona dla Raspberry Pi) i zalogowaniu się, wpisz następujące polecenia: + + + +```bash +sudo apt-get update +sudo apt-get upgrade +sudo apt-get install git-core glslviewer +cd ~ +git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git +cd thebookofshaders +``` diff --git a/appendix/02/README-pl.md b/appendix/02/README-pl.md new file mode 100644 index 0000000..6ac38a8 --- /dev/null +++ b/appendix/02/README-pl.md @@ -0,0 +1,107 @@ +## Jak wydrukować tę książkę? + +Powiedzmy, że nie chcesz nawigować ani wchodzić w interakcje z przykładami i chcesz po prostu mieć starą dobrą książkę tekstową, którą możesz czytać na plaży lub podczas dojazdu do miasta. W takim przypadku możesz wydrukować tę książkę. + + +#### Instalacja programu glslViewer + +Aby wydrukować tę książkę, musisz najpierw ją przetworzyć. W tym celu będziesz potrzebował [`glslViewer`](https://github.com/patriciogonzalezvivo/glslViewer) - konsolowego narzędzia do shaderów, które skompiluje i przekształci przykłady shaderów w obrazy. + + + +W **MacOSX** upewnij się, że masz zainstalowany [homebrew](http://brew.sh/), a następnie w terminalu wykonaj: + + + +```bash +brew install glslviewer +``` + +Na **Raspberry Pi** należy pobrać [Raspbian](https://www.raspberrypi.org/downloads/raspbian/), dystrybucję Linuksa opartą na Debianie, stworzoną dla Raspberry Pi, a następnie wykonać: + + + +```bash +sudo apt-get update +sudo apt-get upgrade +sudo apt-get install git-core glslviewer +``` + +#### Instalacja Pythona 3, silnika Latex i Pandoc + +Do parsowania Markdowna do Latexa, a następnie do pliku PDF użyjemy Xetex Latex Engine i Pandoc. + +W **MacOSX**: + +Pobierz i zainstalluj MacTeX: + + + +```bash +brew cask install mactex-no-gui +``` + +a następnie zainstalowuj [Pandoc](http://johnmacfarlane.net/pandoc/) i Python 3 przez: + + + +```bash +brew install pandoc python +``` + +Na **Raspberry Pi** (Raspbian): + +```bash +sudo apt-get install texlive-xetex pandoc python2.7 +``` + +#### Skompiluj książkę do pdf i wydrukuj ją + +Teraz, gdy masz już wszystko, czego potrzebujesz, nadszedł czas na sklonowanie [repozytorium tej książki](https://github.com/patriciogonzalezvivo/thebookofshaders) i skompilowanie książki. + +W tym celu otwórz jeszcze raz swój terminal i wpisz: + + + +```bash +cd ~ +git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git +cd thebookofshaders +make clean pdf +``` + +Jeśli wszystko pójdzie dobrze, zobaczysz plik `book.pdf`, który możesz przeczytać na swoim ulubionym urządzeniu lub wydrukować. + +#### Skompiluj książkę do postaci epub, aby użyć jej w e-czytniku. + + + +```bash +cd ~ +git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git +cd thebookofshaders +make clean epub +``` + +Wygenerowany `book.epub` może być użyty bezpośrednio, lub przekonwertowany, za pomomocą, na przykład, Calibre, na plik `.mobi` do użytku z Kindle. + + diff --git a/appendix/03/README-pl.md b/appendix/03/README-pl.md new file mode 100644 index 0000000..c0bb318 --- /dev/null +++ b/appendix/03/README-pl.md @@ -0,0 +1,113 @@ +## Jak mogę pomóc? + +Dziękujemy za chęć współpracy! Jest wiele sposobów pomocy: + +- Tłumaczenie treści +- Poprawianie [sekcji ```glosariusz/```](https://github.com/patriciogonzalezvivo/thebookofshaders/tree/master/glossary) +- Edytowanie zawartości +- Dzielenie się swoimi przykładami shaderów poprzez [edytor on-line](http://editor.thebookofshaders.com/) + + + +### Tłumaczenie treści + +Ta książka jest napisana w [języku Markdown](https://daringfireball.net/projects/markdown/syntax), więc bardzo łatwo jest ją edytować i pracować nad nią. + +1. Zacznij od przejścia do [repozytorium github pod adresem ``github.com/patriciogonzalezvivo/thebookofshaders``](https://github.com/patriciogonzalezvivo/thebookofshaders). Przyjrzyj się znajdującym się w nim plikom i folderom. Zauważysz, że treść znajduje się w pliku ``README.md`` oraz innych plikach z dużymi literami jak: ``TITLE.md``, ``SUMMARY.md``, itd. Zauważ również, że tłumaczenia są hostowane w plikach z nazwami kończącymi się na dwie litery reprezentujące język tłumaczenia, na przykład: ``README-jp.md``, ``README-es.md``, itd. + + + +2. Forkuj repozytorium i sklonuj je w swoim komputerze. + +3. Zduplikuj zawartość plików, które chcesz przetłumaczyć. Pamiętaj, aby do plików, nad którymi będziesz pracował, dodać dwie litery nawiązujące do języka, który tłumaczysz. + +4. Przetłumacz treść linijka po linijce (patrz **Uwagi dotyczące tłumaczenia**). + +5. Przetestuj ją (patrz **Testy**). + +6. Pushuj na własny fork githuba, aby następnie zrobić [Pull Request](https://help.github.com/articles/using-pull-requests/) + + + +#### Uwagi dotyczące tłumaczenia + +Nie wymazuj ani nie modyfikuj rzeczy w osadzonych przykładach, wyglądających tak: + + + +```html +
+``` + +lub + +```html +
+``` + +#### Testowanie + +Rozpocznij uruchamianie lokalnego serwera PHP wewnątrz lokalnego folderu repozytorium: + + + +```bash +php -S localhost:8000 +``` + +Następnie w przeglądarce wyszukaj ``localhost:8000``, przejdź do rozdziału, który tłumaczysz i dodaj ``?lan=``, a następnie dwie litery, których użyłeś do oznaczenia języka, na który tłumaczysz. + +Na przykład, jeśli tłumaczysz rozdział ``03`` na język francuski pracowałeś z plikiem ``03/README-fr.md``, to możesz go przetestować wchodząc na: ``http://localhost:8000/03/?lan=fr`` + + + +### Ulepszanie glosariusza + +Glosariusz jest w trakcie rozwoju. Chętnie wysłuchamy Twoich pomysłów, jak uczynić ją przyjaznym narzędziem dla wszystkich. Wyślij nam wiadomość na adres [@bookofshaders](https://twitter.com/bookofshaders). + +### Edycja treści + +Wszyscy jesteśmy ludźmi. Jeśli widzisz błąd, daj znać i zrób Pull Request lub otwórz Issue. Dzięki! + + + +### Dzielenie się przykładami shaderów + +Zobaczysz wiele linków do [edytora on-line](http://editor.thebookofshaders.com/) i jego osadzonych instancji. +Gdy zakodujesz coś, co sprawi, że będziesz dumny, kliknij "Export" (lub ikonę ``⇪``), a następnie skopiuj "URL to code...". Wyślij go do [@bookofshaders](https://twitter.com/bookofshaders) lub [@kyndinfo](https://twitter.com/kyndinfo). Czekamy na nie i dodamy je do [działu galeria przykładów](https://thebookofshaders.com/examples/). + + diff --git a/appendix/README-pl.md b/appendix/README-pl.md new file mode 100644 index 0000000..5f0c4e0 --- /dev/null +++ b/appendix/README-pl.md @@ -0,0 +1,32 @@ +# Dodatek + +1. [Jak mogę nawigować po tej książce w trybie off-line?](00/) + +2. [Jak uruchomić przykłady na Raspberry Pi?](01/) + +3. [Jak wydrukować tę książkę?](02/) + +4. [Jak współpracować przy tworzeniu tej książki?](03/) + +5. [Wprowadzenie dla osób pochodzących z JS](04/) autorstwa [Nicolas Barradeau](http://www.barradeau.com/) + +6. [Wprowadzenie dla wektorów](05/) autorstwa ... + +7. [Wprowadzenie do interpolacji](06) przez ... + + +