Template:Annotated link

Jump to navigation Jump to search
Template documentation[view] [edit] [history] [purge]

Usage[edit source]

Used in lists to provide an annotated link using the short description from the linked page for annotation. Useful for disambiguation and providing an idea of what the link is about, without having to hover on the link. The link may be piped to adjust appearance. An abbreviation/acronym/initialism may be included as an optional parameter, and an alias as another optional parameter. The annotation follows a spaced ndash.

If a {{short description}} template exists in the targeted article, but is empty, or contains a space, non-breaking space, the word blank, none, null, or other indication that a short description is not appropriate or needed, the output should be an un-annotated link. If it is not, list such cases on the talk page for attention, or fix it if you can.

The template should not be used for annotating links on disambiguation pages. The relevant discussion is at Starfleet Logistics talk:Disambiguation § Use of annotated links and concludes:

  • They contain formatting that is not in line with the long-established formatting for disambiguation entries at MOS:DAB.
  • The text of the descriptions is frequently not optimal for disambiguation pages, as it may be neither distinguishing nor succinct.
  • They would remove control of the text from the disambiguation page itself, and allow disambiguation pages to be modified without appearing in the edit history of the page itself, or in notifications relating to the page. (This reason is not fixable, and is sufficient reason not to use the template or any modification thereof.)

Syntax[edit source]

{{Annotated link|Article title|piped link|abbreviation= |aka= }}

Examples[edit source]

Null case: Short description template present in article but indicates short description not needed by using one of the null descriptions

{{Annotated link|Template:Annotated link/demo}}
Template:Annotated link/demo

Basic

{{Annotated link|Starfleet Logistics:Short description}}
Starfleet Logistics:Short description – Explanation of short descriptions on Starfleet Logistics

Piped for alternative link display

{{Annotated link|Starfleet Logistics:Short description|<big>Short ''description''</big>}}
Short description – Explanation of short descriptions on Starfleet Logistics

Abbreviation added

{{Annotated link|Starfleet Logistics:Short description|Short description|abbreviation=SD}}
Short description (SD) – Explanation of short descriptions on Starfleet Logistics

Alias added

{{Annotated link|Starfleet Logistics:Short description|Short description|abbreviation=SD |aka=''disambiguation description''}}
Short description (SD), also known as disambiguation description – Explanation of short descriptions on Starfleet Logistics

Dash replaced

{{Annotated link|Starfleet Logistics:Short description|Short description|abbreviation=SD |aka=''disambiguation description''|dash=,&nbsp;}}
Short description (SD), also known as disambiguation description, Explanation of short descriptions on Starfleet Logistics

Notes[edit source]

  • If you are porting this template to other Starfleet Logistics sites, you may want to modify this template to read Wikidata for short descriptions depending on your local policies on placing such descriptions. To do so, you will need to run some Lua code along the lines of return mw.wikibase.description(mw.wikibase.getEntityIdForTitle(frame.args[1])) in a module. Module:ResolveEntityId may be used for the entity ID if you wish to handle redirects too.

External links[edit source]