stringtranslate.com

Помощь:Ссылки, определенные списком

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

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

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

Обзор

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

< ссылки >  < ref name = "name1" > ссылка </ ref > < ref name = "name2" > ссылка2 </ ref > </ ссылки >
Или; используя {{ reflist }}
{{ reflist | refs =  < ref name = "name1" > ссылка </ ref > < ref name = "name2" > ссылка2 </ ref > }}

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

< ссылки >  {{ r | имя = "имя1" | ссылка = ссылка }}  {{ r | имя = "имя2" | ссылка = ссылка2 }} </ ссылки >
Или; с {{ reflist }}
{{ reflist | refs =  {{ r | name = "name1" | ref = ссылка }}  {{ r | name = "name2" | ref = ссылка2 }} } }

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

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

Руководящие принципы

Примеры


Заметки об использовании

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

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

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

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

Кроме того, созданный пользователем скрипт 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= }}

Ошибки

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

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

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

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

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

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

Ссылки

  1. ^ Скопируйте следующий код, отредактируйте пользовательский JavaScript , затем вставьте:
    {{subst:lusc|1=User:Cumbril/RefConsolidate_start.js}}