Jak překládat Linuxové manuálové stránky

Obsah

Projekt překladu manuálový stránek základních linuxových nástrojů obsahuje základní nástroje linuxové příkazové řádky, respektive jejich překlady do češtiny.

Jak něco jednorázově přeložit nebo nahlásit chybu

Pokud chcete přeložit jeden konkrétní program nebo opravit nalezenou chybu a nemáte zájem na dlouhodobější spolupráci, to nejjednodušší co můžete udělat je najít a stáhnout si PO soubor příslušného programu, přeložit jej pomocí nástroje jako je Lokalize a upravený PO soubor poslat koordinátorovi.

Překládání linuxových manuálových stránek

Vhodné pro pravidelně překládající zájemce o dlouhodobou spolupráci.

Získání přístupu k překladům

Překlady jsou uloženy ve veřejném Git repozitáři. Pokud do něj chcete sami odesílat své překlady, potřebujete vývojářský účet v GitLabu Debianu. Kontaktujte koordinátora a on vám přes správce repozitáře (Helge Kreutzmann, debian zavináč helgefjell.de) zajistí vytvoření uživatelského účtu a přístup pro zápis.

Nezapomeňte si do nastavení GitLabu uložit své SSH (a případně i GPG) klíče.

Nyní si můžete naklonovat repozitář s překlady:

git clone git@salsa.debian.org:manpages-l10n-team/manpages-l10n.git
cd manpages-l10n/po/cs/ # Adresář s českými překlady

Překládání

Adresář po obsahuje několik obslužných skriptů, které prochází PO soubory a pokud nově přeložený textový řetězec existuje i v jiných souborech, také je přeloží. Adresář po/cs/common obsahuje PO soubory obsahující řetězce, které se v ostatních souborech (v adresářích man#) vyskytují víc jak N-krát (tzv. kompendium). Tyto skripty dovedou ušetřit hodně práce, ale pokud nejsou použity správně, mohou nadělat hodně škody (ještě že to je v Gitu).

Řekněme, že se pro příklad rozhodneme přeložit soubor man1/chown.1.po:

# Nejprve se ujistíme, že máme aktuální stav repozitáře
git fetch
git pull
# Přesuneme se do adresáře s českými překlady
cd po/cs/
# Aktualizujeme překlady man1/chown.1.po podle kompendia
../update-po.sh man1/chown.1.po
# Přeložíme chown.1.po, např. pomocí Lokalize
# Odešleme výsledek do repozitáře
# Vždy používejte přefix "[cs]", protože repozitář obsahuje všechny jazyky
git commit -m "[cs] Recomplete man1/chown.1.po."
# Na základě našich nových překladů aktualizujeme kompendium
../use-for-compendium.sh man1/chown.1.po
# Odešleme výsledek do repozitáře
git commit -a -m "[cs] Use recent updates for compendium."
# Nyní můžeme na základě aktualizovaného kompendia aktualizovat ostatní soubory
../update-translations.sh
# Odešleme výsledek do repozitáře
git commit -a -m "[cs] Update translations from compendium."
# Odešleme všechno do centrálního repozitáře
git push

Viz také

Kontakt