Difference between revisions of "Help:Add new Honor"

From Pathfinder Wiki
Line 62: Line 62:
  
 
Next one needs to define the requirement that is the challenging part of the honor. That is again done by using the section-tags using the section name "challenge". In the example that would be the N-th requirement.
 
Next one needs to define the requirement that is the challenging part of the honor. That is again done by using the section-tags using the section name "challenge". In the example that would be the N-th requirement.
 +
 +
== Create the Answer Key's Page ==
 +
As for the Requirements page, open the honors landing page and click on the answer key page, to create it. The following code is the template for the new page.
 +
 +
<syntaxhighlight lang="html+handlebars" style="overflow:auto">
 +
{{HonorSubpage}}
 +
 +
<section begin="Body" />
 +
{{ansreq|page={{#titleparts:{{PAGENAME}}|2|1}}|num=1}}
 +
<noinclude><translate>
 +
</noinclude>
 +
<!-- The text of the first requirement, helps to know what it is about. -->
 +
The answer of the first requirement
 +
 +
<noinclude></translate></noinclude>
 +
{{CloseReq}}
 +
{{ansreq|page={{#titleparts:{{PAGENAME}}|2|1}}|num=N}}
 +
<noinclude><translate>
 +
</noinclude>
 +
<!-- The text of the N-th requirement, helps to know what it is about. -->
 +
The answer of the N-th requirement.
 +
 +
<noinclude></translate></noinclude>
 +
{{CloseReq}}
 +
 +
<section end="Body" />
 +
{{CloseHonorPage}}
 +
</syntaxhighlight >
 +
 +
The page needs to start with the Template-Call of [[Template:HonorSubpage|HonorSubpage]]. It generates the Honor-Navigation, Language Switcher, the Infobox and the basic page structure. At the end of the page, the Template [[Template:CloseHonorPage|CloseHonorPage]] needs to be called, to close the HTML-Page-Structure. Between the two Templage calls the <code><section begin=Body /></code>-Tag and the <code><section end=Body /></code>-Tag is needed. The section-tags enable the wiki, to include the enclosed content, on other pages, by the name of the section. Each section name, needs to be unique on the page.
 +
 +
To create the answer-section for a requirement, the [[Template:ansreq|ansreq-template]] needs to be called with the <code>num</code>-Argument set to the number of the wanted requirement. After that the opening translate-tag is needed, surrounded by noinclude-tags. For the readability it is common to add the text of the requirement inside of an HTML Comment after that. Now the answer can be written.
 +
After the answer the closing translate-tag needs to be added, again surrounded by noinclude-tags. Then the [[Template:CloseReq|CloseReq]]-Template needs to be called.
 +
 +
This section needs to be repeated as long as there are requirements. If there are sub-requirements just add a requirement section, where the answer goes.

Revision as of 15:02, 3 October 2023

Here you'll find a guide on how to add a new honor to the wiki. To know which pages are important for an honor, read the section about the Structure of an Honor.

Create the Honor Landing Page

That is the first page that need's to be created. It has the following structure: The Honor Navigation, followed by an Overview and the Challenging-Part-Section. On the right side it has the infobox that is displaying the most important information about an honor.

Source Code wise it has the following structure: Template call of HonorLanding followed by the Overview and the Challenging-Part-Section. The content ends with a call of the CloseHonorPage-Template Use the following code as a starting point and set the needed arguments of the HonorLanding Template, they are described in the documentation of the template, and write an awesome overview. Then the Landing Page should be finished.

{{HonorLanding
|skill=2
|year=Unknown
|category=Regional
|authority=Florida Conference
|insignia=Scrapbooking (FL) AY Honor.png
|insignia_source=FL
|primary=AY Honors/Scrapbooking
}} 

== {{Localize|Overview}}==
WRITE AN AWESOME OVERVIEW HERE :)

== {{Localize|The Challenging Part}} ==
{{Localize|Challenging Part}}

{{#lst:{{#titleparts:{{PAGENAME}}|2|1}}/Requirements{{GetLangSuffix}} |challenge}}
{{CloseHonorPage}}

Create the Requirements Page

To create the requirement page, just use the link to the requirements page on the newly created honor landing page. Use the following code as a template for the requirements page.

{{HonorSubpage}}

<section begin=Body />

<b>1. <section begin=req1 /><noinclude></noinclude>The first Requirement of this honor.
<noinclude></noinclude><section end=req1 /></b>

<section begin=challenge />
<b>N. <section begin=reqN /><noinclude></noinclude>The N-th Requirement of this honor
<noinclude></noinclude><section end=reqN /></b>
<section end=challenge />

<section end=Body />

{{CloseHonorPage}}

The page needs to start with the Template-Call of HonorSubpage. It generates the Honor-Navigation, Language Switcher, the Infobox and the basic page structure. At the end of the page, the Template CloseHonorPage needs to be called, to close the HTML-Page-Structure. Between the two Templage calls the -Tag and the -Tag is needed. The section-tags enable the wiki, to include the enclosed content, on other pages, by the name of the section. Each section name, needs to be unique on the page.

The requirements are also enclosed by section-tags. The names of these start with "req", followed by the requirement number. Between the section-tags the translate-tags need to be opened and closed. That they aren't included on other pages they need to be surrounded by noinclude-tags. For the sake of styling the whole requirement is surrounded by the b-tags, those make the text bold.

Next one needs to define the requirement that is the challenging part of the honor. That is again done by using the section-tags using the section name "challenge". In the example that would be the N-th requirement.

Create the Answer Key's Page

As for the Requirements page, open the honors landing page and click on the answer key page, to create it. The following code is the template for the new page.

{{HonorSubpage}}

<section begin="Body" />
{{ansreq|page={{#titleparts:{{PAGENAME}}|2|1}}|num=1}}
<noinclude></noinclude>
<!-- The text of the first requirement, helps to know what it is about. -->
The answer of the first requirement

<noinclude></noinclude>
{{CloseReq}}
{{ansreq|page={{#titleparts:{{PAGENAME}}|2|1}}|num=N}}
<noinclude></noinclude>
<!-- The text of the N-th requirement, helps to know what it is about. -->
The answer of the N-th requirement.

<noinclude></noinclude>
{{CloseReq}}

<section end="Body" />
{{CloseHonorPage}}

The page needs to start with the Template-Call of HonorSubpage. It generates the Honor-Navigation, Language Switcher, the Infobox and the basic page structure. At the end of the page, the Template CloseHonorPage needs to be called, to close the HTML-Page-Structure. Between the two Templage calls the -Tag and the -Tag is needed. The section-tags enable the wiki, to include the enclosed content, on other pages, by the name of the section. Each section name, needs to be unique on the page.

To create the answer-section for a requirement, the ansreq-template needs to be called with the num-Argument set to the number of the wanted requirement. After that the opening translate-tag is needed, surrounded by noinclude-tags. For the readability it is common to add the text of the requirement inside of an HTML Comment after that. Now the answer can be written. After the answer the closing translate-tag needs to be added, again surrounded by noinclude-tags. Then the CloseReq-Template needs to be called.

This section needs to be repeated as long as there are requirements. If there are sub-requirements just add a requirement section, where the answer goes.