Skip to content

Commit b3e37aa

Browse files
author
Jakub Drozdek
committed
Add translation style guide in Polish
1 parent 6dea652 commit b3e37aa

File tree

1 file changed

+96
-0
lines changed

1 file changed

+96
-0
lines changed

TRANSLATION.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
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.

0 commit comments

Comments
 (0)