الگو:لنگر/توضیحات
![]() | این زیرصفحهٔ مستندات الگو:لنگر است. این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمیگیرد. |
![]() | این الگو از لوآ استفاده میکند: |
The template {{لنگر}} inserts one or more HTML fragment identifiers (anchor names) in a page. Those locations can then be linked to using [[#Location|...]]
syntax. (Usually the first letter of the location is capitalised to reflect the common capitalisation used in section headers – see ویکیپدیا:شیوهنامه.)
استفاده
{{لنگر|فلان}}
نمونهها
{{لنگر|Foo}}
could be linked to with[[#Foo|...]]
from within the same article,
or it could be linked to with[[Article name#Foo|...]]
from other articles and from redirects.- Anchors can be more suitable for inter-article linking than section titles are. For example:
==الگو:Sp
{{لنگر|Foo}}
الگو:SpSection title ==
Here, links via[[Article name#Foo]]
would remain valid even if the section were renamed. (Note that the anchor is placed before the section name; otherwise browsers may hide the section title from view.) However, as noted under Limitations below, it may be preferable to use direct HTML rather than the template within section titles:
==الگو:Sp
<span id="Foo"></span>
الگو:SpSection title == - The template can be used to create multiple anchors with a single call. For example,
{{لنگر|Foo|Bar|baz}}
will create three anchors that can then be linked to with[[#Foo]]
,[[#Bar]]
and[[#baz]]
.
- برای مثال واقعی بر روی ویکیپدیا:شیوهنامه/پیونددهی#مثال لنگر کلیک کنید.
محدودیتها
نویسه | کد | الگو | مفهوم |
---|---|---|---|
" | " "
|
الگو:ن-م | (double) علامت گفتاورد |
# | #
|
الگو:ن-م | hash |
| | |
|
الگو:پیوند الگو | خط عمودی (pipe) |
= | =
|
الگو:پیوند الگو | مساوی (equals) |
- 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 الگو:برچسب and الگو:برچسب (superscript and subscript) cannot be used. Most other characters, including white space and punctuation, are not a problem.
- Anchor names should be unique on a page, and should not duplicate any heading titles. Duplicate anchors will not work as expected since the
#location
links go to the first anchor with that name. Duplicate anchors result in invalid HTML; you can check for duplicate anchors by running the page through the W3C Markup Validation Service. - If the template is added to a section title then the code will appear in the edit summary window when that section is edited, as in "
/* {{لنگر|Issues}}Limitations */ New issue
". Also, when the section is saved, browsers may not return to the section. Consider using<span id="..."></span>
directly, rather than using the anchor template, when in a section title. - Anchor links are case sensitive in some browsers, so treat all anchor links as case sensitive.
استفاده در جداول
|+ {{لنگر|FooX}} A table caption
!{{لنگر|Foo1}} A header cell
!style="background:white;" |{{لنگر|Foo2}} A header cell with styling
|{{لنگر|Foo3}} A data cell
|rowspan=2 |{{لنگر|Foo4}} A data cell spanning two rows
{|
(start of table) or |-
(new row), and the following forms of cell are not valid:!{{لنگر|Foo1}} |A header cell
!style="background:white;" {{لنگر|Foo2}} |A header cell with styling
|{{لنگر|Foo3}} |A data cell
|rowspan=2 {{لنگر|Foo4}} |A data cell spanning two rows
id=
attribute. This is placed in that portion of the markup where the classes, styles etc. may be used, as follows:{| id=FooX class=wikitable
|- id=FooY
!id=Foo1 |A header cell
!style="background:white;" id=Foo2 |A header cell with styling
|id=Foo3 |A data cell
|rowspan=2 id=Foo4 |A data cell spanning two rows
id=
attribute may appear before, between or after any other attributes that may be present, but only one id=
attribute may be used in each of these areas.
دادههای الگو
The template {{لنگر}} inserts one or more HTML anchors in a page. Those locations can then be linked to using [[#location|...]] syntax. The parameters here are for convenience; no parameter name is required in the template itself.
پارامتر | توضیحات | نوع | وضعیت | |
---|---|---|---|---|
First anchor | 1 | First anchor; Only the first anchor is required. | رشته | ضروری |
Second anchor | 2 | Second anchor. | رشته | اختیاری |
Third anchor | 3 | Third anchor. For additional anchors, just type in 4 as the parameter name for the next, 5 for the next after that, and so on. | رشته | اختیاری |
جستارهای وابسته
- الگو:پیوند الگو
- الگو:پیوند الگو
- الگو:پیوند الگو
- الگو:پیوند الگو
- راهنما:فهرست/پیوندها
- ویکیپدیا:تغییرمسیر