Příručka:Jmenný prostor
Jmenný prostor je soubor stránek, které mají z hlediska svého obsahu podobný účel a cíl. Wiki má svůj obsah rozdělen do několika jmenných prostorů s různým zaměřením, které pomáhají udržet "skutečný obsah" oddělený od stránek uživatelských profilů, nápovědy, atp.
Jmenný prostor prefix stránky tvoří část titulku stránky oddělený dvojtečkou (:
).
Technický přehled
Jak již bylo řečeno, každá stránka existuje v rámci svého jmenného prostoru. Nejde-li zrovna o stránku v hlavním jmenném prostoru, je název jmenného prostoru součástí názvu stránky, jako prefix oddělený dvojtečkou (:
)
Například:
Název | Jmenný prostor | Kód |
---|---|---|
Foo |
Main | 0 |
Template:Foo |
Template | 10 |
Module:Foo |
Module | 828 |
"Hlavní jmenný prostor" prefix nemá. Stejně tak stránky v tomto jmenném prostoru nemohou mít názvy, které by začínaly jménem některého z existujících jmenných prostorů, následovaným dvojtečkou.
Stránky lze mezi jmennými prostory jednoduše přesunovat změnou prefixu před vlastním názvem.
Názvy jmenných prostorů lze překládat. Rovněž lze pro ně tvořit aliasy (viz $wgNamespaceAliases
). Všechny jmenné prostory mají také svůj "odvozený" prefix, který funguje bez ohledu na nastavení wikin. Tyto aliasy a odvozené názvy jmenných prostorů lze s výhodou používat v odkazech, při vyhledávání nebo u názvů stránek které využívají systémovou proměnnou {{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
- 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
MediaWiki 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 Příručka:Konstanty jmenných prostorů .
- ↑ 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
Další 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
Ně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
- Nápověda:Jmenné prostory – uživatelsky orientované informace.
Správa stránek
- 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í
- 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í
- 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í.