Skip to content

Add translation style guide in Polish #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Feb 12, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
128 changes: 128 additions & 0 deletions TRANSLATION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,128 @@
# Jak tłumaczyć stronę reactjs.org?

Aktualny postęp tłumaczenia: https://github.com/reactjs/pl.reactjs.org/issues/1

## Identyfikatory nagłówków

Wszystkie nagłówki mają swój unikalny identyfikator, na przykład:

```md
## Try React {#try-react}
```

**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ć!

```md
Po więcej informacji zajrzyj do [wstępu](/getting-started#try-react).
```

✅ TAK MOŻNA:

```md
## Wypróbuj React {#try-react}
```

❌ ALE TAK JUŻ NIE:

```md
## Wypróbuj React {#wyprobuj-react}
```


## Tekst w blokach kodu

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!

Przykład:
```js
// Example
const element = <h1>Hello, world</h1>;
ReactDOM.render(element, document.getElementById('root'));
```

✅ TAK MOŻNA:

```js
// Przykład
const element = <h1>Hello, world</h1>;
ReactDOM.render(element, document.getElementById('root'));
```

✅ TAK TEŻ MOŻNA:

```js
// Przykład
const element = <h1>Witaj, świecie!</h1>;
ReactDOM.render(element, document.getElementById('root'));
```

❌ TAK NIE MOŻNA:

```js
// Przykład
const element = <h1>Witaj, świecie!</h1>;
// "root" to identyfikator elementu.
// NIE TŁUMACZYĆ!
ReactDOM.render(element, document.getElementById('korzeń'));
```

❌ TAK TYM BARDZIEJ NIE WOLNO:

```js
// Przykład
const element = <h1>Witaj, świecie!</h1>;
ReactDOM.renderuj(element, dokument.znajdzElementPoId('korzeń'));
```

## Linki zewnętrzne

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

[MDN]: https://developer.mozilla.org/en-US/
[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page

Przykład:

```md
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.
```

✅ OK:

```md
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.
```

W przypadku linków, które nie mają odpowiedników (posty ze Stack Overflow, filmiki z YouTube itp.), używaj wersji oryginalnych, angielskich.

# Glosariusz

Oto kilka sugestii dotyczących tłumaczenia terminów powszechnie używanych w tego typu dokumentacji technicznej.

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

| Termin oryginalny | Sugestia (z literatury) |
| ------------------ | ---------- |
| array | |
| arrow function | |
| bug | |
| bundler | |
| camelCase | |
| callback | |
| controlled component | |
| debugging | |
| framework | |
| function component | |
| hook | |
| key | |
| lazy initialization | |
| library | |
| lowercase | |
| props | |
| React element | |
| render | |
| state | |
| string | |
| template literals | |
| uppercase | |
| uncontrolled component | |