Этот шаблон цитирования обеспечивает форматирование и организационные функции для сносок . Он инкапсулирует <references />
тег, используемый расширением Cite MediaWiki для отображения списка ссылок, определенных <ref>
тегами. Он добавляет поддержку для изменения ширины столбца, групп и ссылок, определенных списком .
Обязательных параметров нет ; если ни один не указан, будет сгенерирован список из одного столбца, если в списке меньше 10 ссылок. Если у вас больше 10 ссылок, будут использоваться столбцы шириной 30em, если ваше устройство это позволяет.
Необязательные параметры:
|30em
без пробела (т.е. не |30 em
). Обратите внимание, что это заменяет colwidth — см. § Устаревшие параметры.{{Reflist|group=groupname}}
отображает все ссылки с groupname в качестве имени группы ( <ref group="groupname">
). Существует пять предопределенных имен групп, которые по-разному оформляют список. См. § Группированные ссылки ниже.|group=
, не влияя на функциональность группы. См. § Стили списков ниже.{{Reflist|30em}}
(например) указывает браузеру создать как можно больше столбцов (шириной не менее 30 em в этом примере) с учетом ширины окна дисплея. (Поддерживаемые единицы измерения: em, ex, in, cm, mm, pt, pc, px, но em используется почти всегда.) Между числом и единицей измерения не должно быть пробела. Проценты не поддерживаются.
Выберите ширину, соответствующую типичной ширине ссылок:
Синтаксис {{Reflist|2}}
(например), который указывает два столбца одинаковой ширины независимо от доступной ширины отображения , устарел. При использовании 1 шаблон выдает один столбец, а 2 будет делать вид, что вы указали 30em. При использовании большего количества столбцов будет делать вид, что вы указали 25em.
Список ссылок может быть определен внутри {{ Reflist }} с помощью |refs=
параметра, так же как включение именованных <ref name="...">...</ref>
элементов внутрь <references>...</references>
контейнера.
Ссылки можно группировать в отдельные разделы (для пояснительных записок, ссылок на таблицы и т.п.) с помощью group=
:
<ref group="groupname">
где groupname — это (например) notes
или sources
. Имя группы не обязательно заключать в кавычки; это отличается от маркера сноски, где кавычки требуются, если имя группы включает пробел.
Каждая группа, используемая в статье, должна иметь соответствующий список литературы:
{{Reflist|group=groupname}}
Существуют предопределенные имена групп, которые автоматически устанавливают метки в маркерах сносок и списке ссылок на другие стили. Таким образом, настройка {{Reflist|group=lower-alpha}}
установит группу на lower-alpha
и будет оформлять список ссылок с помощью нижних буквенных символов. Соответствующий маркер сноски может быть сформирован с помощью <ref group="lower-alpha">...</ref>
. Это упрощается с помощью ряда шаблонов для установки стилей групп/меток для маркера сноски и списка ссылок:
Как отмечено в § Предопределенные группы, есть предопределенные группы, которые автоматически добавляют стили списка. Использование перечисленных шаблонов удобнее, чем использование |liststyle=
.
Списки ссылок по умолчанию являются нумерованными списками. Используя |liststyle=
параметр, вы можете управлять тем, как отображается список. Например, использование |liststyle=upper-roman
приведет к тому, что ссылки будут помечены римскими цифрами вместо десятичных чисел. Параметр принимает любое допустимое значение CSS, определенное для list-style-type
.
Можно использовать |liststyle=
так, чтобы метки для маркера сноски и маркера списка ссылок отличались. Это следует использовать с осторожностью, так как это может сбить с толку читателей. Например:
В необычном случае размещения изображения слева от списка ссылок в некоторых браузерах могут возникнуть проблемы с макетом. Это можно предотвратить, используя функцию колонок.
Размер шрифта должен уменьшиться до 90% почти для всех браузеров, но может отображаться как 100% для очень старых браузеров, таких как ранние версии Internet Explorer. [general 1] По состоянию на 21 декабря 2010 года стандартный <references />
тег имеет тот же стиль шрифта. Меньший шрифт можно отключить через Настройки → Гаджеты → Отключить меньшие размеры шрифта для таких элементов, как инфобоксы, навигационные блоки и списки ссылок .
Несколько столбцов генерируются с помощью CSS . Почти все браузеры должны поддерживать свойство multi-column и будут отображать несколько столбцов с помощью {{ Reflist }} . [general 2] [general 3] [general 4]
Эти браузеры поддерживают столбцы CSS:
Эти браузеры не поддерживают столбцы CSS:
Использование столбцов может привести к появлению вдов и сирот , когда цитата внизу столбца может быть разделена на верхнюю часть следующего столбца. MediaWiki:Common.css включает правила CSS для предотвращения разрыва элементов списка между столбцами. Вдовы могут по-прежнему отображаться в экстремальных обстоятельствах, например, в списке ссылок, отформатированном в столбцах, где определена только одна ссылка.
Редактируя CSS, можно настроить внешний вид списка ссылок. В разделе «Настройки» выберите вкладку «Внешний вид», затем на выбранном скине выберите «Пользовательский CSS». После редактирования и сохранения следуйте инструкциям в верхней части страницы, чтобы очистить. Для получения дополнительной помощи см. Wikipedia:Skin#Customisation (для продвинутых пользователей) .
Размер шрифта
Размер шрифта для всех списков литературы по умолчанию составляет 90% от стандартного размера. Чтобы изменить его, добавьте:
ol.references , .mw - parser-output div.reflist , .mw - parser - output div.refbegin { размер - шрифта : 90 % ; }
Измените 90% на желаемый размер.
Колонны
Чтобы отключить столбцы, добавьте:
. ссылки-ширина-столбца { ширина-столбца : авто !важно ; }
Разделители столбцов
Чтобы добавить разделители (линии) между столбцами, добавьте:
. ссылки-ширина-столбца { правило-столбца : 1 пиксель сплошной #aaa ; }
Вы можете изменить внешний вид разделителей, изменив значения.
Сворачивание и прокрутка
Было несколько запросов на добавление функциональности для сворачиваемого или прокручиваемого списка ссылок. Эти запросы не были выполнены из-за проблем с читаемостью, доступностью и печатью. Соответствующие рекомендации находятся на MOS:SCROLL . Ссылки между встроенной ссылкой и списком ссылок не работают, если список ссылок заключен в свернутый блок.
Чтобы отобразить список ссылок в виде прокручиваемого поля или свернутого для каждого пользователя, см. раздел Справка:Настройка отображения ссылок .
Обсуждение предыдущих попыток сделать это с помощью шаблона см. в обсуждениях Scrollref и Refbox .
Включая название раздела
Были предложения включить разметку заголовка раздела, например ==References==
. Это нецелесообразно, потому что:
Эти параметры больше не используются:
Статьи, использующие неподдерживаемые параметры, отслеживаются в категории «Страницы с использованием списка ссылок с неизвестными параметрами» (8).
TemplateData для Reflist
Этот шаблон отображает список сносок в конце статьи и предоставляет дополнительные параметры форматирования и организации. После нажатия «Применить изменения» и возврата в режим чтения VE вы не увидите список ссылок. После нажатия «Опубликовать страницу» и возврата в обычный режим чтения список ссылок снова появится с примененными изменениями, см. T53146.
Не используйте {{ Reflist }} или другие шаблоны или модули, которые используют {{#tag:references}} в нумерованных или ненумерованных списках, если список находится внутри тега HTML div . Смотрите страницу обсуждения (постоянная ссылка) для примеров и подробностей.
<references />
тегов для включения/выключения отображения нескольких столбцовВарианты