Template:Glossary item View history

Revision as of 19:08, 27 January 2015 by PesachZ (talk | contribs) (troubleshoot link using trim)
Documentation icon Template documentation[view] [edit] [history] [purge]

This template produces an entry for the automated glossary table system. It should be added on a new line in the glossary page by the caretakers of the Glossary database.

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. Used for duplicate abbrs. to allow the abbr. entry itself to be the target and list the possible expansions.

|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

Entry title ET, Title, Entry, Fourth
Template:1}&summary=Create%20glossary%20item%20redirect%20page&preload=User:PesachZ/Glossary/Glossary_item/Redirect&preloadparams%5b%5d=ET&preview=no Create redirect
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.
Glossary This is an entry describing the Glossary concept, and includes a link to the Entry title entry.
Template This is an entry describing templates, and includes a link to the Entry title entry as a template example.
Table This is an entry describing tables, and is linked to from the Entry title entry template.



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

Entry title ET, Title, Entry, Fourth
Template:1}&summary=Create%20glossary%20item%20redirect%20page&preload=User:PesachZ/Glossary/Glossary_item/Redirect&preloadparams%5b%5d=ET&preview=no Create redirect
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.

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

No-Anchor title Noanchor, Hidden, NA, NAT
Template:1}&summary=Create%20glossary%20item%20redirect%20page&preload=User:PesachZ/Glossary/Glossary_item/Redirect&preloadparams%5b%5d=Noanchor&preview=no Create redirect
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.

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)
The above documentation is transcluded from Template:Glossary item/doc.
Please add categories to the /doc subpage.
Subpages of this template.