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

Эта страница справки представляет собой практическое руководство . В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не одна из политик или рекомендаций Википедии , и может отражать различные уровни консенсуса и проверки .

Ярлыки РГ: LDRHOW РГ: LDRHTG

Список ссылок (LDR) - это ссылки, которые определены в разметке списка ссылок, а не в основной части статьи. LDR был реализован в сентябре 2009 года , чтобы упростить создание ссылок на статьи и сделать их менее беспорядочными.

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

Обзор [ править ]

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

<references>  <ref  name = "name" > ссылка </ref>  <ref  name = "name2" > ссылка2 </ref> </references>

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

{{reflist | refs = <ref  name = "name" > ссылка </ref>  <ref  name = "name2" > ссылка2 </ref>}}

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

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

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

Рекомендации [ править ]

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

Примеры [ править ]

Солнце довольно большое. <ref  name = "Foot01" /> Но Луна <ref  name = "Foot02" /> не такая большая. <ref  name = "Foot03" /> Солнце тоже довольно горячее. <ref  name = "Foot04" />== Примечания =={{reflist | refs =<ref  name = "Foot01" > Миллер, "Солнце", Оксфорд, 2005 г., стр. 23. </ref> <ref  name = "Foot02" > Джонс, "Солнечная система", Макмиллан, 2005 г., стр. 623. </ref> <ref  name = "Foot03" > Браун, "Луна" ', 2006, Пингвин, стр. 46. </ref> <ref  name = "Foot04" > Смит, "Вселенная", Random House, 2005, стр. 334. </ref>}}

Солнце довольно большое. <ref  name = "Foot01" /> <ref  group = "Note"  name = "Note01" /> Но Луна <ref  group = "Note"  name = "Note02" /> не такая большая. <ref  name = "Foot02" /> <ref  group = "Note"  name = "Note03" /> Солнце тоже довольно горячее. <ref  name = "Foot03" />== Примечания =={{reflist | group = Примечание | refs =<ref  name = "Note01" > Но Миллер отмечает, что Солнце не такое большое, как некоторые другие звезды. </ref> <ref  name = "Note02" > Луна носит другие имена, например, Селена. </ref> <ref  name = "Note03" > Исторически Луна не всегда считалась большой. </ref>}}== Ссылки =={{reflist | refs =<ref  name = "Foot01" > Миллер, "Солнце", Оксфорд, 2005 г., стр. 23. </ref> <ref  name = "Foot02" > Браун, "Луна", 2006 г., Penguin, стр. 46. </ref> <ref  name = "Foot03" > Смит, "Вселенная", Random House, 2005, стр. 334. </ref>}}

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

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

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

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

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

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

Наконец, есть некоторые неправильные представления о сносках, определенных списком:

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

Ошибки [ править ]

Иногда ссылки могут приводить к ошибкам, которые отображаются красным текстом. См. Справка: цитируйте ошибки, чтобы помочь диагностировать и устранить эти ошибки. Как вариант, сравните свой код с приведенным выше примером или с документацией по списку ссылок в Template: Reflist § Ссылки, определенные списком . Следует отметить, что ошибки в любом названном реф теге или RefList кода может вызвать проблемы, в качестве записи должны быть определены и использованы в обоих для ЛДС к работе.

Преобразование [ править ]

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

См. Также [ править ]

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

Ссылки [ править ]