Template:Preview Only Infobox: Difference between revisions

From HorizonXI Wiki
m (preserving the previous examples, documentation and some old code that hopefully isn't needed any longer. if we start to have issues with errant categorisations then this code might be necessary.)
m (man I'm dumb. removed the template code! replaced)
Line 1: Line 1:
<onlyinclude><includeonly>{{#switch:{{{disable|}}}|no documentation|no doc|ncnd|ndnc|nd=|#default={{#if:{{REVISIONID}}||<div style="border: 4px #AA0000 solid;"><div style="margin: 4px; padding: 4px; text-align: center; font-weight: bold; color: #AA0000; font-size: 1.6em;">This Documentation is only visible in preview mode!</div>{{{1|}}}</div>}}}}</includeonly></onlyinclude>
==Usage==
==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 [[:Template:Preview Only Infobox/List|this page]]. If you would like to add this feature to a template, follow the stepw below.
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 [[:Template:Preview Only Infobox/List|this page]]. If you would like to add this feature to a template, follow the stepw below.
Line 42: Line 43:
{{#section:Template:Preview Only Infobox/Default|commands}}<!--
{{#section:Template:Preview Only Infobox/Default|commands}}<!--


preserving the orignially documentation and some hopefully unneeded code  
preserving the orignially documentation and some hopefully unneeded code.
 
<onlyinclude><includeonly>{{#switch:{{{disable|}}}|no documentation|no doc|ncnd|ndnc|nd=|#default={{#if:{{REVISIONID}}||<div style="border: 4px #AA0000 solid;"><div style="margin: 4px; padding: 4px; text-align: center; font-weight: bold; color: #AA0000; font-size: 1.6em;">This Documentation is only visible in preview mode!</div>{{{1|}}}</div>}}}}</includeonly></onlyinclude>
 


*'''First unnamed Parameter''' (optional): You can set the first unnamed parameter to:
*'''First unnamed Parameter''' (optional): You can set the first unnamed parameter to:

Revision as of 10:06, 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|}}}}}<!--

-->|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.