View source for Manual:Language/cs

<languages/>
{{i18n navigation}}
{{tocright}}
:''Podívejte také na stránku [[Special:MyLanguage/Manual:MediaWiki architecture#Languages|Příručka:Architektura MediaWiki#Jazyky]] (Nemělo by se to sloučit s touto stránkou?)''

V rámci MediaWiki rozlišujeme různá pojetí jazyků:

* '''Jazyk obsahu webu''' (služba <code>ContentLanguage</code> v <code>MediaWiki\MediaWikiServices::getContentLanguage</code>, na základě <code>{{ll|Manual:$wgLanguageCode|$wgLanguageCode}}</code>), který by měl obecně zůstat stejný, dokud bude wiki existovat.
** '''Varianta jazyka stránky''' ({{ll|Manual:$wgDefaultLanguageVariant|$wgDefaultLanguageVariant}}) je výchozí verzí, pokud je pro tento jazyk implementován {{ll|LanguageConverter}}.
* '''Jazyk uživatelského rozhraní''' ([[Special:MyLanguage/Manual:RequestContext|$contextSource->getLanguage()]] dříve <code>{{ll|Manual:$wgLang|$wgLang}}</code>), který lze nastavit v Nastavení, nebo použitím kódu <code>&uselang=xyz</code> v URL. Ve standardních případech zůstává během používání jedné wiki taktéž neměnný.
* '''Jazyk obsahu stránky''' se může u každé stránky lišit, i když základní jazyk stránek a uživatelského rozhraní budou totožné. Je definován v getPageLanguage() v [[Special:MyLanguage/Manual:Title.php|hlavičce]] a značí, v jakém jazyce je zdroj obsahu stránky (např. wikitext) psán.
** '''Jazyk zobrazení stránky''', neboli '''uživatelem nastavený jazyk''' je jazyková varianta jazyka stránky, kterou si uživatel zvolil. Lze ji nastavit pomocí <code>&variant</code> (nebo {{$wg|VariantArticlePath}}) v URL (např. zvolením některé ze záložek) '''pokud''' se jedná o variantu jazyka obsahu prohlížené stránky. Je definován v getPageViewLanguage() v [[Special:MyLanguage/Manual:Title.php|hlavičce]] a značí, v jakém jazyce je vykreslený HTML obsah psán.

Všechny tři výše zmíněné chápeme jako [[Special:MyLanguage/language object|jazykové objekty]].

<span id="Language_code"></span>
== Kód jazyka ==

: ''Neplést s [[m:Special:MyLanguage/Special language codes|kódem projektu Wikimedie]]; viz také [[m:Special:MyLanguage/Language codes|Jazykové kódy]] na Meta.''
Jazykový kód je platná standardní zkratka pro jazyk podporovaný MediaWiki,<ref>viz [[phab:diffusion/MW/browse/master/includes/languages/data/Names.php|includes/languages/data/Names.php]].</ref> který používá takové kódy jako standardní identifikátory jazyků (většinou v souladu s [[w:ISO 639|ISO 639-3 ]], kromě dvoupísmenných kódů z ISO 639-1 pro "zavedené" lokality) a odhaluje je nebo je vyžaduje v mnoha bodech rozhraní a kódu.<ref>Navzdory tomu není od roku 2012 validace jazykových kódů dosud vyřešeným problémem. Viz Niklas Laxström, ''[http://laxstrom.name/blag/2012/08/28/language-validation-in-mediawiki/ Language validation in MediaWiki]'', 28. srpna, 2012</ref>

V níže uvedeném příkladu je <code>MediaWiki:Message/ar</code>, <code>ar</code> kód jazyka pro {{#language:ar|{{PAGELANG2}}}}.

Pro zajištění dobré jazykové podpory je nutná jednotnost se standardem Unicode, zejména ve spolupráci s [[translatewiki:CLDR|CLDR]]. Kód ISO 639-3 je [[translatewiki:Translatewiki.net_languages#Policy_on_enabling_translation_into_a_language|požadavkem na přidání jazyka do lokalit MediaWiki]].

== Names.php ==
{{git file | project = mediawiki/core | file = includes/languages/data/Names.php | text = Names.php}} je hlavní registr jazyků podporovaných MediaWiki.
To není totéž jako jazyky, jejichž MediaWiki zobrazí l10n ([[Special:MyLanguage/Help:System_message#Localisation_file_format|JSON soubory]]), ani jazyky, jejichž názvy MediaWiki zná (prostřednictvím {{ll|Extension:CLDR|nsp=0}}), pamatujte!

<span id="Fallback_languages"></span>
== Záložní jazyky ==
{{See also|Help:System message|ll=1}}
[[File:MediaWiki fallback chains.svg|thumb|Záložní řetězy (Některé ze zobrazených řádků jsou nepřesné kvůli zdvojeným jazykům v záložní verzi. Zkontrolujte, zda spojení skutečně existuje v [[phab:T258492#6490574|textové verzi]])]]
Některé jazyky v MediaWiki mají to, co je známé jako "záložní sekvence".
Zde se MediaWiki vrátí k jinému jazyku, pokud nenajde, co potřebuje.
Příkladem toho je kód jazyka <code>frc</code> (cajunská francouzština), který vychází z kódu jazyka <code>fr</code> (francouzština).
Důvodem je, že někdy jazyky nemají všechny zprávy v nich definované.

Záložní nastavení pro jazyk lze nalézt v příslušném souboru <code>languages/messages/MessagesXX.php</code>.
Například {{git file|file=languages/messages/MessagesFrc.php|text=MessagesFrc.php}}. Můžete [https://codesearch.wmcloud.org/search/?q=%5C%24fallback%20%3D&i=nope&files=languages%2Fmessages&excludeFiles=&repos=MediaWiki%20core vyhledat kód pro všechna použití]. V [[phab:T258492#9028038|tomto komentáři Phabricatoru]] je také prostý seznam z {{ym|2020|09}}.

<span id="Site_content_language"></span>
== Výchozí jazyk webu ==

Zobrazení/získání jazyka obsahu webu

{{ll|Manual:Interface/JavaScript|JavaScript}}:
<syntaxhighlight lang="javascript">
mw.config.get( 'wgContentLanguage' );
</syntaxhighlight>

<span id="User_interface_language"></span>
== Jazyk uživatelského rozhraní ==
{{MW 1.18|and after}}
; Výchozí hodnota
:*[[Special:MyLanguage/Manual:RequestContext|$contextSource->getLanguage()]]

; Nastavit přes

:* Special:Preferences
:* <code>&uselang=zxx</code> v adrese URL (viz [[Special:MyLanguage/uselang|uselang]])
:* <code>&variant=xy</code> (nebo {{$wg|VariantArticlePath}}) v adrese URL '''if''' je to varianta vašeho uživatelského jazyka

; Problémy
: Protože zprávy rozhraní mohou pocházet ze záložních jazyků, ale jazyk není vrácen, skutečný jazyk každé zprávy není znám.

<span id="Page_content_language"></span>
== Jazyk obsahu stránky ==
{{MW 1.18|and after}}
; Výchozí hodnota

:* $wgLang u speciálních stránek.
:*Angličtina pro stránky, které obsahují CSS a JS kódy.
:* U stránek jmenného prostoru MediaWiki závisí jazyk na podstránce. Například MediaWiki:Message/ar bude nastaveno na arabštinu (ar) a MediaWiki:Message bude mít hodnotu <code>ContentLanguage</code>.
:* Všechny ostatní stránky jsou ve výchozím nastavení <code>ContentLanguage</code>.

; Konfigurace
: Rozšíření mohou změnit všechny ostatní stránky pomocí háčku {{ll|Manual:Hooks/PageContentLanguage|PageContentLanguage}}. Hodnotu pro speciální stránky, CSS, JS a stránky jmenného prostoru MediaWiki nelze přepsat.

; Příklady
: Rozšíření [[Special:MyLanguage/Extension:Translate|Translate]] jej používá pro funkci překladu stránek. Viz [[translatewiki:Project:About/ar|translatewiki:Project:About/ar]] jako překlad [[translatewiki:Project:About|translatewiki:Project:About]]. Směrovost stránky je tak pro arabštinu správně nastavena zprava doleva.
{{MW 1.24|and after}}
; Ruční změna jazyka stránky
: Výběr jazyka stránky je nyní dosažitelný pomocí Special:PageLanguage od MediaWiki 1.24.
: Uživatelé mohou změnit jazyk obsahu stránky, který je ve výchozím nastavení výchozím jazykem wiki (<code>ContentLanguage</code>). Jazyk stránek v jmenném prostoru MediaWiki nelze změnit.
: Funkce musí být povolena pomocí <code class="mw-highlight">{{ll|Manual:$wgPageLanguageUseDB|$wgPageLanguageUseDB}} = {{#tag:span|true|class=k}}</code> a oprávnění <code>pagelang</code> musí být uděleno skupině uživatelských práv wiki (která pak může provádět změny jazyka stránky).
: Změna jazyka stránky způsobí, že zdrojová stránka překladu a její jednotky budou přesunuty do správného cílového jazyka. V případě, že stránka překladu do cílového jazyka již existuje, změna jazyka není povolena. 
: Matching API lze nalézt na {{ll|API:SetPageLanguage}}.

; Co to znamená?

:* V SkinTemplate přidá kolem textu stránky <syntaxhighlight lang=html inline><div lang="xyz" dir="ltr/rtl" class="mw-content-ltr/rtl"></div></syntaxhighlight>. Atribut dir nastavuje správný '''[[Special:MyLanguage/Directionality support|směr zápisu]]'''. Atributem lang bude vždy kořenový kód, např. "de", i když je uvedeno "de-formal".
:*: U souborových stránek se to nastavuje v ImagePage.php, protože tam je hodně HTML, které jsou v uživatelském jazyce.
:* V Parser.php nastavuje číslování obsahu (TOC) a věci jako gramatiku, i když to většinou není relevantní. Chcete-li to provést pouze, použijte parserOptions->setTargetLanguage().
:* Směr textu rozdílu (DifferenceEngine) je nastaven na jazyk obsahu stránky. V některých případech to není totožné, v takovém případě lze použít $diffEngineObject->setTextLanguage($code).
:* Od {{r|94680|1.19}} také nastavuje čas a formátování čísel '''[[Special:MyLanguage/Help:magic words|magic words]]''', včetně DIRECTIONMARK, ale ne NAMESPACE(E), protože to opravdu závisí na jazyce webu. Všimněte si, že zahrnutí šablony označené jako jazyk A na stránku s jazykem B bude analyzováno s jazykem B na této stránce.

; Více jazyků na jedné stránce
: Více jazyků na jedné stránce není teoreticky podporováno, ale jednoduché značky <syntaxhighlight lang=html inline><div lang="xyz" dir="ltr/rtl" class="mw-content-ltr/rtl"></syntaxhighlight> lze použít k označení textu jako napsaného v jiném jazyce. Pokud je použita třída CSS, seznamy ul/ol a sekce úprav se zobrazí pěkně, když je značka dir opačná než hodnota jazyka obsahu stránky. Věci definované v parseru, jako TOC a magická slova, se však nezmění.

; Zobrazení/získání jazyka stránky

* [[Special:MyLanguage/Manual:Interface/JavaScript|JavaScript]]: <code>mw.config.get( 'wgPageContentLanguage' )</code> - všimněte si, že když např. při prohlížení historie stránky vrátí jazyk stránky, na které je historií, zatímco stránka historie nemá třídu mw-content-ltr/rtl. Tj. "/wiki/Page" i "/w/index.php?title=Page&action=history" vrátí jazyk "Page". {{MW version-inline|1.19+}}
* Jazyk obsahu stránky je uveden v zobrazení informací o stránce (<code>action=info</code>, odkaz v panelu nástrojů) {{MW version-inline|[[gerrit:30099|1.21+]]}}
*Jazyk obsahu stránky lze získat v [[Special:MyLanguage/API|API]] přes [[Special:MyLanguage/API:Properties|api.php?action=query&prop=info]] {{MW version-inline|[[gerrit:64512|1.22+]]}}

<span id="Code_structure"></span>
== Struktura kódu == 
Nejprve máte objekt Language v {{ll|Manual:Code#Language.php|Language.php}}.
Tento objekt obsahuje všechny lokalizovatelné [[Special:MyLanguage/Help:System message|řetězce zpráv]] a také další důležitá nastavení specifická pro jazyk a vlastní chování (velká písmena, malá písmena, tisk dat, formátování čísel, [[Special:MyLanguage/Directionality support|směr]], [[Special:MyLanguage/Manual:Messages API#…on use context inside sentences via GRAMMAR|vlastní gramatická pravidla]] ''atd.'').

Objekt je vytvořen ze dvou zdrojů: Podtřídy verze sebe sama (třídy) a soubory zpráv (zprávy).

K dispozici je také třída MessageCache, která zpracovává vkládání textu prostřednictvím jmenného prostoru MediaWiki.
Většina internacionalizace se dnes provádí prostřednictvím objektů na stránce {{ll|Manual:Messages API}} a pomocí funkce zkratky <code>wfMessage()</code>, která je definována v <code>includes/GlobalFunctions.php</code>.
Starší kód může stále používat staré funkce <code>wfMsg*()</code>, které jsou nyní považovány za zastaralé ve prospěch výše uvedených objektů Message.

Více na stránce {{ll|Manual:Messages API}}.

<span id="Language_objects"></span>
=== Objekty jazyka ===
Existují dva způsoby, jak získat jazykový objekt.
Pro uživatelské rozhraní a jazyk obsahu můžete použít globální službu {{ll|Manual:$wgLang|$wgLang}} a <code>ContentLanguage</code> (<code>MediaWiki\MediaWikiServices::getContentLanguage</code>).
Pro libovolný jazyk můžete vytvořit objekt pomocí {{phpi|$languageFactory->getLanguage( 'en' )}} nahrazením <code>en</code> kódem jazyka.
Můžete získat {{phpi|$languageFactory}}, objekt třídy {{phpi|MediaWiki\Languages\LanguageFactory}}, pomocí {{ll|Dependency Injection}}.
Můžete také použít <syntaxhighlight lang=php inline>wfGetLangObj( $code );</syntaxhighlight>, pokud <syntaxhighlight lang=php inline>$code</syntaxhighlight> již může být jazykovým objektem.
Seznam kódů je v <code>includes/languages/data/Names.php</code>.

Jazykové objekty jsou potřebné k provádění funkcí specifických pro daný jazyk, nejčastěji k formátování čísel, času a data, ale také k vytváření seznamů a dalších věcí.
Existuje několik vrstev ukládání do mezipaměti a slučování s [[#Fallback languages|#Záložními jazyky]], ale podrobnosti jsou při běžném používání irelevantní.

<span id="Old_local_translation_system"></span>
== Starý místní překladatelský systém ==
S MediaWiki 1.3.0 byl vytvořen nový systém pro lokalizaci MediaWiki.
Namísto úpravy jazykového souboru a žádání vývojářů, aby změny použili, mohou uživatelé upravovat řetězce rozhraní přímo ze svých wikin.
Toto je systém používaný od srpna 2005.
Lidé mohou najít zprávu, kterou chtějí přeložit, v [[Special:AllMessages]] a poté upravit příslušný řetězec ve jmenném prostoru <code>MediaWiki:</code>.
Po úpravě jsou tyto změny aktivní.
Už nebylo třeba žádat o aktualizaci a čekat, až vývojáři soubor zkontrolují a aktualizují.

Systém je skvělý pro projekty Wikipedie. Vedlejším efektem však je, že jazykové soubory MediaWiki dodávané se softwarem již nejsou zcela aktuální a pro vývojáře je obtížnější udržovat soubory na meta synchronizaci se soubory ve skutečném jazyce.

Protože soubory výchozího jazyka neposkytují dostatek přeloženého materiálu, čelíme dvěma problémům:

# Nové projekty Wikimedie vytvořené v jazyce, který nebyl po dlouhou dobu aktualizován, vyžadují úplný nový překlad rozhraní.
# Ostatním uživatelům MediaWiki (včetně projektů Wikimedie ve stejném jazyce) zůstávají nepřeložená rozhraní. To je obzvláště nešťastné pro menší jazyky, které nemají mnoho překladatelů.

To už není tak velký problém, protože translatewiki.net je inzerován prominentně a používají ho téměř všechny překlady.
K místním překladům stále dochází, ale důrazně se od nich odrazuje.
Místní zprávy se většinou musí smazat, přesunout příslušné překlady na translatewiki.net a na wiki ponechat pouze přizpůsobení specifické pro daný web. Zejména u starších projektů dochází k obrovskému nahromadění, s čištěním pomáhá [//toolserver.org/~robin/?tool=cleanuplocalmsgs tento nástroj].

<span id="Keeping_messages_centralised_and_in_sync"></span>
== Udržování centralizovaných a synchronizovaných zpráv ==
Anglické zprávy jsou velmi zřídka nesynchronizované s kódem.
Zkušenosti ukazují, že je vhodné mít všechny anglické zprávy na stejném místě.
Revize anglického textu může být provedena bez odkazu na kód, stejně jako překlad.
Programátoři někdy velmi špatně volí výchozí text.

{{Anchor|what-can-be-localized}}<!-- for links from external pages-->
<span id="What_can_be_localised"></span>
== Co lze lokalizovat ==
Na MediaWiki lze lokalizovat tolik věcí, že ne všechny jsou přímo dostupné na {{ll|translatewiki.net|translatewiki.net}}: viz [[translatewiki:Translating:MediaWiki|translatewiki:Translating:MediaWiki]].
Pokud něco vyžaduje zásah [[Special:MyLanguage/Developers|vývojáře]] do kódu, můžete si to [[Special:MyLanguage/How to report a bug|vyžádat na Phabricatoru]] nebo se zeptat na [[translatewiki:Support|translatewiki:Support]], pokud nevíte, co dělat přesně.

* [[#Namespaces|Jmenné prostory]] - jádro i rozšíření plus [[Special:MyLanguage/Manual:Messages API#Users have grammatical genders|pohlavně]] závislé uživatelské jmenné prostory
* Pracovní dny (a zkratky)
* Měsíce (a zkratky)
* Knihkupectví na [[Special:BookSources]]
* Názvy vzhledů
* Matematická jména
* {{ll|Manual:Date formatting|2=Předvolby data}} - <code>$datePreferences</code>
* {{ll|Manual:Date formatting|2=Formáty data}} - <code>$dateFormats</code>
* {{ll|Manual:Date formatting|2=Výchozí formát data}} - <code>$defaultDateFormat</code>
* {{ll|Manual:Date formatting|2=Mapa migrace preferencí data}} - pro kompatibilitu se starými databázemi MediaWiki
* Výchozí uživatelská možnost přepíše
* Názvy jazyků
* Názvy zemí (přes {{ll|Extension:CLDR}})
* Názvy měn (v rámci {{ll|Extension:CLDR}})
* Časová pásma
* Převod kódování znaků prostřednictvím [[w:en:Iconv|<code>iconv</code>]]
* Nejprve UpperLowerCase (pro některé potřebuje casemaps){{clarify}}
* Velká malá písmena{{clarify}}
* Velká písmena
* Konec slov s velkými písmeny{{clarify}}
* Skládání obalu{{clarify}}
* Odstranění interpunkci pro vyhledávání v MySQL (optimalizace vyhledávání)
* Získání prvního znaku
* Alternativní kódování
* Překódování pro úpravy (a poté překódování vstupu){{clarify}}

[[Image:MediaWiki fallback chains.svg|thumb|Graf jazykové zálohy]]

* [[Special:MyLanguage/Manual:Language|Záložní jazyky]] (tj. další blíže příbuzné jazyky, které se mají použít, když překlad není k dispozici, namísto výchozího záložního jazyka, kterým je angličtina)
* Směrovost (zleva doprava nebo zprava doleva, RTL)
* Znak směrové značky v závislosti na RTL
* Šipka v závislosti na RTL
* Jazyky, kde nelze použít kurzívu
* Formátování čísel (comma-ify, ''tj.'' přidání nebo ne oddělování číslic; transformace číslic; transformační oddělovače)<ref>
Ty se konfigurují podle jazyka v příslušných souborech <code>language/classes/LanguageXx.php</code> nebo <code>language/messages/MessagesXx.php</code>.</ref>
* Zkrácení (multibajt)
* [[Special:MyLanguage/Manual:Messages API#…on use context inside sentences via GRAMMAR|Gramatické převody pro skloňované jazyky]]
* [[Special:MyLanguage/Manual:Messages API#Be aware of PLURAL use on all numbers|Plurální transformace]]
* Formátování časů vypršení platnosti{{clarify}}
* Segmentace pro rozdíly (čínština)
* Převést na varianty jazyka (mezi různými pravopisy nebo písmy)
* Možnosti uživatelských preferencí specifické pro daný jazyk
* [[Special:MyLanguage/Help:Links#linktrail|Trasy odkazů]] a předpona odkazu – <code>$linkTrail</code>. Toto jsou písmena, která lze nalepit za/před uzavírací/otevírací závorky odkazu na wiki, ale na obrazovce se zobrazují jako součást odkazu (to znamená, že lze kliknout a mají stejnou barvu), ''např.'': <code><nowiki>[[foo]]</nowiki>bar</code>. Ve výchozím nastavení je trasa odkazu "a-z"; možná budete chtít do seznamu přidat písmena s diakritikou nebo písmena jiná než latinka používaná vaším jazykem.
* Kód jazyka (nejlépe používaný podle nejnovějšího RFC ve standardu BCP 47, aktuálně {{IETF RFC|5646}}, s přidruženou databází IANA. Vyhněte se zastaralým, starým a soukromým kódům: Podívejte se, co znamenají ve standardu ISO 639, a vyhněte se kódům přiřazeným sbírkám/skupinám jazyků v ISO 639-5 a kódům ISO 639, které nebyly importovány do databáze IANA pro BCP 47)
* Typ zdůraznění
* Rozšíření {{ll|Extension:Cite|nsp=0}} má speciální stránkovací soubor pro každý jazyk, <code>cite_text-''zyx''</code> pro kód jazyka <code>zyx</code>.

Čistá funkčnost:

* I18N <code>sprintfDate</code>
* Formátování římských číslic

<span id="Namespaces"></span>
=== Jmenné prostory ===

:<!-- See [https://translatewiki.net/wiki/Translating:MediaWiki#Translating namespace names how they're translated] and [[#Namespace name aliases]]. -->
V současné době je vytváření překladů jmen jmenného prostoru na translatewiki.net zakázáno, takže to musíte udělat sami v Gerritu nebo zadat {{ll|Phabricator}} úkol a požádat někoho jiného, aby to udělal.<ref>
[[gerrit:211677|https://gerrit.wikimedia.org/r/211677]]
</ref>

Chcete-li umožnit překlad vlastních jmenných prostorů zavedených vaším rozšířením, vytvořte soubor <code>''MyExtension''.i18n.namespaces.php</code>, který vypadá takto:

<syntaxhighlight lang="php">
<?php
/**
 *  Překlady jmenných prostorů zavedených MyExtension.
 *
 * @file
 */

$namespaceNames = [];

//  Pro wikiny, kde není nainstalováno rozšíření MyExtension.
if( !defined( 'NS_MYEXTENSION' ) ) {
	define( 'NS_MYEXTENSION', 2510 );
}

if( !defined( 'NS_MYEXTENSION_TALK' ) ) {
	define( 'NS_MYEXTENSION_TALK', 2511 );
}

/** English */
$namespaceNames['en'] = [
	NS_MYEXTENSION => 'MyNamespace',
	NS_MYEXTENSION_TALK => 'MyNamespace_talk',
];

/** Finnish (Suomi) */
$namespaceNames['fi'] = [
	NS_MYEXTENSION => 'Nimiavaruuteni',
	NS_MYEXTENSION_TALK => 'Keskustelu_nimiavaruudestani',
];
</syntaxhighlight>

Poté jej načtěte ze souboru <code>extension.json</code> pomocí ExtensionMessagesFiles takto:

<syntaxhighlight lang="json">
{
	"name": "MyExtension",
	"version": "0.0.1",
	"descriptionmsg": "myextension-desc",
    "ExtensionMessagesFiles": {
		"MyExtensionNamespaces": "MyExtension.i18n.namespaces.php"
	}
}
</syntaxhighlight>

Nyní, když si uživatel nainstaluje MyExtension na svou finskou (fi) wiki, vlastní jmenný prostor bude magicky přeložen do finštiny a uživatel nemusí nic dělat!

Nezapomeňte také zaregistrovat jmenný prostor(y) svého rozšíření na stránce {{ll|extension default namespaces}}.

<span id="Special_page_aliases"></span>
=== Speciální aliasy stránek ===
Aktuální informace naleznete na [[Manual:Special pages#The aliases file|manuálové stránce pro speciální stránky]].
Zdá se, že následující neplatí.

<!--TODO: check what needs to be updated or removed here -->

Vytvořte nový soubor pro speciální aliasy stránek v tomto formátu:

<syntaxhighlight lang="php">
<?php
/**
 * Aliases for the MyExtension extension.
 *
 * @file
 * @ingroup Extensions
 */

$aliases = [];

/** English */
$aliases['en'] = [
	'MyExtension' => [ 'MyExtension' ]
];

/** Finnish (Suomi) */
$aliases['fi'] = [
	'MyExtension' => [ 'Lisäosani' ]
];
</syntaxhighlight>

Poté jej načtěte ze souboru <code>extension.json</code> pomocí ExtensionMessagesFiles takto:

<syntaxhighlight lang="json">
{
	"name": "MyExtension",
	"version": "0.0.1",
	"descriptionmsg": "myextension-desc",
    "ExtensionMessagesFiles": {
		"MyExtensionAlias": "MyExtension.i18n.alias.php"
	}
}
</syntaxhighlight>

Když váš speciální kód stránky používá {{phpi|SpecialPage::getTitleFor( 'MyExtension' )}} nebo {{phpi|$this->getTitle()}} (ve třídě, která poskytuje Special:MyExtension), použije se lokalizovaný alias, pokud je k dispozici.

<span id="Namespace_name_aliases"></span>
=== Aliasy jmenného prostoru ===
Aliasy jmenných prostorů jsou další názvy, které lze použít k adresování existujících jmenných prostorů.
Jsou zřídkakdy potřeba, ale když je nemáte, obvykle to na stávajících wikinách způsobí zmatek.

Potřebujete aliasy jmenného prostoru:

# Když má jazyk varianty a tyto varianty hláskují některé jmenné prostory odlišně a chcete, aby editoři mohli používat varianty pravopisu. Varianty jsou volitelné v uživatelských preferencích. Uživatelé vždy vidí svou vybranou variantu, kromě wikitextu, ale při editaci nebo vyhledávání lze použít libovolnou variantu.
# Když se změní jazyk existující wiki, záložní jazyk(y) nebo lokalizace, změní se i některé názvy jmenných prostorů. Aby nedošlo k přerušení odkazů již přítomných na wiki, které používají stará jména jmenných prostorů, musíte přidat každé ze změněných předchozích jmen jmenných prostorů k jejich aliasům jmen jmenných prostorů, když je změna provedena nebo před ní.

Obecné anglické názvy jmenných prostorů jsou vždy přítomny jako aliasy jmenných prostorů ve všech lokalizacích, takže je nemusíte a neměli byste přidávat.

Aliasy nelze přeložit na {{ll|translatewiki.net}}, ale lze o ně požádat tam nebo na {{ll|bugzilla}}: viz [[translatewiki:Translating:MediaWiki#Namespace name aliases|translatewiki:Translating:MediaWiki#Jméno aliasů jmenného prostoru]].

<span id="Regional_settings"></span>
=== Regionální nastavení ===

Některá jazyková nastavení se v různých zeměpisných oblastech liší. MediaWiki nemá koncept regionu, má pouze jazyky a jazykové varianty.

Tato nastavení je potřeba nastavit jednou jako výchozí jazyk, pak si je jednotlivé wikiny mohou ve své konfiguraci libovolně měnit.

<span id="Time_and_date_formats"></span>
===== Formáty času a data =====
Čas a data jsou zobrazeny na speciálních stránkách a podobně.
Pro podpisy se používá výchozí formát času a data, takže by to měl být nejpoužívanější a nejrozšířenější formát pro uživatele daného jazyka.
Také anonymní uživatelé vidí výchozí formát.
Registrovaní uživatelé si mohou ve svých preferencích vybrat jiné formáty.

Pokud jste obeznámeni s formátem PHP time(), můžete se pokusit vytvořit formáty sami.
MediaWiki používá podobný formátovací řetězec s některými funkcemi navíc.
Pokud nerozumíte předchozí větě, nevadí.
Můžete poskytnout seznam příkladů na {{ll|Developers}}.

Viz [[Special:MyLanguage/Help:System message#Message sources|Nápověda:Systémová zpráva#Zdroje zpráv]].

<span id="Notes"></span>
== Poznámky pod čarou ==
<references/>

<span id="See_also"></span>
== Související odkazy ==

* [[Special:MyLanguage/Multilingual MediaWiki|Multijazyčná MediaWiki]]
* Získávání názvů jazyků z kódů je možné pomocí základní funkce <nowiki>{{#language:<code>}}</nowiki> zdokumentované v [[Special:MyLanguage/Help:magic words|magických slovech]]

[[Category:Localisation{{#translation:}}]]