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ů.

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ý.

Standard group configuration format
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 ; více ohledně konfigurace viz zde. Příklad:

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.

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)
This section describes the filesystem layout and format of message files for groups of type FileBasedMessageGroup. List of possible keys (mandatory keys are marked with *):

The path variables are: Příklad:

MANGLER
Mangler is a way to mungle message keys to avoid conflicting message keys in multiple groups: 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
This section allows to define pre-defined or custom validators.

INSERTABLES
This section allows to define a class which suggests insertables or use pre-defined insertables. The classes can be autoloaded as described in the AUTOLOAD section.

TAGS (značky)
It is possible to assign tags to messages. Each tag takes list of message keys (after mangling). "*" can be used as wildcard. The following tags are supported: Příklad:

AUTOLOAD
This item takes list of class names with filenames as values. This way custom classes can be bundled easily with your custom message groups. The path should be relative to the location of the group configuration file itself.

Příklad:

TEMPLATE (šablona)
There is a handy shortcut if you are defining multiple similar message groups. To avoid repetition, have the first definition start with this key. You can use any other top-level keys as subkeys for this item. All other groups will use these definitions as default values. Each group can of course override the default value from the template.

Příklad:

GROUPS (for AggregateMessageGroup class)
This key only takes list of group ids this message group consists of.

Příklad: Wildcards are supported. In this case the aggregate group will not recursively include itself even if it matches a pattern. Example: Wildcards can be problematic if you have nested aggregate groups, because some groups can be included multiple times: both directly and via the included aggregate groups.

LANGUAGES (jazyky)
This key allows white listing and black listing of languages for the group. Blacklisted languages will not be allowed for translation. Whitelist overrides any values in the blacklist. If whitelist value is  that means all languages are allowed. Whitelist is also optional.

Message groups for interface messages specific to your wiki
Example of message group for custom user interface of the wiki, for example for localized sidebar. Add the following code into your  and replace wikiname with something meaningful.

Shortcut for MediaWiki extensions
See units group for MediaWiki.