Příručka:Jmenný prostor
Jmenný prostor je soubor stránek, které mají všechny podobný účel. Jmenné prostory lze chápat jako rozdělení informací v rámci wiki do různých typů, čímž se "skutečný" obsah (stránky o hlavním tématu wiki) oddělí od uživatelských profilů, stránek nápovědy atd.
Předpona jmenného prostoru je první část názvu stránky (pokud existuje), která označuje, do kterého jmenného prostoru stránka patří. Od zbytku názvu je oddělena dvojtečkou (:). Takzvaný "hlavní jmenný prostor" předponu nemá.
Každý jmenný prostor má číslo nebo index, který software MediaWiki používá k odkazování na jmenný prostor namísto jeho názvu.
Technický přehled
editKaždá stránka na wiki má jedinečný název, který může začínat prefixem jmenného prostoru, nebo ne. Stránky v různých jmenných prostorech mohou jinak sdílet stejný název (tj. jejich prefixy se nepočítají).
Například:
| Název | Jmenný prostor | Kód | Popis stránky |
|---|---|---|---|
API
|
0 | Stránka v "hlavním jmenném prostoru" | |
Template:API
|
Template | 10 | Šablona, kterou lze vložit do jiných stránek |
Manual:API
|
Manual | 100 | Stránka v naší příručce MediaWiki (která v tomto případě přesměrovává na jinou stránku) |
Protože "hlavní jmenný prostor" nemá prefix, je jakýkoli název stránky bez prefixu – nebo jakákoli stránka, jejíž zdánlivý prefix neodpovídá žádnému rozpoznanému jmennému prostoru na wiki (ani žádnému interwiki/interlanguage prefixu) – interpretován jako stránka v hlavním jmenném prostoru.
Všimněte si, že stránky v hlavním jmenném prostoru nemohou mít názvy začínající žádnou existující předponou jmenného prostoru následovanou dvojtečkou, protože takové stránky by byly znepřístupněny přítomností daného jmenného prostoru. (Pokud k tomu došlo v důsledku vytvoření nového jmenného prostoru, lze k opravě problému použít údržbový skript namespaceDupes.php.)
Stránky lze mezi jmennými prostory jednoduše přesunovat změnou prefixu před vlastním názvem.
Předpony jmenného prostoru lze přeložit a pro každý z nich lze nakonfigurovat aliasy (užitečné ve zkratkách) (viz $wgNamespaceAliases).
Všechny jmenné prostory mají také "kanonickou" předponu, která funguje na všech wikinách bez ohledu na konfiguraci.
Aliasy a kanonické názvy lze použít v odkazech, při provádění vyhledávání a v názvu stránky pomocí kouzelného slova {{DISPLAYTITLE}}.
Každý jmenný prostor má také svůj index jmenného prostoru. V databázi je název článku rozdělen na index jmenného prostoru a vlastní název, čehož se mimo jiné využívá pro uložení page.page_namespace a page.page_title.
Subjekty a diskuse
edit- Pro bližší seznámení s diskusemi slouží Nápověda:Diskusní stránka.
Většina jmenných prostorů má k sobě odpovídající diskusní jmenný prostor (Název jmenného prostoru rozšířený o řetězec "talk").
Všechny jmenné prostory diskusí mají indexy lichých celých čísel a index jmenného prostoru diskuse pro konkrétní jmenný prostor s indexem n je n+1.
Jmenné prostory s indexy sudých celých čísel jsou předmětové jmenné prostory (všimněte si, že se jedná o odlišný koncept od obsahových jmenných prostorů).
Dualitu předmětné diskuse lze prozkoumat pomocí kouzelných slov {{SUBJECTPAGENAME}} a {{TALKPAGENAME}}.
Značka <body> u stránek ve jmenných prostorech diskuse má třídu CSS ns-talk, která může být užitečná pro tvorbu stylu.
Výchozí jmenné prostory
editMediaWiki používá ve výchozím stavu 18 jmenných prostorů:
- 16 "skutečných" jmenných prostorů, číslovaných od 0 do 15, odpovídají existujícím stránkám, spárovaným vždy subjekt/diskuse
- 2 "virtuální" jmenné prostory (jeden pro dynamicky generované speciální stránky a jeden sloužící jako alias pro přímé odkazy na soubory), očíslované -1 a -2. Protože tyto jmenné prostory neodpovídají stránkám uloženým v databázi, nelze v těchto jmenných prostorech vytvářet ani mazat stránky a neexistují žádné k nim odpovídající jmenné prostory diskusí.
Úplný seznam je v následující tabulce.
| ID | Název | Účel | Diskuse | |
|---|---|---|---|---|
| 0 | (Main) | Články se "skutečným" obsahem.[1] | Talk | 1 |
| 2 | User | Uživatelské stránky.[2] | User talk | 3 |
| 4 | Project | Informace o wiki.[3] | Project talk | 5 |
| 6 | File | Stránky s informacemi k souborům | File talk | 7 |
| 8 | MediaWiki | Uživatelské úpravy rozhraní[4] | MediaWiki talk | 9 |
| 10 | Template | Stránky šablony | Template talk | 11 |
| 12 | Help | Stránky nápovědy | Help talk | 13 |
| 14 | Category | Popis ke stránkám kategorií | Category talk | 15 |
| -1 | Special | Zahrnuje speciální stránky | N/A | |
| -2 | Media | Aliasy na přímé odkazy k souborům | ||
Každý jmenný prostor má také konstantu odvozenou od svého názvu, přičemž všechna písmena jsou velká, mezery jsou nahrazeny podtržítky a předponou je NS_.
Například konstanta pro jmenný prostor "User talk" je NS_USER_TALK.
Kompletní seznam najdete na stránce Výchozí jmenné prostory rozšíření.
- ↑ Tento jmenný prostor nemá žádný prefix.
- ↑ Po úpravě uživatelovy diskusní stránky se vygeneruje upozornění pro uživatele.
- ↑ Definuje se přes
$wgMetaNamespace, není-li ručně přenastaven automaticky se použije$wgSitename. - ↑ Úpravy mohou dělat pouze uživatelé s právem 'editinterface' (editační rozhraní).
Uživatelské jmenné prostory
editDalší jmenné prostory, které sdružují specifické stránky, mohou pro svou potřebu vytvářet rozšíření nebo správce s přístupem ke kódu stránek. Pro více informací na stránce Příručka:Použití vlastních jmenných prostorů.
Funkčnost
editNěkteré jmenné prostory, jako je projekt a nápověda, existují pouze pro pohodlí a ve srovnání s hlavním jmenným prostorem nemají žádné další funkce.
Jmenný prostor Template (šablona) obsahuje stránky, které lze vkládat bez uvedení prefixu jmenného prostoru.
Stránky v uživatelském jmenném prostoru User (uživatel) jsou spojovány s uživatelským účtem nebo IP adresou. Pro každou změnu v rámci uživatelských diskusních stránek se automaticky generuje upozornění pro uživatele, že na jeho diskuzní stránce došlo ke změně.
Stránky ve jmenném prostoru "MediaWiki" využívají pro modifikaci výchozích textů z jazykových souborů. Editovat je mohou pouze administrátoři nebo uživatelé s přiděleným právem editinterface.
Stránky ze jmenného prostoru File (soubor), nebo Category (kategorie) mají rovněž speciální funkce, které jsou popsány na stránkách Nápověda:Práce se soubory a Nápověda:Kategorie. Stránky ve jmenném prostoru Category mohou přesouvat pouze uživatelé s právem "movefile". Stránky kategorií mohou přesouvat uživatelé s právem "move-categorypages".
Všechny stránky z diskusních jmenných prostorů mají funkcionalitu "post a comment".
Související odkazy
edit- Nápověda:Jmenné prostory – uživatelsky orientované informace.
- Extension default namespaces
Správa stránek
edit- Příručka:Nastavení konfigurace#Jmenné prostory
- Příručka:Konstanty jmenných prostorů
- Příručka:Použití vlastních jmenných prostorů
- Manuál:Jmenný prostor Nápověda
Rozšíření
edit- Kategorie:Rozšíření jmenného prostoru
- Extension:NamespaceManager – pro správu jmenných prostorů.
- Extension:BlueSpiceNamespaceManager – umožňuje vytvářet vlastní jmenné prostory.
- Extension:SpecialNamespaces – upravená verze Extension:Interwiki, která jej mění tak, aby poskytovala správce jmenného prostoru jako speciální stránku.
- Extension:Lockdown – pro řízení přístupu k jmenným prostorům.
- Extension:SkinPerNamespace – použít jiný vzhled ve jmenném prostoru.
Pro vývojáře rozšíření
edit- Příručka:Použití vlastních jmenných prostorů
- Seznam vlastních jmenných prostorů registrovaných podle rozšíření. Pokud definujete konstantu pro vlastní jmenný prostor, uveďte ji zde také.
- Třídy
- * Manual:MWNamespace.php, obsahující třídu MWNamespace (odstraněno od 1.39)
- Háčky
- Manual:Hooks/CanonicalNamespaces – přidat vlastní jmenné prostory nebo změnit výchozí hodnoty.
- Manual:Hooks/NamespaceIsMovable – určí, zda je možné přesouvat stránky ve jmenném prostoru.
- Manual:Hooks/SearchableNamespaces – upraví, které jmenné prostory lze prohledávat.
- Manual:Hooks/LanguageGetNamespaces – poskytnout vlastní řazení jmenných prostorů nebo je odebrat.
- Manual:Hooks/PrefixSearchExtractNamespace – volané, pokud jádro nebylo schopno extrahovat jmenný prostor z vyhledávacího řetězce, aby se o to mohla pokusit rozšíření.