Справка: Список

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

Ярлык H: СПИСОК

На этой странице справки объясняется, как создавать и редактировать списки в английской Википедии.

Основы списка [ править ]

Есть три типа списков: неупорядоченные списки , упорядоченные списки и списки описаний (также известные как списки определений или списки ассоциаций ). В следующих разделах для разных примеров используются различные типы списков, но другие типы списков обычно дают соответствующие результаты. Упорядоченные (нумерованные) списки обычно следует использовать только для элементов списка, которые должны быть в определенном порядке, например, шаги в рецепте приготовления .

* Списки легко сделать: ** начинать каждую строку * со звезды ** больше звездочек означает *** более глубокие уровни

* Новая строка * в спискеотмечает конец списка. Конечно* вы можете * начать заново.

# Нумерованные списки хороши ## очень организованы ## просты в использовании

Описание (определение, ассоциация) списков :; Срок: Описаниеили же; Срок: ОписаниеМожет использоваться не только для терминов и определений «как таковых» .или же; Срок: Строка описания 1: Строка описания 2

* Или создать смешанные списки * # и вложить их * # * вот так.* # * ; Фрукты * # * : Яблоко * # * : Черника

# Разрыв строки в элементе делается с помощью HTML <br /> вот так.# Простой разрыв строки приведет к случайному завершению списканравится.# Это должен был быть пункт 3, а не новый список.

* Новый абзац в элементе также является HTML. <p> Вот так. </p> * То же самое и для <blockquote> "блочных цитат" </blockquote> вроде этого.* Обратите внимание, что это делается без разрыва строки в вики-разметке.

Распространенные ошибки [ править ]

Между элементами списка не должно быть пустых строк. Пустые строки завершают список, разделяя его на два отдельных списка. Проще всего это проиллюстрировать с помощью упорядоченного списка:

# Это первый элемент.# Это второй пункт.# Это третий пункт.# Это четвертый пункт.

# Это первый элемент.# Это второй пункт.# Это третий пункт.# Это четвертый пункт.

Во втором примере выше нумерация сбрасывается после пустой строки. Эта проблема менее заметна с другими типами списков, но по-прежнему влияет на базовый HTML-код и может иметь разрушительные последствия для некоторых читателей; подробности см. в WP: LISTGAP .

Чтобы быть списком, каждая строка должна начинаться одинаково. Это верно для смешанных списков.

# Если вы начнете с# один тип списка,#; а затем подсписок#: другого типа,#: * символы списка# всегда идти по порядку.

# Если вы перевернете# приказ,;# все: # получает*: # скинул# и ничего не совпадает.

Эта ошибка также может быть менее заметной в некоторых обстоятельствах, но она создает списки из отдельных элементов разных типов; Помимо семантической ошибки, это может вызвать у некоторых читателей деструктивные побочные эффекты.

Не используйте точку с запятой просто для названия списка. Точки с запятой и двоеточия составляют один вид списка ; звездочки делают другое.

;Никогда не делай*это

Абзацы и другие разрывы [ править ]

Все методы, описанные в этом разделе, можно использовать друг с другом и с любым типом списка на любом уровне списка.

Абзацы внутри элементов списка [ править ]

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

Абзацы могут быть созданы внутри элементов списка с помощью <p>...</p>элемента HTML (абзац) вокруг второго и последующих абзацев без разрывов строк в вики-разметке :

# Абзац 1. <p> Пункт 2. </p> <p> Пункт 3. </p> # Второй пункт.

Не использовать <br />вместо <p>...</p>; они имеют разную семантику и не взаимозаменяемы.

Для удобочитаемости кода (улучшение более очевидно, когда абзацы длинные, а не короткие примеры, подобные этим), разрывы строк могут быть созданы с помощью комментариев HTML <!-- ... -->, которые начинаются на одной строке с концом кода этой строки и заканчиваются на другая строка, напротив начала кода этой строки:

# Пункт 1. <! - -> <p> Параграф 2. </p> <! - -> <p> Пункт 3 </p># Второй элемент.

Этот метод можно использовать с другими примерами, приведенными ниже.

Разрывы строк внутри элементов списка [ править ]

Используйте одиночный символ <br />для разрыва строки без абзаца, например, если использование вложенного списка нежелательно, потому что подпунктам уже предшествуют числа:

# Соберите ингредиенты: <br /> 1 {{ frac | 1 | 2 }} & nbsp; чайная ложка глаза тритона (порошка) <br /> 2 крылышка летучей мыши <br /> 4 & nbsp; чашки сока корня мандрагоры # Перемешать в казане на слабом огне в течение 30 минут.

