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

注意点：


 * 1) 同一名の節が複数ある場合、最初に出現するsectionXに限定して参照読み込みされる.
 * 2) Make sure you type what the heading of sectionX is in wiki code, not how it is displayed. For example if the heading of the section is  , you should type " " not " ".
 * 3) When transcluding a section from a page marked for translation using the translate extension, translude from the language-specific version. E.g. from pagename/en rather than from pagename.
 * 4) The matching is case insensitive, to prevent links from breaking due to case changes.

複数の節の参照読み込み
You can also transclude from the first occurrence of sectionX (excluding the heading of sectionX itself) until it reaches the next occurrence of sectionY. Note that sectionY acts as a stop point so the transclusion doesn't contain the content of sectionY.

スキップした見出しについての注記
Since the traditional transclusion in MediaWiki isn't intended to transclude sections, it doesn't account for skipped headings. As a result, if you were to transclude a template with multiple headings, and skip the first heading, then all of the edit sections links would point to the wrong section in the template.

When this extension is used (with MediaWiki 1.9 or later), the #lst and #lsth functions count headings in the "skipped" beginning part, and offset transcluded headings appropriately. This will allow these links to point to the correct section in the simple case.

Note that #lstx does not count skipped headings, and that skipped headings within discontiguous sections are not offset. '''But it seems it has been fixed now (likely when ported to MediaWiki's new preprocessor). The transcluded headings can be linked to the correct sections'''.

地域化
Internally, the parser functions all use the lst prefix, for consistency with the name of the extension. Since this acronym may be confusing to non-developers, readable English variants have been introduced, so the functions can currently be called from either name.

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


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

制限

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

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

例

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

関連ページ

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