Template:Visible anchor/doc
This is a documentation subpage for Template:Visible anchor. It contains usage information, categories 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.
Usage[edit source]
1. {{vanchor|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,
{{vanchor|foo|bar|baz}}
- Visible as: foo
- Linkable as:
[[#foo]]
,[[#bar]]
and[[#baz]]
.
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
will not work as expected.
|humpty
|dumpty}}
TemplateData[edit source]
Visible anchor
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.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Anchor name, and text to display | 1 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting; you can put formatting in the "text" parameter instead.
| String | required |
Second anchor name | 2 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | suggested |
Third anchor name | 3 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Fourth anchor name | 4 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Fifth anchor name | 5 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Sixth anchor name | 6 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Seventh anchor name | 7 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Eighth anchor name | 8 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Ninth anchor name | 9 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Tenth anchor name | 10 | This will become an anchor. The characters ", #, | and = must be escaped; see the main template page for details. Do not try to use formatting. | String | optional |
Display text | text | Overrides the display of parameter 1, but is not an anchor name. May be formatted.
| Content | suggested |
Aliases[edit source]
See also[edit source]
- {{Anchor}}
- {{Anchored list}}
- {{Shortcut}}