Шаблон: Reflist

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон используется примерно на 5 350 000 страниц, или примерно на 10% всех страниц . Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах / sandbox или / testcases шаблона или на подстранице вашего собственного пользователя . Протестированные изменения могут быть добавлены на эту страницу одним редактированием. Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ).

На этой странице приведены технические сведения о шаблоне {{ reflist }}. Полный обзор используемого шаблона см. В разделе « Справка: сноски» .

См. Информацию о копировании этого шаблона и изменении его для использования в другой вики.

Этот шаблон использует TemplateStyles : Шаблон: Reflist / styles.css

Этот шаблон цитирования обеспечивает форматирование и организационные функции для сносок . Он инкапсулирует <references />тег, используемый расширением Cite MediaWiki для отображения списка ссылок, определенного <ref>тегами. Он добавляет поддержку для изменения размера столбца, групп и ссылок, определенных списком .

Параметры

Нет обязательных параметров; если ничего не указано, будет сгенерирован список из одной колонки, если в списке меньше 10 ссылок. Если у вас более 10 ссылок, будут использоваться столбцы шириной 30 em, если ваше устройство позволяет это.

Необязательные параметры:

• Безымянный параметр (должен быть первым, если используется): минимальная ширина для каждого столбца ссылок, обычно в ems . Синтаксис (например) |30emбез пробела (т.е. нет |30 em). Обратите внимание, что это заменяет colwidth - см. § Устаревшие параметры .
• refs : используется со ссылками, определенными списком .
• группа : идентифицирует по имени подмножество отображаемых ссылок; значение должно соответствовать тому , что используется рядным, например, делает все ссылки с имя_группой в качестве названия группы ( ). Есть пять предопределенных имен групп, которые по-разному оформляют список. См. § Сгруппированные ссылки ниже.{{Reflist|group=groupname}}<ref group="groupname">
• liststyle : определяет стиль, используемый при отображении списка ссылок. По умолчанию это нумерованный список. Если он установлен, он переопределит стиль, установленный |group=параметром, не влияя на функциональность группы. См. § Стили списка ниже.

использование

Lorem ipsum. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>== Ссылки =={{Reflist}}

Lorem ipsum. Lorem ipsum dolor sit amet.== Ссылки =={{Refbegin}}* ссылка 1* ссылка 2{{Refend}}

Lorem ipsum. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>== Ссылки =={{Reflist}}{{Refbegin}}* ссылка 1* ссылка 2{{Refend}}

Столбцы

{{Reflist|30em}}(к примеру) инструктирует браузер , чтобы создать как можно больше столбцов , насколько это возможно (по ширине , по меньшей мере 30  эм , в данном примере) с учетом ширины окна дисплея. ( Поддерживаются следующие единицы измерения: em, ex, in, cm, mm, pt, pc, px , но почти всегда используется em.) Между числом и единицей не должно быть пробелов. Проценты не поддерживаются.

Выберите ширину, соответствующую типичной ширине ссылок:

• Автоматические столбцы (по умолчанию, если ширина не указана): там, где только несколько сносок ; см., например, Silver State Arena (23:05, 28 декабря 2012 г.)
• 30em: Там, где много сносок плюс подраздел библиографии шириной в страницу: см., Например, болезнь , вызванную вирусом Эбола (02:02, 12 января 2018 г.)
• 20em: где используются сокращенные сноски ; см., например, классы NBR 224 и 420 (13:32, 1 августа 2011 г.) .

Пример

Lorem ipsum. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet. <ref> Название источника, дата доступа и т. Д. </ref>== Ссылки =={{Reflist | 15em}}

• Примечание 1. Синтаксис (например), который определяет два столбца одинаковой ширины независимо от доступной ширины отображения , является устаревшим (и отключен для мобильного представления). Когда вы используете 1, шаблон дает вам один столбец, а 2 будет делать вид, что вы указали 30em. При использовании большего количества столбцов будет выглядеть так, будто вы указали 25em.{{Reflist|2}}
• Примечание 2. Поддержка браузером: Internet Explorer 10+, Microsoft Edge, Firefox 2+, Chrome 4+, Safari 3.1+, Opera 11.1+.

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

Список ссылок может быть определен в {{ Reflist }} с помощью |refs=параметра, точно так же, как включение именованных <ref name="...">...</ref>элементов внутри <references>...</references>контейнера.

Пример

Это ссылка 1. <ref name = "refname1" />Это ссылка 2. <ref name = "refname2" />== Ссылки =={{Reflist | refs =<ref name = "refname1"> content1 </ref><ref name = "refname2"> content2 </ref>}}

Сгруппированные ссылки

Ссылки можно сгруппировать в отдельные разделы (для пояснительных примечаний, ссылок на таблицы и т. Д.) С помощью group=:

<ref group="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=так, чтобы метки маркера сноски и маркера списка ссылок отличались. Это следует использовать с осторожностью, поскольку это может сбить с толку читателей. Например:

<ref group = "note"> Ссылка </ref>{{Reflist | group = note | liststyle = lower-alpha}}

Взаимодействие с изображениями

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

Технические детали

Размер шрифта

Размер шрифта должен уменьшиться до 90% для большинства браузеров, но может отображаться 100% для Internet Explorer и, возможно, других браузеров. ^{[общее 1]} По состоянию на 21 декабря 2010 г. стандартный <references />тег имеет тот же стиль шрифта. Меньший шрифт можно отключить  , выбрав « Настройки»  → « Гаджеты» → «Отключить меньший размер шрифта для таких элементов, как информационные блоки, навигационные ящики и списки ссылок» .

