Jak mogę pomóc?

Dziękujemy za chęć współpracy! Jest wiele sposobów pomocy:

• Tłumaczenie treści
• Poprawianie sekcji glosariusz/
• Edytowanie zawartości
• Dzielenie się swoimi przykładami shaderów poprzez edytor on-line

Tłumaczenie treści

Ta książka jest napisana w języku Markdown, 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. 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.

1. Forkuj repozytorium i sklonuj je w swoim komputerze.

2. 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.

3. Przetłumacz treść linijka po linijce (patrz Uwagi dotyczące tłumaczenia).

4. Przetestuj ją (patrz Testy).

5. Pushuj na własny fork githuba, aby następnie zrobić Pull Request

Uwagi dotyczące tłumaczenia

Nie wymazuj ani nie modyfikuj rzeczy w osadzonych przykładach, wyglądających tak:

    <div class="codeAndCanvas" data="grid-making.frag"></div>

lub

<div class="simpleFunction" data="y = mod(x,2.0);"></div>

Testowanie

Rozpocznij uruchamianie lokalnego serwera PHP wewnątrz lokalnego folderu repozytorium:

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.

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 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 lub @kyndinfo. Czekamy na nie i dodamy je do działu galeria przykładów.