Справка:Ссылки, определенные списком

Ссылки, определяемые списком (LDR), — это ссылки, которые определены в разметке списка ссылок, а не в тексте статьи. LDR был реализован в сентябре 2009 года как способ сделать ссылки на статьи проще и с меньшим беспорядком.

Эта страница является продолжением раздела Help : Footnotes . В этом руководстве предполагается, что вы знакомы с описанными там инструментами, такими как функции <ref>...</ref>тегов и параметров.<ref name="REFNAME" />

LDR усложняет просмотр и редактирование ссылок для пользователей VisualEditor . Возможно, вы захотите рассмотреть это перед его реализацией.

Обзор

LDR использует именованные ссылки , где каждая отдельная ссылка имеет уникальное имя и определяется в разметке списка ссылок:

< ссылки >  < имя ссылки = "имя1" > ссылка </ ссылка > < имя ссылки = "имя2" > ссылка2 < / ссылка > </ ссылки >

Или; используя {{ reflist }}

{{ повторить список | refs =  < ref name = "name1" > ссылка </ ref > < ref name = "name2" > reference2 </ ref > }}

Альтернативно, ссылки могут быть определены с использованием шаблона-оболочки «ссылки» {{ r }} (для краткости имена параметров |name=можно |ref=сокращать до |n=и |r=):

< ссылки >  {{ r | имя = "имя1" | ссылка = ссылка }}  {{ r | имя = "имя2" | ref = reference2 }} </ ссылки >

Или; с {{ reflist }}

{{ повторить список | ссылки =  {{ р | имя = "имя1" | ссылка = ссылка }}  {{ r | имя = "имя2" | ссылка = ссылка2 }} }}

Каждая ссылка вызывается в теле текста с помощью <ref name="name1" />или .{{r|name}}

Названия сносок и групп должны соответствовать следующим правилам:

Имена чувствительны к регистру. Пожалуйста, не используйте случайные заглавные буквы.
Имена не должны быть чисто числовыми; программное обеспечение примет что-то вроде ":31337"(знак препинания плюс число), но проигнорирует "31337"(чисто числовое).
Имена должны иметь семантическую ценность, чтобы их было легче отличить друг от друга редакторам, просматривающим викитекст. Это означает, что имена ссылок "Nguyen 2010"типа ":31337".
Имена должны быть уникальными. Вы не можете использовать одно и то же имя для определения разных групп или сносок. Старайтесь не выбирать имя, которое, скорее всего, выберет кто-то другой для новой цитаты, например ":0"или "NYT".
Пожалуйста, подумайте о том, чтобы названия ссылок были короткими, простыми и ограничивались стандартным английским алфавитом и цифрами. При использовании помещений становятся актуальными следующие технические ограничения:
- Кавычки являются предпочтительными, но необязательными, если используются только буквы A–Z, a–zцифры 0–9и символы !$%&()*,-.:;<@[]^_`{|}~. То есть все печатаемые символы ASCII, кроме #"'/=<>?\пробела.
- Включение любых других символов, включая пробелы , требует, чтобы имя ссылки было заключено в кавычки; например, name="John Smith". Но имена ссылок, заключенные в кавычки, не могут включать знак «меньше» ( <) или символ двойной прямой кавычки ( "), которые, однако, могут быть включены путем экранирования как <и "соответственно.
- Кавычки должны быть стандартными, прямыми, двойными кавычками ( "); фигурные или другие кавычки будут анализироваться как часть ссылочного имени.
При желании вы можете указать ссылочные имена, даже если ссылочное имя не требуется. Это упрощает позднее повторное использование исходной ссылки.

Методические рекомендации

Все ссылки, определенные в списке, должны иметь имена . Можно использовать любое имя, соответствующее указанным выше техническим ограничениям; однако они должны быть единообразными, чтобы другие пользователи могли их редактировать. Широко используемой практикой является дата автора, название автора или дата публикации.
Кроме того, любые неиспользуемые ссылки вызовут ошибку . Все ссылки, определенные списком, должны использоваться в теле и наоборот, все <ref name="ABC">...</ref>теги должны содержать определяющую информацию.
Ссылки, определенные в списке, и ссылки, определенные в тексте статьи, могут быть смешаны на странице — это не является техническим ограничением шаблона. Однако это может сбить с толку текущих редакторов и должно быть нормализовано к единому стилю согласно WP:CITEVAR .
Списки ссылок можно упорядочить любым способом (например, в алфавитном порядке по имени ссылки), но создаваемый список будет располагаться в том порядке, в котором ссылки вызываются.

Примеры

Примечания по использованию

Использование ссылок, определенных списком, означает, что при редактировании все ссылки и сноски, отформатированные таким образом, вставляются в исходный раздел, где находится шаблон. Это в первую очередь изменение исходного кода и не влияет на отображение статьи читателю. Основные эффекты предназначены для редакторов, как описано ниже.{{reflist|refs= }}

Метод LDR удаляет любые детали цитирования или примечания, которые могут нарушить работу окна редактирования при редактировании основного текста, что особенно полезно, если они расположены вертикально или иным образом занимают несколько строк. Кроме того, этот раздел централизованного списка ссылок можно открыть сам по себе, если какая-либо из записей цитирования требует изменения, что может быть особенно полезно при попытке изменить ссылку, которая используется несколько раз, что позволяет избежать необходимости искать ее во всем источнике.

Недостатком этого подхода является то, что эти ссылки сложнее вставить в источник, поскольку они отделены от текста. Редактор должен либо открыть весь документ, чтобы увидеть источник как текста, так и списка литературы, либо, в качестве альтернативы, использовать двухэтапную процедуру: сначала ввести идентификатор в основной текст, а затем открыть раздел списка литературы для ввода источника или сноска как . Еще одна накладная нагрузка этого подхода заключается в том, что список в конце статьи должен быть организован так, чтобы его мог легко найти редактор — скорее всего, он будет расположен в окне редактирования в алфавитном порядке по имени ссылки, поскольку это, скорее всего, сохранит целостность и полезность исходного кода. , даже если разделы текста изменены.<ref name="name" /><ref name="name">content</ref>

Хотя зачастую проще удалить все цитаты из исходного текста, приемлемым компромиссом (особенно для небольших статей) может быть использование LDR только для цитат, использованных несколько раз. Это связано с тем, что они уже используют код имени ссылки и могут находиться в нескольких местах — простое перемещение исходного кода ссылки из ее первого появления в список ссылок является незначительным изменением. Кроме того, эти цитаты, скорее всего, потребуют пересмотра или изменения, поскольку они более важны для статьи и содержат больше деталей, а упрощение их поиска и изменения может быть очень полезным. Наконец, это также сохраняет целостность источника, если изменяется первый экземпляр ссылки, как отмечено выше.

Кроме того, созданный пользователем скрипт сегрегатора User:PleaseStand/References позволяет автоматически отделять цитаты из окна редактирования и временно собирать их в отдельном окне «встроенных цитат». В этом формате цитаты можно вручную вставлять в список литературы. Это может иметь некоторые преимущества постоянных LDR, когда их использование непрактично или противоречит консенсусу. Однако обратите внимание, что перед сохранением страницы любое содержимое этого окна будет заменено в основной текстовый источник по первому соответствующему тегу, если оно не будет очищено вручную. Как указано на странице и ниже, у него есть сценарий автоматического преобразования, который может самостоятельно обрабатывать существующие цитаты в список литературы, но неясно, сможет ли он выполнить этот перенос во время редактирования.<ref name="name" />

Наконец, существуют некоторые заблуждения относительно сносок, определяемых списком:

Одним из них является то, что создание отдельных списков сносок требует использования сносок, определяемых списком. Однако использование имени «группы» для различения различных типов сносок доступно независимо от того, используются ли сноски, определенные в списке или встроенные. Например, в обоих случаях можно обозначить примечания как группу под названием «Примечание» и отделить их от простых цитат с помощью встроенной метки (Полное объяснение использования названий групп показано во втором примере в разделе сразу выше.)<ref group="Note" name="name" />
Другое заблуждение заключается в том, что существует выбор «или-или» между использованием сносок, определенных в виде списка, и встроенных сносок, и что все цитаты в статье должны следовать только одному из стилей. Фактически, он полностью совместим с использованием встроенных сносок в формате или . Хотя использование обеих систем в одной статье может показаться запутанным или нежелательным, фактом является то, что эти две системы можно смешивать без разбора с шаблоном .{{reflist|refs= }}<ref>content</ref><ref name="name">content</ref>{{reflist|refs= }}

Ошибки

Иногда ссылки могут привести к ошибкам, которые отображаются красным текстом. Пожалуйста, обратитесь к разделу «Справка: Укажите ошибки» , чтобы диагностировать и устранить эти ошибки. Альтернативно, сравните свой код с приведенным выше примером или с документацией по рефлисту на странице Template:Reflist § Ссылки, определяемые списком . Примечательно, что ошибки либо в именованном теге ref, либо в коде reflist могут вызвать проблемы, поскольку для работы LDR записи должны быть определены и использованы в обоих случаях.

Преобразование

Стили ссылок могут быть преобразованы из или в ссылки, определенные в списке, следуя тем же правилам для других серьезных изменений в стиле цитирования, в WP:CITEVAR . Пользователь:PleaseStand/segregate-refs.js имеет возможность помочь в конверсии.

Визуальный редактор

Вы можете повторно использовать существующие ссылки, определенные списком, в VisualEditor для дополнительных цитат, но вы не можете добавлять или удалять ссылки, определенные списком. Он также не поддерживает изменение ссылок, определенных в списке, внутри {{ reflist }} , только <references/>. Это затруднит работу пользователей визуального редактора, и вы можете принять во внимание эти ограничения, если вы заинтересованы в добавлении ссылок, определяемых списком.

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

Шаблон:R – этот шаблон уменьшает текст, необходимый для определения и вызова именованных ссылок, <ref name="foo"/> становится {{r|foo}}
Шаблон: Использовать ссылки, определенные списком . Этот дополнительный шаблон можно использовать, чтобы указать редакторам и инструментам, что в статье используются LDR.
Организатор ссылок ^[1] ( источник )– это инструмент, который представляет все ссылки в графическом пользовательском интерфейсе, где вы можете выбрать, следует ли определять ссылки в теле статьи или в шаблоне(ах) списка ссылок (формат, определяемый списком). Выбор можно применить ко всем ссылкам, ко всем ссылкам с определенным количеством использований (цитирований) или отметив ссылки по отдельности. Вы также можете сортировать ссылки различными способами (и сохранять порядок сортировки в шаблоне списка ссылок) и переименовывать их. Используйте только при наличии консенсуса .