Template:Glossary item/doc View history

m (→‎Parameters: added noanchor=yes to param list)
Line 35: Line 35:


{{Para|anchor4|<fourth non-displayed anchor name>}}
{{Para|anchor4|<fourth non-displayed anchor name>}}
{{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|description}} {{red|*}}Glossary term description.
{{Para|description}} {{red|*}}Glossary term description.

Revision as of 21:57, 13 February 2015

This is a documentation subpage for Template:Glossary item.
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 under 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.

|related2=<second exact Term Name>

|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 links at the bottom 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>

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

  1. REDIRECT Glossary/Glossary item
  2. REDIRECT Glossary/Glossary item
  3. REDIRECT Glossary/Glossary item
  4. REDIRECT Glossary/Glossary item



{{/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

  1. REDIRECT Glossary/Glossary item

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

  1. REDIRECT Glossary/Glossary item

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)