cdc是什么| 背部长痘痘是什么原因造成| 三问表是什么意思| 放疗后不能吃什么| 老九门2什么时候上映| 鸡粉是什么| 成人受到惊吓吃什么药| 1962属什么| ppm是什么单位| 水险痣是什么意思| 一拃是什么意思| 晚上睡觉腿抽筋是什么原因| 吃了阿莫西林不能吃什么| 胎盘成熟度1级是什么意思| 情绪是什么| 做梦梦见大火是什么意思| 五六月份是什么星座| 2月22日什么星座| 胸腔里面像岔气了的疼是什么原因| 脚趾缝痒用什么药| 胡萝卜什么时候种植| 消化不良反酸吃什么药| 奉天为什么改名沈阳| 灌肠什么意思| 老年人屁多是什么原因| 静脉曲张挂号挂什么科| 来月经小腹痛是什么原因| 铁棍山药和普通山药有什么区别| 倒班什么意思| 胃肠炎可以吃什么水果| 经常出汗是什么原因| 产后吃什么对身体恢复好| 贫血的人来姨妈会有什么症状| 安徽有什么土特产| 皮肤过敏用什么药| 忻字五行属什么| 碧字五行属什么| 喉结下面是什么部位| 枭念什么| 竟然是什么意思| 拾荒者是什么意思| 眼帘是什么意思| 夏天可以种什么花| 肝火旺吃什么药| 什么时候取环最合适| 腔梗灶是什么意思| 梦见偷菜是什么意思| 阿司匹林肠溶片什么时间吃最好| 龙须菜是什么植物| 为什么手机打不出去电话| nt是什么币| 什么东西清肺最好| 十面埋伏是什么生肖| 查贫血挂什么科| ul是什么单位| 什么是强势的女人| 天行健的下一句是什么| 于心不忍是什么意思| 青海有什么特产| 切除扁桃体有什么好处和坏处| 红斑狼疮吃什么药| 糖尿病吃什么食物最好| 误食干燥剂有什么危害| ein是什么牌子| 胃疼是什么症状| 木芙蓉什么时候开花| 1997年属牛的是什么命| 狗狗吐黄水是什么原因| 腰椎管狭窄吃什么药| 痰多吃什么化痰| 上升水瓶座为什么可怕| 内推是什么意思| 12年义务教育什么时候实行| 双星座是什么意思| 喝什么茶能降血压| 肾上腺素是什么| 1919年属什么生肖| 什么是磁场| 什么样的柳条| 9月26号是什么星座| 释然什么意思| 血液循环不好吃什么药| 水银是什么| 印堂跳动是什么预兆| 孕晚期高血压对胎儿有什么影响| 一本线是什么意思| 脾胃寒湿吃什么中成药| 乳腺病是什么意思| 5岁属什么| 维生素a是什么| 阴虚吃什么食物补得快| 大排畸什么时候做| 橘白猫是什么品种| 为什么哭会流鼻涕| 空调抽湿是什么意思| 晟这个字念什么| 不爱喝水是什么原因| 盖是什么意思| 阴茎出血是什么原因| zm是什么意思| 什么水果可以减肥刮油脂| 大嘴猴属于什么档次| 带资进组什么意思| 包二奶是什么意思| 掉头发吃什么好| 入幕之宾是什么意思| 什么不可当| 什么情况下喝补液盐| 麻辣拌里面都有什么菜| 中元节是什么| 贝的偏旁有什么字| hc2是什么检查| 沙和尚是什么动物变的| 清明节与什么生肖有关| 舌头发黄是什么问题| 赵子龙属什么生肖| 嘴唇上长痘是什么原因| 寒湿重吃什么药| 维生素什么牌子好| 尿液特别黄是什么原因引起的| 葡萄籽有什么功效| 6月16是什么星座| 酵母提取物是什么| 哈喽是什么意思| 了凡四训讲的是什么| 眼睛发黑是什么原因引起的| 发烧适合吃什么食物| 芒果过敏吃什么药| 排档是什么意思| 卵巢多囊是什么意思| 前任是什么意思| 地包天什么意思| 他汀是什么药| 米粉用什么做的| 雪碧喝多了有什么害处| 君子兰用什么土最好| 结石吃什么药| 肚兜是什么| 喉咙痛有什么好办法| 停月经有什么症状| 没落是什么意思| 空调买什么品牌的好| 血脂血糖高吃什么食物好| 林冲到底属什么生肖的| 港澳通行证办理需要什么材料| 晒伤用什么药| 为什么会突然长痣| 诬赖是什么意思| 脚旁边骨头突出叫什么| 翔是什么意思| 硬度不够是什么原因| 市公安局局长是什么级别| 用一什么就什么造句| 慢性阑尾炎挂什么科| 鸡婆什么意思| 李子什么时候成熟| 女人更年期是什么症状| 什么的烤鸭| 肌肉拉伤有什么症状| 7月1日是什么星座| 药剂师是干什么的| 真棒是什么意思| 手麻挂什么科室| 水分是什么意思| 肺部微结节是什么意思| 中医是什么| 旗人是什么意思| 820是什么意思| 海带属于什么植物| 白带像豆腐渣用什么药| exr是什么牌子| 月经来的少是什么原因| 燃烧卡路里是什么意思| 除了胃镜还有什么检查胃的方法吗| 我们为什么会笑| 银装素裹是什么意思| 欣字取名什么寓意| 喷砂是什么意思| 腹水是什么| 梦见两只狗是什么征兆| 身体潮湿是什么原因| 火乐念什么| 木加鬼念什么| 宽宽的什么填空| 什么时间泡脚最好| 国家电网需要什么专业| 正科级是什么级别| 脚背痛什么原因| 梦到分手了是什么征兆| 西米是什么字| 双响炮是什么| ca199偏高是什么原因| 犀利哥什么意思| 4.11是什么星座| 七月份怀孕预产期是什么时候| 唐三彩是什么意思| pisen是什么牌子| 什么头什么颈| 眼底出血是什么原因引起的| 今年26岁属什么生肖| 黔鱼是什么鱼| N1是什么| 雌激素分泌过多是什么原因引起的| robam是什么牌子| 参天大树什么意思| 红楼梦大结局是什么| 可逆是什么意思| 山及念什么| 非常的近义词是什么| 唐伯虎属什么生肖| 04年属猴的是什么命| s标志的运动鞋是什么牌子| ac疫苗是预防什么的| 进击的巨人真相是什么| 一库是什么意思| 五级职员是什么级别| 四条杠是什么牌子衣服| 双克是什么药| 为什么会长闭口| 肺炎吃什么药最有效| 男孩子送什么礼物| 冤家路窄是什么生肖| 查乙肝挂什么科| 着床成功后有什么症状或感觉| 前白蛋白是什么意思| 牡丹花像什么| sanag是什么牌子| 马赛克是什么意思啊| 宫颈醋酸白色上皮是什么病变| 夏天适合种什么植物| 肠道ct能检查什么| 芒果不能和什么一起吃| 倭瓜是什么瓜| 吃什么补维生素b6| 每天流鼻血是什么原因| 口加才是什么字| 戒定真香是什么意思| 残疾证有什么用| 冲牛煞西是什么意思| 拉肚子喝什么饮料| 吃什么可以排出霉菌| 尿检隐血弱阳性是什么意思| 月经推迟十天是什么原因| 肝火旺吃什么降火最快| 掌心有痣代表什么| 用淘米水洗脸有什么好处| 铎读什么| 牙龈长泡是什么原因| 喝酒吃海带有什么危害| 猫鼻支是什么症状| fierce是什么意思| 1109是什么星座| 雍正叫什么| 老年人爱出汗是什么原因| 请问今晚买什么生肖| 喉炎吃什么药| 螨虫长什么样| 江字五行属什么| 葛粉吃了有什么好处| 梦见玫瑰花是什么预兆| 粗枝大叶是什么意思| die是什么意思| 肚脐眼臭是什么原因| borel手表是什么牌子| 百度Jump to content

