Examples/Parameter: multisecseparators (example 3): Difference between revisions

From DynamicPageList3 Manual
Content added Content deleted
imported>FrozenPlum
(This example is a bit complex for an introduction to formatting, so, also link to the include statement where I can put a simplified example related directly to including contents related to templates (and using a surrogate).)
 
imported>FrozenPlum
m (tweak link text)
 
(8 intermediate revisions by the same user not shown)
Line 6:
==Example==
 
This example contains all the same elements as the prior examples, only it uses a [[Template:DPL parameter.surrogateexample|surrogate/ (also known as phantom) template]] to format the second and third column of results. The first column is included in the <code>{{DPL|listseparators}}</code> statement, to prevent the page name from being repeated in every subsequent line. ThisThe issecond and third column, formatted in the surrogate, creates a bitlink ofto anthe advancedpage's useparameter name section, and then display the "purpose" text using [[mw:Help:Extension:ParserFunctions|Parser Functions]]. This combination of formatting the page name in a "separators" format statement '''and''' a surrogate template, andresults in templates used multiple times on a page to be separated into separate table rows under the formatparent statement.page name (normally repeat templates used Foron a page are combined into a single row). This example is advanced, for more, simple exampleexamples of surrogate template use, see the [[Controlling output volume#include contents related to templates|include examples]] parameter,as forrelated to including contents related tofrom templates, usingsee athe surrogate<code>{{DPL|table}}</code> templateand <code>{{DPL|tablerow}}</code> parameters for straightforward table examples.
 
<pre>
{{#dpl:
|category = Primary Module
|nottitlematch = %volume%¦%page selection%
|uses = Template:DPL Parameter
|include = {dpl manual}:,{DPL parameter}.surrogateexample
|mode = userformat
|listseparators = ¶{¦class="wikitable sortable" ¶!colspan=3¦Includes a surrogate (phantom) template¶¦-¶!Page ¶!Name ¶!Purpose,¶¦-¶¦[[%PAGE%]]¶,¶¦-¶¦class="dpl-dark-background" colspan=3¦,¶¦}
|secseparators = ,¶¦class="dpl-orange-background"¦,
|multisecseparators = ,¶¦-¶¦¶¦class="dpl-blue-background"¦
Line 24 ⟶ 25:
|category = Primary Module
|nottitlematch = %volume%¦%page selection%
|uses = Template:DPL Parameter
|include = {dpl manual}:,{DPL parameter}.surrogateexample
|mode = userformat
|listseparators = ¶{¦class="wikitable sortable" ¶!colspan=3¦Includes a surrogate (phantom) template¶¦-¶!Page ¶!Name ¶!Purpose,¶¦-¶¦[[%PAGE%]]¶,¶¦-¶¦class="dpl-dark-background" colspan=3¦,¶¦}
|secseparators = ,¶¦class="dpl-orange-background"¦,
|multisecseparators = ,¶¦-¶¦¶¦class="dpl-blue-background"¦

Latest revision as of 05:35, 1 April 2023

Please do not edit this page unless you're wanting to edit the manual itself, it is an example included in the manual.

Example

This example uses a surrogate (also known as phantom) template to format the second and third column of results. The first column is included in the listseparators statement, to prevent the page name from being repeated in every subsequent line. The second and third column, formatted in the surrogate, creates a link to the page's parameter name section, and then display the "purpose" text using Parser Functions. This combination of formatting the page name in a "separators" format statement and a surrogate template, results in templates used multiple times on a page to be separated into separate table rows under the parent page name (normally repeat templates used on a page are combined into a single row). This example is advanced, for more, simple examples of surrogate template use see include examples as related to including contents from templates, see the table and tablerow parameters for straightforward table examples.

{{#dpl:
|category           = Primary Module
|nottitlematch	    = %volume%¦%page selection%
|uses               = Template:DPL Parameter
|include            = {dpl manual}:,{DPL parameter}.surrogateexample
|mode               = userformat
|listseparators     = ¶{¦class="wikitable sortable" ¶!colspan=3¦Includes a surrogate (phantom) template¶¦-¶!Page ¶!Name ¶!Purpose,¶¦-¶¦[[%PAGE%]]¶,¶¦-¶¦class="dpl-dark-background" colspan=3¦,¶¦}
|secseparators      = ,¶¦class="dpl-orange-background"¦,
|multisecseparators = ,¶¦-¶¦¶¦class="dpl-blue-background"¦
}}

Result

{{#dpl: |category = Primary Module |nottitlematch = %volume%¦%page selection% |uses = Template:DPL Parameter |include = {dpl manual}:,{DPL parameter}.surrogateexample |mode = userformat |listseparators = ¶{¦class="wikitable sortable" ¶!colspan=3¦Includes a surrogate (phantom) template¶¦-¶!Page ¶!Name ¶!Purpose,¶¦-¶¦%PAGE%¶,¶¦-¶¦class="dpl-dark-background" colspan=3¦,¶¦} |secseparators = ,¶¦class="dpl-orange-background"¦, |multisecseparators = ,¶¦-¶¦¶¦class="dpl-blue-background"¦ }}