WikiDer > Справка: ссылки, определенные списком - Википедия

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

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

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

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

Обзор

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

<references>  <ссылка имя =имя>ссылка</ref>  <ссылка имя =имя2>ссылка2</ref></references>

Или же; с помощью {{рефлист}}

{{reflist | refs = <ссылка имя =имя>ссылка</ref>  <ссылка имя =имя2>ссылка2</ref>}}

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

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

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

Руководящие указания

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

Примеры

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

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

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

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

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

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

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

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

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

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

Ошибки

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

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

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

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

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

Рекомендации