Extension:Labeled Section Transclusion/zh

标记部分转换扩展允许选择性transclusion标记文本部分，解析wikitext正常. 它的功能类似于带有正常wiki转换的 标记的增强版本，它选择包含的部分. 它在所有维基媒体wiki上启用.

虽然正常转换主要用于转换大部分小模板，但标记的部分转换适用于大页面的一小部分.

但是，存在一些差异. 在本机模板转换中，部分由行为标记，因此，您只能包含或跳过一个（可能是非连续的）部分.

这里，部分由名称标记，并且调用者选择行为，可以根据需要包括或跳过部分. 不同的页面可以包括或排除选定的部分，可以有任意数量的部分，也可以任意重叠.

通过名称而不是行为标记部分允许编辑部分链接更适合于从较大文本中获取摘录，因为扩展现在可以考虑在页面开头跳过的部分，从而允许适当地偏移包含的部分.

第1步：标记部分
使用 标签标记文本中的部分，如下所示：

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

请注意，这些标记不是HTML/XML，并且不使用普通属性语法. 出于这个原因，并且因为begin和end标记是单独的，而不是普通的XML打开/关闭标记，这允许嵌套或重叠的部分. 这允许您插入节标记而不必担心干扰其他节.

步骤2a：转换部分
调用解析器函数#lst来转换它，即从名为articleX的页面转换一个名为chapter1的部分：

目标文章定义了该部分的位置，它的行为由解析器函数决定.

步骤2b：转换页面但不包括部分
要转换页面，但排除指定的部分，请使用#lstx函数：

（可选）您可以将替换文本添加到排除部分.

例如：

替换文本将出现在跳过该部分的区域（排除）.

不连续的部分
可以有多个具有相同名称的部分，在这种情况下，将包含/排除具有该名称的每个部分. 这对标记各种讨论特别有用.

区间范围
这些函数有一个额外的可选参数来指定一个节范围，即 ，包括从第1章开头到第3章结尾的所有内容. 这允许使用空标记对来标记该部分的一端 ，可能在模板中. 目前法语维基文库使用了类似的机制.

替代
这也适用于替代，甚至可以用一篇文章替换它自己的一部分. 这样做的一个用途是提供一种简洁的方式来存档讨论页：使用 等标记要存档的文本，然后使用 archive 创建一个包含文本的存档页面，该页面复制存档的部分. 最后用 archive 替换讨论页的内容以删除这些部分.

按标题转换部分
可选支持转换标有正常标题的文本部分，即. 如果已安装，则使用lsth功能完成.

转发介绍
要转换页面的引入（即第一个标题之前的内容），请使用

转换特定部分
您还可以转换sectionX的整个内容（包括其所有子节，但不包括sectionX本身的标题）.

注意以下几点：


 * 1) 如果您有多个具有相同名称的部分，则仅转换sectionX的第一个匹配项.
 * 2) 确保键入sectionX的标题是 in wiki code 而不是它的显示方式. 例如，如果该部分的标题是 ，则应键入“ ”而不是“ ”.
 * 3) The matching is case insensitive, to prevent links from breaking due to case changes.

Transclude multiple sections
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.

Notes about skipped headings
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.

Additionally, the tag can now be localised (currently English, German, and Hebrew), i.e.:


 *  ... 
 * (RTL): <קטע התחלה=א> ... <קטע סוף=א> ("start" code to the right and "end" code to the left)
 *  ...
 *  ...

限制

 * While it is possible to use this extension across namespaces, interwiki references are not resolved. It is not yet possible, for example, to include part of a Wikisource page into a remote MediaWiki installation.
 * Section tags cannot themselves be transcluded in order to work on other pages.  and   work only if section tags appear directly in the wikitext of the transcluded page. This means, for instance, that these tags cannot be embedded in a template using template parameters and parser functions. The   magic word does not work with section tags.   produces balanced tags, while the section tags uses singular tags. See.
 * As of 2014, section tags don't have any effect when used inside a template parameter. If page A contains a text, there's no way  can access X.

安装
There is also a Gadget in use on various Wikisources that makes it possible to define sections with a simplified  syntax. Its code can be found at Wikisource:MediaWiki:Gadget-Easy_LST.js.

例子

 * wikisource:user:sanbeg/Includer is an early demonstration that shows several of the basic features.

另见

 * DynamicPageList (third-party) includes a slightly modified built-in version of Labeled Section Transclusion