Это должно быть сделано с помощью кодированных <br />разрывов строк; фактический разрыв строки викитекста (т.е. нажатие enter/returnво время написания исходного кода) завершит список.

Вложенные блоки внутри элементов списка [ править ]

Подобное использование HTML может обеспечить блочные цитаты в элементах списка:

* Начало первого пункта. <blockquote> Большая цитата. </blockquote> Остаток первого элемента.* Второй пункт.

Другой подобный случай - небольшие вложенные блоки кода:

Шаблон {{ tnull | fnord }} имеет два параметра: # {{ para | foo }} Указывает уровень "foo" : <pre> {{ fnord | foo = 20 }} </pre> # {{ para | bar }} Это означает ...

Здесь разрывы строк по-прежнему не могут происходить внутри элемента списка, даже если они находятся внутри <pre>, а трюк с HTML-комментарием внутри не работает <pre>, поэтому этот метод подходит только для примеров короткого кода. Для более длинных см в тег MediaWiki .

Уловка с комментариями HTML работает между элементами внутри одного и того же элемента списка:

* Начало первого пункта. <! --> <blockquote> Большая цитата. </blockquote> <! - -> Остальная часть первого элемента.* Второй пункт.

Продолжение элемента списка после подпункта [ редактировать ]

В HTML элемент списка может содержать несколько подсписок, не обязательно смежных; таким образом, части элемента списка могут быть не только перед первым подсписком, но также между подсписками и после последнего.

К сожалению, в wikimarkup подсписки подчиняются тем же правилам, что и разделы страницы: единственная возможная часть элемента списка, не входящая в подсписки, находится перед первым подсписком.

В случае ненумерованного списка первого уровня в wikimarkup это ограничение можно несколько обойти, разделив список на несколько списков; Текст с отступом между частичными списками может визуально служить частью элемента списка после подсписка. Однако многих читателей это сбивает с толку, так как отступ делает его больше похожим на продолжение последнего элемента подсписка. Кроме того, этот метод может дать, в зависимости от CSS, пустую строку до и после каждого списка, и в этом случае для единообразия каждый элемент списка первого уровня может быть сделан отдельным списком, что еще больше усложняет код. Для сложных списков, подобных этому, рекомендуется использовать технику {{ упорядоченный список }} или {{ маркированный список }} и заменять экземпляры "быстрой и грязной" версии вики-разметки на {{упорядоченный список }} версия.

Нумерованные списки показывают, что то, что должно выглядеть как один список, может для программного обеспечения (и, следовательно, для пользователей программ чтения с экрана для слабовидящих) на самом деле привести к созданию нескольких вложенных списков. Ненумерованные списки дают соответствующий результат, за исключением того, что проблема перезапуска с 1 не применима.

< ol >  < li > элемент списка A1 < ol >  < li > элемент списка B1 </ li >  < li > элемент списка B2 </ li >  </ ol > продолжение элемента списка A1 </ li >  < li > элемент списка A2 </ li > </ ol >

{{упорядоченный список | элемент списка A1 {{упорядоченный список | элемент списка B1 | элемент списка B2 }} продолжение пункта списка A1 | элемент списка A2}}

# элемент списка A1## элемент списка B1## элемент списка B2#: продолжение пункта списка A1?# элемент списка A2

Последний из них сбивает с толку и приводит к недействительной разметке. Это привело к созданию встроенного, но неправильно сформированного списка описаний ( <dl>элемент HTML): у него есть определение, обозначенное :(в HTML <dd>), но нет термина (отсутствующий ;элемент, соответствующий HTML <dt>).

На один уровень глубже, когда элемент подсписка продолжается после подсписка, появляется еще больше пустых строк; однако это не влияет на продолжение списка первого уровня:

< ol >  < li > элемент списка A1 < ol >  < li > элемент списка B1 < ol >  < li > элемент списка C1 </ ol > продолжение элемента списка B1 </ li >  < li > элемент списка B2 </ li >  < / ol >  </ li >  < li > элемент списка A2 </ li > </ ol >

{{упорядоченный список | элемент списка A1 {{упорядоченный список | элемент списка B1 {{упорядоченный список | элемент списка C1 }} продолжение элемента списка B1 | элемент списка B2 }} | элемент списка A2}}

# элемент списка A1## элемент списка B1### элемент списка C1##: продолжение пункта списка B1?## элемент списка B2# элемент списка A2

Опять же, третий пример нежелателен, так как он создает неправильную разметку и в любом случае визуально сбивает с толку.

См. Также meta: Template: List demo .

Расстояние между элементами [ править ]