Page semi-protected
From Wikipedia, the free encyclopedia
(Redirected from Wikipedia:Transclusion)
百度 那时确实征公粮太多。

Transclusion refers to the inclusion of the content from one document within another document by reference. In Wikipedia, transclusion means the MediaWiki software retrieving the content from a source page, often a template, and incorporating it into the content of a target page.

Similar to creating a wikilink using double square brackets ([[Pagename]]), a page can be transcluded as a template by enclosing its title in double curly braces or double curly brackets: {{Namespace:Pagename}}. Any changes made to the source page, or template, are automatically reflected on all pages that include the transcluded content.[a]

If no namespace is specified, it is assumed to be in the Template namespace. To refer to a page in the Main article namespace, it is necessary to prefix it with a colon (:). For example:

Transclusion and what content it includes or excludes can be modified by using the invisible wikitext tags <noinclude>, <onlyinclude>, <includeonly>, and <section> on the source page, as further outlined in § Transclusion markup.[b] The first three tags enable § Partial transclusion, as opposed to the default behavior of double curly braces, which will transclude the entire source page's content. For § Selective transclusion, the <includeonly> or <section> tags can be used and sections of the source page named, then using parser functions the template can be called with the section name as a parameter: {{#section:Pagename|Sectionname}}.

Transclusion events occur each time the target page is loaded and the template is rendered. A related event is Substitution, where a template call is replaced with its transcluded source content at the time it is invoked in a one-time inclusion of the content. Unlike transclusion, which continuously updates the target page with changes from the source, substitution results in a one-time inclusion of the content, meaning that subsequent updates to the source content will not be reflected in the target page. For example, a template call for {{Pagename}} with the subst: prefix results in the substitution template call {{subst:Pagename}}. When invoked, this template is replaced, also referred to as substituted, with the actual wikitext of the source page at the time of the call, thereby making it a permanent part of the target page.[c]

