На этой странице справки объясняется, как создавать и форматировать списки в английской Википедии.
Существует три типа списков: неупорядоченные списки , упорядоченные списки и списки описаний (они же списки определений или списки ассоциаций ). В следующих разделах для разных примеров используются различные типы списков, но другие типы списков, как правило, дадут соответствующие результаты. Упорядоченные (пронумерованные) списки обычно следует использовать только для элементов списка, которые должны располагаться в определенном порядке, например, шаги в рецепте приготовления пищи .
Между элементами списка не должно быть пустых строк. Пустые строки завершают список, разделяя его на два отдельных списка. Это проще всего проиллюстрировать с помощью упорядоченного списка:
Во втором примере выше нумерация сбрасывается после пустой строки. Эта проблема менее заметна с другими типами списков, но она все равно влияет на базовый код HTML и может иметь разрушительные эффекты для некоторых читателей; см. WP:LISTGAP для получения подробной информации.
Чтобы быть списком, каждая строка должна начинаться одинаково. Это справедливо для смешанных списков.
Эта ошибка может быть менее заметна в некоторых обстоятельствах, но она создает списки из одного элемента разных типов; помимо того, что это семантически неверно, это может вызвать неприятные побочные эффекты для некоторых читателей.
Не используйте точку с запятой просто для того, чтобы дать списку название. Точки с запятой и двоеточия создают один вид списка ; звездочки создают другой.
Все методы, описанные в этом разделе, можно использовать друг с другом и с любым типом списка, на любом уровне списка.
Для простоты элементы списка в чистой вики-разметке не могут быть сложнее базового абзаца. Разрыв строки в вики-разметке элемента списка завершит не только элемент, но и весь список, и сбросит счетчик в упорядоченных списках. Разделение неупорядоченных элементов списка пустыми строками может выглядеть примерно нормально на экране, но это создает много отдельных списков из одного элемента, что является проблемой для людей, использующих программы чтения с экрана , и не рекомендуется руководством по доступности для людей с ограниченными возможностями , а также проблематично для машинного анализа статьи и для повторного использования контента Википедии в целом.
Абзацы можно создавать внутри элементов списка, используя <p>...</p>элемент HTML (paragraph) вокруг второго и последующих абзацев, без переносов строк в вики-разметке :
Не используйте <br>вместо <p>...</p>; они имеют разную семантику и не являются взаимозаменяемыми.
Для удобства чтения кода (улучшение более заметно, когда абзацы длинные, а не в коротких примерах, как в этих), переносы строк можно создавать с помощью HTML-комментариев, <!-- ... -->которые начинаются на одной строке напротив конца кода этой строки и заканчиваются на другой строке напротив начала кода этой строки:
Эту технику можно использовать и с другими примерами, приведенными ниже.
Используйте одинарный символ <br>для переноса строки, не являющегося абзацем, например, когда использование вложенного списка нежелательно, поскольку подпунктам уже предшествуют числа:
Это необходимо сделать с помощью закодированных <br>переносов строк; фактический перенос строки викитекста (т. е. нажатие enter/returnво время написания исходного кода) приведет к завершению списка.
Аналогичное использование HTML может обеспечить блочные цитаты внутри элементов списка:
Другой подобный случай — небольшие вложенные блоки кода:
Здесь переносы строк по-прежнему не могут происходить внутри элемента списка, даже если они находятся внутри <pre>, а трюк с комментариями HTML не работает внутри <pre>, поэтому этот метод подходит только для коротких примеров кода. Для более длинных примеров см. тег <syntaxhighlight> MediaWiki.
Трюк с HTML-комментариями работает между элементами внутри одного и того же элемента списка:
В HTML элемент списка может содержать несколько подсписков, не обязательно смежных; таким образом, части элемента списка могут находиться не только перед первым подсписком, но и между подсписками, и после последнего.
К сожалению, в вики-разметке подсписки следуют тем же правилам, что и разделы страницы: единственная возможная часть элемента списка, не входящая в подсписки, находится перед первым подсписком.
В случае ненумерованного списка первого уровня в вики-разметке это ограничение можно обойти, разделив список на несколько списков; отступ между частичными списками может визуально служить частью элемента списка после подсписка. Однако многие читатели находят это запутанным, так как отступ делает его больше похожим на продолжение последнего элемента подсписка. Кроме того, этот прием может давать, в зависимости от CSS, пустую строку до и после каждого списка, и в этом случае для единообразия каждый элемент списка первого уровня можно сделать отдельным списком, хотя это еще больше усложняет код. Для сложных списков, таких как этот, рекомендуется использовать прием {{ ordered list }} или {{ bulleted list }} и заменять экземпляры версии вики-разметки "quick and dirty" на версию {{ ordered list }} .
Нумерованные списки иллюстрируют, что то, что должно выглядеть как один список, может для программного обеспечения (и, следовательно, для пользователей экранных ридеров для слабовидящих) на самом деле привести к нескольким вложенным спискам. Ненумерованные списки дают соответствующий результат, за исключением того, что проблема перезапуска с 1 неприменима.
Последний из них визуально сбивает с толку и приводит к недействительной разметке. Он вызвал создание встроенного, но неправильно сформированного списка описаний ( <dl>элемент HTML): у него есть определение, обозначенное :(в HTML это <dd>), но нет термина (отсутствующий ;элемент, который соответствует HTML <dt>).
На один уровень глубже, когда элемент подсписка продолжается после подподсписка, мы получаем еще больше пустых строк; однако продолжение списка первого уровня не затрагивается:
Опять же, третий пример нежелателен, поскольку он создает некорректную разметку и в любом случае визуально сбивает с толку.
Для упорядоченного списка с элементами, длина которых превышает один абзац, может потребоваться использование вышеупомянутого трюка с комментарием HTML для добавления пустой строки между элементами в викикоде , чтобы избежать путаницы редактора. Это делается с помощью закомментированной строки:
# Первый элемент <!-- --> # Второй элементЭто не приводит к появлению нежелательных видимых пробелов или плохого кода списка на отображаемой странице, как это произошло бы при добавлении простой пустой строки:
Комментарий должен начинаться на той же строке, на которой заканчивается предыдущий элемент, и заканчиваться на отдельной строке.
Неправильный:
# Первый элемент <!-- --> # Второй элементНеправильный:
# Первый элемент <!----> #Второй элементЕсли отображаемый текст имеет проблемы с читаемостью из-за сложных элементов списка или по какой-либо другой причине требуется пространство между элементами списка, просто добавьте пару явных переносов строк HTML в конец элементов списка:
# Элемент 1 < br >< br > # Элемент 2 < br >< br >дает
Сравните версию без пробела:
Тип списка (какой тип маркера появляется перед элементом списка) можно изменить в CSS, установив свойство list-style-type. Это можно сделать с помощью шаблона {{ Ordered list }} :
Или, используя HTML:
В нумерованном списке с крупным шрифтом некоторые браузеры не отображают более двух цифр (ширина 2 пробела) отступа, если не применяется дополнительный отступ (если есть несколько столбцов: для каждого столбца). Это исправляется путем увеличения отступа по умолчанию 3.2em еще на 2em, и это можно сделать несколькими способами:
При использовании явных <li>элементов списка HTML используйте явный интервал CSS margin 4em, чтобы удвоить интервал по умолчанию 2em. Хотя это и не самый простой, но самый чистый и универсальный метод , поскольку он не полагается ни на какие особенности парсера, ни на злоупотребление какой-либо семантической разметкой в чисто визуальных целях. Он позволяет начинать с числа, отличного от 1 ( см. ниже ). Это рекомендуемый метод для сложных списков .
Парсер преобразует упорядоченный список, <ol>, без каких-либо элементов списка, <li>(в данном случае он содержит только еще один <ol>) в с <div>, style="margin-left: 2em;"вызывая отступ содержимого. Это универсальный, но потенциально запутанный метод , поскольку он позволяет начинать с числа, отличного от 1 ( см. ниже ). Он неуклюжий , излишне сложный и выглядит как недействительный HTML . Хотя парсер исправляет его на лету, об этом знают только эксперты MediaWiki, в результате чего другие редакторы, скорее всего, попытаются «исправить» его, удалив то, что выглядит как избыточный <ol>код.
Просто поместите явный HTML <ol>...</ol>вокруг элементов списка вики-разметки. Он работает так же, как и предыдущий пример с содержимым "упорядоченного списка без каких-либо элементов списка", который сам по себе является упорядоченным списком, выраженным кодами #; созданный HTML, а следовательно, и рендеринг, тот же самый. Это самый простой метод, и он рекомендуется при начале простого списка с номером 1 .
Список из одной или нескольких строк, начинающихся с двоеточия, создает список описаний HTML5 (ранее список определений в HTML4 и список ассоциаций в черновике HTML5) без терминов, которые нужно определить/описать/связать, но с элементами в качестве описаний/определений/ассоциаций, поэтому с отступом. Однако, если двоеточия находятся перед кодами "*" или "#" неупорядоченного или упорядоченного списка, список рассматривается как одно описание/определение, поэтому весь список с отступом.
Устаревший метод : Метод ниже создает плохо сформированную (хотя технически DTD-валидирующую ) разметку и злоупотребляет семантическим назначением HTML списков описаний для чисто визуального эффекта, и, таким образом, является проблемой удобства использования и доступности. Он будет работать в спешке, но его следует заменить более чистым кодом ; см. WP:Manual of Style/Glossaries для нескольких подходов.
Указать начальное значение можно с помощью шаблона {{ ordered list }} , используя атрибуты startи value.
Или:
В качестве альтернативы, только элемент списка, значение которого задается, должен быть написан на HTML, остальная часть списка может использовать синтаксис вики:
Внутри это не работает <ol>...</ol>.
Помимо обеспечения автоматической нумерации, нумерованный список также выравнивает содержимое элементов, что сопоставимо с использованием синтаксиса таблицы:
{| |- | style = "text-align: right" | 9. || Амстердам |- | style = "text-align: right" | 10. || Роттердам |- | style = "text-align: right" | 11. || Гаага |} дает
Такая неавтоматическая нумерация имеет то преимущество, что если текст ссылается на номера, то вставка или удаление элемента не нарушает соответствия.
Оберните список в {{ Columns-list }}, чтобы добавить столбцы.
Эта настройка также работает с нумерованными списками.
{{ columns-list }} — это общее решение. Вы можете комбинировать его с любым другим типом форматирования списков, включая, но не ограничиваясь, каждым типом синтаксиса списков, упомянутым на этой странице. Он также работает с контентом, который не является списками.
Также можно представить краткие списки, используя очень простое форматирование, например:
''Название списка:'' пример 1, пример 2, пример 3
Название списка: пример 1, пример 2, пример 3
Этот стиль занимает меньше места на странице и предпочтителен, если в списке всего несколько записей, его легко читать, и не требуется прямая точка редактирования. Элементы списка должны начинаться со строчной буквы, если только они не являются именами собственными.
См. также WP:HLIST .
Таблица с одним столбцом очень похожа на список, но допускает сортировку. Если сам вики-текст уже отсортирован с тем же ключом сортировки, это преимущество не применяется. Таблица с несколькими столбцами допускает сортировку по любому столбцу.
См. также Справка:Таблица .
Маркеры и номера списков иногда могут перекрывать плавающие слева изображения, а отступы могут отображаться неправильно рядом с плавающими слева изображениями. Например:
Шаблон {{ flowlist }} позволяет спискам избегать этих плавающих слева объектов:
[[ Файл : Westminstpalace.jpg | слева | большой палец | 100px ]] {{ flowlist }} < ol > <li> элемент списка A1 <ol> <li> элемент списка B1 </ li > < li > элемент списка B2 </ li > </ ol > продолжающийся элемент списка A1 < / li > < li > элемент списка A2 </ li > / ol > {{ endflowlist }} {{ flowlist }}Первая линия: Вторая строка :: Третья строка ::: Четвертая строка {{ endflowlist }}Отображается как:
Первая линия
Этот метод не будет работать внутри таблицы, и если ваш список длиннее плавающего элемента, то список не будет обтекать изображение, как обычно, а вместо этого будет представлять собой один блок, оставляя пустое пространство под плавающим элементом.
Практически все, что касается отображения списков, можно настроить на стороне пользователя с помощью CSS . Некоторые из наиболее полезных настроек описаны ниже. Конечно, вы вводите код в режиме текстового редактора — если вы вводите его в режиме WYSIWYG, он вводится с использованием экранированных символов. Кроме того, если вы вводите HTML в текстовом редакторе и переключаетесь в режим WYSIWYG, HTML теряется и снова преобразуется в markdown без стилей.
Как отмечено выше, в нумерованном списке с крупным шрифтом некоторые браузеры не отображают более двух цифр ширины отступа, если не применяется дополнительный отступ (если есть несколько столбцов; тогда отступ для каждого столбца). Хотя это должно быть исправлено в викикоде, пользовательская таблица стилей CSS может обойти эту проблему, пока она присутствует, увеличив отступ по умолчанию с 3,2em еще на 2em:
ol { margin-left : 5.2 em ;} С помощью следующего пользовательского стиля CSS, неупорядоченные списки заменяются упорядоченными для зрячих пользователей ( но не для пользователей, которые должны использовать вспомогательные технологии ). Это применимо (насколько селектор CSS не ограничивает это) ко всем ul-спискам в исходном коде HTML:ul { list-style: decimal; }
Поскольку каждая специальная страница, как и другие страницы, имеет класс, основанный на имени страницы, для каждого типа можно отдельно указать, следует ли упорядочивать списки, см. Справка:Вклад пользователей#Пользовательские стили и Справка:Что здесь ссылается#Пользовательские стили .
Однако, по-видимому, невозможно сделать все списки истории страниц упорядоченными (если только не сделать все списки упорядоченными), поскольку имя класса основано на странице, для которой просматривается история.
Самый простой способ найти соответствующие статьи для нового списка или отсутствующие записи в существующем — найти наиболее соответствующую категорию и проверить ее записи. Иногда списки посвящены вещам, которые являются пересечениями категорий, для которых можно использовать инструмент PetScan.
Более релевантные статьи также можно найти по ссылкам в статье темы списка и статьях, уже представленных в списке — чаще всего в разделах «См. также» (если они есть) и автоматически предлагаемых «СВЯЗАННЫХ СТАТЬЯХ» под ними.
Другие способы найти соответствующие статьи включают поиск в Википедии по теме списков и поиск в Интернете по теме в кавычках ( "с синонимами, также в кавычках и добавленными после OR), а также добавление к ним слова wikiили .Wikipediasite:Wikipedia.org
Наконец, инструмент « Что здесь ссылается » можно использовать в статье темы списка для поиска соответствующих статей.
Для списков, записи которых не требуют наличия статьи в Википедии, существуют дополнительные способы поиска соответствующих записей, такие как списки на внешних веб-сайтах (например, Goodreads для книг) — обычно с использованием веб-поиска.
