Difference between revisions of "Template:See Also"

From Pathfinder Wiki
m (Protected "Template:See Also": high-impact page ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(107 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{#ifexpr:{{PAGESINCATEGORY:Adventist Youth Honors Answer Book/Prerequisite/{{{1|}}}}}|
+
<noinclude>
<div class="toccolours mw-collapsible mw-collapsed" style="width:80%">
+
Displays a list of all the honors tagged as a "See Also" for which the specified honor. This includes all pages for which it is listed as a prerequisite, as well as any that are adjacent in a series labelled with Roman numerals. Every Honor-Link is separated by "%|%".
<noinclude><translate></noinclude>Honor Sequels<noinclude></translate></noinclude>
+
 
<div class="mw-collapsible-content">
+
==Parameters==
<noinclude><translate></noinclude>Honors for which this is a prerequisite:<noinclude></translate></noinclude>
+
;honorname: This parameter specifies the name of the honor. If omitted, the template assumes the can be found as the second element of the page title invoking the template.
{{#tag:DynamicPageList|
+
 
category=Adventist Youth Honors Answer Book/Prerequisite/{{{1|}}}
+
This template is related to [[:Template:Honor prerequisite]] which is used as the answer to most requirements to earn some other honor. That template will add whatever invokes it to <nowiki>[[</nowiki>Category:AY Honors/See Also/''honor'']], where ''honor'' is the prerequisite. Every honor in that category has ''honor'' as a prerequisite or is related to ''honor'' in some other way (such as being the adjacent in a series. This template merely lists all the honors in that category to indicate that once you've earned this one, you're partway to earning another.
category=Adventist Youth Honors Answer Book/Honors
+
 
notcategory=Adventist Youth Honors Answer Book/Secondary
+
==Example==
order=ascending
+
<div class="toccolours">
namespace=0
+
:<nowiki>{{</nowiki>See Also|honorname=Camping Skills IV}} &rarr;{{See Also|honorname=Camping Skills IV}}
suppresserrors = true
+
:<nowiki>{{</nowiki>See Also|honorname=Basic Water Safety}} &rarr;{{See Also|honorname=Basic Water Safety}}
}}
+
:<nowiki>{{</nowiki>See Also|honorname=Tumbling & Balancing}} &rarr;{{See Also|honorname=Tumbling & Balancing}}
 +
:<nowiki>{{</nowiki>See Also|honorname=Edible Wild Plants}} &rarr;{{See Also|honorname=Edible Wild Plants}}
 +
 
 
</div>
 
</div>
</div>
 
}}
 
<noinclude>
 
This template is used by [[:Template:Honor_desc]] to build the honor prerequisite list.
 
  
Use:<br/>
+
==Mechanics==
<nowiki>{{See Also|pagename}}</nowiki>
+
First define a variable for honorname. If the honorname parameter is specified, it gets used. Otherwise, it extracts the honorname from the second element of the page title.
 +
 
 +
Next define the honor category honcat. We're looking for the category AY_Honors/See_Also/''honorname''/language. The honor specified by honorname is related to every honor in this category, such as if it is a prerequisite, or if it is adjacent in a series.
 +
 
 +
Then define an IA category. This honor is related to the IA pages in the category AY_Honors/Prerequisite_IA/''honorname''/language.
 +
 
 +
If honcat has any pages in it, we create a variable dplList, which is the output of a dpl query.
 +
We then enter a loop, converting the list of dpl hist into dplItems, formatted into a link with the translated honorname as the link display.
 +
 
 +
This is repeated for iacat.
 +
 
 +
Of special note is that the dpl is using categorymatch instead of category. The reason for this is because category can specify multiple categories using the "&" character as a delimiter, and some honornames (I'm looking at you Tumbling & Balancing) have & in them. This has tragic consequences for dpl's category specifier. The categorymatch specifier is very much like category, except that it can use % as a wildcard - using the same format as an SQL LIKE statement. If there are no % wildcards, then it's largely the same as category, except that categorymatch does not recognize & as a delimiter.
  
Where page name is the name of the Honor that serves as the primary version of any variants (such as translations, or regional variants, etc).
+
That bug took half a week to track down and slay.
  
Translations of this page only need to change the display text (which is marked off by &lt;translate> tags).  Translations of the honor_desc template (which calls this) should append "/langcode" (such as "/es") to the argument passed to this template.
+
</noinclude><includeonly>{{#vardefine:honorname|{{{honorname|{{#titleparts:{{PAGENAME}}|1|2}} }}} }}{{#vardefine:honcat|AY Honors/See Also/{{#var:honorname}}{{GetLangSuffix}}}}{{#vardefine:iacat|AY Honors/Prerequisite IA/{{#var:honorname}}{{GetLangSuffix}}}}{{#vardefine:honcatsize|{{PAGESINCATEGORY:{{#var:honcat}}}}}}{{#if:{{#var:honcatsize}}
</noinclude>
+
    |{{#vardefine:dplList
 +
                  |{{#dpl:format=,%PAGE%,%{{!}}%
 +
                        |categorymatch={{#replace:{{#var:honcat}}|&|%}}
 +
                        |notcategory=AY Honors/Secondary
 +
                        |ordermethod=sortkey
 +
                        |debug=0
 +
                  }}
 +
      }}{{#loop:index
 +
              |0
 +
              |{{#var:honcatsize}}
 +
              |{{#vardefine:dplItem|{{#explode:{{#var:dplList}}|%{{!}}%|{{#var:index}}}}}}
 +
                {{#if:{{#var:dplItem}}
 +
                    |[[{{#titleparts:{{#var:dplItem}}|2}}{{!}}{{GetHonorName|page={{#var:dplItem}}}}]]%{{!}}%}}}}}}{{#vardefine:iacatsize|{{PAGESINCATEGORY:{{#var:iacat}}}}}}{{#if:{{#var:iacatsize}}
 +
    |{{#vardefine:dplList
 +
                  |{{#dpl:format=,%PAGE%,%{{!}}%
 +
                        |categorymatch={{#replace:{{#var:iacat}}|&|%}}
 +
                        |notcategory=AY Honors/Secondary
 +
                        |ordermethod=sortkey
 +
                        |debug=0
 +
                  }}
 +
      }}{{#loop:index
 +
              |0
 +
              |{{#var:iacatsize}}
 +
              |{{#vardefine:dplItem|{{#explode:{{#var:dplList}}|%{{!}}%|{{#var:index}}}}}}
 +
                {{#if:{{#var:dplItem}}
 +
                    |[[{{#titleparts:{{#var:dplItem}}|2}}{{!}}{{GetHonorName|page={{#var:dplItem}}}}]]%{{!}}%}}}}}}{{#if:{{{debug|}}}
 +
|<li>dplList={{#var:dplList}}</li>
 +
<li>honcat={{#var:honcat}}</li>
 +
}}</includeonly>

Latest revision as of 16:12, 7 October 2022

Displays a list of all the honors tagged as a "See Also" for which the specified honor. This includes all pages for which it is listed as a prerequisite, as well as any that are adjacent in a series labelled with Roman numerals. Every Honor-Link is separated by "%|%".

Parameters

honorname
This parameter specifies the name of the honor. If omitted, the template assumes the can be found as the second element of the page title invoking the template.

This template is related to Template:Honor prerequisite which is used as the answer to most requirements to earn some other honor. That template will add whatever invokes it to [[Category:AY Honors/See Also/honor]], where honor is the prerequisite. Every honor in that category has honor as a prerequisite or is related to honor in some other way (such as being the adjacent in a series. This template merely lists all the honors in that category to indicate that once you've earned this one, you're partway to earning another.

Example

{{See Also|honorname=Camping Skills IV}} →Camp Safety - Advanced%|%Outdoor Leadership%|%Camping Skills III%|%
{{See Also|honorname=Basic Water Safety}} →Swimming - Beginner%|%
{{See Also|honorname=Tumbling & Balancing}} →Tumbling & Balancing - Advanced%|%
{{See Also|honorname=Edible Wild Plants}} →Wilderness Leadership - Advanced%|%[[Investiture Achievement/Voyager|]]%|%

Mechanics

First define a variable for honorname. If the honorname parameter is specified, it gets used. Otherwise, it extracts the honorname from the second element of the page title.

Next define the honor category honcat. We're looking for the category AY_Honors/See_Also/honorname/language. The honor specified by honorname is related to every honor in this category, such as if it is a prerequisite, or if it is adjacent in a series.

Then define an IA category. This honor is related to the IA pages in the category AY_Honors/Prerequisite_IA/honorname/language.

If honcat has any pages in it, we create a variable dplList, which is the output of a dpl query. We then enter a loop, converting the list of dpl hist into dplItems, formatted into a link with the translated honorname as the link display.

This is repeated for iacat.

Of special note is that the dpl is using categorymatch instead of category. The reason for this is because category can specify multiple categories using the "&" character as a delimiter, and some honornames (I'm looking at you Tumbling & Balancing) have & in them. This has tragic consequences for dpl's category specifier. The categorymatch specifier is very much like category, except that it can use % as a wildcard - using the same format as an SQL LIKE statement. If there are no % wildcards, then it's largely the same as category, except that categorymatch does not recognize & as a delimiter.

That bug took half a week to track down and slay.