Template:Anchor: Difference between revisions

From OniGalore
Jump to navigation Jump to search
(oops, I've gotten rusty; we need noinclude for docs so they are not transcluded)
m (link fix in docs)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>If you enclose text on a page as a parameter to this template, e.g. <nowiki>{{Anchor|some_anchor_name}}</nowiki>, it creates an invisible HTML span id while still displaying that text on the page as before. This span id can be used as a "jump point" by making a link in any article such as <nowiki>[[Some_article#some_anchor_name]]</nowiki>; upon clicking it, you will be taken directly to the text that you enclosed in <nowiki>{{Anchor|}}</nowiki>.
<noinclude>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.


This is similar to the functionality of the "==Header Name=="-type wiki code that marks section headers, except that it does not display as text and it will not be included in the automatically-generated Table of Contents (TOC) like "=="-type headers will be. For a sample usage of the Anchor template, see the wiki markup for [[History of the Oni community]], which marks the article with year tags so that intrawiki links can jump the user to that year in history by using, for instance, <nowiki>[[History of the Oni Community#2001]]</nowiki>.
There's where this template comes in. Here are some examples of how it's been used on OniGalore:
*<nowiki>{{Anchor|Manifesto}}</nowiki> was used on the "Quotes/Manual" page to allow linking to the Pre-Mission Briefing section under its alternate name, "Manifesto": [[Quotes/Manual#Manifesto]].
*<nowiki>{{Anchor|2001}}</nowiki>, 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]].
*<nowiki>{{Anchor|textures_tag}}</nowiki> was used on "Creating a level" to allow a specific field within a table to be linked to: [[Creating a level#textures_tag]].


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 [[BSL:Tutorial/airport1_level_logic.bsl|raw BSL]]; however, no simple solution to the issue of how to create a TOC from span ids has been found yet.
Handy, huh? Note that you can create up to ten anchors by supplying multiple parameters, e.g. <nowiki>{{Anchor|one|two|three}}</nowiki>, though this capability is probably not being used anywhere on the wiki.
[[Category:Basic formatting templates]]</noinclude>
 
<includeonly>{{#if:{{{1|}}}|<span id="{{{1|}}}"></span>}}<!--
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 [[BSL:Tutorial/airport1_level_logic.bsl|raw BSL]]; however, no simple solution to the issue of how to create a TOC from span ids has been found yet.
[[Category:Basic formatting templates]]</noinclude><includeonly>{{#if:{{{1|}}}|<span id="{{{1|}}}"></span>}}<!--
-->{{#if:{{{2|}}}|<span id="{{{2|}}}"></span>}}<!--
-->{{#if:{{{2|}}}|<span id="{{{2|}}}"></span>}}<!--
-->{{#if:{{{3|}}}|<span id="{{{3|}}}"></span>}}<!--
-->{{#if:{{{3|}}}|<span id="{{{3|}}}"></span>}}<!--

Latest revision as of 01:25, 20 November 2023

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 "Creating a level" to allow a specific field within a table to be linked to: Creating a level#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.