Template:Visible anchor/doc

This is a documentation subpage for Template:Visible anchor (see that page for the template itself).
It contains usage information, categories, interlanguage links and other content that is not part of the original template page.

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.

Examples

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. For example,

{{visible anchor|foo|bar|baz}}

Visible as: foo

Linkable as:[[#foo]], [[#bar]] and [[#baz]].

Limitations

Anchor names that contain # (hash), | (pipe), = (equal) will not work as expected. However, the latter can be worked around with {{=}}; a redirect with "=" in its name will link properly to an anchor with {{=}}. Markup code such as <sup></sup> and <sub></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.
Putting each anchor name on separate lines, for example

{{visible anchor

|humpty
|dumpty}}

will probably not work as expected.

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, so you can check for duplicate anchors by consulting the W3C Markup Validation Service.

Examples

Limitations

See also