Для упорядоченного списка с элементами, длина которых превышает один абзац, может потребоваться упомянутый выше трюк с HTML-комментариями для добавления пустой строки между элементами в викикоде , чтобы избежать путаницы в редакторе. Это делается с помощью закомментированной строки:

# Первый элемент <! - -># Второй предмет

Это не приводит к появлению нежелательных видимых интервалов или неправильного кода списка на отображаемой странице, как если бы добавление простой пустой строки:

1. Первый предмет
2. Второй предмет

Комментарий должен начинаться на той же строке, на которой заканчивается предыдущий элемент, а комментарий должен заканчиваться на отдельной строке.

Неправильный:

# Первый элемент<! - -># Второй предмет

Неправильный:

# Первый элемент<! --> # Второй элемент

Если отображаемый текст имеет проблемы с удобочитаемостью из-за сложных элементов списка или по какой-либо другой причине между элементами списка требуется пространство, просто добавьте пару явных разрывов строк HTML в конец элементов списка:

# Пункт 1 <br /> <br /> # Пункт 2 <br /> <br />

дает

1. Пункт 1
   
   
2. Пункт 2
   
   

Сравните версию без интервала:

1. Пункт 1
2. Пункт 2

Изменение типа списка [ править ]

Тип списка (какой тип маркера появляется перед элементом списка) можно изменить в CSS, установив свойство list-style-type . Это можно сделать с помощью шаблона {{ Упорядоченный список }}:

{{упорядоченный список | тип = нижний римский алфавит | Об авторе | Предисловие к первому изданию | Предисловие ко второму изданию}}

Или, используя HTML:

< ol  style = "list-style-type: lower-roman;" >  < li > Об авторе </ li >  < li > Предисловие к первому изданию </ li >  < li > Предисловие ко второму изданию </ li > </ ol >

Дополнительный отступ списков [ править ]

В нумерованном списке крупным шрифтом некоторые браузеры не показывают отступа более двух цифр (шириной 2 пробела), если не применяется дополнительный отступ (если имеется несколько столбцов: для каждого столбца). Это исправляется путем увеличения отступа по умолчанию 3.2em на 2em больше, и это можно сделать несколькими способами:

При использовании явных <li>элементов списка HTML используйте явный интервал полей CSS 4em, чтобы удвоить интервал по умолчанию 2em. Хотя это и не самый простой, это самый чистый и универсальный метод , поскольку он не полагается ни на какие особенности парсера, ни на злоупотребление какой-либо семантической разметкой в чисто визуальных целях. Это позволяет начинать с числа, отличного от 1 ( см. Ниже ). Это рекомендуемый метод для сложных списков .

< ol  style = "margin-left: 5.2em;" >  < li > abc </ li >  < li > def </ li >  < li > ghi </ li > </ ol >

{{упорядоченный список | style = margin-left: 2em | abc | def | Гхи}}

Синтаксический анализатор переводит упорядоченный список <ol>без каких-либо элементов списка <li>(в данном случае он содержит только другой <ol>) в a <div>с a style="margin-left: 2em;", вызывая отступ содержимого. Это универсальный, но потенциально сбивающий с толку метод , поскольку он позволяет начинать с числа, отличного от 1 ( см. Ниже ). Он беспорядочный , излишне сложный и выглядит как недопустимый HTML . Хотя синтаксический анализатор исправляет это на лету, это знают только эксперты MediaWiki, в результате чего другие редакторы, вероятно, попытаются «исправить» это, удалив то, что выглядит как избыточный <ol>код.

< ol >  < ol >  < li > abc </ li >  < li > def </ li >  < li > ghi </ li >  </ ol > </ ol >

Просто поместите явный HTML <ol>...</ol>-код вокруг элементов списка вики-разметки. Он работает так же, как и предыдущий пример, с содержимым «упорядоченного списка без каких-либо элементов списка», который сам по себе является упорядоченным списком, выраженным с помощью # кодов; созданный HTML и, следовательно, рендеринг, такие же. Это простейший метод, который рекомендуется использовать при запуске простого списка с номера 1 .

<ol> # abc # def # ghi </ol>

Список из одной или нескольких строк, начинающихся с двоеточия, создает список описаний HTML5 (ранее список определений в HTML4 и список ассоциаций в черновике HTML5) без терминов, которые необходимо определить / описать / связать, но с элементами в виде описаний / определений / ассоциаций , следовательно, с отступом. Однако, если двоеточия ставятся перед кодами «*» или «#» неупорядоченного или упорядоченного списка, список рассматривается как одно описание / определение, поэтому весь список имеет отступ.

