Manual:Title.php/ja

MediaWiki ソフトウェアの  クラスは 記事タイトル を表し、様々な目的で使用されます. 例えば:
 * 人間に読めるテキスト形式の記事タイトルとして
 * 記事にアクセスするための URL 中で
 * 記事への Wikitext リンク
 * 記事データベースへのキー

このクラスでは、これらのいずれかの書式のインスタンスが生成されます. インスタンスが生成されると、タイトルを属性に応じて他の書式またはクエリとして取得できます. は、不変 "値" クラスとして設計されているため、ミューテータ関数は存在しません.

のインスタンスを生成するには、以下のいずれかの静的ファクトリメソッドを呼び出します:

インスタンスが生成されると、他の非静的アクセサメソッドが使用可能になります. 例えば、 、 、 等です.

タイトルの構成
タイトルは、省略可能な インターウィキ 接頭子 （例えば、mediawiki.org ページを指す "m:" や、ウィキペディア 記事を指す "w:"）、省略可能な名前空間 （例えば "Manual:"）、記事名、の順序で構成されます.

インターウィキ接頭子と名前空間
インターウィキ接頭子と名前空間は、どちらも同じ記述規則に従います:
 * 先頭は文字であること
 * 末尾はコロンであること
 * 数字、文字、空白、アンダースコアのみ使用可能
 * 空白とアンダースコアは区別されない
 * 大小文字は区別されない

インターウィキ接頭子および名前空間は、既定値もしくは設定値として MediaWiki システムに対して指定されたもののみ認識されます.

例: 本 Wiki では、"w:Name" はウィキペディアの記事 "Name" へのリンクとなります. これは、"w" がインターウィキ接頭子として認識されるためです. タイトル "talk:Name" は、現在の Wiki の "talk" 名前空間にある記事 "Name" へのリンクとなります. これは、"talk</tt>" が名前空間として認識されるためです. インターウィキ接頭子と名前空間の両方を記述することも可能で、その場合はインターウィキ接頭子を先に記述します （例: "w:talk:name</tt>"）.

タイトルの先頭文字がコロンで始まる場合は、接頭子はスキャンされず、コロンもタイトルが処理される前に取り除かれます. この規則により、名前にコロンを含む記事を記述することが可能になります. "大腸菌 O127:H7</tt>" や "2001: A Space Odyssey" 等のタイトルは、そのままでも有効です. これは、"大腸菌 O157</tt>" および "2001</tt>" は、有効なインターウィキ接頭子または名前空間ではないためです.

記事名
キャラクタマッピングルール: 一旦接頭辞がストリップされると、タイトルの残りは次の方法で処理されます: スペースとアンダースコアは同等なものとして取り扱われそれぞれは適切なコンテキストで別なものに変換されます(URLとデータベースキーでアンダースコア、平文でスペース). 0x80..0xFFの範囲で"拡張された"キャラクタはすべての場所で許可され、有効な文字列です. それらはURLでエンコードされます. 別のキャラクタはASCII文字、数字、ハイフン、コンマ、ピリオド、アポストロフィ、丸括弧、とコロンです. 別のASCIIキャラクタではないものは許可されず、見つかると削除されます(それらによっておそらくブラウザがURLを誤解する原因になります). 拡張されたキャラクタはテキストもしくはデータベースとして使われるときにurlencode'''されません. '''

正統なフォーム: タイトルの正統なフォームは常にオブジェクトによって返されます. このフォームにおいて、最初の名前空間とタイトルの最初の(そして唯一の最初の)キャラクタは大文字です; 名前空間の残りの部分は小文字の一方で、タイトルはそのままです. テキストフォームはスペースを使い、URLとDBキーフォームはアンダースコアを使います. インターウィキの接頭辞はすべて小文字です. 名前空間は単独で返されるときはアンダースコアを使います; それはテキストのタイトルに付属するときのみにスペースを使います.

はいくつか説明が必要です: "内部の(internal)"記事のために、記事が存在する場合、それは"cur_id"を返し、そうでなければ0を返します. すべての外部記事のためには、それは0を返します. リクエストの間に作成されるTitleのすべてのインスタンスのためにIDのすべてはキャッシュされるので、多くの内部リンクを持つwikitextをレンダーする間にそれらを素早く調べることが出来ます.