It is possible to transclude content from Wikidata into Wikipedia articles or other wikis.

How transclusion works

To transclude content from a source page within a single MediaWiki project (such as English Wikipedia) onto a target page, use {{SOURCEPAGE}} in the target page's code.

Whenever {{SOURCEPAGE}} is included on a target page, the WikiMedia software retrieves and embedes the entire content of SOURCEPAGE (i.e., Template:SOURCEPAGE) at that location on the target page.

Example

Consider an example, complemented by the illustration below, with target pages A, P, and Q, and source page B.

If source page B is transcluded into A, the content from B (for instance, the word "foo") will appear in place of the {{B}} code in page A. When transcluded, this content is not highlighted or boxed on the target page – it is integrated directly into the page's text (highlighted here only for illustration).

How it works

Transclusion creates a 'live' link between a source page and all target pages where its content is transcluded to and used. Editing the source page automatically updates its content on all target pages that include it.

For example, if you create a source page with details about a Wikimedia event and transclude it onto the talk pages of 50 editors you wish to invite, any updates you make to the source page (such as changing the event location) will immediately reflect on all 50 talk pages.

Edit source pages with caution

Edits to a source page can impact all target pages using it. If a source page also contains its own transclusions from other source pages, avoid changes that may break these links, as this would affect the source page you are editing and all target pages that transclude it. This is known as 'breakage', and it is best to ensure any updates maintain the integrity of transcluded content across all pages. For example, Main Page is a large page that transcludes its content from multiple embed source pages such as Wikipedia:Today's featured list.

Transclusion syntax

The general syntax for transclusion on Wikipedia follows the format {{Namespace:Pagename}}, where Namespace:Pagename specifies the title of a Wikipedia page.

Similar to creating a wikilink using double square brackets ([[Pagename]]), a page can be transcluded as a template by enclosing its title in double curly braces: {{Namespace:Pagename}}. Any changes made to the source page, or template, are automatically reflected on all pages that include the transcluded content.[d]

Wikipedia is structured using namespaces, which organize pages based on their function. For example, a page titled Wikipedia:Tips belongs to the Wikipedia namespace, with Wikipedia: as its namespace and Tips as its pagename. However, articles in the Main namespace, such as Potato, do not require a namespace prefix when linked using [[Potato]], as Wikipedia assumes any wikilink without a specified namespace belongs to the Article namespace.

When transcluding pages, if no namespace is specified, Wikipedia defaults to the Template namespace. To reference a page in the Article namespace within transclusion syntax, it must be explicitly prefixed with a colon : (e.g., {{:Potato}}).

Examples

blue lightbulb Summary: {{Pagename}} or {{Template:Pagename}} will transclude the content of Template:Pagename.
{{:Pagename}} will transclude the mainspace article titled Pagename.
{{Namespace:Pagename}} transcludes a page in the defined namespace, such as Help:Pagename.
  • Specifying namespace: {{Namespace:Pagename}} will transclude the page titled Namespace:Pagename. For example, if a page has the wikitext {{Wikipedia:Notability}} in it, it will transclude the page Wikipedia:Notability into it. Please note that {{WP:Notability}} would do exactly the same thing, as WP: is a namespace alias, which is automatically translated by the Wikipedia servers to Wikipedia:.
  • Calling from the Article namespace: If the namespace is omitted, but the colon is included, like {{:Pagename}}, the mainspace article Pagename will be transcluded. For example, {{:Notability}} will transclude the article Notability.
  • Template namespace: If both namespace and colon are omitted, like {{Pagename}}, the Template:Pagename will be transcluded. For example {{Notability}}, and also {{Template:Notability}}, will both transclude the Template:Notability.

Additionally, specific § Template parameters and § Transclusion modifiers allow parameters to be passed to templates, alter how transclusion occurs, and therefore the output customized. This is explained in more detail below.

Subpages

Subpages, identifiable by a / prefixed in their page names, are pages related to a 'parent' page (e.g., Namespace:Pagename/Subpagename is a subpage of Namespace:Pagename). This feature is disabled in the Main, File, and MediaWiki namespaces, but not on their corresponding talk namespaces.

