Шаблон:AnnotatedListOfLinks
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
 | Этот шаблон всегда следует заменять (т.е. использовать {{subst:AnnotatedListOfLinks}}). Любые случайные включения будут автоматически заменяться ботом. |
 | Этот шаблон использует Lua : |
При замене AnnotatedListOfLinks оборачивает шаблон вокруг неаннотированных вики-ссылок в списке. Он разработан, чтобы избежать затирания существующих описаний, поэтому его можно размещать вокруг смешанного контента без особых проблем. Одним заметным исключением является потеря комментариев в стиле HTML. Ожидаемое общее использование — быстрое обновление разделов «См. также», при этом необходимо учитывать предыдущие ручные правки. {{Annotated link}}
Использование
{{ subst : AnnotatedListOfLinks | <!-- смешанный викитекст (включая заголовки, комментарии, шаблоны) -->== Смотрите также =={{ Портал | пример }}
* [[ Стандартные ссылки ]]
* [[ Канальные ссылки | Каналы ]]
* [[ Общие ссылки ]] - ссылки, требующие большего контекста, чем просто текст* {{ Аннотированная ссылка | Хорошие статьи }}
* [[ Еще ссылки ]]
* [[ Файл : Some_photo_from_1944 ]] <!-- хотя пример Файла: был бы необычным -->
Продолжение прозы с [[ встроенными ссылками ]] на другие вещи. }}При применении вышеописанного метода вики-текст будет выглядеть следующим образом:
== Смотрите также == {{ Портал | пример }} * {{ Аннотированная ссылка | Стандартные ссылки }} * {{ Аннотированная ссылка | Канальные ссылки | Каналы }} * [[ Общие ссылки ]] - ссылки, требующие большего контекста, чем просто текст * {{ Аннотированная ссылка | Хорошие статьи }} * {{ Аннотированная ссылка | Больше ссылок }} * [[ Файл : Some_photo_from_1944 ]]
Продолжение прозы с [[ встроенными ссылками ]] на другие вещи.В результате три ссылки были обновлены для использования шаблона , два комментария в стиле HTML были удалены, а остальной вики-текст остался без изменений.{{Annotated link}}
Советы
- Сохраняйте обновления узкими
- Не окружайте всю страницу, если в этом нет необходимости. Если возникнут непредвиденные ошибки (например, важные потерянные комментарии), они будут более ограниченными, если вы будете использовать это только там, где это действительно необходимо. Сохранение узких обновлений также немного ускоряет процесс. Кроме того, нет эквивалента обратного редактирования для изменения аннотированных ссылок обратно на обычные ссылки в квадратных скобках, что означает, что самый быстрый способ отменить случайный ущерб, нанесенный этим шаблоном, — это откат.
- Предварительный просмотр и показ изменений
- Вы можете не осознать, что вы меняете, а что нет, не взглянув на результаты "Показать изменения", которые выводят изменения в викитексте, которые нужно внести. Дважды проверьте это и просмотрите страницу, чтобы быть уверенным.
- Оставьте полезный обзор редактирования
- Этот шаблон не объясняет причину вносимых им изменений; это ваша работа. Ссылка на один или несколько из них может быть полезна по вашему усмотрению: Template:Anl , WP:WPSD , WP:HOWTOSD .
- Напишите недостающие описания
- После использования этого шаблона рассмотрите возможность посещения любых страниц, на которых не отображается описание WP:Short , даже если они уже заключены в . Заполнение отсутствующих описаний — простой способ помочь другим редакторам понять, что делает шаблон. Это также действительно помогает WP:WPSD .
{{Annotated link}}
Что он обновляет
Этот шаблон обновляет ссылку только в том случае, если соблюдены все эти критерии.
- Ссылка представляет собой неупорядоченный элемент списка, который может иметь или не иметь отступ.
- Единственное , что есть в списке, — это вики-ссылка в квадратных скобках, которую можно передать по каналу.
- Ссылка не имеет идентификатора пространства имен (т.е.
[[Special: Random]]не будет изменена). - Ссылка не использует приемы Pipe
- Связанный заголовок длиннее одного символа. (т.е. не является ссылкой на озаглавленную статью
[[T]])
Ссылки, соответствующие этим критериям, обновляются независимо от того, есть ли у целевой статьи WP:WPSD или нет, с пониманием того, что при добавлении он будет правильно отображен шаблоном . Это означает, что некоторые правки с этим шаблоном изначально не будут иметь никакого эффекта. Вы можете исправить это, посетив любую статью, которой требуется описание, и написав его для целевой страницы. Также обратите внимание, что ссылки, нацеленные на страницы перенаправления, будут обновлены, но могут показывать другой WP:WPSD , чем целевая страница, поскольку у каждой может быть свое собственное описание. Это может сбивать с толку редакторов, которые проверяют согласованность SD между аннотированными ссылками и их целью, но, как правило, это не проблема для читателей, поскольку статьи не включают описание как часть отображаемого контента. Другими словами, читатели будут видеть только SD для страницы перенаправления, а не для целевой страницы.{{Annotated link}}
- Комментарии в стиле HTML
Комментарии, прошедшие через этот шаблон, будут удалены и должны быть добавлены вручную в последующем редактировании, если они желательны. В качестве альтернативы, переместите важные комментарии за пределы шаблона перед заменой, чтобы сохранить их.
Что НЕ обновляется
Маловероятно, что ситуация изменится.
- Все, что находится на той же строке, что и вызов этого шаблона: как правило, размещайте вступительный вызов этого шаблона и заключительный вызов на двух отдельных выделенных строках выше и ниже вики-текста, который следует обновить.
- Упорядоченные списки: В настоящее время их избегают из-за избытка осторожности. Упорядочивание подразумевает, что редакторы приложили некоторые усилия для управления представлением списка, поэтому этот шаблон пытается не вмешиваться.
- Перенаправленные ссылки (типа): Этот шаблон будет обертывать ссылки для перенаправлений, но не будет повторно передавать их в цель (т. е. вставлять соответствующее каноническое имя) и не будет извлекать WP:WPSD из цели перенаправления, если он отличается от SD на самой странице перенаправления - даже если страница перенаправления имеет пустое описание. Перенаправления могут иметь свои собственные описания WP:Short , и это описание, естественно, будет предпочтительным, если редактор, написавший ссылку, решит использовать перенаправленное название вместо канонического названия цели.
- Любые ссылки, указывающие за пределы пространства имен статьи: Хотя описания WP:Short используются ограниченно в некоторых других пространствах имен, содержимое статьи обычно не должно ссылаться на эти страницы. В тех немногих случаях, когда это происходит, краткие описания, вероятно, не нужны.
- Ссылки, содержащие двоеточие (
:) в целевом или замещающем тексте: Поиск двоеточия — это механизм, используемый для предотвращения изменения ссылок на пространства имен, не относящиеся к статьям. - Ссылки, которые разделяют местоположение элемента списка с чем-либо еще: Сюда входит форматирование вики, например, жирные ссылки, но они редко соответствуют WP:MOS в любом случае. Сюда также входят ссылки, которые используют расширения, такие как Vintage cars (обратите внимание на добавленную 's' в конце) и строки с более чем одной ссылкой.
- Ссылки, использующие прием Pipe или обратный прием Pipe: Тестирование, похоже, показывает, что приемы Pipe заменяются при сохранении правок. Если это правда, то единственный раз, когда вы должны с ними столкнуться, это когда вы пытаетесь заменить этот шаблон и использовать приемы Pipe в приложенном викитексте. Простой способ обойти это — разделить ваши правки на два: один для добавления ссылки с приемом Pipe и последующий для аннотации всех ссылок в списке.
Почему это должно быть заменено?
Трансклюзия этого шаблона не имеет никакого эффекта. Технически возможно было бы написать шаблон таким образом, чтобы он выполнял то же самое с помощью трансклюзии, но этого избегали в основном в попытке заимствовать WP:Principle of least astonishment для использования в контексте редактирования викитекста. Для шаблонов необычно выполнять выборочный парсинг викитекста, что, по сути, и делает этот: некоторые ссылки парсятся, а другие нет. Это может привести к тому, что редакторы изменят викитекст, используемый в шаблоне, и увидят неожиданные результаты. Использование подстановки позволяет коду шаблона вставлять шаблоны именно туда, где они нужны, делая понятными, какие части исходного викитекста дополняются, а какие нет. {{Annotated link}}
Другим преимуществом подстановки является согласованность отображения с шаблоном "Annotated link". Транспонирование потребовало бы повторной реализации рендеринга описаний WP:Short в HTML-вывод, и в долгосрочной перспективе может привести к небольшим различиям между ссылками, отрисованными с помощью этого шаблона и с помощью отдельных аннотированных ссылок. Подстановка позволяет избежать этого потенциального отклонения.
Наконец, замена снижает нагрузку на будущих редакторов викитекста, связанную с знанием. Замена шаблона не оставляет следов имени шаблона в последующей правке. Хотя это звучит проблематично, на самом деле это имеет тонкое преимущество: хотя редакторам, которые используют этот шаблон, нужно знать, что он делает, редакторам, которые сталкиваются с результатами этого шаблона, нужно знать только, чтобы понять конечный вывод. По сути, это помогает направить других редакторов викитекста к этому шаблону вместо этого. {{Annotated link}}
Ограничения
- Комментарии в стиле HTML будут удалены. Это может никогда не измениться. Будьте осторожны, размещая этот шаблон вокруг полезных комментариев в викитексте, так как они будут удалены. Это особенно трудно увидеть, так как комментарии не отображаются на странице в режиме предварительного просмотра по замыслу . Однако вы можете увидеть это изменение до того, как оно станет окончательным, используя кнопку «Показать изменения» в редакторе викитекста.
- Он работает только в английской Википедии. Не пытайтесь использовать этот шаблон в другой вики за пределами английской Википедии (т. е. копировать код туда), так как он не будет иметь никакого эффекта, если только описания WP:Short не станут там общепринятыми. До тех пор вы просто тратите свое время.
- Есть несколько вещей, упомянутых выше, которые этот шаблон не будет обновлять.
Поиск неисправностей
- Целевая статья имеет WP:WPSD , но он не отображается
- Вероятно, это случай перенаправленной ссылки. Для перенаправленных ссылок SD целевой статьи не извлекается автоматически с помощью . Фактическая страница перенаправления также должна иметь собственное описание, иначе она будет зарегистрирована как пустая. Обычно это предпочтительнее, поскольку описания могут немного отличаться в выборе слов, которые лучше всего описывают один и тот же предмет альтернативными именами.
{{Annotated link}} - Почему(не) была обновлена какая-то ссылка?
- Если это не рассмотрено выше, может быть полезно просмотреть тестовые случаи модуля .
История
- Соответствующее обсуждение от мая 2021 года о длине кратких описаний коснулось их полезности в разделах «См. также» энциклопедии. См.: обсуждение Википедии:Краткое описание/Архив 9#Но как насчет wp:подумайте о читателе?
- Это было первое живое редактирование, сделанное с помощью этого шаблона (размещенного в пользовательском пространстве в то время). Это редактирование не оказало видимого влияния на отображаемое содержимое страницы, поскольку ни на одной из связанных страниц не было написано кратких описаний. Тем не менее, это полезное и продуктивное редактирование, поскольку будущие краткие описания будут автоматически отображаться в целевой статье без дополнительных обновлений.