Устаревший метод . Приведенный ниже метод создает плохо сформированную (хотя технически DTD-валидацию ) разметку и злоупотребляет семантическим назначением HTML списков описаний для чисто визуального эффекта и, таким образом, является проблемой удобства использования и доступности. Он будет работать в спешке, но его следует заменить более чистым кодом ; см. WP: Руководство по стилю / глоссарии для нескольких подходов.

: # abc: # def: # ghi 

Демонстрация страницы meta: Help: List демонстрирует, что некоторые из этих методов показывают все цифры трехзначных чисел (т. Е. Могут обрабатывать списки до 999 элементов без проблем с отображением даже в довольно больших шрифтах).

Указание начального значения [ править ]

Определение исходного значения можно с {{ упорядоченного списка }} шаблоном, используя startи valueатрибуты.

{{упорядоченный список | начало = 9| Амстердам| Роттердам| Гаага}}

Или же:

{{упорядоченный список| item1_value = 9 | 1 = Амстердам| item2_value = 8 | 2 = Роттердам| item3_value = 7 | 3 = Гаага}}

В качестве альтернативы, только элемент списка, значение которого устанавливается, необходимо записать в HTML, остальная часть списка может использовать синтаксис wiki:

#  <li value = "9"> Амстердам </li> # Роттердам # Гаага

Это не работает внутри <ol>...</ol>.

Сравнение с таблицей [ править ]

Нумерованный список не только обеспечивает автоматическую нумерацию, но и выравнивает содержимое элементов, что сравнимо с использованием синтаксиса таблицы:

{|| -| style = "text-align: right" | 9. || Амстердам| -| style = "text-align: right" | 10. || Роттердам| -| style = "text-align: right" | 11. || Гаага|}

дает

Эта неавтоматическая нумерация имеет то преимущество, что, если текст относится к номерам, вставка или удаление элемента не нарушает корреспонденцию.

Многоколоночные списки [ править ]

Оберните список в {{ Columns-list }}, чтобы добавить столбцы.

{{список-столбцов | colwidth = 10em |* 1* 2* 3* 4* 5}}

Эта настройка также работает с нумерованными списками.

