Difference between revisions of "Help:Add new Honor Variant"
DesignerThan (talk | contribs) m (DesignerThan moved page AY Honors/Postcards (Other)/Answer Key to Help:Add new Honor Variant without leaving a redirect) |
DesignerThan (talk | contribs) |
||
Line 1: | Line 1: | ||
<translate> | <translate> | ||
+ | ==How to add Honor Variants== | ||
+ | There are two different types of honor variants. Answer Key Variants and Requirement Variants. | ||
+ | The way of creating them is the same for both. | ||
+ | # Open the landing page of the honor where you want to add a variant. | ||
+ | # Go into the Edit view. | ||
+ | # Add the property with the information of the wanted variant and increment the count of the variants. | ||
+ | # Save the changes. Now the added Variant should appear in the dropdown, over which it is possible to create the needed pages. | ||
+ | |||
+ | ==Requirement Variant specific information== | ||
+ | Requirement Variants are used for honors, that have different requirements in different levels of our Organization. For example the North American Division has introduced an honor and later the General Conference adapts it, but changes some requirements, that the NAD doesn't want to use. That is where Requirement Variants come into play. | ||
+ | The are allowed to use for the following Authority Levels: | ||
+ | * General Conference | ||
+ | * Division Level | ||
+ | * Union Level | ||
+ | With the Requirement Variant the wiki will generate a link in the Requirements Tab but '''NOT''' one for the Answer Key Tab. | ||
+ | |||
+ | ===Properties of the Requirement Variant=== | ||
+ | <code>cnt_requirements_variants</code>: This is the count of the Requirement Variants. | ||
+ | <code>requirement_n</code>: This is the name of the Variant, it defines which text is used in the tab. You can find the possibilities here: [[Localization:Authorities]]. n needs to be incremented starting at 1. | ||
+ | |||
+ | ==Answer Key Variant specific information== | ||
+ | Answer Key Variants are needed for two reasons. One are the Requirement Variants and the other are honors that need Country/Region specific answers. | ||
+ | |||
+ | ===Properties of the Answer Key Variant=== | ||
+ | <code>cnt_answerKey_variants</code>: This is the count of the Answer Key Variants. | ||
+ | <code>answerKey_n</code>: Here we define the different informations that the Answer Key Variant needs. <code>country1;country2;;number of the requirement variant associated/source language code only needed in special cases</code> | ||
+ | :Here you can find the implemented Countries using the ID as propert. [[Localization:Countries]] Each country ID needs to be separated by a semicolon. | ||
+ | :The number of the Requirement Variant needs to be separated by two semicolons | ||
+ | :The source language code is only needed if the source language of the answer key page isn't english. | ||
+ | |||
+ | ==Examples== | ||
+ | These are some honors that have already different combinations of Variants so you can see on how it is done in practice. | ||
+ | * [[AY_Honors/Orienteering]] | ||
+ | * [[AY_Honors/Postcards]] | ||
+ | |||
+ | ==Additional information== | ||
You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following these steps: | You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following these steps: | ||
Line 14: | Line 50: | ||
#Add your answers below each instance of the ''<nowiki>{{</nowiki>ansreq=...}}'' text between the ''<nowiki><translate></nowiki>'' and ''<nowiki></translate></nowiki>'' tags. | #Add your answers below each instance of the ''<nowiki>{{</nowiki>ansreq=...}}'' text between the ''<nowiki><translate></nowiki>'' and ''<nowiki></translate></nowiki>'' tags. | ||
#If you need help drop a note in the [[Talk:AY Honors/Postcards (Other)/Answer Key|discussion page]]. Someone should get back to you in about a day. | #If you need help drop a note in the [[Talk:AY Honors/Postcards (Other)/Answer Key|discussion page]]. Someone should get back to you in about a day. | ||
+ | |||
+ | |||
</translate> | </translate> |
Revision as of 15:45, 6 July 2023
How to add Honor Variants
There are two different types of honor variants. Answer Key Variants and Requirement Variants. The way of creating them is the same for both.
- Open the landing page of the honor where you want to add a variant.
- Go into the Edit view.
- Add the property with the information of the wanted variant and increment the count of the variants.
- Save the changes. Now the added Variant should appear in the dropdown, over which it is possible to create the needed pages.
Requirement Variant specific information
Requirement Variants are used for honors, that have different requirements in different levels of our Organization. For example the North American Division has introduced an honor and later the General Conference adapts it, but changes some requirements, that the NAD doesn't want to use. That is where Requirement Variants come into play. The are allowed to use for the following Authority Levels:
- General Conference
- Division Level
- Union Level
With the Requirement Variant the wiki will generate a link in the Requirements Tab but NOT one for the Answer Key Tab.
Properties of the Requirement Variant
cnt_requirements_variants
: This is the count of the Requirement Variants.
requirement_n
: This is the name of the Variant, it defines which text is used in the tab. You can find the possibilities here: Localization:Authorities. n needs to be incremented starting at 1.
Answer Key Variant specific information
Answer Key Variants are needed for two reasons. One are the Requirement Variants and the other are honors that need Country/Region specific answers.
Properties of the Answer Key Variant
cnt_answerKey_variants
: This is the count of the Answer Key Variants.
answerKey_n
: Here we define the different informations that the Answer Key Variant needs. country1;country2;;number of the requirement variant associated/source language code only needed in special cases
- Here you can find the implemented Countries using the ID as propert. Localization:Countries Each country ID needs to be separated by a semicolon.
- The number of the Requirement Variant needs to be separated by two semicolons
- The source language code is only needed if the source language of the answer key page isn't english.
Examples
These are some honors that have already different combinations of Variants so you can see on how it is done in practice.
Additional information
You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following these steps:
- Edit the https://wiki.pathfindersonline.org/index.php?title=AY_Honors/Postcards&action=edit page by clicking this link (it's best to open this in another tab so you can continue reading these instructions).
- Near the top of the page you should find the list of countries listed as answer_variants=.... Add your country here (please maintain alphabetic ordering). Make sure you do not put a space between the two semicolons (;;) and the country name.
- Save the page, and click the Answer Key dropdown. Your country should appear. Click it.
- This will take you to a non-existant page. Click the create page link.
- Enter the text below to add all the formatting and requirements:
{{subst::AY Honors/Postcards (Template)/Answer Key}}
- Save the page.
- Open the page for editing again (see the pencil icon at the top right).
- Add your answers below each instance of the {{ansreq=...}} text between the <translate> and </translate> tags.
- If you need help drop a note in the discussion page. Someone should get back to you in about a day.