Шаблон:Reflist
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
 | Этот шаблон используется примерно на 6 230 000 страницах, или примерно на 10% всех страниц . Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах шаблона /sandbox или /testcases , или на вашей собственной подстранице пользователя . Протестированные изменения можно добавить на эту страницу за одно редактирование. Рассмотрите возможность обсуждения изменений на странице обсуждения перед их реализацией. |
 | Этот шаблон могут редактировать только администраторы , поскольку он включен в одну или несколько страниц с каскадной защитой . |
 |
|
 | Ознакомьтесь с информацией о копировании этого шаблона и его изменении для использования в другой вики. |
 | Этот шаблон использует Lua : |
 | В этом шаблоне используются TemplateStyles: |
Этот шаблон цитирования обеспечивает форматирование и организационные функции для сносок . Он инкапсулирует <references />тег, используемый расширением Cite MediaWiki для отображения списка ссылок, определенных <ref>тегами. Он добавляет поддержку для изменения ширины столбца, групп и ссылок, определенных списком .
Параметры
Обязательных параметров нет ; если ни один не указан, будет сгенерирован список из одного столбца, если в списке меньше 10 ссылок. Если у вас больше 10 ссылок, будут использоваться столбцы шириной 30em, если ваше устройство это позволяет.
Необязательные параметры:
- Неназванный параметр (должен быть первым, если используется): минимальная ширина для каждого столбца ссылок, обычно в ems . Синтаксис (например)
|30emбез пробела (т.е. не|30 em). Обратите внимание, что это заменяет colwidth — см. § Устаревшие параметры. - refs : используется со ссылками, определенными в списке .
- group : идентифицирует по имени подмножество ссылок, которые необходимо отобразить; значение должно соответствовать используемому inline, например,
{{Reflist|group=groupname}}отображает все ссылки с groupname в качестве имени группы (<ref group="groupname">). Существует пять предопределенных имен групп, которые по-разному оформляют список. См. § Группированные ссылки ниже. - liststyle : определяет стиль, используемый при отображении списка ссылок. По умолчанию используется нумерованный список. При установке он переопределяет стиль, заданный параметром
|group=, не влияя на функциональность группы. См. § Стили списков ниже.
Использование
| Разметка | Отображается как |
|---|---|
Lorem ipsum.<ref>Название источника, дата доступа и т. д.</ref>Lorem ipsum dolor sit amet.<ref>Название источника, дата доступа и т. д.</ref>==Ссылки=={{Reflist}} | Лорем ипсум. [1] Lorem ipsum dolor sit amet. [2] Ссылки
|
| Разметка | Отображается как |
|---|---|
Лорем ипсум. Lorem ipsum dolor сидит amet.==Ссылки=={{Refbegin}}* ссылка 1* ссылка 2{{Refend}} | Лорем ипсум. Lorem ipsum dolor сидит amet. Ссылки
|
| Разметка | Отображается как |
|---|---|
Lorem ipsum.<ref>Название источника, дата доступа и т. д.</ref>Lorem ipsum dolor sit amet.<ref>Название источника, дата доступа и т. д.</ref>==Ссылки=={{Reflist}}{{Refbegin}}* ссылка 1* ссылка 2{{Refend}} | Лорем ипсум. [1] Lorem ipsum dolor sit amet. [2] Ссылки
|
Колонны
{{Reflist|30em}}(например) указывает браузеру создать как можно больше столбцов (шириной не менее 30 em в этом примере) с учетом ширины окна дисплея. (Поддерживаемые единицы измерения: 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 Classes (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] Lorem ipsum dolor sit amet. [2] Lorem ipsum dolor sit amet. [3] Lorem ipsum dolor sit amet. [4] Lorem ipsum dolor sit amet. [5] Ссылки
|
Синтаксис {{Reflist|2}}(например), который указывает два столбца одинаковой ширины независимо от доступной ширины отображения , устарел. При использовании 1 шаблон выдает один столбец, а 2 будет делать вид, что вы указали 30em. При использовании большего количества столбцов будет делать вид, что вы указали 25em.
Определенные списком ссылки
Список ссылок может быть определен внутри {{ Reflist }} с помощью |refs=параметра, так же как включение именованных <ref name="...">...</ref>элементов внутрь <references>...</references>контейнера.
Пример
| Разметка | Отображается как |
|---|---|
Это ссылка 1.<ref name="refname1" />Это ссылка 2.<ref name="refname2" />==Ссылки=={{Список ссылок|ссылки=<ref name="refname1">контент1</ref><ref name="refname2">content2</ref>}} | Это ссылка 1. [1] Это ссылка 2. [2] Ссылки
|
Сгруппированные ссылки
Ссылки можно группировать в отдельные разделы (для пояснительных записок, ссылок на таблицы и т.п.) с помощью group=:
<ref group="groupname">
где groupname — это (например) notesили sources. Имя группы не обязательно заключать в кавычки; это отличается от маркера сноски, где кавычки требуются, если имя группы включает пробел.
Каждая группа, используемая в статье, должна иметь соответствующий список литературы:
{{Reflist|group=groupname}}
Предопределенные группы
Существуют предопределенные имена групп, которые автоматически устанавливают метки в маркерах сносок и списке ссылок на другие стили. Таким образом, настройка {{Reflist|group=lower-alpha}}установит группу на lower-alphaи будет оформлять список ссылок с помощью нижних буквенных символов. Соответствующий маркер сноски может быть сформирован с помощью <ref group="lower-alpha">...</ref>. Это упрощается с помощью ряда шаблонов для установки стилей групп/меток для маркера сноски и списка ссылок:
| Тип группы | Шаблон маркера сноски или разметка | Шаблон списка литературы | Образцы этикеток |
|---|---|---|---|
| по умолчанию нет, но опционально любой | <ref>...</ref> | {{reflist}} | 1 2 3 4 5 6 7 8 9 10 |
{{r}}(для вложенных ссылок) | |||
{{refn}}(для вложенных ссылок) | |||
| нижняя альфа |
| abcdefghij | |
| верхняя альфа | {{efn-ua}} | {{notelist-ua}} | ABCDEFGHIJ |
| нижнеримский | {{efn-lr}} | {{notelist-lr}} | я ii iii iv v vi vii viii ix x |
| верхнеримский | {{efn-ur}} | {{notelist-ur}} | I II III IV V VI VII VIII IX X |
| нижнегреческий | {{efn-lg}} | {{notelist-lg}} | α β γ δ ε ζ η θ ι κ |
| примечание |
| примечание 1 примечание 2 примечание 3 |
Список стилей
Как отмечено в § Предопределенные группы, есть предопределенные группы, которые автоматически добавляют стили списка. Использование перечисленных шаблонов удобнее, чем использование |liststyle=.
Списки ссылок по умолчанию являются нумерованными списками. Используя |liststyle=параметр, вы можете управлять тем, как отображается список. Например, использование |liststyle=upper-romanприведет к тому, что ссылки будут помечены римскими цифрами вместо десятичных чисел. Параметр принимает любое допустимое значение CSS, определенное для list-style-type.
Можно использовать |liststyle=так, чтобы метки для маркера сноски и маркера списка ссылок отличались. Это следует использовать с осторожностью, так как это может сбить с толку читателей. Например:
| Разметка | Отображается как |
|---|---|
<ref group="note">Ссылка</ref>{{Reflist|group=note|liststyle=lower-alpha}} | [примечание 1]
|
Взаимодействие с изображениями
В необычном случае размещения изображения слева от списка ссылок в некоторых браузерах могут возникнуть проблемы с макетом. Это можно предотвратить, используя функцию колонок.
Технические подробности
Размер шрифта
Размер шрифта должен уменьшиться до 90% почти для всех браузеров, но может отображаться как 100% для очень старых браузеров, таких как ранние версии Internet Explorer. [general 1] По состоянию на 21 декабря 2010 года стандартный <references />тег имеет тот же стиль шрифта. Меньший шрифт можно отключить через Настройки → Гаджеты → Отключить меньшие размеры шрифта для таких элементов, как инфобоксы, навигационные блоки и списки ссылок .
Поддержка браузером столбцов
| Свойство | Интернет Эксплорер | Firefox | Сафари | Хром | Опера |
|---|---|---|---|---|---|
| ширина-столбца количество-столбцов | ≥ 10 (2012) | ≥ 1,5 (2005) | ≥ 3 (2007) | ≥ 1 (2008) | ≥ 11,1 (2011) |
| столбцы | ≥ 10 (2012) | ≥ 9 (2011) | ≥ 3 (2007) | ≥ 1 (2008) | ≥ 11,1 (2011) |
| перерыв-до перерыв-после перерыв-внутрь | ≥ 10 (2012) | ≥ 65 (2019) | ≥ 10 (2016) | ≥ 65 (2016) | ≥ 15 (2013) |
Несколько столбцов генерируются с помощью CSS . Почти все браузеры должны поддерживать свойство multi-column и будут отображать несколько столбцов с помощью {{ Reflist }} . [general 2] [general 3] [general 4]
Эти браузеры поддерживают столбцы CSS:
- Браузеры на базе Gecko, такие как Mozilla Firefox
- Браузеры WebKit, такие как Safari
- Браузеры на основе Blink , такие как Microsoft Edge , Opera и Google Chrome
- Internet Explorer , начиная с версии 10
Эти браузеры не поддерживают столбцы CSS:
- Браузеры на базе Microsoft MSHTML , включая Internet Explorer до версии 9 [общий 5]
- Очень старая Opera до версии 11
Вдовы и сироты
Использование столбцов может привести к появлению вдов и сирот , когда цитата внизу столбца может быть разделена на верхнюю часть следующего столбца. MediaWiki:Common.css включает правила CSS для предотвращения разрыва элементов списка между столбцами. Вдовы могут по-прежнему отображаться в экстремальных обстоятельствах, например, в списке ссылок, отформатированном в столбцах, где определена только одна ссылка.
| Разметка | Отображается как |
|---|---|
Lorem ipsum.<ref>Название источника, дата доступа и т. д.</ref>Lorem ipsum dolor sit amet.==Ссылки=={{Reflist|10em}} | Лорем ипсум. [1] Lorem ipsum dolor sit amet. Ссылки
|
Настройка вида
Редактируя 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==. Это нецелесообразно, потому что:
- Стандартного названия раздела не существует .
- При включении в статью будет добавлена ссылка для редактирования, которая приведет к ошибочному открытию шаблона для редактирования.
Устаревшие параметры
Эти параметры больше не используются:
- colwidth : То же, что и указание ширины столбца для первого неименованного параметра. Заменяется на width как неименованный первый параметр.
Статьи, использующие неподдерживаемые параметры, отслеживаются в категории «Страницы, использующие список ссылок с неизвестными параметрами» (4).
Шаблон данных
TemplateData для Reflist
Этот шаблон отображает список сносок в конце статьи и предоставляет дополнительные параметры форматирования и организации. После нажатия «Применить изменения» и возврата в режим чтения VE вы не увидите список ссылок. После нажатия «Опубликовать страницу» и возврата в обычный режим чтения список ссылок снова появится с примененными изменениями, см. T53146.
| Параметр | Описание | Тип | Статус | |
|---|---|---|---|---|
| Колонки / Ширина колонки | 1 colwidth | Поддерживаются два режима. Первый режим (устарел): целое число фиксированных столбцов, в которые должен быть отображен список ссылок. Второй режим: типографская единица измерения, например, «em», указывающая ширину столбцов списка ссылок, например, «33em»; интервал «33 em» не будет распознан
| Нить | необязательный |
| Liststyle | liststyle | Указывает стиль, используемый при перечислении списка ссылок; принимает любое допустимое значение CSS, определенное для list-style-type
| Нить | необязательный |
| Группа | group | Группа — это идентификатор, который ограничивает отображаемые ссылки. Без этого параметра этот шаблон показывает только ссылки без идентификатора группы. Если указан идентификатор группы, обрабатываются только ссылки с соответствующим идентификатором группы. Остальные остаются нетронутыми. | Нить | необязательный |
| Список литературы | refs | Предоставляет пространство для определения именованных ссылок для использования в статье. Ссылки, определенные в этом пространстве, не отображаются, если они не используются где-либо в статье. | Нить | необязательный |
Ограничения
Не используйте {{ Reflist }} или другие шаблоны или модули, которые используют {{#tag:references}} в нумерованных или ненумерованных списках, если список находится внутри тега HTML div . Смотрите страницу обсуждения (постоянная ссылка) для примеров и подробностей.
Нет — :{{Reflist}}- Нет — *{{Reflist}}
- Нет — #{{Reflist}}
- Да — {{Reflist}}
Смотрите также
- Wikipedia:Ссылающиеся источники – руководство по стилю цитирования источников
- Wikipedia:Шаблоны цитирования – шаблоны для использования со ссылками
- Помощь:Сокращенные сноски
- {{ Notelist }} и {{ efn }} – шаблоны для использования со сносками
- {{ Refbegin }} и {{ Refend }} – форматирование списков литературы
- T53260 – Поддержка редактирования
<references />тегов для включения/выключения отображения нескольких столбцов
Варианты
- {{ Template reference list }} – версия reflist для использования в шаблонах
- {{ Reflist-talk }} и {{ Sources-talk }} – для использования в разделах страниц обсуждения и других неосновных страницах
Ссылки
- ^ См . User:Edokter/fonttest для сравнения размеров шрифтов для различных браузеров; см. предыдущие обсуждения об изменении размера шрифта для решения проблемы IE.
- ^ "CSS3 Multi-Column Thriller". 30 декабря 2005 г. Получено 24 ноября 2006 г.
- ^ "Модуль CSS3: Многоколоночная компоновка". W3C . 15 декабря 2005 г. Получено 24 ноября 2006 г.
- ^ "columns - CSS: каскадные таблицы стилей | MDN". MDN Web Docs . 21 июня 2023 г. . Получено 6 февраля 2024 г. .
- ^ "Совместимость CSS и Internet Explorer: многоколоночная разметка". Microsoft Docs . Microsoft Developer Network . Получено 2021-03-19 .