Template:Visible anchor/doc

Jump to navigation Jump to search

The template {{Visible anchor}} inserts one or more HTML anchors in a page. Those locations can then be linked to using [[#link|...]] syntax. Unlike {{Anchor}}, the first parameter will be visible text on the page.

Usage[edit source]

1. {{visible anchor|foo}}

Visible as: foo
Linkable as: [[#foo|...]] from within the same article, [[articlename#foo|...]] from other articles and from redirects.

2. The template can be used to create up to ten anchors with a single call. Here's an example using the vhanchor shortcut:

{{vanchor|foo|bar|baz}}
Visible as: foo
Linkable as:[[#foo]], [[#bar]] and [[#baz]].
Note how only the first parameter is made visible in the rendered text.

Limitations[edit source]

Character Code Template Meaning
 "
"
N/A (double) quotation mark
# # N/A hash
| | {{!}} pipe
= = {{=}} equals
  • This template should not be used within section headings. Doing so will result in broken links in edit summaries, as well as possible duplicate anchors (see below).
  • Anchor names should be unique on a page, and should not duplicate any heading titles. Duplicate anchors won't work as expected since the #links go to the first anchor with that name. Duplicate anchors also result in invalid HTML; you can check for duplicate anchors by running the page through the W3C Markup Validation Service.
  • Anchor names that contain any character shown in the table on the right will not work as expected. However, any of these characters can be replaced with the "&#" codes shown for them here. Or, the pipe symbol and equals sign can be worked around with {{!}} and {{=}}, respectively. Markup code such as <sup> and <sub> (superscript and subscript) cannot be used. Most other characters, including white space and punctuation, are not a problem.
  • The template can create a maximum of 10 anchors. Specifying more than 10 anchors will result in an error message.
  • As with other templates which use positional parameters, putting each anchor name on separate lines, for example
    {{vanchor
    |humpty
    |dumpty}}
    will not work as expected.

Aliases[edit source]

See also[edit source]

External links[edit source]