To transclude subpages:

  • In general, use {{Namespace:Pagename/Subpagename}}. With exception:
    • On the parent page of a subpage, the more specific general syntax mentioned above can be used or simply {{/Subpagename}}.
    • For a template namespace page, it is either the general syntax or {{Pagename/Subpagename}}.
    • Article subpages are disabled on this wiki, but would otherwise be {{:Pagename/Subpagename}}.
  • Alternatively, you can also use § Template parameters and § Transclusion modifiers.

For example, to transclude Template:Like/doc, you could use {{Template:Like/doc}} or {{Like/doc}}. Note that subpage names are case sensitive, and {{Like/Doc}} would lead to a different page.

Template parameters

The most common use of transclusion on Wikipedia is for templates. Templates are specially designed pages intended to be included in other pages using either transclusion or substitution. The standard syntax for transcluding a template titled Template:Pagename is {{Pagename}}.

Additionally, many templates support parameters, which are variables that allow templates to function in different ways by passing specific values, also termed arguments. Templates may have no parameters, use a fixed number of parameters, or support a variable number of parameters. The number of parameters a template can accept ranges from one to multiple, depending on its design.

The exact syntax for using parameters varies by template. However, for a hypothetical template titled Template:Pagename that accepts three parameters, the general format would be:

{{Pagename|parameter1|parameter2|parameter3}}

Where each parameter in a template can be substituted with either a value or a |parameter name=value format when used in practice. Notice that each parameter is separated by a vertical bar (|). Parameters that take the form value are called unnamed or positional parameters, while those in the form |parameter name=value are known as named parameters. With unnamed parameters, the first, second, and third parameters correspond to |1=, |2=, |3=, respectively, etc., in template documentation. Unnamed parameters must be provided in the correct order and are best placed before named parameters.[e]

For example, using the Template:Collapse top with two unnamed parameters and one named parameter:

Green tickY {{Collapse top|This is the title text|This is a custom warning line|left=true}}
Green tickY {{Collapse top|left=true|1=This is the title text|2=This is a custom warning line}}
Red XN {{Collapse top|left=true|This is the title text|2=This is a custom warning line}}

In this case, This is the title text and This is a custom warning line are the values of unnamed parameters |1= and |2=, while true is the value assigned to the named parameter |left=. The last example shows how unnamed parameters should not be used after named parameters without their 'name'. Although this example includes three parameters, Template:Collapse top can accept a variable number of parameters.

For more details, see Help:Template. Additionally, Wikipedia:Template index provides a categorized list of templates, including those for mainspace and other namespaces, along with a search function. Template parameters also play a role in the § Parametrization method of § Selective transclusion, allowing for more dynamic content inclusion.

Substitution

Transclusion events occur each time the target page is loaded and the template is rendered. A related event is Substitution, where a template call is replaced with its transcluded source content at the time it is invoked in a one-time inclusion of the content. Unlike transclusion, which continuously updates the target page with changes from the source, substitution results in a one-time inclusion of the content, meaning that subsequent updates to the source content will not be reflected in the target page. For example, a template call for {{Pagename}} with the subst: prefix results in the substitution template call {{subst:Pagename}}. When invoked, this template is replaced, also referred to as substituted, with the actual wikitext of the source page at the time of the call, thereby making it a permanent part of the target page.[f]

For example, when {{subst:Like}} is inserted in a page and the changes published, it would substitute that wikitext with the actual wikitext from Template:Like. In practice, subsequent updates to Template:Like will not be reflected in the page it was substituted into.

Magic words

Magic words are not examples of transclusion. But some have a near identical double curly bracket syntax and similar action to transclusion. For example, {{FULLPAGENAME}} renders the full page name of any Wikipedia page, for example it returns Help:Transclusion on this page. Like templates, some magic words can also take parameters, which are separated using a colon (:); for example {{TALKPAGENAME:Help:Transclusion}} returns Help talk:Transclusion.

Templates do exist for some magic words, for example Template:FULLPAGENAME; but these just invoke the related magic word and pass parameters using the verticle bar (|) to the magic word in anycase; for example like {{FULLPAGENAME|value}}. But magic words parameters are best passed directly by using a colon, which bypasses the unnecessary use of a template call too. For example, {{FULLPAGENAME|value}} is synonymous with {{FULLPAGENAME:value}}, where the latter is preferred.

Transclusion modifiers

