Шаблон: Якорь

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон используется примерно на 80 000 страницах, и изменения могут быть широко заметны. Протестируйте изменения на подстраницах / sandbox или / testcases шаблона или на подстранице вашего собственного пользователя . Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ).

Этот шаблон использует Lua : Модуль: Якорь ( песочница )

Этот шаблон используется в системных сообщениях. Его изменения могут вызвать немедленные изменения в пользовательском интерфейсе Википедии. Чтобы избежать крупномасштабных сбоев, любые изменения следует сначала протестировать на подстранице / sandbox или / testcases этого шаблона или в вашем собственном пользовательском пространстве . Затем протестированные изменения могут быть добавлены в этот шаблон за один раз. Пожалуйста, обсудите любые изменения на странице обсуждения, прежде чем внедрять их.

Этот шаблон используется одним или несколькими ботами . Если вы намерены существенно изменить этот шаблон или выставить его на удаление, сообщите об этом операторам ботов. Спасибо. Соответствующие боты: cewbot .

Шаблон {{ anchor }} вставляет одно или несколько невидимых имен привязок ( идентификаторов фрагментов HTML ) на страницу.

Базовый формат - {{anchor|Anchor name}}. Чтобы создать ссылку на привязку на той же странице, используйте [[#Anchor name|display text]]синтаксис. Чтобы создать ссылку на привязку с другой страницы, используйте [[Article name#Anchor name|display text]]синтаксис. См. Справка: Ссылки на разделы для получения более подробной информации.

Обратите внимание, что #Anchor nameэто не инструкция для браузера, например #redirect.

Якоря наиболее полезны с разделами, поскольку ссылки на раздел не будут работать, если раздел будет переименован. Однако якоря можно использовать по мере необходимости в любом месте статьи. Имя привязки может быть произвольным, но первую букву обычно следует писать с заглавной буквы в соответствии со стилем заголовка (см. Руководство по стилю: заголовки разделов для получения дополнительной информации).

Базовый формат

Вы можете определить одно или несколько имен привязок, разделенных знаком |. Это может быть полезно для альтернативных вариантов написания, таких как «юмор» и «юмор».

Как правило, размещайте привязку в строке над заголовком раздела:
{{anchor|Anchor name 1|Anchor name 2}}
== Section header ==

Имена якорей чувствительны к регистру, поэтому [[#Anchor name 1]]и [[#Anchor Name 1]]не эквивалентны. При создании привязки, как правило, первая буква имени привязки должна быть заглавной и следовать тем же правилам использования заглавных букв, что и для заголовков (см. Руководство по стилю: заголовки для получения дополнительной информации).

Ограничения

• Имена якорей, содержащие любой символ, показанный в таблице справа, не будут работать должным образом. Однако любой из этих символов можно заменить показанным для них здесь кодом "& #". Или можно обойти символ вертикальной черты и знак равенства с помощью {{ ! }} и {{ = }} соответственно. Код разметки, такой как <sup>и <sub>(надстрочный и подстрочный), использовать нельзя. Большинство других символов, включая пробелы и знаки препинания, не являются проблемой.
• Имена якорей должны быть уникальными на странице и не должны дублировать заголовки. Повторяющиеся якоря не будут работать должным образом, поскольку #locationссылки переходят к первому якорю с таким именем. Повторяющиеся привязки приводят к недопустимому HTML; вы можете проверить наличие повторяющихся привязок, запустив страницу через службу проверки разметки W3C .
• Якорные ссылки чувствительны к регистру в некоторых браузерах, поэтому обрабатывайте все якорные ссылки как чувствительные к регистру при создании ссылок на них. Например, если вы создаете якорь с помощью === {{anchor|Bar}} Baz ===, ссылаться на него с помощью [[pagename#Bar]], а не [[pagename#bAR]]. Однако, поскольку некоторые браузеры не чувствительны к регистру, не создавайте заголовки или привязки разделов, которые отличаются только регистром от других на странице. То есть не создавайте одновременно === {{anchor|Baz}} Abcd ===и === {{anchor|bAZ}} Efgh ===.
• Если шаблон находится внутри заголовка раздела, то код шаблона будет отображаться в итоговом окне редактирования каждый раз, когда начинается редактирование раздела этого раздела, как в " /* {{anchor|Issues}}Limitations */ New issue" . Редактор должен вручную исправить часть заголовка раздела в окне сводки редактирования, иначе при сохранении раздела браузер может не вернуться к разделу, и ссылка на раздел этого редактирования на странице истории не будет работать. При использовании привязки в заголовке раздела подумайте о замене шаблона, что приведет к его сохранению.Cd=

Использование в таблицах

Якоря можно использовать в таблицах с некоторыми ограничениями. Шаблон может быть использован в подписи и клетках таблицы, но не те части таблицы , которые находятся за пределами заголовка и клеток. Он используется в подписи к таблице таким образом:{{anchor}}

| + {{anchor | FooX}} Заголовок таблицы

и допустимы следующие формы ячейки:

! {{anchor | Foo1}} Ячейка заголовка! style = "background: white;" | {{anchor | Foo2}} Ячейка заголовка со стилем| {{anchor | Foo3}} Ячейка данных| rowspan = 2 | {{anchor | Foo4}} Ячейка данных, охватывающая две строки

Вам необходимо убедиться, что он не находится в той части разметки, которая предназначена для классов, стилей и т. Д. Таким образом, он не может быть размещен где-либо в строках, которые начинаются с (начало таблицы) или (новая строка), а также в следующих формах ячейки недействительны:{{anchor}}{{anchor}}{||-

! {{anchor | Foo1}} | Ячейка заголовка! style = "background: white;" {{anchor | Foo2}} | Ячейка заголовка со стилем| {{anchor | Foo3}} | Ячейка данных| rowspan = 2 {{anchor | Foo4}} | Ячейка данных, охватывающая две строки

Если необходимо, чтобы якорь находился в любом из этих положений, используется другой прием - id=атрибут. Он помещается в ту часть разметки, где могут использоваться классы, стили и т. Д., Следующим образом:

{| id = FooX class = wikitable| - id = FooY! id = Foo1 | Ячейка заголовка! style = "background: white;" id = Foo2 | Ячейка заголовка со стилем| id = Foo3 | Ячейка данных| rowspan = 2 id = Foo4 | Ячейка данных, охватывающая две строки

id=Атрибут может появиться раньше, между или после каких - либо других признаков , которые могут присутствовать, но только один id=атрибут может использоваться в каждой из этих областей.

Обоснование размещения над заголовком

Чтобы показать, почему размещение над заголовком является предпочтительным, следующий якорь помещается над заголовком раздела Базовый формат: Поскольку якорь фактически используется на этой странице документации, ссылки #Basic format , #Foo и #Foo bar работают и могут быть протестировали, чтобы увидеть эффект. Для сравнения, якорь с именем # Under-Foo также размещен под заголовком раздела основного формата, и его можно щелкнуть, чтобы проиллюстрировать, как это размещение скрывает заголовок раздела при переходе к связанной цели:
{{anchor|Foo|Foo bar}}
== Basic format ==

== Basic format ==
{{anchor|Under-Foo}}

Пояснения и примеры

Причины того, что вышеизложенное является наилучшей практикой, подробно описаны в следующих дополнительных пронумерованных примерах, а также в § Ограничения :

1. {{anchor|Foo}}
   могут быть связаны с [[#Foo|...]]из той же статьи (назовем эту статью «Qux»),
   или на нее можно ссылаться [[Qux#Foo|...]]из других статей и из перенаправлений (где многоточие после слова «Foo» здесь означает слова, выбранные для представления ссылка в статье в Википедии, которая, конечно, может быть чем угодно).
2. Якоря могут быть более подходящими для ссылки между статьями, чем заголовки разделов, потому что якоря более стабильны. Например, заголовок раздела == Foo ==в статье Википедии под названием Qux: Здесь ссылки через будут оставаться действительными, даже если раздел был переименован . Недостатком этого подхода (как подробно описано в § Ограничения раздела) является то, что наличие шаблона в заголовке раздела вызывает проблемы с редактировать сводное окно каждый раз, когда для этого раздела выполняется редактирование раздела. Очевидное решение - разместить привязку перед названием раздела. Это также не позволяет браузерам скрывать заголовок раздела от просмотра при переходе к цели.
   == {{anchor|Foo bar}} Foo ==
[[Qux#Foo bar]]== {{anchor|Foo bar}} On foo and its many friends ==
   
   Примечание. Имя привязки ( Foo bar) должно отличаться от имени section ( Foo), чтобы избежать недопустимого HTML.
3. В заголовках разделов может быть предпочтительнее просто использовать прямой HTML, что может быть достигнуто с помощью такой замены : который сохраняется в статье как: Это обеспечивает стабильную привязку с возможностью ссылки, но без проблем с редактированием. Примечание выше , еще применимо. См. Подробности в § Ограничения .
   == {{subst:anchor|Foo bar}} Foo ==

== Cd= Foo ==
   
   
4. Шаблон можно использовать для создания нескольких якорей за один вызов. Например, создаст три якоря, которые затем можно будет связать с помощью , и .
   {{anchor|Foo|Bar|baz}}
[[#Foo]][[#Bar]][[#baz]]
5. Вот более буквальный пример.
   Допустим, вы написали статью о недавно открытом индоевропейском языке под названием «иш-яш». Название вашей статьи, вероятно, было бы «язык иш-яш» (если бы уже была статья под названием «иш-яш», которая освещала бы культуру в целом). Теперь предположим, что в вашей статье вы хотели бы иметь раздел под названием «Размещение языка при воспроизведении гласных звуков иш-яш». Вы бы создали заголовок раздела, который выглядел бы так:
   == The placement of the tongue when producing Yish Yash vowel sounds ==
   Допустим, вы закончили писать и сохранили новую статью. Теперь предположим, что вы наткнулись на другую статью в Википедии под названием «Протоиндоевропейские гласные», в которой случайно есть раздел об уникальном расположении языка, используемом в Иш Яш. Вы решили, что здесь читателям может быть полезно иметь возможность быстро получить доступ к разделу вашей статьи о расположении языка Йиш Яш при формировании гласных; однако вы не хотите отправлять их в начало всей статьи о языке иш-яш (вы хотели настроить таргетинг на них более конкретно). Таким образом, вы создаете ссылку в статье протоиндоевропейских гласных на раздел внутри вашегостатья о расположении языка в Иш Яш: вы можете сделать это, отредактировав текст протоиндоевропейской гласной статьи и добавив что-то вроде этого в соответствующее место в ней:
   [[Yish Yash language#The placement of the tongue when producing Yish Yash vowel sounds|Yish Yash tongue placement]] is particularly interesting.
   Это действительно длинный код, но он создайте прямую ссылку на соответствующий раздел новой статьи о языке иш-яш, которая будет выглядеть так в статье о протоиндоевропейских гласных:
   "... Размещение языка иш-яш особенно интересно ..."
   Теперь давайте скажем еще один Редактор пришел и пожелал изменить заголовок этого раздела вашей статьи по какой-то законной причине - возможно, на «Иш-Яш гласные и язык». Они могут сделать это, отредактировав вашу статью и сделав заголовок раздела таким:
   == Yish Yash vowels and the tongue ==
   Без ведома редактора это будет означать, что ссылка в статье о протоиндоевропейских гласных, которую вы создали ранее, теперь будет по умолчанию идти в верхнюю часть статьи Йиш Яш, а не в ваш тщательно выбранный подраздел! Однако, если якорь был помещен в заголовок раздела статьи Йиш Яш либо при ее создании, либо когда другой редактор пришел и изменил ее - возможно, что-то вроде этого: или вот так: и текст статьи на Прото- Индоевропейские гласные были вами изменены на что-то вроде этого: тогда ссылка из протоиндоевропейской статьи будет по-прежнему указывать на соответствующий раздел
   == {{subst:anchor|Tongue}} The placement of the tongue when producing Yish Yash vowel sounds ==

== {{subst:anchor|Tongue}} Yish Yash vowel–tongue interaction ==

[[Yish Yash language#Tongue|Yish Yash tongue placement]] is particularly interesting.
   статьи Иш Яш, даже если формулировка заголовка раздела изменилась полностью и читателю не пришлось разбираться в нем самостоятельно. Использование якорей может сделать чтение Википедии более чистым и эффективным, когда заголовки разделов меняются, что нередко случается.

TemplateData

Смотрите также

• {{ Видимый якорь }}
• {{ Закрепленный список }}
• {{ Комментарий якоря }}
• {{ Ярлык }}
• WP: ЯКОРЬ
• WP: ЦЕЛЬ
• {{ Ссылка на раздел }}