m (moved anchors into term cell) |
m (anchors now work properly in first cell even after sorting table) |
||
| Line 9: | Line 9: | ||
</noinclude><includeonly><!-- Begin template code --><!-- begin table row --> | </noinclude><includeonly><!-- Begin template code --><!-- begin table row --> | ||
|- valign="top" <!-- Start new table row --> | |- valign="top" <!-- Start new table row --> | ||
|{{#ifeq:{{{noanchor|}}}|yes|<!-- If "noanchor" is set to yes, don't output any anchors | |<!-- ### Begin Term Cell ### -->{{#ifeq:{{{noanchor|}}}|yes|<!-- If "noanchor" is set to yes, don't output any anchors | ||
-->|<!-- If not output an anchor starting with the term name -->{{anchor|{{{term|}}}<!-- Then if up to 4 additional aliases are present | -->|<!-- If not output an anchor starting with the term name -->{{anchor|{{{term|}}}<!-- Then if up to 4 additional aliases are present | ||
-->|{{{1|}}}|{{{2|}}}|{{{3|}}}|{{{4|}}}|{{{anchor1|}}}<!-- if up to 4 non display anchors are specified, add them to the anchor | -->|{{{1|}}}|{{{2|}}}|{{{3|}}}|{{{4|}}}|{{{anchor1|}}}<!-- if up to 4 non display anchors are specified, add them to the anchor | ||
-->|{{{anchor2|}}}|{{{anchor3|}}}|{{{anchor4|}}}<!-- | -->|{{{anchor2|}}}|{{{anchor3|}}}|{{{anchor4|}}}<!-- | ||
end anchor -->}}<!-- | end anchor -->}}<!-- | ||
end IF "noanchor" -->}} '''{{{term|}}}'''<!-- Fill first cell of row with "term" --> | end IF "noanchor" -->}}<!-- Place anchors at beginning of first cell then | ||
--> '''{{{term|}}}'''<!-- Fill first cell of row with "term" --> | |||
| <!-- use trim for unnamed parameters to eliminate extra whitespace | | <!-- use trim for unnamed parameters to eliminate extra whitespace | ||
-->{{Trim| {{{1|~}}} }}<!-- fill second cell with 1st alias, if there is no alias put a "~" so it goes to the bottom when sorting this column. | -->{{Trim| {{{1|~}}} }}<!-- fill second cell with 1st alias, if there is no alias put a "~" so it goes to the bottom when sorting this column. | ||
Revision as of 01:39, 23 February 2015
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 | Related entries: Glossary • Template 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. |
2015-01-25 (U) 2014-02-13 (A) | |
| Glossary | ~ | This is an entry describing the Glossary concept, and includes a link to the Entry title entry. | 2015-02-13 (U) 2014-02-13 (A) | |
| Template | ~ | This is an entry describing templates, and includes a link to the Entry title entry as a template example. | 2015-02-13 (U) 2014-02-13 (A) | |
| Table | ~ | Related entries: Entry title This is an entry describing tables, and is linked to from the Entry title entry template. |
2015-02-13 (U) 2014-02-13 (A) | |
{{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 | 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. | 2015-01-25 (U) 2014-02-13 (A) | |
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 | 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. | 2015-02-08 (U) 2014-02-13 (A) | |
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. |