Manual:Title.php/fr

La classe  du logiciel MediaWiki implemente les interfaces  et IDBAccessObject. Elle représente les titres des articles, utilisés à différentes fins, y compris :


 * comme texte du titre de l'article lisible par un humain
 * dans l'URL utilisée pour accéder à l'article
 * le lien en wikicode vers l'article
 * la clé de l'article dans la base de données

La classe est instanciée avec l'un de ces formats. Une fois instancié, le titre peut être récupéré dans d'autres formats ou interrogé pour avoir ses attributs. est prévu pour être une classe de valeur non mutable, il n'y a donc pas de fonction mutateur.

Pour instancier, appelez l'une des méthodes statiques de la fabrique :
 * - Ce n'est pas la fonction que vous désirez. Utilisez Title::newFromText.
 * - retourne un tableau d'objets Title
 * - Crée un nouvel objet Title à partir d'un index d'espace de noms et d'une clé de base de données. Retourne null en cas d'erreur.
 * - Ce n'est pas la fonction que vous désirez. Utilisez Title::newFromText.
 * - retourne un tableau d'objets Title
 * - Crée un nouvel objet Title à partir d'un index d'espace de noms et d'une clé de base de données. Retourne null en cas d'erreur.
 * - Crée un nouvel objet Title à partir d'un index d'espace de noms et d'une clé de base de données. Retourne null en cas d'erreur.

Une fois instancié, les autres méthodes non statiques des assesseurs peuvent être utilisées telles que,  ,  , etc.

Si vous avez un objet Title, vous pouvez obtenir un :


 * objet, utilisant
 * objet, utilisant

Cette classe peut récupérer différents types de données de la base de données; néanmoins, elle le fait de manière pas trop efficace. A la place, prenez plutôt un objet. TitleValue est plus léger et ne dépend pas de l'état global de la base de données.

Structure de Title
Un titre est constitué d'un préfixe Interwiki optionnel (tel que « mw: » pour les pages de mediawiki.org ou « w: » pour les articles Wikipedia), suivi d'un espace de nom optionnel (tel que « Manual: »), suivi enfin du nom de la page.

Interwiki prefixes and namespaces
Interwiki prefixes and namespaces follow the same content rules:


 * they must start with a letter
 * they must end with a colon
 * they may only contain digits, letters, the space character and the underscore character
 * les espaces et les caractères souligné '_' peuvent être utilisés invariablement
 * ils ne sont pas sensibles à la casse

Interwiki prefixes and namespaces are only recognized if they are known to a given installation of MediaWiki, either by default or through configuration.

For example: On this wiki, "w:Name" is a link to the article "Name" on Wikipedia, because "w" is recognized as one of the allowable interwiki prefixes. The title "talk:Name" is a link to the article "name" in the "talk" namespace of the current wiki, because "talk</tt>" is a recognized namespace. Both may be present, and if so, the interwiki must come first, for example, "w:talk:name</tt>".

If a title begins with a colon as its first character, no prefixes are scanned for, and the colon is removed before the title is processed. Because of this rule, it is possible to have articles with colons in their names. "E. Coli 0157:H7</tt>" is a valid title, as is "Commandos: Behind Enemy Lines", because "E. Coli 0157</tt>" and "Commandos</tt>" are not valid interwikis or namespaces.

Nom d'article
In the article name, spaces and underscores are treated as equivalent and each is converted to the other in the appropriate context (underscore in URL and database keys, spaces in plain text). "Extended" characters in the 0x80..0xFF range are allowed in all places, and are valid characters. They are encoded in URLs. Extended characters are not urlencoded when used as text or database keys. Other characters may be ASCII letters, digits, hyphen, comma, period, apostrophe, parentheses and colon. No other ASCII characters are allowed, and will be deleted if found (they will probably cause a browser to misinterpret the URL).

Canonical forms
The canonical form of a title will always be returned by the object. Canonicalization involves the following:


 * Certain Unicode directional characters (left-to-right mark, etc.) are stripped, since that usually results from errant copy-and-paste.
 * Everything from #</tt> onward is stripped, since that's used for section links.
 * Sequences of underscores and/or certain whitespace characters are collapsed into a single underscore (for the URL and DBkey forms) or a single space (for the text form). At the beginning or end of the title (or namespace or interwiki prefix), these are stripped.
 * Recognized interwiki prefixes are canonicalized, meaning that they're put entirely in lowercase.
 * Recognized namespace-names are canonicalized, meaning that the first character is capitalized and subsequent characters are put in lowercase. (This is not done for interwiki-links, however.)
 * Depending on the wiki and the namespace, the first character of a title may be capitalized. (This is not done for interwiki-links, however.)
 * For links to user-pages of anonymous users, the IP address is canonicalized.
 * The canonicalization process also includes some validation logic to reject various kinds of invalid titles (such as ones that are too long, or that contain illegal characters).

&#x5B;code link&#x5D;

needs some explanation: for "internal" articles, it should return the "page_id" field if the article exists, else it returns 0. For all external articles it returns 0. All of the IDs for all instances of Title created during a request are cached, so they can be looked up quickly while rendering wikitext with lots of internal links.

Exemple
To check and see if a given page already exists: Create a new Title from text, such as what one would find in a link. Decodes any HTML entities in the text. Spaces, prefixes, and an initial ':' indicating the main namespace are accepted. Note that if the page does not exist, this will not create it. For that, see Manual:Article.php.

Functions
Many of these functions are used by Manual:CoreParserFunctions.php to generate magic words.

getArticleID
Get the article ID for this Title from the link cache, adding it if necessary

getBaseText
Get the base page name, i.e. the leftmost part excluding namespace and before any slashes, without converting spaces to underscores. See magic words and.

getText
Gets the text form (spaces not underscores) of the main part, i.e. the title excluding namespace, but including slashes and everything after. See magic word.

getDBKey
Get the main part (i.e. the title excluding namespace) with underscores.

getPrefixedDBKey
Get the prefixed database key form with underscores.

getFragment
Get the Title fragment (i.e. the bit after the #) in text form.

getFullText
Get the prefixed title with spaces, plus any fragment (part beginning with '#').

getPartialURL
Get the URL-encoded form of the main part. See magic word.

getFullURL
Get a real URL referring to this title, with interwiki link and fragment.

getLocalURL
Get a URL with no fragment or server name.

getPrefixedText
Get the prefixed title with spaces. This is the form usually used for display. See magic word.

getPrefixedUrl
Get a URL-encoded title (not an actual URL) including interwiki. See magic word.

getSubjectNsText
Get the namespace text of the subject (rather than talk) page. See magic words and.

getSubjectPage
Get a title object associated with the subject page of this talk page. See magic word.

getSubpageText
Get the lowest-level subpage name, i.e. the rightmost part after any slashes. See magic word.

getSubpageUrlForm
Get a URL-encoded form of the subpage text. See magic word.

getTalkNsText
Get the namespace text of the talk page. See magic word and.

getTalkPage
Get a Title object associated with the talk page of this article. See and.

getNamespace
Get the namespace index. See.