{{список-столбцов | colwidth = 10em |# а# б# c# d # е}}

{{ Колонки-лист }} является общим решением. Вы можете комбинировать его с любым другим типом форматирования списка, включая, помимо прочего, каждый тип синтаксиса списка, упомянутый на этой странице. Он также работает с контентом, который не является списком.

Многоколоночный нумерованный список [ править ]

Если вы хотите сделать это, вы можете разделить нумерованный список на несколько меньших списков, по одному на столбец. В этом случае полезно указать начальное значение, чтобы избежать перезапуска с одного в каждом столбце. Как упоминалось выше, это возможно только с HTML-синтаксисом (для первого столбца можно использовать wiki-синтаксис или HTML-синтаксис).

В сочетании с дополнительным отступом, используя |gap=параметр:

{{col-begin | width = auto}}{{col-break | gap = 2em}}{{упорядоченный список | начало = 125 | a | bb | ccc}}{{col-break | gap = 2em}}{{упорядоченный список | start = 128 | ddd | ee | f}}{{col-end}}

дает

Используя {{ пронумерованный список с несколькими столбцами }}, вычисление начальных значений может быть автоматизировано, и необходимо указать только первое начальное значение и количество элементов в каждом столбце, кроме последнего. Добавление элемента в столбец или удаление элемента из столбца требует настройки только одного числа, количества элементов в этом столбце, вместо изменения начальных номеров для всех последующих столбцов.

{{multi-column numbered list|125|a<li>bb<li>ccc|3|<li>ddd<li>ee<li>f}} →

Вы можете указать тип списка CSS с помощью параметра lst:

{{multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}} →

{{multi-column numbered list|lst=disc|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}} →

Обратите внимание, что начальные значения каждого столбца (125, +3, +2) не действуют, когда используется нечисловой тип списка дисков.

Обтекаемый стиль или горизонтальный стиль [ править ]

Также можно представить короткие списки, используя очень простое форматирование, например:

'' Заголовок списка: '' пример 1, пример 2, пример 3

Заголовок списка: пример 1, пример 2, пример 3

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

См. Также WP: HLIST .

Таблицы [ править ]

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

См. Также Help: Table .

Взаимодействие с плавающими элементами [ править ]

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

[[File: Westminstpalace.jpg | left | thumb | 100px]] < ol >  < li > элемент списка A1 < ol >  < li > элемент списка B1 </ li >  < li > элемент списка B2 </ li >  </ ol > продолжение элемента списка A1 </ li >  < li > элемент списка A2 </ li > </ ol >

[[Файл: Westminstpalace.jpg | left | thumb | 100px]] Первая строка:Вторая линия:: Третья линия::: Четвертая строка

Шаблон {{ flowlist }} позволяет спискам держаться подальше от этих плавающих влево объектов:

[[Файл: Westminstpalace.jpg | left | thumb | 100px]]{{ flowlist }} <ol>  <li> элемент списка A1 <ol>  <li> элемент списка B1 </li>  <li> элемент списка B2 </li>  </ol> продолжающийся элемент списка A1 </li>  < li> элемент списка A2 </li>  </ol>
{{ endflowlist }}{{ flowlist }}Первая строка:Вторая линия:: Третья линия::: Четвертая строка{{ endflowlist }}

Отображается как:

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

Управление списками с помощью пользовательских таблиц стилей [ править ]

Практически все, что касается отображения списков, можно настроить на стороне пользователя с помощью CSS . Некоторые из наиболее полезных настроек описаны ниже. Конечно, вы вводите код в режиме текстового редактора - если вы вводите его в режиме WYSIWYG, он вводится с использованием escape-символов. Кроме того, если вы вводите HTML в текстовом редакторе и переключаетесь в режим WYSIWYG, HTML теряется и повторно конвертируется в уценку без стилей.

Дополнительный отступ [ править ]

Как отмечалось выше , в нумерованном списке крупным шрифтом некоторые браузеры не показывают более двух цифр ширины отступа, если не применяется дополнительный отступ (если имеется несколько столбцов; затем отступ для каждого столбца). Хотя это должно быть исправлено в викикоде, пользовательская таблица стилей CSS может обойти проблему до тех пор, пока она присутствует, путем увеличения отступа по умолчанию 3.2em еще на 2em:

 ol  {  margin-left :  5.2 em ;}

Замена неупорядоченных списков на упорядоченные [ править ]

С помощью следующего CSS стиля пользователя неупорядоченные списки заменяются упорядоченными для зрячих пользователей ( но не пользователей, которые должны использовать вспомогательные технологии ). Это применимо (если селектор CSS не ограничивает это) ко всем спискам ul в исходном коде HTML:ul { list-style: decimal; }

• произведенные с *
• те, у кого в викитексте есть <ul>
• производимые системой

Поскольку каждая специальная страница, как и другие страницы, имеет класс, основанный на имени страницы, можно отдельно указать для каждого типа, следует ли упорядочивать списки, см. Справка: Вклад пользователя # Стили пользователя и Справка: Какие ссылки здесь # Стили пользователя .

Однако не представляется возможным упорядочить все списки истории страниц (если не упорядочить все списки), потому что имя класса основано на странице, для которой просматривается история.

Как найти записи в списке [ править ]

Самый простой способ найти подходящие статьи для нового списка или отсутствующие записи в существующем - это найти наиболее подходящую категорию и проверить ее записи. Иногда списки касаются вещей, которые являются пересечением категорий, для которых можно использовать инструмент PetScan .

Ссылки на более релевантные статьи также можно найти в тематической статье списка и статьях, уже включенных в список - чаще всего в их разделах «См. Также» (если они есть) и в автоматически предлагаемых «РОДСТВЕННЫХ СТАТЬЯХ» под ними.

Другие способы поиска релевантных статей включают поиск в Википедии темы списков и поиск в Интернете темы в кавычках "(синонимы также в кавычках и добавляются после OR) и добавление к ним слова wikiили Wikipediaили site:Wikipedia.org.

И, наконец, инструмент « Какие ссылки здесь » можно использовать в статье по теме списка, чтобы найти соответствующие статьи.

Для списков, которые не требуют наличия статей в Википедии, существуют дополнительные способы поиска соответствующих записей, такие как списки на внешних веб-сайтах (например, Goodreads для книг) - обычно с использованием веб-поиска.

См. Также [ править ]

• MOS: PLIST , в котором объясняется форматирование списков без маркировки.
• Википедия: Руководство по стилям / спискам , для предлагаемых стилей списков.
• Категория шаблонов форматирования списка .
• (  {{·}} И {{•}} , точки ( вставки ) и маркеры, которые можно использовать для разделения элементов в горизонтальных списках без использования разметки списков HTML.)
  Более доступный, управляемый и семантически надежный метод - это использовать {{ flatlist }} или класс "hlist".
• Википедия: обработка разрыва строки , включая то, как обрабатывать перенос строки в горизонтальных списках.
• Википедия: Служба поддержки , чтобы задать вопросы об использовании списков в статьях, если вы не смогли найти здесь нужную информацию.