A transclusion modifier is a type of specialist magic word for altering transclusion in some manner. An example of which is the subst: modifier discussed above in § Substitution. Another example is {{:Notability}}, where the colon character (:) forces transclusion to the main namespace. There are additional transclusion modifiers such as safesubst:, int:, msg:, msgnw:, and raw:. For more details on their usage, see mw:Help:Magic words § Transclusion modifiers. Also see the modified commands #section:, #section-x: and #section-h: used for labeled section transclusion, see Help:Labeled section transclusion and the section § Using the labeled section method.

Usage

Transclusion is commonly used in templates, allowing content to be embedded dynamically across multiple pages. However, it is also applied in other contexts, particularly within project space, where it facilitates the management of structured content.

Composite pages

Composite pages are created by transcluding multiple component pages, either entirely or in part, into a central page. The wikitext of a composite page may include HTML tags to embed content, typically from standalone pages that are not part of the template namespace. The primary purpose of composite pages is to consolidate related content for easier access.

Examples

The use of composite pages allows users to view multiple related pages in one location rather than navigating through individual links.

Characteristics

Composite pages function independently from their component pages in several ways. While changes made to a component page are reflected on the composite page, the composite page maintains its own edit history, recent changes log, page-watch settings, and protection levels, separate from those of its transcluded content.

The talk page of a composite page is used specifically for discussions about the composite itself rather than for the individual component pages it includes. However, in some cases, a composite talk page may also transclude discussions from its component pages, allowing for a centralized discussion space.

When editing, users can modify sections of a component page directly from the composite page by selecting the edit section links generated by {{transcluding article}}, {{transcluded section}} and {{excerpt}}, which all employ {{transclusion notice}} to generate the notice. Once changes are saved, they are applied to the original component page, ensuring consistency across all instances where the content appears.

For projects that support interlanguage links, a composite page aggregates all interlanguage links from its component pages. This can sometimes lead to multiple links pointing to the same language or page, reflecting the structure of the transcluded content.

Pages with a common section

When two pages need to discuss the same material in the same way, they can share a section. For example, a section of an existing page may be transcluded to other pages. This may also involve creating a third page and transcluding that page onto both pages. This third page may be a standalone page in its own right for another purpose, or a subpage of either of the other two – except in the mainspace, where subpages are not allowed. The third page may be placed in the same namespace as the other pages or in template namespace – again, except for use in mainspace, where templates should not be used to store article text, as this makes it more difficult to edit the content (see Wikipedia:Template namespace). Common sections like this should be marked with an explanatory header, such as using the templates {{transcluding article}} or {{transcluded section}} to create hatnotes above the transcluded content, and/or given a special layout, to inform the reader that this section of the page is in a different location, since transcluding shared article sections can easily confuse novice editors and readers alike if left unmarked. All templates can be found at Category:Transclude page content templates.

This can be very useful when two disambiguation pages share content,[disputeddiscuss] or a list page and a disambiguation page share content (see second example below).

Examples:

Repetition within a page

On pages with a lot of repetitive information – typically lists or tables – it can be useful to create a template that contains the repeating text, and then call that template multiple times. For example, {{EH listed building row}} is used repeatedly to build tables in many articles.

For simple repetition of the same text, you can use a template like {{3x}}. For instance, {{3x|howdy!}} produces: howdy!howdy!howdy!

Partial transclusion

By using <noinclude>, <includeonly> and <onlyinclude> markup, it is possible to transclude part of a page, rather than all of it. Such partial transclusions can be achieved by transcluding from any pages, including subpages. It is often useful to exclude part of a page in a transclusion, an example being with template documentation.

For an example of how this technique can be applied to simplify the creation of summary articles, see how part of the History of pathology (see the diff here) was transcluded into Pathology (see the diff here) using the {{:History of pathology}} markup. The Pathology article at that time (see here) mainly consisted of transcluded lead paragraphs and other sections from a number of articles. Since then, the Pathology article has been rewritten, and does not include all these transclusions.

Another example can be found in the transclusion of part of HitRecord (introductory paragraph only) into a same-named summary section in Joseph Gordon-Levitt.

Markup

In transclusion, a source page is transcluded into a destination page. But with partial transclusion, only part of that source page will be transcluded into a destination page. But in addition, what is transcluded to a destination page does not have to be visible on the source page.

Page rendering of a source page can be defined as the rendering of that source page when it is saved, which will be the same as the preview. We can call this rendering here.

Transclusion rendering of a source page can be defined as the rendering of a destination page that has a source page transcluded into it; but only that part of the destination page that was transcluded from the source page. The preview of the transclusion rendering will again be identical. We can call this rendering there.

There are three pairs of tags involved in cases where page rendering here should differ from transclusion rendering there. As described earlier, these are <noinclude>, <includeonly> and <onlyinclude>. These tags are invisible, but affect both page rendering here and transclusion rendering there. These tags pair-off to demarcate sections that will create differences. Each tag will describe exceptions to transcluding the whole page named.

