WikiDer > Справка: Список - Википедия

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

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

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

Основы списка

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

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

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

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

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

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

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

* Новый абзац в элементе также является HTML. 
 Вот так 
 * То же самое касается 
 «блочных цитат» 
 вроде этого. * Обратите внимание, что это делается без разрыва строки wikimarkup.

Распространенные ошибки

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

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

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

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

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

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

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

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

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

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

Абзацы и другие разрывы

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

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

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

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

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

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

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

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

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

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

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

# Соберите ингредиенты: 
 1 {{frac | 1 | 2}} чайную ложку глаза тритона (в порошке) 
 2 крылышка летучей мыши 
 4 чашки сока корня мандрагоры # Перемешайте в котле на слабом огне 30 минут

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

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

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

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

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

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

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

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

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

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

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

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

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

<ol>  <li>list item A1    <ol>      <li>list item B1</li>      <li>list item B2</li>    </ol>continuing list item A1  </li>  <li>list item A2</li></ol>

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

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

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

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

Смотрите также m: Шаблон: Демо-список (обратные ссылки редактировать).

Расстояние между элементами

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

# Первый элемент  # Второй элемент

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

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

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

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

# Первый элемент  # Второй элемент

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

# Первый элемент  # Второй элемент

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

# Пункт 1 
 
 # Пункт 2 
 

дает

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

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

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

Изменение типа списка

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

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

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

<ol style="list-style-type: lower-roman;">  <li>About the author</li>  <li>Foreword to the first edition</li>  <li>Foreword to the second edition</li></ol>

Дополнительный отступ списков

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

При использовании явного HTML <li> Для элементов списка используйте явный интервал полей 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 | ghi}}

Парсер переводит упорядоченный список, <ol>, без элементов списка, <li> (в данном случае он содержит еще один <ol>) в <div> с 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: Показать демо демонстрирует, что некоторые из этих методов показывают все цифры трехзначных чисел (т.е. могут обрабатывать списки до 999 элементов без проблем с отображением даже в довольно больших шрифтах).

Указание начального значения

Указать начальное значение можно с помощью {{упорядоченный список}} шаблон с помощью Начните и ценить атрибуты.

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

Или же:

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

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

# 
 Амстердам 
 # Роттердам # Гаага

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

Сравнение с таблицей

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

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

дает

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

Многоколоночные списки

Оберните список в {{Столбцы-список}} для добавления столбцов.

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

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

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

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

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

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

В сочетании с дополнительным отступом с помощью | пробел = параметр:

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

дает

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

{{пронумерованный список с несколькими столбцами | 125 | a

f}} →

а bb ccc

ддд ее

ж

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

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

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

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

Название списка: пример 1, пример 2, пример 3

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

Смотрите также WP: HLIST.

Столы

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

Смотрите также Справка: Таблица.

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

Ярлык

• WP: EISL

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

Разметка	Отображается как
[[File: Westminstpalace.jpg | left | thumb | 100px]] элемент списка A1 элемент списка B1 элемент списка B2 продолжение элемента списка A1 элемент списка A2	элемент списка A1 элемент списка B1 элемент списка B2 элемент продолжающегося списка A1 элемент списка A2
[[Файл: Westminstpalace.jpg | left | thumb | 100px]] Первая строка: Вторая строка :: Третья строка ::: Четвертая строка	Первая линия Вторая линия Третья линия Четвертая линия

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

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

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

1. элемент списка A1
   1. элемент списка B1
   2. элемент списка B2
   элемент продолжающегося списка A1
2. элемент списка A2

Первая линия

Вторая линия

Третья линия

Четвертая линия

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

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

Дальнейшая информация: Справка: вклад пользователей § Пользовательские стили

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

Дополнительный отступ

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

 ол { маржа слева: 5.2Эм;}

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

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

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

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

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

  Как найти записи в списке

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

  Ссылки на более релевантные статьи также можно найти в тематической статье списка и статьях, уже включенных в список - чаще всего в их "Смотрите также" разделы (если они есть) и автоматически предлагаемые «СТАТЬИ ПО ТЕМЕ» под ними.

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

  Наконец "Какие ссылки здесь"-tool можно использовать в статье по теме списка, чтобы найти соответствующие статьи.

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

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

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