Podręcznik:Przestrzeń nazw
Przestrzeń nazw to zbiór stron o treści z podobnym przeznaczeniem. Przestrzenie nazw mogą być rozumiane jako przegródki na różne typy informacji na tej samej wiki i oddzielać "rzeczywistą" zawartość od profili użytkowników, stron pomocy, itp.
A namespace prefix is the first part of a page title (if present) indicating which namespace it belongs to. It is separated from the rest of the title by a colon (:). The so-called "main namespace" does not have a prefix.
Every namespace has a number or index which the MediaWiki software uses to refer to the namespace instead of its name.
Techniczne spojrzenie
Every page on a wiki has a unique title which may begin with a namespace prefix or not. Pages in different namespaces can otherwise share the same name (i.e., not counting their prefixes).
Na przykład:
| Tytuł | Przestrzeń nazw | Kod | Page description |
|---|---|---|---|
API
|
0 | a page in the "main namespace" | |
Template:API
|
Template | 10 | a template that can be transcluded into other pages |
Manual:API
|
Manual | 100 | a page in our MediaWiki manual (which, in this case, redirects to a different page) |
Because the "main namespace" does not have a prefix, any page title having no prefix—or any page whose apparent prefix doesn't match any recognized namespace on the wiki (nor any interwiki/interlanguage prefix)—is interpreted as a page in the main namespace.
"Główna przestrzeń nazw" nie ma prefiksu. Strony w głównej przestrzeni nazw również nie mogą mieć nazw zaczynających się na istniejące prefiksy przestrzeni nazw z dwukropkiem. (If this has happened as the result of the creation of a new namespace, the namespaceDupes.php maintenance script can be used to fix the problem.)
Strony mogą być przenoszone między przestrzeniami nazw poprzez zwykłą zmianę tego prefiksu w ich tytułach.
Prefiksy przestrzeni nazw mogą być tłumaczone na inne języki i można dla każdej z nich skonfigurować aliasy (zobacz $wgNamespaceAliases). Każda przestrzeń nazw ma także prefiks "kanoniczny", który działa na wszystkich wiki bez względu na konfigurację. Aliasy i nazwy kanoniczne mogą być używane w linkach, podczas wyszukiwania oraz w tytule strony z użyciem magicznego słowa {{DISPLAYTITLE}}.
All namespaces also have a "canonical" prefix, which works on all wikis regardless of configuration.
Aliases and canonical names can be used in links, when performing a search, and in the page title with the help of the {{DISPLAYTITLE}} magic word.
Każda przestrzeń nazw ma odpowiadający jej indeks przestrzeni nazw. W bazie danych tytuł jest podzielony na indeks przestrzeni nazw i tytuł i przechowywane są kolumnach page.page_namespace oraz page.page_title.
Przestrzenie nazw tematyczne i dyskusji
- Zobacz Help:Strony dyskusji po instrukcje na temat korzystania ze stron dyskusji.
Większość przestrzeni nazw posiada powiązaną przestrzeń nazw dyskusji (lub przestrzeń nazw "Dyskusja").
Wszystkie przestrzenie nazw dyskusji maja nieparzyste wskaźniki, większe o 1 (n+1) niż przestrzeń nazw, z którą są powiązane (n).
Przestrzenie nazw z parzystymi wskaźnikami są nazywane tematycznymi przestrzeniami nazw (uwaga - nie jest to to samo co przestrzenie nazw treści).
Ten rozdział na temat i dyskusję można odkrywać za pomocą magicznych słów {{SUBJECTPAGENAME}} oraz {{TALKPAGENAME}}.
Znacznik <body> na stronach w przestrzeniach nazw dyskusji ma klasę CSS ns-talk, która może być przydatna dla nadawania stylów.
Wbudowane przestrzenie nazw
MediaWiki ma 18 wbudowanych przestrzeni nazw:
- 16 "rzeczywistych" przestrzeni nazw odpowiadającym właściwym stronom, ponumerowane od 0 do 15 i pogrupowane w pary temat/dyskusja
- 2 "wirtualne" przestrzenie nazw (jedna dla dynamicznie generowanych stron specjalnych, druga dla bezpośrednich linków do plików), odpowiednio o numerach -1 i -2. Ponieważ nie odpowiadają one stronom przechowywanym w bazie danych, nie można tworzyć i usuwać stron w tych przestrzeniach nazw, ani nie mają one odpowiadających im stron dyskusji.
Pełna lista jest przedstawiona w poniższej tabeli.
| ID | Nazwa | Przeznaczenie | Dyskusja | |
|---|---|---|---|---|
| 0 | (Main) | "Real" content articles[1] | Talk | 1 |
| 2 | User | Strony użytkowników.[2] | User talk | 3 |
| 4 | Project | Informacje o wiki.[3] | Project talk | 5 |
| 6 | File | Strony opisu plików | File talk | 7 |
| 8 | MediaWiki | Dostosowywanie interfejsu strony[4] | MediaWiki talk | 9 |
| 10 | Template | Strony szablonów | Template talk | 11 |
| 12 | Help | Strony pomocy | Help talk | 13 |
| 14 | Category | Strony opisu kategorii | Category talk | 15 |
| -1 | Special | Przechowuje strony specjalne | N/A | |
| -2 | Media | Alias dla bezpośrednich linków do plików | ||
Każda przestrzeń nazw ma stałą o nazwie pochodzącej od nazwy przestrzeni, pisaną dużymi literami, ze spacjami zamienionymi na podkreślenia i z prefiksem NS_.
Na przykład, stała dla przestrzeni nazw "Dyskusja użytkownika" to NS_USER_TALK.
Pełną listę można znaleźć w: Extension default namespaces.
- ↑ Przestrzeń nazw tematu nie ma prefiksu.
- ↑ Edytowanie strony dyskusji użytkownika generuje powiadomienie dla danego użytkownika.
- ↑ Definiowana przez
$wgMetaNamespace, która dopóki nie jest ustawiona ręcznie, domyślnie jest to$wgSitename. - ↑ Mogą edytować w niej tylko użytkownicy z uprawnieniem 'editinterface'.Some pages in this namespace additionally require
editsitecssandeditesitejspermissions.
Własne przestrzenie nazw
Administratorzy oraz rozszerzenia mogą definiować dodatkowe przestrzenie nazw, aby grupować inne rodzaje stron. Aby zobaczyć dokładny przegląd, zobacz Podręcznik:Korzystanie z własnych przestrzeni nazw.
Funkcjonalność
Niektóre przestrzenie nazw, takie jak Projekt i Pomoc istnieją tylko dla wygody i nie mają żadnej specjalnej funkcji odróżniającej od głównej przestrzeni nazw.
Strony w przestrzeni szablonów mogą być transkludowane bez podawania prefiksu tej przestrzeni nazw.
Strony w przestrzeni nazw użytkowników są powiązane z kontami użytkowników lub adresami IP. Zmiany na stronach dyskusji użytkowników generują automatyczne powiadomienie o nowej wiadomości.
Strony w przestrzeni nazw "MediaWiki" są wykorzystywane do nadpisywania domyślnych komunikatów interfejsu z pliku językowego i mogą być edytowane tylko przez administratorów lub przez użytkowników będących w innej grupie z uprawnieniem editinterface.
Strony w przestrzeniach nazw Plik i Kategoria mają specjalne funkcje opisane w Pomoc:Zarządzanie plikami oraz Help:Kategorie. Files can be moved by users with the "movefile" right. Strony kategorii mogą być przenoszone przez użytkowników z uprawnieniem "move-categorypages".
Wszystkie strony w przestrzeni nazw dyskusji mają funkcję "Dodaj komentarz".
Zobacz też
- Help:Przestrzenie nazw – user-oriented information.
- Extension default namespaces
Site administration
- Podręcznik:Ustawienia konfiguracyjne#Przestrzenie nazw
- Manual:Namespace constants/pl
- Podręcznik:Korzystanie z własnych przestrzeni nazw
- Manual:Help namespace
Rozszerzenia
- Kategoria:Rozszerzenia przestrzeni nazw
- Extension:NamespaceManager – for management of namespaces.
- Extension:BlueSpiceNamespaceManager – lets you create custom namespaces.
- Extension:SpecialNamespaces – a modified version of the Rozszerzenie:Interwiki which changes it to provide a namespace manager as a special page.
- Extension:Lockdown – to control access to namespaces.
- Extension:SkinPerNamespace – to use a different skin in a namespace.
Dla twórców rozszerzeń
- Podręcznik:Korzystanie z własnych przestrzeni nazw
- List of custom namespaces registered by extensions. If you define a constant for a custom namespace, list it here, too.
- Classes
- * Podręcznik:Namespace.php, plik zawierający klasę MWNamespace (usunięto w 1.39)
- Haki
- Manual:Hooks/CanonicalNamespaces – add custom namespaces or alter the defaults.
- Manual:Hooks/NamespaceIsMovable – determine if it is possible to move pages in a namespace.
- Manual:Hooks/SearchableNamespaces – modify which namespaces are searchable.
- Manual:Hooks/LanguageGetNamespaces – provide custom ordering for namespaces or remove namespaces.
- Manual:Hooks/PrefixSearchExtractNamespace – called if core was not able to extract a namespace from the search string so that extensions can attempt it.