| English | Polish | Comment | | -------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | ahead-of-time compilation | kompilacja z wyprzedzeniem | | API reference | dokumentacja API | | array | tablica | | arrow function | funkcja strzałkowa | za pierwszym razem dopisek `(ang. *arrow function*)` | | assertion; to assert | asercja lub sprawdzenie; wykonać sprawdzenie lub sprawdzać, testować | | asset | zasób | | boilerplate | kod szablonowy | za pierwszym razem `(ang. *boilerplate*)` | | breaking older browsers | nie jest kompatybilny ze starszymi przeglądarkami | | bug | błąd | | build pipeline | potok budowania | | bundler | bundler | | callback | funkcja zwrotna | za pierwszym razem dopisem `(ang. *callback*)` | | camelCase | notacja "camelCase" | odmiana: `camelCasem`, ale: `camelCase'owi`, `camelCase'a` lub z dodatkiem słowa "notacja" - wtedy odmieniamy tylko to słowo | | CDN | CDN | | child component | komponent potomny | | client(s) | klient(y) | **NIE: klienci** | | commit | (na Gicie) commit, commitem, (poza Gitem) _czas._ akceptować, wdrażać, potwierdzać | | component wrapping | opakowywanie komponentu | | concept, idea | koncepcja, zagadnienie | | controlled component | komponent kontrolowany | | data | wartość, dane | | debugging | debugowanie | | destructuring assignment | przypisanie destrukturyzujące | | Dev Tools | Narzędzia deweloperskie | | development server | serwer deweloperski | | dispatcher | dyspozytor | za pierwszym razem dopisem `(ang. *dispatcher*)` | | dispatching an event | przesyłanie zdarzenia | | dummy component | sztuczny komponent | | element | element | | event handler | procedura obsługi zdarzenia | | fallback | zastępczy lub awaryjny | | focus | fokus | "ustawianie fokusu na polu formularza" lub "aktywowanie pola formularza" | | framework | framework | | generic | generyczny, ogólny, ogólnego użytku | | Git, GitHub | Git, Gitem, Gicie; GitHub, GitHubem, GitHubie | | Glossary | Słownik pojęć | | hands-on tutorial | praktyczny tutorial | | HTML entities | encje HTML | | immutable | niezmienny | za pierwszym razem dopisek `(ang. *immutable*)` | | inline condition | warunek wewnątrzliniowy | | input (data) | dane wejściowe | | JavaScript | M:JavaScript, D:JavaScriptu, C:JavaScriptowi, B:JavaScriptu, N:JavaScriptem, Ms:JavaScripcie, W:JavaScript | przymiotnik piszemy małymi literami: "javascriptowy" | | lazy initialization | leniwa inicjalizacja | za pierwszym razem `(ang. *lazy initialization*)` | | library | biblioteka | | lowercase | małymi literami | **NIE piszemy: "z małej litery"!** | | local storage | pamięć lokalna | | minify, minification | _czas._ minifikować, _rzecz._ minifikacja | | mocked component, component mock | atrapa komponentu | | opt-in | (stosowane) wedle własnego uznania | | output (data) | dane wyjściowe, rezultat, wynik | | overview | ogólne informacje | | playground | środowisko eksperymentalne | | polyfill | łatka | | primitive | typ podstawowy | | Promise | obietnica | za pierwszym razem `(ang. *promise*)` | | property | właściwość | zmienna w obiekcie | | read-only | tylko do odczytu | | render | _czas._ renderować, _rzecz._ renderowanie | alternatywa: "wyświetlać" | | (HTTP) request | _rzecz._ żądanie (HTTP), _czas._ wysyłać żądanie | | (HTTP) response | _rzecz._ odpowiedź (HTTP) | | reusable | wielokrotnego użytku | | sandbox | środowisko izolowane | | roadmap | plan działania | | section | podrozdział, rozdział, sekcja | | shallow rendering | renderowanie płytkie | | Single Page Application, SPA | aplikacja jednostronicowa | | snapshot | zrzut | | spread operator | operator rozszczepienia | | state | stan | | store | magazyn | | string | "ciąg znaków" lub "łańcuch znaków" lub "napis" lub "literał znakowy" | | syntactic sugar | lukier składniowy | za pierwszym razem `(ang. *syntactic sugar*)` | | tag [HTML] | znacznik [HTML] | | template literal | literał szablonowy | za pierwszym razem `(ang. *template literal*)` | | term | pojęcie | | throws an exception | rzuca wyjątek | | two-way binding | wiązanie dwukierunkowe | alternatywnie "one-way binding" jako "jednokierunkowe" | | UI | "UI" lub "interfejs użytkownika" | | uncontrolled component | komponent niekontrolowanie | | update | _czas._ aktualizuje, _rzecz._ aktualizacja | | uppercase | wielkimi literami | **NIE piszemy: "z wielkiej litery"!** | | Versioned Documentation | Dokumentacja wersji | | wrapper component | komponent opakowujący | # Zasady tłumaczenia ## Tytuły rozdziałów Tytuły (np. rozdziałów, książek, utworów) piszemy w cudzysłowie bądź też bez cudzysłowu, ale kursywą (patrz: [poradnia PWN](https://sjp.pwn.pl/poradnia/haslo/kursywa-czy-w-cudzyslowie;8597.html)) Przykłady: - ... znajdziesz w rozdziale pt. "Jak łączyć się z API"? - ... znajdziesz w rozdziale pt. _Jak łączyć się z API_? ## Odmiana nazw własnych - Nazwy własne odmieniamy zgodnie z obowiązującymi zasadami w języku polskim (przydatna okazuje się tu [wyszukiwarka Poradni PWN](https://sjp.pwn.pl/poradnia/szukaj/nazwy%20obce.html)). Przykłady: [Link 1](https://sjp.pwn.pl/poradnia/haslo/odmiana-obcych-nazw-wlasnych;13285.html), [Link 2](https://sjp.pwn.pl/poradnia/haslo/tlumaczenie-obcych-nazw-wlasnych;13579.html), [Link 3](https://sjp.pwn.pl/poradnia/haslo/Odmiana-obcych-nazw-firmowych;19136.html). ## Zwroty do czytelnika - Nie piszemy "Ci", "Tobie", "Twój", lecz "ci", "tobie", "twój". - Staramy się, żeby tekst był spójny i logiczny, nawet jeśli taki nie jest w oryginale. - Ten samouczek jest dość nieformalny i ma być przyjazny dla czytelnika, dlatego możemy spokojnie pisać "mamy", "robimy" itp. - Nie piszmy "zrobiłeś", "przeczytałeś" (ze wskazaniem na rodzaj męski), bo to jest kiepsko odbierane (nawet nie chodzi o równouprawnienie i tym podobne, a o sam "dysonans" podczas czytania przez kobiety ;)). ## Tłumaczenie kodu Co można tłumaczyć: - komentarze - stringi, jeśli są tylko tekstem wyświetlanym na stronie Czego nie można tłumaczyć: - nazw zmiennych, funkcji, klas - słów kluczowych - stringów, które są interpretowane przez kod (np. klasy w CSS)