Manual:Title.php/pt-br

A classe  representa títulos de artigos, que são utilizados para diversos fins, incluindo:
 * como o título do texto legível do artigo
 * na URL usada para acessar o artigo
 * o link wikitexto para o artigo
 * a chave na base de dados do artigo

A classe é instanciada com um desses formatos. Uma vez instanciado, o título pode ser recuperado em outros formatos ou consultado por seus atributos. é pretendido que seja uma classe imutável "value", para que não haja funções modificadoras.

Para instanciar, chame um dos métodos estáticos de fatoração:
 * ("Esta não é a função desejada! Use Title::newFromText.")
 * (returns an array of Titles)
 * ("Esta não é a função desejada! Use Title::newFromText.")
 * (returns an array of Titles)
 * (returns an array of Titles)

Uma vez instanciado, os outros métodos de acesso não-estáticos podem ser utilizados, tais como,  ,  , etc.

Se você tem um objeto Title, você pode obter:
 * um objeto Article, usando
 * um objeto WikiPage, usando

Estrutura de título
Um título é composto por um prefixo opcional Interwiki (como "m:" para páginas do mediawiki.org ou ":pt:" para artigos da Wikipédia), seguido por um namespace opcional (como "Manual:"), finalmente seguido pelo nome do atrigo.

Prefixos interwiki e namespaces
Prefixos interwiki e namespaces seguem as mesmas regras de conteúdo:
 * eles devem começar com uma letra
 * eles devem terminar com dois pontos
 * eles só podem conter dígitos, letras, o caractere de espaço e o caractere sublinhado
 * espaços e sublinhados podem ser usados ​​indistintamente
 * eles não são case-sensitive

Prefixos interwiki e namespaces são reconhecidos somente se eles forem conhecidos por uma determinada instalação do MediaWiki, por padrão ou através de configuração.

Por exemplo: Neste wiki, ":pt:Name" é um link para o artigo "Name" na Wikipédia, pois "pt" é reconhecido como um dos prefixos interwiki permitidos. O título "talk:Name" é um link para o artigo "name" no namespace "talk" do wiki atual, pois "talk</tt>" é um namespace reconhecido. Ambos podem estar presentes, e em caso afirmativo, o interwiki deve vir em primeiro lugar, por exemplo, ":pt:talk:name</tt>".

Se um título começa com dois pontos, como seu primeiro caractere, nenhum prefixo é verificado, e os dois pontos são removidos antes do título ser processado. Devido a essa regra, é possível ter artigos com dois pontos em seus nomes. "E. Coli 0157:H7</tt>" é um título válido, assim como é "Commandos: Behind Enemy Lines", pois "E. Coli 0157</tt>" e "Commandos</tt>" não são interwikis ou namespaces válidos.

Nome do artigo
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. In this form, the first (and only the first) character of the namespace and title will be uppercase; the rest of the namespace will be lowercase, while the rest of the title will be left as is.

The text form will use spaces, the URL and DBkey forms will use underscores. Interwiki prefixes are all lowercase. The namespace will use underscores when returned alone; it will use spaces only when attached to the text title.

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.

Example
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.

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.