Revision 484658 of "قالب:Anchor/doc" on arzwiki

{{صفحه توثيق فرعيه}}
<!--
     PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE
-->
{{TOC right}}
== Usage ==
=== Description ===
The template <nowiki>{{</nowiki>[[{{ns:Template}}:{{BASEPAGENAME}}|{{lc:{{BASEPAGENAME}}}}]]<nowiki>}}</nowiki> inserts one or more [[HTML element#Anchor|HTML anchors]] in a page. Those locations can then be linked to using <code><nowiki>[[#link|...]]</nowiki></code> syntax. {{#ifeq:{{BASEPAGENAME}}|Visible anchor|&nbsp;Unlike {{tl|Anchor}}, the first parameter will be visible text on the page. See the "{{Here|Usage details}}" section for an example.|}}

=== Examples ===

1. <code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo<nowiki>}}</nowiki></code>
: could be linked to with <tt><nowiki>[[#foo|...]]</nowiki></tt> from within the same article, 
: or it could be linked to with <tt><nowiki>[[</nowiki>''<small>articlename</small>''#foo|...<nowiki>]]</nowiki></tt> from other articles and from redirects.

2. Anchors can be more suitable for inter-article linking than section titles are. For example,
:<code style="color:green;"><nowiki>=={{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo<nowiki>}}</nowiki></code><code style="color:gray;"> Section title <nowiki>==</nowiki></code>
:Here, links via <tt><nowiki>[[</nowiki>''articlename''#foo<nowiki>]]</nowiki></tt> would remain valid even if the section were renamed.

3. The template can be used to create up to ten anchors with a single call. For example,
: <code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo|bar|baz<nowiki>}}</nowiki></code> 
:will create three anchors that can then be linked to with <tt><nowiki>[[#foo]]</nowiki></tt>, <tt><nowiki>[[#bar]]</nowiki></tt> and <tt><nowiki>[[#baz]]</nowiki></tt>. 
:Specifying more than 10 anchors will cause an error message to be displayed.

=== Limitations ===
* Anchor names that contain [[Number sign|&#35;]] (hash), [[Vertical bar|&#124;]] (pipe), [[Equals sign|&#61;]] (equal) will not work as expected. 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
:<code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}
:|humpty<br />|dumpty<nowiki>}}</nowiki></code> 
: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]].
* If the template is added to a section title then the code will appear in the edit summary when that section is edited, as in <nowiki>"/* {{anchor|Issues}}Limitations */ New issue"</nowiki>. This can be fixed by deleting the template code from the edit summary before the changes are saved.

== See also ==
*{{#ifeq:{{BASEPAGENAME}}|Visible anchor|{{tl|Anchor}}|{{tl|Visible anchor}}}}
*{{Tl|Section}}

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Category:Wikipedia formatting and function templates]]

</includeonly>