Браузерная поддержка столбцов

Несколько столбцов создаются с помощью CSS3 , который все еще находится в разработке; таким образом, только браузеры, которые должным образом поддерживают свойство нескольких столбцов, будут отображать несколько столбцов с {{ Reflist }}. ^{[общий 2] [общий 3]}

Эти браузеры поддерживают столбцы CSS3:

• Браузеры на основе Gecko, такие как Mozilla Firefox
• Браузеры на основе WebKit, такие как Safari и Google Chrome
• Opera, начиная с версии 11.10
• Internet Explorer, начиная с версии 10

Эти браузеры не поддерживают столбцы CSS3:

• Браузеры на основе Microsoft Trident, включая Internet Explorer до версии 9 ^{[общая 4]}
• Opera до версии 11

Вдовы и сироты

Использование столбцов может привести к вдовам и сиротам , где цитата в нижней части столбца может быть разделена на верхнюю часть следующего столбца. MediaWiki: Common.css включает правила CSS для предотвращения разрыва элементов списка между столбцами. Вдовы могут по-прежнему отображаться в крайних случаях, например, в списке литературы, отформатированном в столбцы, где определена только одна ссылка.

Lorem ipsum. <ref> Название источника, дата доступа и т. Д. </ref>Lorem ipsum dolor sit amet.== Ссылки =={{Reflist | 10em}}

Поддержка CSS

{{ Reflist }} использует правило CSS в MediaWiki: Common.css для установки размера шрифта:

• div.reflist { font-size: 90%; }

При заданной ширине столбца шаблоном назначается следующий класс:

• .references-column-width

Следующие свойства CSS используются с использованием шаблонов {{ column-width }}:

• column-width Стандарт CSS3

Настройка вида

Редактируя свой CSS, можно настроить внешний вид списка ссылок. В настройках выберите вкладку «Внешний вид», затем на выбранной обложке выберите «Пользовательский CSS». После редактирования и сохранения следуйте инструкциям вверху страницы для очистки. См. Wikipedia: Skin # Customization (продвинутые пользователи) для получения дополнительной помощи.

Размер шрифта

Размер шрифта для всех списков литературы по умолчанию составляет 90% от стандартного размера. Чтобы изменить это, добавьте:

ол . ссылки , div . Reflist , DIV . refbegin  {  размер шрифта :  90 % ; }

Измените 90% до желаемого размера.

Столбцы

Чтобы отключить столбцы, добавьте:

. ссылки-ширина-столбца  {  ширина- столбца :  авто  ! важно ; }

Разделители колонн

Чтобы добавить разделители (правила) между столбцами, добавьте:

. ссылки на колонки ширины  {  колонки-правила :  1 ПВ  твердого вещества  #aaa ; }

Вы можете изменить внешний вид разделителей, изменив значения.

Многолетние предложения

Сворачивание и прокрутка

Был ряд запросов на добавление функциональности для сворачиваемого или прокручиваемого справочного списка. Эти запросы не были выполнены из-за проблем с удобочитаемостью, доступностью и печатью. Применимые рекомендации находятся на MOS: SCROLL . Ссылки между встроенной цитатой и списком ссылок не работают, если список ссылок заключен в свернутую рамку.

Чтобы отобразить справочный список в поле прокрутки или свернуть для каждого пользователя, см. Справка: настройка отображения справочника .

Обсуждение предыдущих попыток сделать это с помощью шаблона см. В обсуждениях Scrollref и Refbox .

Включая заголовок раздела

Были предложения включить разметку заголовка раздела, такую ​​как ==References==. Это не рекомендуется, потому что:

• Стандартного названия раздела нет (см. WP: Руководство по стилю / компоновке § Примечания и ссылки ) .
• При включении статья будет иметь ссылку для редактирования, которая сбивает с толку шаблон для редактирования.

Устаревшие параметры

Эти параметры больше не используются:

• colwidth : То же, что и указание ширины столбца для первого безымянного параметра. Заменено на ширину как безымянный первый параметр.
• close : до 2014 года этот параметр |close=1использовался для обхода ошибки, связанной с многократным использованием {{ Reflist }} на одной странице. Когда ошибка была исправлена, это было удалено. (Для многократного использования на страницах обсуждения и других страницах, не связанных со статьями, разделенными на разделы, см. {{ Reflist-talk }}.)

Статьи с неподдерживаемыми параметрами отслеживаются в Категория: Страницы с использованием списка ссылок с неизвестными параметрами  (3).

Данные шаблона

Ограничения

Не используйте {{ reflist }} или другие шаблоны или модули, которые используют {{#tag: links}} в нумерованных или ненумерованных списках, если список находится внутри тега HTML div . См. Страницу обсуждения ( постоянная ссылка ) для примеров и подробностей.

 Нет -: {{reflist}}

 Нет - * {{reflist}}

 Нет - # {{reflist}}

 Да - {{reflist}}

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

• Википедия: Цитирование источников  - руководство по стилю цитирования источников
• Википедия: шаблоны цитирования  - шаблоны для использования со ссылками
• {{ Refbegin }} и {{ Refend }} - форматировать справочники
• T53260 - Поддержка редактирования тегов для включения / выключения отображения нескольких столбцов

Варианты

• {{ Список ссылок на шаблоны }} - версия списка ссылок для использования в шаблонах
• {{ Reflist-talk }} и {{ Sources-talk }} - для использования в разделах страницы обсуждения и других страницах, не относящихся к основному пространству.

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