~~NOTOC~~ ====== Upstream ====== {{page>Lokalizace/Header}} Práce v [[FAQ#upstream|upstreamu]] je mnohem hodnotnější než úpravy těchto překladů v Rosettě, ale o něco složitější. K práci budete potřebovat pár desktopových, ale i konzolových nástrojů. Pokud to však s překlady myslíte vážně, určitě se zapojte. ===== Nejznámější upstreamy ===== K největším a nejznámějších upstreamům zde máme pár konkrétních informací. Vyberte si: {{.:gnome.png}} Informace o [[GNOME|překládání GNOME]].\\ {{.:kde.png}} Informace o [[KDE|překládání KDE]].\\ {{.:debian.png}} Specifika překládání Debianu: [[http://www.debian.cz/develop/translation.php|Co a jak překládat]]. Ptát se můžete v konferenci [[http://lists.debian.org/debian-l10n-czech|debian-l10n-czech]]. ===== Obecné informace o překladech přímo u autora ===== - Nejprve je potřeba najít domovskou stránku programu/dokumentace a podívat se, zda již překlad neexistuje - obvykle na stránkách bývá možnost stažení poslední vydané verze, ale je lepší podívat se přímo do vývojového cvs/svn/bazaar/apod repositáře. Hledejte soubory s názvem **cs.po**, ale obecně cokoliv s názvem **cs** (například podadresář cs/, ve kterém je několik souborů dokumentace v docbooku s příponou .xml). - Pokud překlad existuje, bývá v něm uveden kontakt na posledního překladatele (položka **Last-Translator** na začátku .po souboru), se kterým se pak můžete domluvit, zda nepotřebuje pomoci. Pokud se překladatel do rozumné doby cca 2 týdnů neozve, můžete předpokládat, že jste se právě stali novým hlavním překladatelem daného programu/dokumentace. V takovém případě (případně pokud tam položka //Last-Translator// vůbec není) kontaktujte autora programu nebo (u větších projektů) koordinátora lokalizace pro daný jazyk, např. pokud je program součástí GNOME. - Jestliže překlad ještě neexistuje, zkuste se podívat do systému sledování chyb daného projektu a do diskuzní konference, zda tam již někdo neoznámil svůj úmysl projekt překládat. Pokud ne, můžete svůj záměr oznámit a začít s překladem. - Dále se postup liší dle projektu, protože někdy vás autor programu sám kontaktuje před vydáním novější verze programu a požádá vás o aktualizaci překladu, jindy se musíte snažit sami a průběžně zasílat své aktuální verze překladu (důležité je mít hotovou verzi v době těsně před vydáním nové verze programu). Autor programu vám někdy dá práva zápisu přímo do vývojového stromu projektu, takže můžete překlady zapisovat sami, jiný třeba preferuje zasílání překladů mailem přímo jemu, další preferuje zasílání překladů do systému sledování chyb jako nové hlášení o chybě... - Velké/uvědomělé projekty často zmrazí řetězce nějakou dobu před vydáním nové verze programu a dávají tak překladatelům čas nerušeně pracovat na překladech, čímž odpadá nutnost být pořád ve střehu a kontrolovat, zda se náhodou nějaký řetězec nezměnil. ===== Práce s .PO soubory ===== Nemá smysl opakovat stokrát napsané, proto odkážeme na externí zdroje: * [[http://www.abclinuxu.cz/clanky/navody/ako-na-preklad-slobodnych-programov|Ako na preklad slobodných programov]] * [[http://www.abclinuxu.cz/clanky/navody/ako-na-preklad-slobodnych-programov-2|Ako na preklad slobodných programov - 2]] * [[http://www.root.cz/clanky/lokalizace-otevreneho-a-svobodneho-software/|Lokalizace otevřeného a svobodného software]] ==== Grafické nástroje pro překlad ==== Pro začátečníky je zřejmě nejjednodušší a nejlehčí **poEdit**, který si můžete nainstalovat z balíku ''poedit''. Pokud se bude překládaný soubor jmenovat ''cs.po'', tak vám bude //poEdit// automaticky kontrolovat českou gramatiku. ==== Struktura .po souboru ==== Na začátku najdete několik řádků komentářů, a pak úvodní řetězec obsahující nejdůležitější informace o souboru. Poté následují řádky s tímto významem: |**msgid "text"**|překladový klíč, původní anglický text| |**msgstr "text"**|překladová hodnota, český překlad předchozího klíče| |**# text**|řádek s komentářem| |**#: soubor:řádek**|popis umístění textu ve zdrojovém souboru, pro překladatele nepodstatné| |**#, fuzzy**|následující překlad je nejasný, a nebude v programu použit, dokud se neodstraní tento komentář| |**#. text**|nápověda překladateli od programátora| |**#~ text**|zastaralý, nadále nepoužívaný překlad. Přesto nemažte, používá se pro fuzzy překlady.| ==== Postup překladu ==== * V souboru bývá jeden speciální klíč msgid "translator-credits" Tento řetězec se nepřekládá doslova, ale sem se uvádí seznam překladatelů, kteří se o překlad zasloužili. Vždy ve tvaru ''jméno '' (příp. nějaké URL), oddělených novým řádkem. Nezapomeňte se podepsat taky :-) * Po překladu nezapomeňte v hlavičce .po souboru aktualizovat položky **Last-Translator** (vaše jméno) a **PO-Revision-Date** (aktuální čas v UTC - pozor na časová pásma). Grafické nástroje pro překlad to za vás většinou udělají samy (pokud máte správně vyplněné své údaje v nastavení), ale přesto to zkontrolujte. * Po úplném přeložení PO souboru si ověřte, že je v pořádku a nejsou v něm žádné chyby. Zkompilujte si ho do MO souboru příkazem msgfmt -cv soubor.po Vznikne vám ''soubor.mo''. Pokud by byly v PO souboru nějaké problémy, tak se vám vypíší. Vzniklým MO souborem mimochodem můžete přehrát existující MO soubor v systému, a spustit si tak překládanou aplikaci s vašimi novými překlady. * V případě potřeby je možné soubor PO získat ze souboru MO zpět msgunfmt soubor.mo ===== Užitečné nástroje ===== Naprostým základem, který je nezbytné mít nainstalovaný, je balík ''gettext''. ==== Překlad ==== Následující nástroje vám umožní snadno překládat PO soubory. Všechny aplikace jsou v Ubuntu zdrojích ve stejnojmenných balících. * **poEdit** - velice jednoduchý nástroj s pouze základními funkcemi. Ideální pro začátečníka. * **GTranslator** - taktéž jednoduchý nástroj, ovšem s trochu nepraktickým ovládáním (trošku nepřehledné, potřeba na mnoho úkonů chytat do ruky myš, což při překladech obtěžuje) * **KBabel** - mnoho funkcí a tudíž nepřehledný chaos pro začátečníka Pro malé úpravy lze použít i obyčejný textový editor, pozor však na escapování znaků (''\n'' jako nový řádek, ''\"'' pro uvozovky uvnitř překladu, apod). ==== Porovnávání a slučování ==== Následující nástroje vám umožní porovnat rozdíly mezi dvěma soubory, případně je sloučit (slít) do jediného. To se hodí, pokud máte dva PO soubory (např z Rosetty a upstreamu) a chcete z nich udělat jeden. Nebo chcete porovnat rozdíly mezi vaším překladem a původním souborem z upstreamu. Všechny aplikace jsou v Ubuntu zdrojích ve stejnojmenných balících. * **KDiff3** - slušně udělaný nástroj, orientovaný na klávesové zkratky, umí porovnávat i slučovat * **Meld** - taktéž použitelný nástroj s trochu jinou filozofií, orientovaný na myš, přesto také dobře použitelný. Umí porovnávat i slučovat (uložením jednoho z porovnávaných souborů).