Skip to content

Commit a091ad0

Browse files
authored
Add translation style guide in Polish (#2)
* Add translation style guide in Polish * Add empty glossary to the style guide
1 parent 6dea652 commit a091ad0

File tree

1 file changed

+128
-0
lines changed

1 file changed

+128
-0
lines changed

Diff for: TRANSLATION.md

+128
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
# Jak tłumaczyć stronę reactjs.org?
2+
3+
Aktualny postęp tłumaczenia: https://github.com/reactjs/pl.reactjs.org/issues/1
4+
5+
## Identyfikatory nagłówków
6+
7+
Wszystkie nagłówki mają swój unikalny identyfikator, na przykład:
8+
9+
```md
10+
## Try React {#try-react}
11+
```
12+
13+
**Nie wolno** tłumaczyć tych identyfikatorów! Są one używane przez nawigację i jeśli je zmienimy, odwołania z innych stron (takie, jak to poniżej) przestaną działać!
14+
15+
```md
16+
Po więcej informacji zajrzyj do [wstępu](/getting-started#try-react).
17+
```
18+
19+
✅ TAK MOŻNA:
20+
21+
```md
22+
## Wypróbuj React {#try-react}
23+
```
24+
25+
❌ ALE TAK JUŻ NIE:
26+
27+
```md
28+
## Wypróbuj React {#wyprobuj-react}
29+
```
30+
31+
32+
## Tekst w blokach kodu
33+
34+
Tekstu w blokach kodu nie tłumaczymy, z wyjątkiem komentarzy. Jeśli chcesz, możesz też przetłumaczyć tekst w stringach, ale uważaj, żeby nie tłumaczyć tych, które mają wpływ na działanie kodu!
35+
36+
Przykład:
37+
```js
38+
// Example
39+
const element = <h1>Hello, world</h1>;
40+
ReactDOM.render(element, document.getElementById('root'));
41+
```
42+
43+
✅ TAK MOŻNA:
44+
45+
```js
46+
// Przykład
47+
const element = <h1>Hello, world</h1>;
48+
ReactDOM.render(element, document.getElementById('root'));
49+
```
50+
51+
✅ TAK TEŻ MOŻNA:
52+
53+
```js
54+
// Przykład
55+
const element = <h1>Witaj, świecie!</h1>;
56+
ReactDOM.render(element, document.getElementById('root'));
57+
```
58+
59+
❌ TAK NIE MOŻNA:
60+
61+
```js
62+
// Przykład
63+
const element = <h1>Witaj, świecie!</h1>;
64+
// "root" to identyfikator elementu.
65+
// NIE TŁUMACZYĆ!
66+
ReactDOM.render(element, document.getElementById('korzeń'));
67+
```
68+
69+
❌ TAK TYM BARDZIEJ NIE WOLNO:
70+
71+
```js
72+
// Przykład
73+
const element = <h1>Witaj, świecie!</h1>;
74+
ReactDOM.renderuj(element, dokument.znajdzElementPoId('korzeń'));
75+
```
76+
77+
## Linki zewnętrzne
78+
79+
Jeśli link zewnętrzny przenosi do artykułu ze źródła takiego jak [MDN] czy [Wikipedia], a w dodatku istnieje całkiem dobra jakościowo wersja tego artykułu w języku polskim, podmień link na wersję polską.
80+
81+
[MDN]: https://developer.mozilla.org/en-US/
82+
[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page
83+
84+
Przykład:
85+
86+
```md
87+
But if `SharedApplicationState.recordEvent` is not [idempotent](https://en.wikipedia.org/wiki/Idempotence#Computer_science_meaning), then instantiating this component multiple times could lead to invalid application state.
88+
```
89+
90+
✅ OK:
91+
92+
```md
93+
Lecz jeśli `SharedApplicationState.recordEvent` nie będzie [idempotentny](https://pl.wikipedia.org/wiki/Idempotentność), to tworzenie instancji tego komponentu wielokrotnie może spowodować błędy w stanie aplikacji.
94+
```
95+
96+
W przypadku linków, które nie mają odpowiedników (posty ze Stack Overflow, filmiki z YouTube itp.), używaj wersji oryginalnych, angielskich.
97+
98+
# Glosariusz
99+
100+
Oto kilka sugestii dotyczących tłumaczenia terminów powszechnie używanych w tego typu dokumentacji technicznej.
101+
102+
Terminy z (?) przy sugestii są do przegadania. Jeśli wiesz, jakie powinno ich być poprawne tłumaczenie i masz dowód w postaci linku/cytatu z literatury/blogów/poradni językowych, to daj znać [w odpowiednim wątku](https://github.com/reactjs/pl.reactjs.org/issues/3).
103+
104+
| Termin oryginalny | Sugestia (z literatury) |
105+
| ------------------ | ---------- |
106+
| array | |
107+
| arrow function | |
108+
| bug | |
109+
| bundler | |
110+
| camelCase | |
111+
| callback | |
112+
| controlled component | |
113+
| debugging | |
114+
| framework | |
115+
| function component | |
116+
| hook | |
117+
| key | |
118+
| lazy initialization | |
119+
| library | |
120+
| lowercase | |
121+
| props | |
122+
| React element | |
123+
| render | |
124+
| state | |
125+
| string | |
126+
| template literals | |
127+
| uppercase | |
128+
| uncontrolled component | |

0 commit comments

Comments
 (0)