Extension:Labeled Section Transclusion/ja

Labeled Section Transclusion（ラベル付き段落の参照読み込み）拡張機能は、通常のようにウィキテキストを構文解析して、マークされた節の選択的な参照読み込みを可能にします. その機能は、通常の参照読み込みを持つ タグの拡張バージョンと似ています. これは、包含する節を選択します. これはウィキメディアのすべてのウィキで有効になっています.

標準の参照読み込みが基本的には小規模なテンプレートの大きなまとまりを扱うのに対し、ラベル付き節の山椒読み込みは大きなページの小さなまとまりを意図しています.

ただし、多少の相違点があります. ネイティブなテンプレートの参照読み込みでは節を挙動ごとにマークします. そのおかげで利用者は対象にするかしないか、(おそらく隣接しない) セクションひとつに絞り込むことができます.

さて、節の名前でマークし、呼び出し子で挙動を選択すると、必要に応じて節を対象に含めたり外したりできます. 異なるページごとに選択した節を対象に含めたり除外したりできます. 節の数は任意で、また任意に重複が認められます.

節に挙動ではなく名前でマークする場合、長い文を対象にした抽出が節リンクの編集の表示を寄り的確に行います. このとき拡張機能は現在ページの冒頭で対象外とするべき節を考慮に入れることができ、参照読み込みする節を適切にオフセットできるようにします.

ステップ 1: 節へのタグ付け
以下のように  タグを使用して節にタグ付けします:

&lt;translate>this is a chapter&lt;/translate>

これらのタグはHTML/XMLではなく、通常の属性構文を使用しないことに注意してください. このため、begin と end のマーカーは XML の通常の開く/閉じるタグではなく、個別であるため、節の入れ子やオーバーラップが許可されます. これにより、他の節との干渉を気にすることなく、section タグを挿入できるようになります.

ステップ 2a: 節の参照読み込み
Call the parser function #lst to transclude it, i.e. to transclude a section called chapter1 from a page called articleX:

The target article defines the location of the section; its behavior is determined by the parser function.

ステップ 2b: ページは参照読み込みし節は除外する
To transclude a page, but exclude a specified section, use the #lstx function:

Optionally, you may add replacement text to the excluded section.

例:

The replacement text will appear in the area where the section is skipped (excluded).

不連続な節
同一名の複数の節は共存できます. この事例では、同一名の節はどれも対象にしたり除外したりできます. さまざまな議論をマークするとき、特に有効です.

節の範囲
These functions have an additional, optional argument to specify a section range; i.e., to include everything from the beginning of chapter 1 to the end of chapter 3. This allows using empty marker pairs to mark one end of the section, possibly in a template. A similar mechanism is currently used at the French Wikisource.

subst展開
This also works with substitution; it's even possible for an article to substitute a section of itself. One use of this provides a neat way to archive talk pages: Mark the text to be archived using, etc. Then create an archive page with the text, using archive , which copies archived sections. Lastly, replace the contents of talk_page with archive to remove those sections.

見出し単位で節を参照読み込みする
このオプションは、標準的な見出し、たとえば でマークした文の節の参照読み込みをサポートします. インストールすると、lsth 関数で実施します.

導入部の参照読み込み
To transclude the introduction of a page (i.e. the content before the first heading), use

特定の節の参照読み込み
You can also transclude the whole content of the sectionX (which includes all its sub-sections but excludes the heading of sectionX itself).

注意点：

例：単なるpagenameではなくpagename/enを対象にする.
 * 1) 同一名の節が複数ある場合、最初に出現するsectionXに限定して参照読み込みされる.
 * 2) sectionXの見出し名は表示される文字列ではなく、必ず in wiki code の書式で入力. たとえば節見出しが の場合、入力する文字列は「 」が正しく「 」は間違い.
 * 1) 翻訳拡張機能を使って翻訳対象のマークを付けたページから、節を参照読み込みする場合、言語特定版から参照読み込みすること.
 * 1) 対応付けはリンクが大文字と小文字の変更によってリンクが崩れるのを防ぐため. 大文字小文字を区別しない.

複数の節の参照読み込み
最初のsectionXの出現 (sectionX自体の見出しを除外) から次に出現するsectionYまでの間を除外することもできます. sectionYは停止点として機能し、sectionYの内容は参照読み込みの対象外です.

スキップした見出しについての注記
MediaWikiにおける従来の参照読み込みは節を対象にしていないため、連続しない見出しは対象外です. その結果、複数の見出しを含むテンプレートを参照読み込みする場合、冒頭の見出しを対象から除外すると節編集リンクはすべて、テンプレート内の誤った箇所に対応付けされます.

この拡張機能の利用 (MediaWiki 1.9以降の場合)、#lst関数と#lsth関数は「除外した」冒頭部の見出しも数えて見出しの対応付けを的確に実行します. 複雑ではない事例では、節が正しく対応付けされます.

注意点として、#lstxは除外した見出しを対象にしない上、不連続な節内の除外された見出しはオフセットしません. '''ただ現状では解消されたように (おそらくMediaWiki の新しい前処理機能にポートされた場合も) 表示されます. 参照読み込みされた見出しは正しい節を対応付け可能'''.

地域化
内部的には、パーサー関数は拡張子の名前との一貫性を保つため、すべてlst接頭子を使用します. この接頭子は開発者以外を混乱させる可能性があるため、読みやすい英語の変数名が導入され、現在、関数はどちらの名前からも呼び出し可能です.

さらに、タグはこの時点でローカライズ可能になりました (現状では英語、ドイツ語、ヘブライ語). 例をあげます.


 *  ... 
 * (RTL): <קטע התחלה=א> ... <קטע סוף=א> (「開始」コードが右、「終了」コードが左です)
 *  ...
 *  ...

制限

 * 複数の名前空間でこの拡張機能を利用できますが、ウィキ間参照は未解決です. 今も、たとえばウィキソースの部分をリモートのMediaWikiインストールに含めることは不可能です.
 * 節タグそのものを他のページで動作させるために参照読み込みさせることはできません.  and  は、節タグが参照読み込み先のページそのもののウィキテキストに存在する場合のみ有効です. 言い換えるなら、たとえば、テンプレートのパラメータやパーサ関数を利用して節タグをテンプレートに埋め込むことはできません.  マジックワードは節タグとは同時に使えません.  により、節タグが使用するタグが1件でも、バランスのよいタグやバランスのよいタグをが生成します. 詳細はを参照してください.
 * 2014年現在、節タグはテンプレーとのパラメータ内で使われると効果がありませんでした. ページ A に というテキストがある場合、  がXにアクセスすることは不可能です.

インストール
さまざまなウィキソースにガジェットがあり、簡略化した 構文で節を特定できます. コードはWikisource:MediaWiki:Gadget-Easy_LST.jsで入手できます.

例

 * wikisource:user:sanbeg/Includerとは基本機能のいくつかを示す初期のデモンストレーション版です.

関連ページ

 * DynamicPageList (サードパーティ製)にはラベル付き節参照読み込みをわずかに改変したビルトイン版が含まれる