<noinclude>  This section is visible here; but this section is not visible there. Sections outside of these tags will be visible both here and there. </noinclude>

<onlyinclude> This section is visible here; this section is also visible there. Sections outside of these tags will be visible here, but will not be visible there. </onlyinclude> 

<includeonly> This section is not visible here; but it is visible there. Sections outside of these tags will be visible both here and there. </includeonly>
Wikitext What is rendered here (source page) What is transcluded there (destination page)
<noinclude>text1</noinclude> text2 text1 text2 text2
<onlyinclude>text1</onlyinclude> text2 text1 text2 text1
<includeonly>text1</includeonly> text2 text2 text1 text2

An important point to note is that <noinclude> and <onlyinclude> do not affect what is page rendered here at all, unlike <includeonly>. The <noinclude> tags stops text inside the tags being transcluded there, while <onlyinclude> has the opposite effect: it stops text outside of the tags from being transcluded there.

Only <includeonly> stops text from being page rendered here. But naturally enough it is transcluded there. Text outside of the tags will be both rendered here and transcluded there.

There can be several such sections. Also, they can be nested. All possible differences between here and there are achievable.

One example is a content editor who picks an <onlyinclude> section, and then takes a <noinclude> section out of that; but then picks out yet another <onlyinclude> section to append to there; but none of this affects their article in any way.

Another example is the template programmer, who will <includeonly> the code section and <noinclude> the documentation section of a page.

Selective transclusion

Selective transclusion is the process of partially transcluding one selected section of a document that has more than one transcludable section. As noted above, if only one section of a document is to be transcluded, this can be done by simply surrounding the section of interest with <onlyinclude></onlyinclude> tags, and transcluding the whole page. However, to selectively transclude one section from a template or document into one page, and another section from the same template or document into a second page and/or a different section of the same page, requires a way to:

a) uniquely mark each transcludable section in the source document; and
b) in the target document(s) (those to show the transcluded sections), a way to specify which section is to be transcluded.

This section describes how to accomplish this. There are three ways of doing this: (1) Section header-based transclusion, (2) Labeled section transclusion, and (3) the parametrization method.

Standard section transclusion

