Help:Extension:Translate/Group configuration/cs

Existuje několik způsobů, jak vytvářet skupiny zpráv, se kterými pracuje rozšíření Translate. Skupiny zpráv jsou soubory zpráv. Většinou odpovídají jednomu modulu, pokud jde o zprávy v softwaru, jednomu souboru (a obvykle i jednomu jazyku, ze kterého se překládá). Je ale možné vytvářet skupiny, které soustředí zprávy z jiných skupin do jedné. Může tak existovat jedna globální skupina, která bude obsahovat všechny zprávy, které jsou k dispozici. A naopak, mohou existovat také skupiny, které zahrnují pouze vybranou podmnožinu zpráv – například zprávy MediaWiki, které by se měly přeložit jako první, protože jsou nejdůležitější. Tyto nadřazené skupiny nejsou založeny na nějakém konkrétním souboru textových zpráv, ale stejně tak jako zprávy z ostatních skupin se dají vyexportovat ve formátu Gettext aby se daly překládat prostřednictvím externích překladatelských nástrojů. Message groups are collection of messages. Usually they compare to one module in a software and one file (and usually one per language for translations). It is also possible to make groups that include messages from other message groups. For example there can be group that includes all messages in a given software. Groups can also include just subsets of messages, like the most important messages of MediaWiki that should be translated first. These higher level groups do not map directly to files in any particular format, but like all groups they can be exported in Gettext format for use in other translation tools.

Tyto skupiny zpráv jsou nadřazené bloky dat, s nimiž pracují překladatelé: Pokud mají najít zprávy, kterou chtějí přeložit, musí buď použít vyhledávání zpráv, nebo vybrat příslušnou skupinu. Každá skupina má jedinečný identifikátor a také ji lze statisticky zpracovávat. Nejmenší překládanou jednotkou se kterou pracuje překladatel je textová zpráva. Každá má svůj identifikátor, kterému se říká klíč (key), který nemusí být v rámci skupin zpráv jedinečný. For each group we can gather statistics and each group has a unique identifier. Naturally, messages are the smallest blocks of text that translators translate one at a time. Each message also has an identifier, which is usually called a key. The key doesn't need to be unique across message groups.

Standardní formát konfigurace skupiny
Přidat skupinu zpráv přes konfigurační soubor ve formátu YAML je snadné. Potřebujete pouze vytvořit nový jmenný prostor a pak přidat tento konfigurační soubor do $1; více ohledně konfigurace viz zde. Příklad: All you need to do is to define a namespace and add a configuration file to ; see the configuration page for more details. Example:

Samotný soubor používá YAML syntaxi. Ta na této stránce popsána není, ale je snadné se ji naučit a všechny předchystané skupiny lze použít jako příklady. Nezapomínejte, že se místo tabulátorů musí k odsazení používat mezery. V jednom souboru může být nakonfigurováno i několik skupin zpráv. V takovém případě je konfigurace skupiny od následující oddělena řádkem se třemi pomlčkami, což je standardní oddělovač dokumentů pro YAML. The syntax itself is not described here, but it is easy to learn, and all the premade groups can be used as examples. Remember to use spaces instead of tabs for indentation. Each file can define multiple message groups. Each group definition is separated by a line with three dashes, which is the standard document separator in YAML.

Konfigurace je rozdělena do několika bloků: BASIC, FILES, MANGLER, CHECKER, INSERTABLES, TAGS, AUTOLOAD, LANGUAGES a speciální blok TEMPLATE. Některé uživatelsky vytvořené skupiny mohou přidat i několik nadřazených skupin. Všechny skupiny se nemusí konfigurovat tímto způsobem.

BASIC (základní nastavení)
Přes tuto sekci se nastavují základní parametry skupiny, jako např. její jméno a unikátní id. Toto je přehled použitelných klíčů (povinné klíče jsou označeny *):

Příklad:

FILES (soubory)
Tato část popisuje rozložení souborového systému a formát souborů zpráv pro skupiny typu FileBasedMessageGroup. Seznam možných klíčů (povinné klíče jsou označeny *): List of possible keys (mandatory keys are marked with *):

Proměnné cesty jsou:

Příklad:

MANGLER
Mangler je způsob, jak zamíchat klíče zpráv, aby se zabránilo konfliktním klíčům zpráv ve více skupinách:

Příklad:

CHECKER (kontrola zpráv)
Je-li to nastaveno, může být realizována kontrola zpráv. Pokud se při ní najde nějaký problém, zobrazí se zpráva překladatelům jako podsvícená.

Příklad:

VALIDATORS (validátory)
Tato sekce umožňuje definovat předdefinované nebo vlastní validátory.

INSERTABLES
Tato sekce umožňuje definovat třídu, která navrhuje insertables nebo používá předdefinované insertables. Třídy lze automaticky načíst, jak je popsáno v části AUTOLOAD.

TAGS (značky)
Ke zprávám je možné přiřadit štítky. Každá značka vezme seznam klíčů zpráv (po manglování). "*" lze použít jako zástupný znak. Podporovány jsou následující značky:

Příklad:

AUTOLOAD
Tato položka vezme seznam názvů tříd s názvy souborů jako hodnoty. Tímto způsobem lze vlastní třídy snadno spojit se svými vlastními skupinami zpráv. Cesta by měla být relativní k umístění samotného konfiguračního souboru skupiny.

Příklad:

TEMPLATE (šablona)
Pokud definujete více podobných skupin zpráv, existuje užitečná zkratka. Abyste se vyhnuli opakování, začněte první definicí s tímto klíčem. Jako podklíče této položky můžete použít jakékoli další klíče nejvyšší úrovně. Všechny ostatní skupiny budou tyto definice používat jako výchozí hodnoty. Každá skupina může samozřejmě přepsat výchozí hodnotu ze šablony.

Příklad:

SKUPINY (pro třídu AggregateMessageGroup)
Tento klíč obsahuje pouze seznam ID skupin, z nichž tato skupina zpráv sestává.

Příklad:

Jsou podporovány zástupné znaky. V tomto případě agregovaná skupina nebude rekurzivně zahrnovat sama sebe, i když odpovídá vzoru. Příklad:

Zástupné znaky mohou být problematické, pokud máte vnořené agregované skupiny. Protože některé skupiny mohou být zahrnuty vícekrát: přímo i prostřednictvím zahrnutých agregovaných skupin.

LANGUAGES (jazyky)
Tento klíč umožňuje bílé a černé seznamy jazyků pro skupinu. Jazyky na černé listině nebudou povoleny k překladu.

Seznam povolených hodnot přepíše všechny hodnoty na černé listině. Pokud je hodnota whitelistu, znamená to, že jsou povoleny všechny jazyky. Seznam povolených položek je také volitelný.

Skupiny zpráv pro zprávy rozhraní specifické pro vaši wiki
Příklad skupiny zpráv pro vlastní uživatelské rozhraní wiki, například pro lokalizovaný postranní panel. Přidejte následující kód do svého  a nahraďte wikiname něčím smysluplným.

Zkratka pro rozšíření MediaWiki
Viz skupina jednotek pro MediaWiki.