Template:Anchor

From OniGalore
Revision as of 13:42, 29 May 2022 by Iritscen (talk | contribs) (better wording for docs; now mentioning multi-anchor capability)
Jump to navigation Jump to search

When a header is created in an article with the notation "==Header Name==", it creates an HTML span id, which is also known as an anchor link; a URL or intrawiki link can then use the "#" mark to link to that specific section by name. Sometimes you want an article to provide such an anchor link but you don't want to give that part of the article its own header, or perhaps it already has a header and you want to give it an alternate name as a sort of alias.

There's where this template comes in. Here are some examples of how it's been used on OniGalore:

  • {{Anchor|Manifesto}} was used on the "Quotes/Manual" page to allow linking to the Pre-Mission Briefing section under its alternate name, "Manifesto": Quotes/Manual#Manifesto.
  • {{Anchor|2001}}, etc. was used on the "History of the Oni community" page so that links from other pages could simply point to a year and the reader could be forwarded to that chronological point in the article regardless of how the text is broken into sections, e.g. History of the Oni community#2001.
  • {{Anchor|textures_tag}} was used on "XML:ONLV" to allow a specific field within a table to be linked to: XML:ONLV#textures_tag.

Handy, huh? Note that you can create up to ten anchors by supplying multiple parameters, e.g. {{Anchor|one|two|three}}, though this capability is probably not being used anywhere on the wiki.

P.S.: The original goal in introducing this template was to create a custom TOC based on this invisible section markup that could be used to document raw BSL; however, no simple solution to the issue of how to create a TOC from span ids has been found yet.