m (→Parameters: typo) |
m (→Parameters: added new params noanchor1-4) |
||
(8 intermediate revisions by the same user not shown) | |||
Line 16: | Line 16: | ||
===Parameters=== | ===Parameters=== | ||
A star (*) next a parameter shows it is required for proper use. | A star ({{red|*}}) next a parameter shows it is required for proper use. | ||
{{Para|term}} * | {{Para|term}} {{red|*}}Glossary term | ||
{{Para||<abbreviation/alias>}} | {{Para||<abbreviation/alias>}} There can be up to 4 abbreviations/aliases as unnamed parameters. Just add the abbreviation in ALL CAPS, or the alias preceded by a pipe (|) character. | ||
{{Para||<2nd abbreviation/alias>}} | {{Para||<2nd abbreviation/alias>}} | ||
Line 36: | Line 36: | ||
{{Para|anchor4|<fourth non-displayed anchor name>}} | {{Para|anchor4|<fourth non-displayed anchor name>}} | ||
{{Para| | {{Para|noanchor|yes}} Putting this parameter in the entry template will prevent this entry from generating any anchors based on the term name or abbreviations/aliases. | ||
{{Para| | {{Para|description}} {{red|*}}Glossary term description. | ||
{{Para| | {{Para|updated}} {{red|*}}The date this entry was last updated. Use the YYYY-MM-DD format. | ||
=== | {{Para|added}} The date this entry was first added to the glossary. Use the YYYY-MM-DD format. | ||
{{Para|related1|<The exact Term Name of a related entry which links to this entry>}} {{u|These are case sensitive, and must be spelled exactly correct to work.}} This will be displayed in a horizontal list above the description as a link. These should be placed in any entry which is linked to from the description of another entry. For example if the entry for "Angle" has links to "Junction Angle", "Roundabout Angle", "Turn Angle", and "Junction Angle Info", the a {{Para|related#|Angle}} parameter should be placed in each of those entries indicating that the "Angle" entry links to those entries. These are required to be in place in the corresponding entries for any {{Para|jump#}} links in other entries to work, they only work in pairs. Be sure you add a {{Para|jump#}} parameter to any corresponding entries when using this parameter. You can specify up to 20 entries using the {{Para|related1}} ... {{Para|related20}} parameters. This parameter must be defined, in order for the following 19 parameters to be activated. | |||
{{Para|related2|<second exact Term Name>}} These 19 following parameters are only available if {{Para|related1}} is set. | |||
{{Para|related3|<third exact Term Name>}} | |||
... | |||
{{Para|related20|<twentieth exact Term Name>}} | |||
{{Para|jump1|<The exact Term Name of a related entry which this entry links to>}} {{u|These are case sensitive, and must be spelled exactly correct to work.}} This will be displayed after the "Related Entries" links at the top of the description. They are displayed simply as a ^ which jumps back to the related entry when clicked on. These are required to be in place in the corresponding entries for any {{Para|related#}} links in other entries to work, they only work in pairs. Be sure you add a {{Para|related#}} parameter to any corresponding entries when using this parameter. In the above example of the "Angle" entry which links to the "Junction Angle", "Roundabout Angle", "Turn Angle", and "Junction Angle Info" entries, you would add {{Para|jump1|Junction Angle}} {{Para|jump2|Roundabout Angle}} {{Para|jump3|Turn Angle}} and {{Para|jump4|Junction Angle Info}} into the entry for "Angle". You can specify up to 4 entries using the {{Para|jump1}} ... {{Para|jump4}} parameters. | |||
{{Para|jump2|<second exact Term Name>}} | |||
{{Para|jump3|<second exact Term Name>}} | |||
{{Para|jump4|<second exact Term Name>}} | |||
{{Para|noanchor1|yes}} Prevents the first unnamed parameter from being added to the anchor. | |||
{{Para|noanchor2|yes}} Prevents the second unnamed parameter from being added to the anchor. | |||
{{Para|noanchor3|yes}} Prevents the third unnamed parameter from being added to the anchor. | |||
{{Para|noanchor4|yes}} Prevents the fourth unnamed parameter from being added to the anchor. | |||
===Examples=== | |||
<code><nowiki>{{</nowiki>/Glossary item<br /> | <code><nowiki>{{</nowiki>/Glossary item<br /> | ||
|term = Entry | |term = Entry title<br /> | ||
| ET<br /> | | ET<br /> | ||
| Title<br /> | | Title<br /> | ||
| Entry<br /> | | Entry<br /> | ||
| Fourth<br/> | | Fourth<br/> | ||
|desc = Here you put the definition and links to further information I.e. disambiguation pages and articles etc.<br /> | |desc = Here you put the definition and links to further information I.e. disambiguation pages and articles etc. This row include a link to the [[#Table|Table]] entry.<br /> | ||
|related1 = Glossary<br /> | |||
|related2 = Template<br /> | |||
|jump1 = Table<br /> | |||
|updated = 2015-01-25<br /> | |updated = 2015-01-25<br /> | ||
|added = 2014-02-13<nowiki>}}</nowiki></code><br /> | |||
<br /> | |||
<code><nowiki>{{</nowiki>/Glossary item<br /> | |||
|term = Glossary<br /> | |||
|desc = This is an entry describing the Glossary concept, and includes a link to the [[#Entry title|Entry title]] entry.<br /> | |||
|jump1 = Entry title<br /> | |||
|updated = 2015-02-13<br /> | |||
|added = 2014-02-13<nowiki>}}</nowiki></code><br /> | |||
<br /> | |||
<code><nowiki>{{</nowiki>/Glossary item<br /> | |||
|term = Template<br /> | |||
|desc = This is an entry describing templates, and includes a link to the [[#Entry title|Entry title]] entry as a template example.<br /> | |||
|jump1 = Entry title<br /> | |||
|updated = 2015-02-13<br /> | |||
|added = 2014-02-13<nowiki>}}</nowiki></code><br /> | |||
<br /> | |||
<code><nowiki>{{</nowiki>/Glossary item<br /> | |||
|term = Table<br /> | |||
|desc = This is an entry describing tables, and is linked to from the [[#Entry title|Entry title]] entry template.<br /> | |||
|related1 = Entry title<br /> | |||
|updated = 2015-02-13<br /> | |||
|added = 2014-02-13<nowiki>}}</nowiki></code> | |added = 2014-02-13<nowiki>}}</nowiki></code> | ||
Line 62: | Line 114: | ||
Date Added</small> | Date Added</small> | ||
{{User:PesachZ/Glossary/Glossary item | {{User:PesachZ/Glossary/Glossary item | ||
|term = Entry | |term = Entry title | ||
| ET | | ET | ||
| Title | | Title | ||
| Entry | | Entry | ||
| Fourth | | Fourth | ||
|desc = Here you put the definition and links to further information I.e. disambiguation pages and articles etc. | |desc = Here you put the definition and links to further information I.e. disambiguation pages and articles etc. This row include a link to the [[#Table|Table]] entry. | ||
|related1 = Glossary | |||
|related2 = Template | |||
|jump1 = Table | |||
|updated = 2015-01-25 | |updated = 2015-01-25 | ||
|added = 2014-02-13}} | |||
{{User:PesachZ/Glossary/Glossary item | |||
|term = Glossary | |||
|desc = This is an entry describing the Glossary concept, and includes a link to the [[#Entry title|Entry title]] entry. | |||
|jump1 = Entry title | |||
|updated = 2015-02-13 | |||
|added = 2014-02-13}} | |||
{{User:PesachZ/Glossary/Glossary item | |||
|term = Template | |||
|desc = This is an entry describing templates, and includes a link to the [[#Entry title|Entry title]] entry as a template example. | |||
|jump1 = Entry title | |||
|updated = 2015-02-13 | |||
|added = 2014-02-13}} | |||
{{User:PesachZ/Glossary/Glossary item | |||
|term = Table | |||
|desc = This is an entry describing tables, and is linked to from the [[#Entry title|Entry title]] entry template. | |||
|related1 = Entry title | |||
|updated = 2015-02-13 | |||
|added = 2014-02-13}} | |added = 2014-02-13}} | ||
|} | |} |
Latest revision as of 05:43, 9 October 2015
This is a documentation subpage for . It contains usage information, categories and other content that is not part of the original template page. |
This templates produces an entry for the glossary table. It should be added on a new line in the glossary page.
Add the new term in the correct place in the glossary by alphabetical order sorted by the term name.
Leave an empty line between each entry template.
The template has three required parameters, and the optional parameters. The term, description, and date last updated parameters are required. The four abbreviations / aliases, four non displayed anchor names, noanchor, and date added parameters are optional.
The template will produce a table row with the aliases in the second column separate by commas. It will also add an {{anchor}} for the term name, each of the aliases/abbreviations, and each of the specified non-display anchor names as well at the top of the table row.
If you do not want an anchor to be produced for a specific entry row, you can prevent it by specifying the |noanchor=yes
Parameters
A star (*) next a parameter shows it is required for proper use.
|term=
*Glossary term
|<abbreviation/alias>
There can be up to 4 abbreviations/aliases as unnamed parameters. Just add the abbreviation in ALL CAPS, or the alias preceded by a pipe (|) character.
|<2nd abbreviation/alias>
|<3rd abbreviation/alias>
|<4th abbreviation/alias>
|anchor1=<non-displayed anchor name>
|anchor2=<second non-displayed anchor name>
|anchor3=<third non-displayed anchor name>
|anchor4=<fourth non-displayed anchor name>
|noanchor=yes
Putting this parameter in the entry template will prevent this entry from generating any anchors based on the term name or abbreviations/aliases.
|description=
*Glossary term description.
|updated=
*The date this entry was last updated. Use the YYYY-MM-DD format.
|added=
The date this entry was first added to the glossary. Use the YYYY-MM-DD format.
|related1=<The exact Term Name of a related entry which links to this entry>
These are case sensitive, and must be spelled exactly correct to work. This will be displayed in a horizontal list above the description as a link. These should be placed in any entry which is linked to from the description of another entry. For example if the entry for "Angle" has links to "Junction Angle", "Roundabout Angle", "Turn Angle", and "Junction Angle Info", the a |related#=Angle
parameter should be placed in each of those entries indicating that the "Angle" entry links to those entries. These are required to be in place in the corresponding entries for any |jump#=
links in other entries to work, they only work in pairs. Be sure you add a |jump#=
parameter to any corresponding entries when using this parameter. You can specify up to 20 entries using the |related1=
... |related20=
parameters. This parameter must be defined, in order for the following 19 parameters to be activated.
|related2=<second exact Term Name>
These 19 following parameters are only available if |related1=
is set.
|related3=<third exact Term Name>
...
|related20=<twentieth exact Term Name>
|jump1=<The exact Term Name of a related entry which this entry links to>
These are case sensitive, and must be spelled exactly correct to work. This will be displayed after the "Related Entries" links at the top of the description. They are displayed simply as a ^ which jumps back to the related entry when clicked on. These are required to be in place in the corresponding entries for any |related#=
links in other entries to work, they only work in pairs. Be sure you add a |related#=
parameter to any corresponding entries when using this parameter. In the above example of the "Angle" entry which links to the "Junction Angle", "Roundabout Angle", "Turn Angle", and "Junction Angle Info" entries, you would add |jump1=Junction Angle
|jump2=Roundabout Angle
|jump3=Turn Angle
and |jump4=Junction Angle Info
into the entry for "Angle". You can specify up to 4 entries using the |jump1=
... |jump4=
parameters.
|jump2=<second exact Term Name>
|jump3=<second exact Term Name>
|jump4=<second exact Term Name>
|noanchor1=yes
Prevents the first unnamed parameter from being added to the anchor.
|noanchor2=yes
Prevents the second unnamed parameter from being added to the anchor.
|noanchor3=yes
Prevents the third unnamed parameter from being added to the anchor.
|noanchor4=yes
Prevents the fourth unnamed parameter from being added to the anchor.
Examples
{{/Glossary item
|term = Entry title
| ET
| Title
| Entry
| Fourth
|desc = Here you put the definition and links to further information I.e. disambiguation pages and articles etc. This row include a link to the Table entry.
|related1 = Glossary
|related2 = Template
|jump1 = Table
|updated = 2015-01-25
|added = 2014-02-13}}
{{/Glossary item
|term = Glossary
|desc = This is an entry describing the Glossary concept, and includes a link to the Entry title entry.
|jump1 = Entry title
|updated = 2015-02-13
|added = 2014-02-13}}
{{/Glossary item
|term = Template
|desc = This is an entry describing templates, and includes a link to the Entry title entry as a template example.
|jump1 = Entry title
|updated = 2015-02-13
|added = 2014-02-13}}
{{/Glossary item
|term = Table
|desc = This is an entry describing tables, and is linked to from the Entry title entry template.
|related1 = Entry title
|updated = 2015-02-13
|added = 2014-02-13}}
Produces ↓
Waze Glossary (With sortable entries!) | ||||
---|---|---|---|---|
Glossary Term | Abbreviation / Acronym | Description | Date Updated Date Added
|
{{/Glossary item
|term = Entry title
| ET
| Title
| Entry
| Fourth
| anchor1 = entry title
| anchor2 = Entry Title
| anchor3 = Entry titles
| anchor4 = Entry Titles
|desc = This entry like all default entries produces anchors for the term, all aliases, and non-displayed anchors. Therefore a link to #entry title, #Entry Title, #Entry titles, #Entry Titles will all come to this row. Since links only point to the first matching anchor on a page links to #Entry title, #ET, #Title, #Entry, or #Fourth will go to the first example.
|updated = 2015-01-25
|added = 2014-02-13}}
Produces ↓
Waze Glossary (With sortable entries!) | ||||
---|---|---|---|---|
Glossary Term | Abbreviation / Acronym | Description | Date Updated Date Added
|
again a table row visually identical to the one above, but this one also includes anchor for four common misspellings of the title. This can be used for backwards compatibility to previous glossary entry anchors. This is also got practice in sober cases to include common spelling variations.
{{/Glossary item
|term = No-Anchor title
| Noanchor
| Hidden
| NA
| NAT
|desc = This row displays identically to other rows but does not produces any anchors. A link to #No-Anchor title will not bring you to this entry.
|updated = 2015-02-08
|added = 2014-02-13
|noanchor = yes}}
Produces ↓
Waze Glossary (With sortable entries!) | ||||
---|---|---|---|---|
Glossary Term | Abbreviation / Acronym | Description | Date Updated Date Added
|
This method is great for entries which are actually just aliases linking to other entries. This helps appreciate the problem of multiple anchors for the same alias on the page shown in the previous example.
Future planned modifications
- an in page anchor search (pipe dream)