Manual:Title.php/tr

MediaWiki yazılımının  sınıfı  ve IDBAccessObject arayüzlerini uygular. Aşağıdakiler dahil olmak üzere birçok amaç için kullanılan makale başlığını temsil eder:


 * maddenin okunabilir metin başlığı olarak
 * maddeye erişmek için kullanılan URL'de
 * maddeye vikimetin bağlantısı
 * madde veritabanının anahtarı

Sınıf, bu biçimlerden biriyle başlatılır. Bir kez başlatıldığında, başlık başka biçimlerde alınabilir veya öznitelikleri için sorgulanabilir. değerinin değişmez bir "value" sınıfı olması amaçlanmıştır, bu nedenle herhangi bir mutasyon işlevi yoktur.

örneğini oluşturmak için statik fabrika yöntemlerinden birini çağırın:


 * - Bu istediğiniz işlev değil. Title::newFromText kullanın.
 * - bir dizi Başlık döndürür
 * - Bir ad alanı dizininden ve bir DB anahtarından yeni bir Başlık oluşturun. Hata durumunda null değerini döndürür.
 * - Bu istediğiniz işlev değil. Title::newFromText kullanın.
 * - bir dizi Başlık döndürür
 * - Bir ad alanı dizininden ve bir DB anahtarından yeni bir Başlık oluşturun. Hata durumunda null değerini döndürür.
 * - Bir ad alanı dizininden ve bir DB anahtarından yeni bir Başlık oluşturun. Hata durumunda null değerini döndürür.

Bir kez başlatıldığında,,  ,   vb. gibi statik olmayan diğer erişimci yöntemleri kullanılabilir.

Bir Title nesneniz varsa, aşağıdakileri alabilirsiniz:


 * kullanarak nesne
 * kullanarak nesne

Bu sınıf, veritabanından çeşitli veri türlerini alabilir; ancak bunu verimsiz yapar. Bunun yerine nesnesi kullanmayı düşünün. TitleValue daha hafiftir ve küresel duruma veya veritabanına bağlı değildir.

Başlık yapısı
Başlık, isteğe bağlı bir Vikiarası önekinden (mediawiki.org'dan sayfalar için "$ 1" veya Vikipedi maddeler için " ") ve ardından isteğe bağlı bir ad alanından oluşur (" " gibi) ve ardından sayfa adı.

Vikiarası önekleri ve ad alanları
Vikiarası önekleri ve ad alanları aynı içerik kurallarına uyar:


 * bir harfle başlamalılar
 * iki nokta üst üste ile bitmeliler
 * yalnızca rakamlar, harfler, boşluk karakteri ve alt çizgi karakteri içerebilirler
 * boşluklar ve alt çizgiler değiştirilebilir olarak kullanılabilir
 * büyük/küçük harfe duyarlı değiller

Vikiarası önekleri ve ad alanları yalnızca, varsayılan olarak veya yapılandırma yoluyla belirli bir MediaWiki yüklemesi tarafından biliniyorsa tanınır.

Örneğin: Bu vikide " ", Vikipedi'deki " " maddesine bir bağlantıdır, çünkü " " izin verilen vikiarası öneklerinden biri olarak tanınır. " " başlığı şu anki vikinin " " ad alanındaki madde "adı" na bir bağlantıdır, çünkü " " tanınan bir ad alanıdır. Her ikisi de mevcut olabilir ve eğer öyleyse, vikiarası önce gelmelidir, örneğin, "$ itk3".

Bir başlık, ilk karakteri iki nokta üst üste ile başlıyorsa, hiçbir önek taranmaz ve başlık işlenmeden önce iki nokta üst üste kaldırılır. Bu kural nedeniyle isimlerinde iki nokta üst üste bulunan yazıların bulunması mümkündür. "$ alid", "Komandolar: Düşman Satırlarının Arkasında" olduğu gibi geçerli bir başlıktır, çünkü " " ve " " geçerli vikiaraları veya ad alanları değildir.

Madde adı
Madde adında boşluklar ve alt çizgiler eşdeğer kabul edilir ve uygun bağlamda her biri diğerine dönüştürülür (URL ve veritabanı anahtarlarında alt çizgi, düz metinde boşluklar). 0x80..0xFF aralığındaki "genişletilmiş" karakterlere her yerde izin verilir ve bunlar geçerli karakterlerdir. URL'lerde kodlanmıştır. Genişletilmiş karakterler, metin veya veritabanı anahtarları olarak kullanıldığında urlencoded değildir. Diğer karakterler ASCII harfleri, rakamları, tire, virgül, nokta, kesme işareti, parantez ve iki nokta üst üste olabilir. Başka hiçbir ASCII karakterine izin verilmez ve bulunursa silinir (muhtemelen bir tarayıcının URL'yi yanlış yorumlamasına neden olurlar).

Kanonik formlar
Bir başlığın kanonik biçimi her zaman nesne tarafından döndürülür. Kanonikleştirme aşağıdakileri içerir:


 * Bazı Unicode yönlü karakterler (soldan sağa işareti vb.) çıkarılır, çünkü bu genellikle hatalı kopyala ve yapıştır işleminden kaynaklanır.
 * Bölüm bağlantıları için kullanıldığı için  üzerinden sonraki her şey çıkarılır.
 * Alt çizgi dizileri ve/veya belirli boşluk karakterleri, tek bir alt çizgi (URL ve DBkey formları için) veya tek bir boşluk (metin formu için) halinde daraltılır. Başlığın (veya ad alanının veya vikiarası önekinin) başında veya sonunda, bunlar çıkarılır.
 * Tanınan vikiarası önekleri standartlaştırılmıştır, yani tamamen küçük harfle yazılmıştır.
 * Tanınan ad alanı adları standartlaştırılmıştır, yani ilk karakter büyük harfle yazılır ve sonraki karakterler küçük harfle yazılır. (Ancak bu, vikiarası bağlantıları için yapılmaz.)
 * Vikiye ve ad alanına bağlı olarak, bir başlığın ilk karakteri büyük harfle yazılabilir. (Ancak bu, vikiarası bağlantıları için yapılmaz.)
 * Anonim kullanıcıların kullanıcı sayfalarına bağlantılar için IP adresi standartlaştırılmıştır.
 * Kanonikleştirme süreci, çeşitli türden geçersiz başlıkları (çok uzun olanlar veya geçersiz karakterler içerenler gibi) reddetmek için bazı doğrulama mantığı da içerir.

MediaWikiTitleCodec Sınıfı için Diyagramlar
A codec for MediaWiki page titles: &#x5B;code link&#x5D;

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 to generate magic words.

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

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.

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.