Manuel:Espace de noms
Un espace de noms (namespace) est une collection de pages qui partagent un sujet similaire. Les espaces de noms peuvent être vus comme des partitions de l'information dans un wiki en différents types, tout en conservant le contenu « réel » (pages sur le sujet principal du wiki) distinct des profils utilisateurs, des pages d'aide, etc.
Le préfixe de l'espace de noms est la première partie du titre de la page (s'il existe) indiquant à quel espace de noms elle appartient. Il est séparé du reste du titre par un caractère deux points (:). L'espace de noms principal (Main) n'a pas de préfixe.
Chaque espace de noms possède un numéro ou un indice utilisé par le logiciel MediaWiki pour le référencer plutôt que d'utiliser son nom.
Aperçu technique
Chaque page du wiki a un titre unique qui peut commencer ou pas par le préfixe d'un espace de noms. Les pages de différents espaces de noms peuvent alors partager le même nom (ignorant leur préfixe).
Par exemple :
| Titre | Espace de noms | Code | description de la page |
|---|---|---|---|
API
|
0 | page de l'espace de noms principal | |
Template:API
|
Template | 10 | modèle pouvant être transclus dans d'autres pages |
Manual:API
|
Manual | 100 | page du Manuel MediaWiki (qui dans ce cas redirige vers une page différente) |
Parce que l'espace de noms principal n'a pas de préfixe, tout titre de page qui n'a pas de préfixe, ou toute page dont le préfixe ne correspond pas à un espace de noms reconnu du wiki (ni à aucun autre préfixe inter-wiki ou interlangue ) — est interprétée comme appartenant à l'espace de noms principal.
Notez que les pages de l'espace de noms principal ne peuvent pas avoir de noms commençant avec un préfixe d'espace de noms existant et suivi du caractère deux points parce que de telles pages seraient rendues inaccessibles à cause de la présence de cet espace de noms. Si cela se produit comme résultat de la création d'un nouvel espace de noms, le script de maintenance namespaceDupes.php peut être utilisé pour corriger le problème.
Les pages peuvent être déplacées entre espaces de noms simplement en changeant la partie préfixe de leur titre.
Les préfixes des espaces de noms peuvent être traduits, et les alias (utiles pour les raccourcis) peuvent être configurés pour chacun d'eux (voir $wgNamespaceAliases ).
Tous les espaces de noms ont un préfixe « canonique » , qui fonctionne sur tous les wikis quelle que soit la configuration.
Les alias et les noms canoniques peuvent être utilisés dans les liens, lors d'une recherche, et dans le titre des pages avec l'aide du mot magique {{DISPLAYTITLE}}.
Chaque espace de noms possède un index d'espace de noms correspondant. Dans la base de données, le titre est composé de l'index de l'espace de noms et du texte du titre, et ceci est utilisé entre autre, pour l'enregistrement dans les colonnes page.page_namespace et page.page_title .
Espaces de noms du sujet et des pages de discussion
- Voir Aide:Pages de discussion pour les instructions concernant l'usage des pages de discussion.
La plupart des espaces de noms possèdent un espace de noms de discussion associé (ou « talk » namespaces).
Tous les espaces de noms de discussion ont des indices entiers impairs et l'indice de l'espace de noms de discussion associé à un espace de noms spécifique d'indice n est n+1.
Les espaces de noms ayant des indices entiers pairs sont les espaces de noms des sujets (notez que c'est un concept distinct de celui d'espaces de noms de contenu).
La dualité entre le sujet et la discussion peut être explorée en utilisant les mots magiques {{SUBJECTPAGENAME}} et {{TALKPAGENAME}}.
La balise <body> des pages des espaces de noms de discussion a la classe CSS ns-talk, ce qui peut être utile pour la mise en forme.
Espaces de noms prédéfinis
Par défaut, MediaWiki est livré avec 18 espaces de noms prédéfinis :
- 16 espaces de noms « réels », contenant de vraies pages, numérotés de 0 à 15, et groupés en paires sujet/discussion
- 2 espaces de noms « virtuels » (un pour les pages spéciales générées dynamiquement, et un servant d'alias pour les liens de fichiers directs), numérotés -1 et -2 respectivement. Comme ces espaces de noms ne correspondent pas à des pages stockées dans la base de données, on ne peut pas créer ou supprimer des pages dans ces espaces de noms, et il n'ont pas d'espaces de noms de discussion associés.
La liste complète est présentée dans la table ci-dessous.
| Identifiant | Nom | Contenu | Discussion | |
|---|---|---|---|---|
| 0 | (Main) | Articles à contenu « réel » .[1] | Talk | 1 |
| 2 | User | Pages utilisateur .[2] | User talk | 3 |
| 4 | Project | Informations sur le wiki.[3] | Project talk | 5 |
| 6 | File | Pages de description du média | File talk | 7 |
| 8 | MediaWiki | Personnalisation de l'interface du site[4] | MediaWiki talk | 9 |
| 10 | Template | Pages des modèles | Template talk | 11 |
| 12 | Help | Pages d’aide | Help talk | 13 |
| 14 | Category | Pages de description des catégories | Category talk | 15 |
| -1 | Special | Contient des pages spéciales | N/A | |
| -2 | Media | Alias pour les liens directs vers les fichiers de média | ||
Chaque espace de noms a aussi une constante dérivée de son nom, avec toutes les lettres en majuscules, les espaces remplacées par des caractères "souligné", et préfixée par NS_.
Par exemple, la constante pour l'espace de noms de « User talk » est NS_USER_TALK.
La liste complète se trouve dans Espaces de noms par défaut des extensions .
- ↑ L'espace de noms du sujet n'a pas de préfixe.
- ↑ Modifier une page de discussion utilisateur génère une notification pour cet utilisateur.
- ↑ Défini par
$wgMetaNamespace, qui - à moins d'être mis à jour manuellement - est fixé par défaut à$wgSitename. - ↑ N'est modifiable que par les utilisateurs ayant les droits 'editinterface' .En plus de cela, quelques pages seulement de cet espace de noms nécessitent les droits
editsitecsseteditesitejs.
Espaces de noms personnalisés
Les administrateurs d'extensions et administrateurs de sites peuvent définir des espaces de noms additionnels pour regrouper ensemble des classes supplémentaires de pages. Pour un aperçu détaillé, voir Manuel:Utiliser des espaces de noms personnalisés .
Fonctionnalité
Certains espaces de noms, comme Project et Help, n'existent seulement que pour la facilité et n'ont pas d'autre but, comparé à l'espace de noms principal.
Les pages de l'espace de noms des modèles (Template) peuvent être transcluses sans mettre le préfixe de l'espace de noms.
Les pages des espaces de noms utilisateur (User) sont associées aux comptes des utilisateurs ou à leur adresse IP. Les modifications des pages de discussion utilisateur génèrent un message automatique de notification.
Les pages de l'espace de noms "MediaWiki" sont utilisées pour remplacer les messages par défaut du fichier de langue et ne peuvent être modifiées que par les administrateurs ou d'autres utilisateurs ayant les droits editinterface .
Les pages de « File » et « Category » ont des fonctionalités spéciales, comme décrit dans Aide:Gérer les fichiers et Aide:Catégories . Les fichiers peuvent être renommés par les utilisateurs ayant les droits « movefile » . Les pages de catégories peuvent être renommées par les utilisateurs ayant les droits « move-categorypages » .
Toutes les pages des espaces de noms de discussion ont une fonctionnalité « envoyer un commentaire ».
Voir aussi
- Espaces de noms – informations concernant l'utilisateur.
- Extension default namespaces
Administration de site
- Paramères de configuration : espaces de noms
- Manuel:Constantes des espaces de noms
- Manuel:Utiliser des espaces de noms personnalisés
- Manuel:Espace de noms Aide
Extensions
- Catégorie:Extensions d'espace de noms
- Extension:NamespaceManager – pour la gestion des espaces de noms.
- Extension:BlueSpiceNamespaceManager – vous permet de créer des espaces de noms personnalisés.
- Extension:SpecialNamespaces – une version modifiée de Extension:Interwiki qui le transforme pour obtenir un gestionnaire d'espaces de noms sous la forme d'une page spéciale.
- Extension:Lockdown – pour contrôler l'accès aux espaces de noms.
- Extension:SkinPerNamespace – pour utiliser un habillage différent dans un espace de noms.
Pour les développeurs d'extensions
- Manuel:Utiliser des espaces de noms personnalisés
- Liste d'espaces de noms personnalisés enregistrés par les extensions . Si vous définissez une constante pour un espace de noms personnalisé, listez-la ici aussi.
- Classes
- Manual:MWNamespace.php , contient la classe MWNamespace (supprimé en 1.39)
- Accroches
- Manual:Hooks/CanonicalNamespaces – ajouter des espaces de noms personnalisés ou modifier les valeurs par défaut.
- Manual:Hooks/NamespaceIsMovable – indique s'il est possible de renommer les pages d'un espace de noms.
- Manual:Hooks/SearchableNamespaces – modifier les espaces de noms où la recherche est autorisée.
- Manual:Hooks/LanguageGetNamespaces – fournit un ordonnancement personnalisé des espaces de noms ou permet de les supprimer.
- Manual:Hooks/PrefixSearchExtractNamespace – appelé si le noyau n'a pas été en mesure d'isoler un espace de noms dans la chaîne de recherche afin que les extensions puissent l'utiliser.