编辑“︁Template:Random portal component/doc”︁

<includeonly><!-- 在這裡加入模板的保護標識 --></includeonly>
<!-- 在本行下編輯模板說明 -->
{{缺乏中文說明}}
{{Documentation subpage}}
{{lua|Module:Random portal component}}
<!-- EDIT TEMPLATE DOCUMENTATION AFTER THIS LINE -->

This template generates a box for a portal home page. The content is drawn randomly from a pre-defined list.

== Layout ==
<pre>
{{Random portal component
 |max      =
 |template =
 |header   =
 |footer   =
 |subpage  = 
 |rootpage =
 |headertemplate = 
}}
</pre>

== Usage ==
* '''header''': (Optional) The header text of the box. If no header is passed to the template, the default is the subpage name.
* '''footer''': (Optional) The footer text in the box. E.g. ''Nominations for selected picture''.
* '''rootpage''': (Optional) The root of the transcluded page, e.g. ''Portal:Foo''.
* '''subpage''': The subpage of the transcluded page, e.g. ''Selected picture''.
* '''max''': The maximum number of sub-subpages. Must be a positive integer.
* '''headertemplate''': (Optional) The name of the template to use for the box header, e.g. {{code|Box-header/10}} for [[Template:Box-header/10]]; default is the portal's {{code|/box-header}} subpage

=== Formatting subpages ===
* Create a sub-page first. If your portal is {{code|Portal:Foo}}, then a sub-page could be {{code|Portal:Foo/Selected bar}}.
* On the {{code|Portal:Foo/Selected bar}} sub-page, place the template {{tl|numbered subpages}} on the page and save it.
* Once the list of subject links have been created, use one of the {{code|Selected <subject>}} templates from below to format each of the subject sub-pages.
* This template calls {{code|/box-header}} (if {{code|headertemplate}} is not specified) and {{tl|box-footer}} for its color styles and closing. Either {{code|headertemplate}} must be used, or the {{code|/box-header}} subpage must exist for everything to work correctly.

== Example ==
To see a real time example, see [[Special:Whatlinkshere/Template:{{BASEPAGENAME}}&hidelinks=1|what links here]] (the list of pages that currently transclude the {{tl|{{BASEPAGENAME}}}} template).

Here is a stale example of the output generated by this template.

<pre>
{{Box-header | title=Header
|editpage   = Template:Lorem ipsum
|border     = Black
|titleforeground = #ffe247
|titlebackground = #646464
|background = #FFFFFF
|foreground = black
}}
{{Lorem ipsum}}
{{Box-footer | Footer }}
</pre>

will produce:

{{Box-header | title=Header
|editpage   = Template:Lorem ipsum
|border     = Black 
|titleforeground = #ffe247
|titlebackground = #646464
|background = #FFFFFF
|foreground = black}}
{{Lorem ipsum}}
{{Box-footer | Footer }}

== See also ==
{{Portal template list}}

<includeonly>{{Sandbox other||
<!--Categories below this line, please; interwikis at Wikidata-->
[[Category:主題模板]]
}}</includeonly>