Template:When on basepage/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
← Older edit
VisualWikitext
meta>Davidgothberg
Adding a caution that I might change the syntax for the demospace parameter. And adding some "See also" links.
Ookami (talk | contribs)
1,664 edits
m 37 revisions imported
 
(33 intermediate revisions by 23 users not shown)
Line 1: Line 1:
{{documentation subpage}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->


{{caution
This is the {{tl|When on basepage}} meta-template. It helps other templates detect if they are on a '''basepage''' (i.e. a page whose name matches the pattern "''x'':''x''") '''subpage''' ("''x'':''x''/''x''") or '''subsubpage''' ("''x'':''x''/''x''/''x''").
| This template is new. It is tested and works well. But I am thinking of changing how the '''demospace''' parameter works. However, the functionality of parameters 1-3 will not be changed. <br> --[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 01:18, 4 November 2009 (UTC)
}}
 
This is the {{tl|basepage subpage}} meta-template.
 
This template helps other templates detect if they are on a '''basepage''', '''subpage''' or '''subsubpage'''.
 
=== Usage ===
 
This template takes one or more parameters, like this:
<pre>
{{basepage subpage
| Basepage text
| Subpage text
}}
</pre>
 
If the template is on the page "User:Example", it will return this:
 
:{{basepage subpage
| Basepage text
| Subpage text
| demospace = basepage
}}
 
If the template is on "User:Example/test" or "User:Example/test/test" or any page lower than that, it will return this:
 
:{{basepage subpage
| Basepage text
| Subpage text
| demospace = subsubpage
}}
 
This template can also detect "subsubpages", like this:
 
<pre>
{{basepage subpage
| Basepage text
| Subpage text
| Subsubpage text
}}
</pre>
 
If the template is on "User:Example/test/test" or any page lower than that, it will return this:


:{{basepage subpage
An alternative way to detect whether a page is a subpage is to combine the parser functions <code>#ifeq:</code> and <code>#titleparts</code>. See [[#Alternatives for simpler text|Alternatives for simpler text]] below.
| Basepage text
| Subpage text
| Subsubpage text
| demospace = subsubpage
}}


By using an empty parameter you can make it so the template doesn't render anything for some specific page type. Like this:
== Usage ==


<pre>
: {{tlx|When on basepage&#32;|''result if on a basepage''&#32;(|''result if on a subpage'')&#32;(|''result if on a subsubpage'')&#32;(|page{{=}}''pagename'')}}
{{basepage subpage
| Basepage text
| Subpage text
|
}}
</pre>


The code above will render nothing when on "User:Example/test/test" or lower, but will return this when on "User:Example/test":
For example, {{tlf|When on basepage |Basepage |Subpage}} on the page "User:Example" would return: {{When on basepage|Basepage|Subpage|page=User:Example}}<br/>whilst on "User:Example/page" (or "User:Example/page/page", "User:Example/page/page/page", etc.) it would return: {{When on basepage|Basepage|Subpage|page=User:Example/page}}


:{{basepage subpage
On a subsubpage such as "User:Example/page/page" (or "User:Example/page/page/page", etc.), {{nowrap|{{tlf|When on basepage |Basepage |Subpage |Subsubpage}}}} would return: {{When on basepage |Basepage |Subpage |Subsubpage |page=User:Example/page/page}}
| Basepage text
| Subpage text
|  
| demospace = subpage
}}


=== Demospace ===
Use an empty parameter to specify no action for a particular type of page. {{nowrap|{{tlf|When on basepage |Basepage | |Subsubpage}}}} on "User:Example/page", for example, would return nothing, but would return "Subsubpage" if on "User:Example/page/page", "User:Example/page/page/page", etc. (and "Basepage" if on "User:Example").


For testing and demonstration purposes this template can take a parameter named '''demospace'''.
===Handling equals-signs ("=")===
Use numbered parameters if their values include equals-signs ("="), i.e.
: {{tlf|When on basepage&#32;|1{{=}}''basepage result'' (|2{{=}}''subpage result'') (|3{{=}}''subsubpage result'')}}


* If it has the value '''basepage''' it returns the basepage text.
===''page'' parameter===
* It if has the value '''subpage''' it returns the subpage text.
The ''page'' parameter is included for testing/demonstration. For example:
* It if has the value '''subsubpage''' it returns the subsubpage text if there is one, otherwise it returns the subpage text.
: {{tlf|When on basepage&#32;|(basepage result) |(subpage result) |page{{=}}User:Example/test}}
* If the parameter is empty or undefined, the actual page type determines the result.
Regardless of where the above is placed, it will return: {{When on basepage|(basepage result)|(subpage result)|page=User:Example/test}}<br/>(because "User:Example/test" is a subpage). The page doesn't have to exist.


Like this:
If ''page'' is left empty ({{para|page}}) or undefined, the page where the template is transcluded (i.e. {{tld|PAGENAME}}) is used.


<pre>
''page'' also accepts variables, e.g. {{nowrap|{{tlf|When on basepage |(basepage result) |(subpage result) |page<nowiki>={{{page|}}}</nowiki>&nbsp;}}}}
{{basepage subpage
| Basepage text
| Subpage text
| demospace = subpage
}}
</pre>


No matter on what kind of page the code above is used it will return this:
== Technical note ==


:{{basepage subpage
This template detects subpages in all namespaces, including those without the [[meta:Link#Subpage feature|MediaWiki subpage feature]] enabled.
| Basepage text
| Subpage text
| demospace = subpage
}}


You can make it so your template also understands the '''demospace''' parameter. That means you can demonstrate the different appearances of your template in the documentation for your template. Then do like this:
== Alternatives for simpler text ==


A subpage can be detected without using another template, by instead using the title-splitting parser function <code>#titleparts</code> with <code>#ifeq</code>:
<pre>
<pre>
{{basepage subpage
{{#ifeq:{{#titleparts:{{PAGENAME}}|1|1}}|{{PAGENAME}}
| Basepage text
| [...code if on a basepage...]
| Subpage text
| [...code if on a subpage...]
| demospace = {{{demospace|}}}
}}
}}
</pre>
</pre>
For example, many templates can check if the page is a /sandbox version, by the similar markup with <code>#ifeq</code> and <code>#titleparts</code>:
: <nowiki>{{#ifeq: {{#titleparts:{{PAGENAME}}|1|1}} | {{PAGENAME}}</nowiki>
:: <nowiki> | {{documentation}}</nowiki>
:: <nowiki> | {{template sandbox notice}}</nowiki>
: <nowiki>}}</nowiki>
That simple logic works because [[Template:Template sandbox notice]] also checks the page name for "/sandbox" before displaying the sandbox notice; otherwise, any other subpage would show no extra text. By avoiding a template, and using a single <code>#ifeq</code>, then the processing uses only +2 expansion depth levels, rather than +7 levels, and avoids "[[wp:exceeded template limits]]" inside a complex /doc page.


=== Technical details ===
== See also ==
{{Namespace and pagename-detecting templates}}


Templates have a problem to handle parameter data that contains equal signs "<code>=</code>". But that is easily solved by using numbered parameters. Like this:
<includeonly>{{Sandbox other||
 
<!--Categories below this line, please; interwikis at Wikidata-->
<pre>
[[Category:Pagename manipulation templates]]
{{basepage subpage
| 1 = Basepage text
| 2 = Subpage text
| 3 = Subsubpage text
| demospace = {{{demospace|}}}
}}
</pre>
 
This template detects subpages even when used in namespaces that doesn't have the MediaWiki subpage feature enabled. Thus this template works the same in all namespaces.
 
=== See also ===
 
* [[mw:Help:Magic words]] – About <code><nowiki>{{PAGENAME}}</nowiki></code> etc.
* [[meta:Link#Subpage feature]] – About the MediaWiki subpage feature.
 
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Wikipedia metatemplates]]
[[Category:Wikipedia metatemplates]]
 
}}</includeonly>
</includeonly>

Latest revision as of 14:11, 3 September 2020

This is the {{When on basepage}} meta-template. It helps other templates detect if they are on a basepage (i.e. a page whose name matches the pattern "x:x") subpage ("x:x/x") or subsubpage ("x:x/x/x").

An alternative way to detect whether a page is a subpage is to combine the parser functions #ifeq: and #titleparts. See Alternatives for simpler text below.

Usage

{{When on basepage |result if on a basepage (|result if on a subpage) (|result if on a subsubpage) (|page=pagename)}}

For example, {{When on basepage|Basepage|Subpage}} on the page "User:Example" would return: Basepage
whilst on "User:Example/page" (or "User:Example/page/page", "User:Example/page/page/page", etc.) it would return: Subpage

On a subsubpage such as "User:Example/page/page" (or "User:Example/page/page/page", etc.), {{When on basepage|Basepage|Subpage|Subsubpage}} would return: Subsubpage

Use an empty parameter to specify no action for a particular type of page. {{When on basepage|Basepage|Subsubpage}} on "User:Example/page", for example, would return nothing, but would return "Subsubpage" if on "User:Example/page/page", "User:Example/page/page/page", etc. (and "Basepage" if on "User:Example").

Handling equals-signs ("=")

Use numbered parameters if their values include equals-signs ("="), i.e.

{{When on basepage |1=basepage result (|2=subpage result) (|3=subsubpage result)}}

page parameter

The page parameter is included for testing/demonstration. For example:

{{When on basepage |(basepage result)|(subpage result)|page=User:Example/test}}

Regardless of where the above is placed, it will return: (subpage result)
(because "User:Example/test" is a subpage). The page doesn't have to exist.

If page is left empty (|page=) or undefined, the page where the template is transcluded (i.e. {{PAGENAME}}) is used.

page also accepts variables, e.g. {{When on basepage|(basepage result)|(subpage result)|page={{{page|}}} }}

Technical note

This template detects subpages in all namespaces, including those without the MediaWiki subpage feature enabled.

Alternatives for simpler text

A subpage can be detected without using another template, by instead using the title-splitting parser function #titleparts with #ifeq: 

{{#ifeq:{{#titleparts:{{PAGENAME}}|1|1}}|{{PAGENAME}}
 | [...code if on a basepage...]
 | [...code if on a subpage...]
}}

For example, many templates can check if the page is a /sandbox version, by the similar markup with #ifeq and #titleparts:

{{#ifeq: {{#titleparts:{{PAGENAME}}|1|1}} | {{PAGENAME}}
| {{documentation}}
| {{template sandbox notice}}
}}

That simple logic works because Template:Template sandbox notice also checks the page name for "/sandbox" before displaying the sandbox notice; otherwise, any other subpage would show no extra text. By avoiding a template, and using a single #ifeq, then the processing uses only +2 expansion depth levels, rather than +7 levels, and avoids "wp:exceeded template limits" inside a complex /doc page.

See also


Retrieved from "https://zoophilia.wiki/index.php?title=Template:When_on_basepage/doc&oldid=96947"