Standard section transclusion uses {{#section-h:PAGENAME|SECTIONNAME}}. One can easily transclude the content within a section from one page to another using the ubiquitous headline-based section headers used throughout Wikipedia. To transclude the lead section of an article with this method, one can use {{#section-h:PAGENAME}}. This method is simpler than other selective transclusion methods, which require special markup in the source article or page to specify what content should be included or excluded.

Standard section transclusion may introduce a leading or trailing line break or newline, depending on the markup in the source and target pages. To prevent this, wrap the transclusion code in a {{trim}} template. For example:

  • To transclude the section of an article: {{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
  • To transclude the lead of an article: {{trim|{{#section-h:PAGENAME}}}}

Hatnote on the target page

To indicate on the target page where selectively transcluded content originates (its source), a {{Transcluded section}} hatnote must be placed at the top of the corresponding section in the target page where the content is being transcluded to.[g][h] Use either of the following, depending on whether the transcluded content is the entire section or only part of it:

  • If an entire section in the target page is transcluded the source: {{transcluded section|source=PAGENAME#SECTION}}, which renders as:
  • If only part of a section in the target page is transcluded the source, specify |part=yes: {{transcluded section|source=PAGENAME#SECTION|part=yes}}, which renders as:

Hidden comment on the source page

It is recommended to include a hidden comment at the beginning of the transcluded section in the source page. This comment informs editors that the content is being used elsewhere and serves as a reminder to consider the broader audience when modifying the wording. Additionally, it helps maintain the integrity of the transcluded material on the target page. For example (replace [[PAGENAME#SECTION]] with the name of the target page):

<!-- The content of this section is transcluded to [[PAGENAME#SECTION]]. Please be aware that changes made to the original source here will affect the transcluded version on the target page mentioned. -->

No hatnote should be placed on the source page, in other words no hatnote is needed on the page being transcluded from, as readers do not need to know where else the content appears.

Using the labeled section method

Labeled-section selective transclusion uses the parser functions listed in mw:Extension:Labeled Section Transclusion, which are enabled on all Wikimedia wikis, to selectively transclude content. See Help:Labeled section transclusion for how labeled section transclusion works.

Parametrization method

Source document markup

Insert the following line into the "source" document (the one from which text is to be transcluded), immediately preceding the first line of each section to be transcluded, substituting SECTIONNAME (twice) with the unique name of the respective section. The section name can be any identifier and must be unique within that document:

<onlyinclude>{{#ifeq:{{{transcludesection|SECTIONNAME}}}|SECTIONNAME|

End each such transcludable section with:

}}</onlyinclude>
Target document markup

To transclude a section marked as above into another page (the "target page"), use the following line on that page, substituting PAGENAME for the "source" document from which text to be transcluded, and SECTIONNAME with the name of the section you want to transclude:

{{PAGENAME|transcludesection=SECTIONNAME}}

Thus each section enclosed within <onlyinclude></onlyinclude> tags will always be rendered when the transcludesection parameter is not set (when the document is viewed ordinarily, or when the document is transcluded without setting the transcludesection parameter as shown below), and will be rendered by transclusion on any page that does set transcludesection to the section's name. It will not be rendered by transclusion that uses the transcludesection parameter but sets it to anything other than the name of the section.

Also, when providing PAGENAME, without providing a Namespace, the wiki will assume that the PAGENAME belongs in the Template Namespace. To transclude from a Mainspace article, use :PAGENAME.

{{:PAGENAME|transcludesection=SECTIONNAME}}
Example

If we want to make the "Principal Criteria" and "Common Name" sections of WP:TITLE be independently transcludable, we edit the WP:TITLE page and enclose the "Principal Criteria" section as follows:

<onlyinclude>{{#ifeq:{{{transcludesection|principalcriteria}}}|principalcriteria|
...
''(text of "Principal Criteria" section)''
...
}}</onlyinclude>

Similarly, we enclose the "Common Name" section with:

<onlyinclude>{{#ifeq:{{{transcludesection|commonname}}}|commonname|
...
''(text of "Common Name" section)''
...
}}</onlyinclude>

Then, to transclude the "Principal Criteria" section into another page, we insert into that page:

{{WP:TITLE|transcludesection=principalcriteria}}

To transclude the "Common Name" section into another page, we insert into that page:

{{WP:TITLE|transcludesection=commonname}}

Of course, the same page can transclude two or more sections this way by including multiple such lines.

There is no limit to how many selectable sections for transclusion a document can have. The only requirement is that each transcludesection be given a value that is unique within that page.

Additional markup for selectively transcluded sub-article leads

Per MOS:LEAD#Format of the first sentence, the first instance of the sub-article title should appear in bold in the first lead sentence of that article; this is often not desirable for a transclusion to a section of the parent article. In addition, the parent article is often wikilinked in the lead of a sub-article; when transcluded to the parent article, this wikilink will appear as bold text. The wikitext markup listed below can be used to address both of these problems.

To ensure that the article title is bolded in the first sentence of the sub-article, but unbolded and wikilinked in the transclusion to the parent article, make the following replacement in the sub-article's first lead sentence:

Replace
SUB-ARTICLE_PAGENAME
with
<noinclude>'''</noinclude>{{No selflink|{{var|SUB-ARTICLE_PAGENAME}}}}<noinclude>'''</noinclude>

If there is a wikilink to the parent article in the lead section of the sub-article, replacing the wikilink to the parent article with a {{no selflink}} template will ensure that it is wikilinked in the sub-article's lead but not in the transclusion to the parent article. In other words:

  1. If the wikilink to the parent article is not a WP:Piped link, replace [[PARENT_ARTICLE]] with {{no selflink|PARENT_ARTICLE}} in the sub-article's lead
  2. If the wikilink to the parent article includes a pipe (e.g., this link), replace [[PARENT_ARTICLE|Piped link wikitext]] with {{No selflink|PARENT_ARTICLE|Piped link wikitext}} in the sub-article's lead

Drawbacks

Like many software technologies, transclusion comes with a number of drawbacks. The most obvious one being the cost in terms of increased machine resources needed; to mitigate this to some extent, template limits are imposed by the software to reduce the complexity of pages. Some further drawbacks are listed below.

Special pages

Some pages on Special:Specialpages can be transcluded, such as AllPages, PrefixIndex, NewFiles, NewPages, RecentChanges, WhatLinksHere (see help page), and RecentChangesLinked. Samples:

  • {{Special:AllPages/General}} – a list of pages starting at "General".
  • {{Special:PrefixIndex/General}} – a list of pages with prefix "General".
  • {{Special:NewFiles/4}} – a gallery of the four most recently uploaded files.
  • {{Special:NewPages/5}} – a list of the five most recently created pages.
  • {{Special:RecentChanges/5}} – the five most recent changes.
  • {{Special:RecentChangesLinked/General}} – recent changes to the pages linked from "General".
  • {{Special:Contribs/Larry Sanger|offset=20021108002158|limit=50}} – user contributions prior to November 2002, limited to 50.

Attempting to transclude {{Special:Categories}} will not result in an actual list of categories, but {{Special:PrefixIndex/Category:}} can be used for this purpose.

Except for Special:RecentChangesLinked, the slash, and the word or number after the slash, can be omitted, giving a list of pages without a specific starting point, or a list of the default length.

URL parameters can be given like template parameters:

  • {{Special:RecentChanges|namespace=10|limit=5}} – the five most recent changes in the "Template" namespace.
  • {{Special:PrefixIndex/Jimbo Wales/|namespace=2|stripprefix=1}} – the subpages for User:Jimbo Wales, but without the user page prefix.

Note: Transcluding certain special pages (such as Special:NewPages) can change the displayed title of the page.

Advanced concepts

Transclusion occurs before parsing and can emit syntax fragments, like HTML entities, to preserve them in the final render. The content being transcluded is processed and embedded before the target page is parsed and fully rendered. When transclusion happens at the HTML layer before parsing, it allows certain content – like syntax fragments such as character entity references like & and mp; or specific HTML components – to be inserted in their original form and preserved in the final render. However, this approach may cause pages to render incorrectly or violate the principle of least surprise for the reader.[i] It should be used sparingly when cleaner alternatives are not available. Emitting fragments of template syntax, such as opening braces ({{}}), is unlikely to re-parse correctly as template syntax in the target page, and it is unwise to rely on such behavior unless formally documented.

Notes

  1. ^ A purge may occasionally be necessary to refresh target pages, ensuring they retrieve and display the latest content from the template or source page. This forces the MediaWiki software to clear the cached version of the page and reload it with the most up-to-date transcluded content.
  2. ^ Transclusion relies on functions that parse the source page, meaning that the appropriate wikitext markup must be present on the source page for it to correctly include or exclude content. The specific tags used for this purpose determine how the content will be transcluded into the target page. Properly implementing these tags allows editors to control the visibility of certain parts of the content based on the needs of the target page.
  3. ^ In simpler terms, the page is published or saved, and any future changes to the source page will not affect this substituted content.
  4. ^ A purge may occasionally be necessary to refresh target pages, ensuring they retrieve and display the latest content from the template or source page. This forces the MediaWiki software to clear the cached version of the page and reload it with the most up-to-date transcluded content.
  5. ^ Otherwise using value on its own will not work, and the unnamed parameters must be called using their 'names', such as |1=value, if named parameters precede them.
  6. ^ In simpler terms, the page is published or saved, and any future changes to the source page will not affect this substituted content.
  7. ^ No hatnote should be placed on the source page, in other words no hatnote is needed on the page being transcluded from, as readers do not need to know where else the content appears.
  8. ^ That is the hatnote should be placed below the header but above the content, per MOS:Layout.
  9. ^ For example, if whitespace, tabs, and newline HTML code are preserved without parsing, the final page may display awkward spacing, misalignments, or unexpected breaks. This whitespace is usually added in the source code to improve readability for developers and isn’t intended to appear in the published content.

See also

MediaWiki transclusion

Templates

Other

腿肿吃什么药消肿最快最有效 gpd是什么意思 子午相冲是什么意思 血小板减少吃什么 什么是甘油三酯
老夫是什么意思 男人阳萎吃什么药最好 鱼腥草有什么用处 broom是什么意思 lirs 是什么意思
中心思想是什么意思 专业服从是什么意思 为什么时间越来越快 缺钙吃什么 snr是什么意思
下火喝什么茶 瞧不起是什么意思 值机是什么 促狭一笑是什么意思 止鼾什么方法最有效
孩子喝什么牛奶有助于长高hcv9jop3ns1r.cn 百什么争鸣travellingsim.com 水肿吃什么药消肿最快最有效zhongyiyatai.com 子宫有积液是什么原因引起的hcv8jop5ns4r.cn 下午3点到4点是什么时辰hcv9jop5ns3r.cn
加拿大用什么货币hcv8jop3ns1r.cn 什么人不能喝牛奶hcv7jop9ns2r.cn 有时候会感到莫名的难过是什么歌hcv9jop1ns6r.cn 扁桃体肥大有什么症状helloaicloud.com 人工受孕和试管婴儿有什么区别hcv9jop6ns1r.cn
桂皮是什么hcv9jop2ns6r.cn 梦见人头是什么征兆youbangsi.com 卜卜脆是什么意思hcv9jop6ns3r.cn 长大做什么hcv9jop0ns2r.cn 300分能上什么大学hcv7jop9ns1r.cn
头疼是什么原因hcv9jop5ns4r.cn 茶水洗脸有什么好处和坏处hcv7jop5ns6r.cn 八一建军节是什么节日hcv9jop7ns0r.cn 什么烟贵gangsutong.com 平均血小板体积低是什么原因weuuu.com
百度