Template:Preview Only Infobox: Difference between revisions
m (expanded step by step guide to include the "turning off" of the command paramter. formatting changes also.) |
m (rewording and reordering of steps 3 and 4) |
||
| Line 48: | Line 48: | ||
}}--> | }}--> | ||
'''Step 1:''' Create a new sub-page of the template in question. As our example: [[:Template:Used In/Help]]<br><br> | '''Step 1:''' Create a new sub-page of the template in question. As our example: [[:Template:Used In/Help]]<br><br> | ||
'''Step 2:''' Paste the below code onto the page. Ensure to tailor the code to your template ie. replace "Template Name" with the required template name, include parameters, | '''Step 2:''' Paste the below code onto the page. Ensure to tailor the code to your template ie. replace "Template Name" with the required template name, include the associated parameters, etc.<br><br> | ||
Unfortunately the <nowiki><pre></pre></nowiki> tags cannot be displayed correctly due to the nature of how they work. When copy and pasting this section, manually close out the second <nowiki></pre></nowiki> tag for both the "boilerplate" and "help" sections. | Unfortunately the <nowiki><pre></pre></nowiki> tags cannot be displayed correctly due to the nature of how they work. When copy and pasting this section, manually close out the second <nowiki></pre></nowiki> tag for both the "boilerplate" and "help" sections. | ||
<pre><includeonly>{{#switch:{{lc:{{{1|}}}}}<!-- | <pre><includeonly>{{#switch:{{lc:{{{1|}}}}}<!-- | ||
| Line 78: | Line 78: | ||
</includeonly></pre><br> | </includeonly></pre><br> | ||
'''Step 3:''' Add the following code to the top of the template page in question. To continue our example, this would be on page [[:Template:Used In]]. | '''Step 3:''' Decide whether you would prefer the preview only infobox to display as default or when the editor "turns it on". The copied text from step 2 is set to display as default. To change this, change the <nowiki>#default</nowiki> line to the following: | ||
<pre>-->|#default = }}</pre><br> | |||
'''Step 4:''' Add the following code to the top of the original template page in question. To continue our example, this would be on page [[:Template:Used In]]. | |||
<pre><includeonly>{{Used In/Help|{{{1}}}}}</includeonly></pre><br> | <pre><includeonly>{{Used In/Help|{{{1}}}}}</includeonly></pre><br> | ||
'''Step 5:''' If your template page has documentation, it needs moving to its own sub-page. In our example, this would be moved to [[:Template:Used In/Documentation]]. This documentation then needs transcluding back onto the template page. To do this, use the code <nowiki>{{Template Name/Documentation}}</nowiki>. If this step isn't completed, the command "fd" sadly won't work.<br> | |||
'''Step 5:''' If your template page has documentation, it needs moving to its own sub-page. In our example, this would be moved to [[:Template:Used In/Documentation]]. This documentation then needs transcluding back onto the template page. To do this, use the code <nowiki>{{Template Name/Documentation}}</nowiki>. If this step isn't completed, the | |||
'''Step 6:''' Test that it works! The following commands will appear when you type the code <nowiki>{{Template Name|}}</nowiki> on any page. | '''Step 6:''' Test that it works! The following commands will appear when you type the code <nowiki>{{Template Name|}}</nowiki> on any page. | ||
{{#section:Template:Preview Only Infobox/Default|commands}} | {{#section:Template:Preview Only Infobox/Default|commands}} | ||
Revision as of 09:46, 11 September 2024
Usage
This template was originally designed to provide help and support to editors when viewing a page in "preview mode". It's since been expanded upon and now provides several different versions of preview mode assistance that will hopefully help editors even further. To see a full list of existing template with this feature, please see this page. If you would like to add this feature to a template, follow the stepw below.
Step 1: Create a new sub-page of the template in question. As our example: Template:Used In/Help
Step 2: Paste the below code onto the page. Ensure to tailor the code to your template ie. replace "Template Name" with the required template name, include the associated parameters, etc.
Unfortunately the <pre></pre> tags cannot be displayed correctly due to the nature of how they work. When copy and pasting this section, manually close out the second </pre> tag for both the "boilerplate" and "help" sections.
<includeonly>{{#switch:{{lc:{{{1|}}}}}<!--
-->|nc|no categories = <!--
-->|bp|boilerplate =
{{Preview Only Infobox|These parameters are the ones most commmonly used for the Horizon server.
<pre>{{Template Name
| = add as many parameters as required
}}<pre>|disable={{{1|}}}}}<!--
-->|help =
{{Preview Only Infobox|
<pre>{{Template Name
| parameter = {short explanation on how each one should be filled out}
}}<pre>|disable={{{1|}}}}}<!--
-->|fd = {{Preview Only Infobox|{{Template:Name/Documentation}}
|disable={{{1|}}}}}<!--
-->|nd|no documentation = <!--
-->|list = {{Preview Only Infobox|{{Preview Only Infobox/List}}
|disable={{{1|}}}}}<!--
-->|command|commands = {{Preview Only Infobox|{{Preview Only Infobox/Default}}}}<!--
-->|#default = {{Preview Only Infobox|{{Preview Only Infobox/Default}}}}}}
</includeonly>
Step 3: Decide whether you would prefer the preview only infobox to display as default or when the editor "turns it on". The copied text from step 2 is set to display as default. To change this, change the #default line to the following:
-->|#default = }}
Step 4: Add the following code to the top of the original template page in question. To continue our example, this would be on page Template:Used In.
<includeonly>{{Used In/Help|{{{1}}}}}</includeonly>
Step 5: If your template page has documentation, it needs moving to its own sub-page. In our example, this would be moved to Template:Used In/Documentation. This documentation then needs transcluding back onto the template page. To do this, use the code {{Template Name/Documentation}}. If this step isn't completed, the command "fd" sadly won't work.
Step 6: Test that it works! The following commands will appear when you type the code {{Template Name|}} on any page.
- {{Template Name|bp: displays a boilerplate of this template.
- {{Template Name|command: dislays this list of available commands.
- {{Template Name|fd: provides the template's full documentation.
- {{Template Name|help: displays parameter help.
- {{Template Name|list: generates a list of all templates that have preview window assistance.
- {{Template Name|nd: removes this documentation.
