Actions

Template

Difference between revisions of "Text CatGeneral/doc"

From The RadioReference Wiki

< Template:Text CatGeneral
m
Line 3: Line 3:
 
====Purpose====
 
====Purpose====
 
*'''[[:Template:Text_CatGeneral]]''' is designed to be a single-source text-template that provides a common and uniform structure for the text that is displayed in the mid-sections of both '''[[:Template:Text_CatStateOther]]''' and '''[[:Template:Text_CatStateOtherFreq]]'''.   
 
*'''[[:Template:Text_CatGeneral]]''' is designed to be a single-source text-template that provides a common and uniform structure for the text that is displayed in the mid-sections of both '''[[:Template:Text_CatStateOther]]''' and '''[[:Template:Text_CatStateOtherFreq]]'''.   
*Variables listed below allow the default message to be shown or hidden, and/or custom-messages to be displayed when provided.
+
*Parameters listed below allow the default message to be shown or hidden, and/or custom-messages to be displayed when provided.
 
*The default message is intended for frequencies-related categories, and contains instructions about submitting information to the Frequency Database.
 
*The default message is intended for frequencies-related categories, and contains instructions about submitting information to the Frequency Database.
  
Line 13: Line 13:
  
  
===Variables===
+
===Parameters===
 
*Specified values will override default values.
 
*Specified values will override default values.
*Specified values, Default values, and Variable Names are all case-sensitive.
+
*Specified values, Default values, and Parameter Names are all case-sensitive.
  
 
{| {{table}} width="100%"
 
{| {{table}} width="100%"
 
|- bgcolor="lightgrey" |  
 
|- bgcolor="lightgrey" |  
! Variable Name !! Var Description !! Expected&nbsp;Value(s) !! Default Value !! Notes
+
! Parameter Name !! Var Description !! Expected&nbsp;Value(s) !! Default Value !! Notes
 
|-
 
|-
 
| '''HideFreqText''' || ||
 
| '''HideFreqText''' || ||
Line 25: Line 25:
 
*or specified with no value  
 
*or specified with no value  
 
||unspecified ||  
 
||unspecified ||  
* When unspecified, the default message displays (and will be above any custom message specified by the MoreText variable).<br/>
+
* When unspecified, the default message displays (and will be above any custom message specified by the MoreText parameter).<br/>
 
*When specified with no value, the default message is hidden.<br/>
 
*When specified with no value, the default message is hidden.<br/>
 
----
 
----
Line 32: Line 32:
  
 
----
 
----
*'''''{{Color|red|Caution}}:''''' '''Please do not specify an actual value for this variable''', as the results will be beyond the designs of both this template and the templates that are expected to invoke this template.
+
*'''''{{Color|red|Caution}}:''''' '''Please do not specify an actual value for this parameter''', as the results will be beyond the designs of both this template and the templates that are expected to invoke this template.
 
|-
 
|-
 
| '''MoreText''' || ||
 
| '''MoreText''' || ||
Line 38: Line 38:
 
*or specified with a custom-message
 
*or specified with a custom-message
 
|| unspecified ||
 
|| unspecified ||
*When unspecified, this variable is hidden.<br/>
+
*When unspecified, this parameter is hidden.<br/>
*When specified, any custom message assigned to this variable will be displayed.  If the default message is not hidden (using the HideFreqText variable), then the default message will be displayed above the custom message.
+
*When specified, any custom message assigned to this parameter will be displayed.  If the default message is not hidden (using the HideFreqText parameter), then the default message will be displayed above the custom message.
 
----
 
----
 
*'''[[:Template:Text_CatStateOther]]''' allows a custom message via MoreText.
 
*'''[[:Template:Text_CatStateOther]]''' allows a custom message via MoreText.

Revision as of 17:15, 12 September 2015

Documentation Sub-page for Template:Text_CatGeneral

Scope of Use

Purpose

  • Template:Text_CatGeneral is designed to be a single-source text-template that provides a common and uniform structure for the text that is displayed in the mid-sections of both Template:Text_CatStateOther and Template:Text_CatStateOtherFreq.
  • Parameters listed below allow the default message to be shown or hidden, and/or custom-messages to be displayed when provided.
  • The default message is intended for frequencies-related categories, and contains instructions about submitting information to the Frequency Database.

Directly Invoked By

Not Intended For


Parameters

  • Specified values will override default values.
  • Specified values, Default values, and Parameter Names are all case-sensitive.
Parameter Name Var Description Expected Value(s) Default Value Notes
HideFreqText
  • either unspecified
  • or specified with no value
unspecified
  • When unspecified, the default message displays (and will be above any custom message specified by the MoreText parameter).
  • When specified with no value, the default message is hidden.


  • Caution: Please do not specify an actual value for this parameter, as the results will be beyond the designs of both this template and the templates that are expected to invoke this template.
MoreText
  • either unspecified
  • or specified with a custom-message
unspecified
  • When unspecified, this parameter is hidden.
  • When specified, any custom message assigned to this parameter will be displayed. If the default message is not hidden (using the HideFreqText parameter), then the default message will be displayed above the custom message.

Examples

  • The horizontal lines below separate examples for clarity and do not appear when template is invoked.


How to invoke this template to show only the default message

  • {{Text_CatGeneral}}

Result

In general, data in any Wiki article:

  • should be used to supplement the data in our Frequency Database.
  • may not be accurate. Members are encouraged to listen and validate it, and to edit the articles.


The data in the articles listed below:

  • should not be submitted to the data base team until the data have been validated.
    • Please read RR Database Submission Guidelines before submitting validated data to the Frequency Database.
    • Please read Wiki Extensions to learn how to incorporate Database-data into a Wiki page.
    • Please use tables if there are more than a couple lines of data.
      • This enables several applications to capture this data, copy it into Windows clipboard, and from there to your scanner programming software. This helps to avoid a large amount of tedious (and error prone) manual typing and copying. See the Applications that can copy Frequency Data from the Wiki article for more information.




How to invoke this template to show both default and custom messages

  • {{Text_CatGeneral|MoreText=<br/><br/>This is a custom message.}}

Result

In general, data in any Wiki article:

  • should be used to supplement the data in our Frequency Database.
  • may not be accurate. Members are encouraged to listen and validate it, and to edit the articles.


The data in the articles listed below:

  • should not be submitted to the data base team until the data have been validated.
    • Please read RR Database Submission Guidelines before submitting validated data to the Frequency Database.
    • Please read Wiki Extensions to learn how to incorporate Database-data into a Wiki page.
    • Please use tables if there are more than a couple lines of data.
      • This enables several applications to capture this data, copy it into Windows clipboard, and from there to your scanner programming software. This helps to avoid a large amount of tedious (and error prone) manual typing and copying. See the Applications that can copy Frequency Data from the Wiki article for more information.



This is a custom message.



How to invoke this template to show only a custom message

  • {{Text_CatGeneral|HideFreqText=|MoreText=<br/><br/>This is a custom message.}}

Result

In general, data in any Wiki article:

  • should be used to supplement the data in our Frequency Database.
  • may not be accurate. Members are encouraged to listen and validate it, and to edit the articles.




This is a custom message.



How to invoke this template to show neither the default nor a custom message

  • {{Text_CatGeneral|HideFreqText=|MoreText=|}}

Result

In general, data in any Wiki article:

  • should be used to supplement the data in our Frequency Database.
  • may not be accurate. Members are encouraged to listen and validate it, and to edit the articles.







Return to: Template:Text_CatGeneral