Skip to content

Commit 130bea7

Browse files
committed
Make README focused on new content translations
1 parent c1d52a3 commit 130bea7

1 file changed

Lines changed: 50 additions & 10 deletions

File tree

README.md

Lines changed: 50 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,34 +25,74 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
2525

2626
*Read this in another language: [English](README.en.md)*
2727

28-
**Znalazłem błąd, co mam zrobić?**
28+
**Jak sprawdzić, co jest do przetłumaczenia?**
2929

30-
Jeśli znalazłeś(-aś) błąd lub masz sugestię,
31-
[dodaj zgłoszenie](https://github.com/python/python-docs-pl/issues) w tym projekcie lub
32-
napraw go sam(a):
30+
Służy do tego paczka `potodo`. Wywołaj ją w głównym katalogu projektu, np. `uvx potodo`.
31+
32+
Jeżeli interesują cię podstawowe artykuły, użyj filtrowania. Przykład:
33+
34+
```
35+
$ uvx potodo --exclude '**/*' '!tutorial/*' '!bugs.po' '!library/functions.po'`
36+
1 directory 99.68% done
37+
└── python-docs-pl/ 99.68% done
38+
├── library/ 98.61% done
39+
│ └── functions.po 99.0% translated 535/536
40+
└── tutorial/ 100.00% done
41+
```
42+
43+
Propozycje priorytetowych zasobów do tłumaczenia można znaleźć w [issue #50](https://github.com/python/python-docs-pl/issues/50).
44+
45+
**Jak tłumaczyć?**
3346

3447
* Wejdź na stronę
35-
projektu [dokumentacji Pythona](https://explore.transifex.com/python-doc/python-newest/).
48+
projektu [dokumentacji Pythona](https://explore.transifex.com/python-doc/python-newest/) na Transifeksie.
3649
* Naciśnij przycisk „Join this project”, aby dołączyć do projektu.
3750
* Utwórz konto Transifex.
3851
* Na stronie projektu wybierz język polski.
52+
* Po wysłaniu zgłoszenia do zespołu przedstaw się na kanale [Discord Python Polska #dokumentacja](https://discord.gg/QB3h2Sxc). Pozwoli to szybciej potwierdzić Twoje zgłoszenie.
3953
* Po dołączeniu do zespołu wybierz zasób, który chcesz poprawić/zaktualizować.
4054

4155
Więcej informacji o używaniu Transifeksa znajdziesz w
4256
[jego artykułach pomocy](https://help.transifex.com/en/articles/6318216-translating-with-the-web-editor) lub [w naszym przewodniku](https://python-docs-transifex-automation.readthedocs.io/new-translators.html).
4357

44-
**Chcę pomóc w tłumaczeniu, ale nie wiem od czego zacząć!**
58+
**Jak lokalnie sprawdzić poprawność moich zmian?**
59+
60+
Pobierz Transifex CLI i zapisz klucz API Transifex do `.tx/api-key`, aby pobrać zmiany z Transifeksa. Pobierz zmieniony
61+
rozdział, np.:
62+
63+
```
64+
$ tx pull --languages pl python-newest.library--turtle
65+
# Getting info about resources
4566
46-
Najpierw dołącz do projektu jako tłumacz, postępując zgodnie z przewodnikiem w poprzedniej sekcji.
67+
python-newest.library--turtle - Done
68+
[##############################] (1 / 1)
4769
48-
Następnie możesz zacząć od tłumaczenia jednego z naszych [priorytetowych zasobów.](https://github.com/python/python-docs-pl/issues/50)
70+
# Pulling files
71+
72+
python-newest.library--turtle [pl] - Done
73+
[##############################] (1 / 1)
74+
```
75+
76+
Uruchom `sphinx-lint`, aby sprawdzić poprawność zmian, np.:
77+
78+
```
79+
$ uvx sphinx-lint library/turtle.po
80+
No problems found.
81+
```
4982

5083
**Jak obejrzeć najnowszy build dokumentacji?**
5184

5285
Pobierz ostatnią zbudowaną dokumentację z listy artefaktów w ostatniej GitHub Action (zakładka Actions).
53-
Tłumaczenia pobierane są z Transifeksa do tego repozytorium co około pół godziny.
86+
Tłumaczenia pobierane są z Transifeksa do tego repozytorium co około godzinę.
5487
Dokumentacja na https://docs.python.org/pl/ aktualizowana jest około raz dziennie.
5588

89+
**Jak zbudować dokumentację?**
90+
91+
Na Uniksach zrób link symboliczny projektu `python-docs-pl` w katalogu `Doc/locales/pl` on nazwie `LC_MESSAGES`.
92+
Na Windowsie skopiuj zawartość katalogu projektu do podanej ścieżki.
93+
94+
Następnie uruchom `make -C Doc SPHINXOPTS="-D language=pl" html` w projekcie CPython, aby zbudować dokumentację.
95+
5696
**Kanały komunikacji**
5797

5898
* [Discord Python Polska #dokumentacja](https://discord.gg/VCyBDGH38e)
@@ -61,7 +101,7 @@ Dokumentacja na https://docs.python.org/pl/ aktualizowana jest około raz dzienn
61101

62102
**Postęp tłumaczenia**
63103

64-
<img src="translation_progress_pl.svg" alt="Postęp tłumaczenia">
104+
<img src="translation_progress_pl.svg" alt="Postęp tłumaczenia">
65105

66106
<!---
67107
Excludes the changelog from calculations.

0 commit comments

Comments
 (0)