Module:Section sizes/doc: Difference between revisions

Content deleted Content added

Inline

Revision as of 01:18, 22 September 2024

This module creates a wikitable that lists each section in a page along with that section's size in bytes. Each section is wikilinked to its target in the page; subsections are indented. Cells for section sizes are shaded according to the size; the smallest section's background is white, and the largest section's background is red.

Usage

This module has two entry points: size, and section_length_get.

Use size to emit the section table:

{{#invoke:Section sizes|size|<page name>|style=<style string>}}

Entry point size() takes two arguments from frame:

<page name> (required) – the first positional parameter is the page name; may include namespace

|style= (optional) – css string suitable for use in the table's style= attribute; for example to render the table at the right side of the page:

{{#invoke:Section sizes|size|<page name>|style=float:right; margin-left:.5em}}

Use entry point section_length_get to return an article or section length statistic:

{{#invoke:Section sizes|section_length_get|<page name>|<section name>}}
{{#invoke:Section sizes|section_length_get|<page name>|<section name> |_all}}
{{#invoke:Section sizes|section_length_get|<page name>|<token>}}

Entry point section_length_get() takes one, two, or three arguments from frame:

<page name> (required) – the first positional parameter is the page name; may include namespace

<section name> (optional) – the second positional parameter is either the section name, or one of three tokens (if param 2 is absent, the default is _lead)

<sectionName> – returns the length of the given section

_lead – returns the length of the lead section (this is the default, if param 2 is absent)

_max – returns the length of the longest section

_total – returns the length of the article (should = {{PAGESIZE}} )

_all (optional) – the third positional parameter is the string _all; this includes the total length of the section whose name is given in parameter 2, including all its subsections.

@@ Line 2: / Line 2: @@
 == Usage ==
-This module has a single entry point:
+This module has two entry points: <code>size</code>, and <code>section_length_get</code>.
-<code><nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}|size|&lt;{{var|page name}}>|style=&lt;{{var|style string}}>}}</code>
-<code>size()</code> takes two arguments from <code>frame</code>:
+: Use <code>size</code> to emit the section table:
+<code>{{((}}#invoke:{{BASEPAGENAME}}|size|&lt;{{var|page name}}>|style=&lt;{{var|style string}}>}}</code>{{br}}
+Entry point <code>size()</code> takes two arguments from <code>frame</code>:
 :<code>&lt;{{var|page name}}></code> (required) – the first positional parameter is the page name; may include namespace
 :{{para|style}} (optional) – css string suitable for use in the table's <code>style=</code> attribute; for example to render the table at the right side of the page:
 ::<code><nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}|size|&lt;{{var|page name}}>|style=float:right; margin-left:.5em}}</code>
+: Use entry point <code>section_length_get</code> to return an article or section length statistic:
+<code>{{((}}#invoke:{{BASEPAGENAME}}|section_length_get|&lt;{{var|page name}}>|&lt;{{var|section name}}>}}</code>{{br}}
+<code>{{((}}#invoke:{{BASEPAGENAME}}|section_length_get|&lt;{{var|page name}}>|&lt;{{var|section name}}> |_all}}</code>{{br}}
+<code>{{((}}#invoke:{{BASEPAGENAME}}|section_length_get|&lt;{{var|page name}}>|&lt;{{var|token}}>}}</code>{{br}}
+Entry point <code>section_length_get()</code> takes one, two, or three arguments from <code>frame</code>:
+:<code>&lt;{{var|page name}}></code> (required) – the first positional parameter is the page name; may include namespace
+:<code>&lt;{{var|section name}}></code> (optional) – the second positional parameter is either the section name, or one of three tokens (if param 2 is absent, the default is _lead)
+:: <code>&lt;{{var|sectionName}}></code> – returns the length of the given section
+:: <code>_lead</code> – returns the length of the lead section (this is the default, if param 2 is absent)
+:: <code>_max</code> – returns the length of the longest section
+:: <code>_total</code> – returns the length of the article (should = {{tl|PAGESIZE}} )
+:<code>_all</code> (optional) – the third positional parameter is the string <code>_all</code>; this includes the total length of the section whose name is given in parameter 2, including all its subsections.
 == See also ==