Zapojení do calibre

Tajemstvím úspěchu calibre je jeho živá uživatelská komunita. Uživatelé přispěli kódem a stali se vývojáři, překlady zpřístupnili calibre v různých jazycích, grafikou vylepšili jeho vzhled a chování a samozřejmě odeslali tisíce hlášení chyb, která pomohla udělat z calibre odolný software, jakým je dnes. Neúplný seznam přispěvatelů do calibre je k dispozici zde.

Připojení ke komunitě calibre

Ke komunikaci s ostatními uživateli calibre a sledování nejnovějšího dění ve světě calibre můžete použít několik nástrojů:

Vytvoření modulu calibre

calibre má rozsáhlé rozhraní pro moduly, které umožňuje vytvářet moduly schopné dělat téměř cokoli. Mnoho příkladů najdete ve fóru modulů calibre. K dispozici je také návod, jak začít s vývojem modulů.

Přispívání překlady pro calibre

calibre podporuje překlad svého uživatelského rozhraní. Seznam jazyků, pro které překlady existují, najdete zde. Pokud jsou překlady pro váš jazyk neúplné nebo chybí, můžete je doplnit pomocí jednoduchého webového rozhraní. Nejprve si vytvořte účet v Transifexu a poté klikněte na svůj jazyk na této stránce. Klikněte na tlačítko "Join Team". Po schválení jednoduše klikněte zde na jazyk, který chcete překládat, a použijte tlačítko "Translate Now" k přispění svými překlady.

Případně si můžete stáhnout soubor PO a překládat offline pomocí odkazu "Download for translation" místo tlačítka "Translate Now". Soubor PO můžete upravit ve svém oblíbeném překladovém softwaru a po dokončení ho nahrát kliknutím na odkaz "Upload file", který je hned pod odkazem "Download for translation".

Nejčastější dotazy k překladům

  • Co dělat se symboly &?
    Symboly & označují klávesovou zkratku. Například řetězec "&Title" znamená, že odpovídající prvek GUI lze vyvolat klávesovou zkratkou "Alt+T" (funguje pouze ve Windows/Linuxu). V překladu proto ponechte symbol & pokud možno před stejným písmenem, případně před jiným vhodným písmenem.
  • Co dělat se znaky "%A_Word"?
    Znak % a slovo napravo od něj (bez mezery mezi znakem procenta a slovem) označují slovo, které bude nahrazeno kódem. Když tedy narazíte na tento symbol a slovo hned vedle něj (například %default), neměňte ho. Ponechte ho v přeložené větě tak, jak je. Podobně u sekvencí jako %s nebo %d je ponechte beze změny. Nakonec i sekvence jako %(some_word)s musí zůstat beze změny.
  • Co dělat s konstrukcemi {word}?
    Jsou to placeholdery a nesmí se překládat. Kód je nahradí skutečným obsahem.
  • Co dělat s datumovými řetězci jako dd MMM yyy?
    Ty musí zůstat nepřeložené.
  • Co dělat se speciálním markupem při překladu uživatelské příručky?
    Uživatelská příručka je napsaná ve formátu reStructuredText. Uvidíte mnoho konstrukcí jako :guilabel:`Some text`. Část :guilabel:`` je markup, podobně jako značky HTML. Překládat byste měli pouze text uvnitř zpětných apostrofů. Zvláštní pozor je třeba dávat na odkazy následujících tvarů:
    • :ref:`some text` Zde se nesmí překládat nic.
    • :ref:`Some text <link-location>` Zde se překládá pouze "Some text".
    • ``Some text`` Toto je literál a nemá se v něm překládat nic.
    • :doc:`generated/en/something` by se mělo nahradit za :doc:`generated/your_language_code/something`. Například :doc:`generated/en/cli-index` se v němčině změní na :doc:`generated/de/cli-index`.
  • Jak otestovat překlady?
    Nejprve si musíte zde stáhnout soubor .po pro svůj jazyk. Soubor .po můžete otestovat nastavením proměnné prostředí CALIBRE_TEST_TRANSLATION na cestu ke staženému souboru .po. Poté spusťte calibre jako obvykle. Překlady uživatelské příručky momentálně testovat nelze.

Jak se stát vývojářem calibre

Získejte zdrojový kód:

git clone https://github.com/kovidgoyal/calibre.git

Nebo pokud nechcete čekat na stažení celé historie verzí, můžete získat pouze zdrojový kód:

curl -L http://code.calibre-ebook.com/dist/src | tar xvJ

Pokyny ke spuštění calibre z vašeho checkoutu zdrojového kódu a také informace o tom, jak je kód calibre uspořádán, najdete v uživatelské příručce.

Pokud přijdete se skvělým nápadem a patchem, který ho implementuje, dejte nám o tom vědět a nejspíš se objeví v příštím týdenním vydání calibre. Skvělé místo, kde se zeptat na tipy k úpravám kódu calibre, je vývojářské fórum calibre, kde se pohybuje mnoho vývojářů calibre.

Zvolte jazyk, který chcete

Zrušit