====== Работа со списками ======

===== Многострочные списки элементов =====

:?: Как я могу добавить блок кода или несколько строк в элемент списка?

:!: Синтаксис списка ожидает, что Вы поместите каждый элемент в одну строку и Вы не можете прерывать нумерованные списки или индекс такого списка начнется с единицы. Это делает невозможным, например, добавлять таблицы в элемент списка. Тем не менее, Вы можете добавить code/file блок или перенос строки в элемент списка. Для блоков кода убедитесь, что они начинаются на той же строке, что и Ваш элемент, для переноса строки используйте форсированный перенос строки ''%%\\%%''.

Пример:

<file>
  - Первый элемент 
  - Второй элемент с переносом строки\\ вторая строка
  - Третий элемент с тэгом code: <code>
Немного кода
здесь
</code>
  - Четвертый элемент
</file>

Это будет выглядеть следующим образом:

  - Первый элемент
  - Второй элемент с переносом строки\\ вторая строка
  - Третий элемент с тэгом code: <code>
Немного кода
здесь
</code>
  - Четвертый элемент

Вы можете использовать этот трюк, чтобы включить в список другой синтаксис, например таблицы, используя плагин [[plugin:wrap]].

===== Продолжение нумерации списков =====

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

:!: Нет, в текущий момент это невозможно с синтаксисом списка по-умолчанию. Как только один список заканчивается - нумерация начинается заново:

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

Больше не список

  - Третий элемент? Нет, это первый элемент второго списка
</code>

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

Больше не список

  - Третий элемент? Нет, это первый элемент второго списка

===== Стили в нумерации упорядоченных списков =====

:?: Мне не нравится нумерация в упорядоченных списках. Как это изменить?

:!: Формат чисел определен с помощью CSS. Шаблон по-умолчанию определяет форматирование для первых 4 уровней нумерованных списков:

<code css>
div.dokuwiki ol { list-style-type: decimal; }
div.dokuwiki ol ol { list-style-type: upper-roman; }
div.dokuwiki ol ol ol { list-style-type: lower-alpha; }
div.dokuwiki ol ol ol ol { list-style-type: lower-greek; }
</code>

Вы можете просмотреть все допустимые значения для ''list-style-type'' в руководстве CSS, например [[https://developer.mozilla.org/en-US/docs/Web/CSS/list-style-type|MDN]].

===== Стили в нумерации неупорядоченных списках =====
:!: The bullet format для неупорядоченных списков также определен с помощью CSS. Выглядит это следующим образом:

<code css>
div.dokuwiki ul {
  line-height: 1.5em;
  list-style-type: square;
  list-style-image: none;
  margin: 0 0 1em 3.5em;
  color: __text_alt__;
}
</code>

и Вы можете изменить его, в том числе этим:

<code css>
div.dokuwiki ul { list-style-type: disc; }
div.dokuwiki ul ul { list-style-type: circle; }
div.dokuwiki ul ul ul { list-style-type: square; }
div.dokuwiki ul ul ul ul { list-style-type: square; }
</code>

Печально, но Вы можете выбирать между символами ''круг'', ''диск'' и ''квадрат''. Если Вы хотите другой символ Unicode (в т.ч. [[wpde>Unicodeblock Dingbats]]) без использования картинки, то попробуйте:

<code css>
div.dokuwiki ul .li:before {content: '➤';}
div.dokuwiki ul ul .li:before {content: '♫';}
div.dokuwiki ul ul ul .li:before {content: '☛';}
div.dokuwiki ul ul ul ul .li:before {content: '⤷';}
div.dokuwiki ul ul ul ul ul .li:before {content: '✩';}
</code>

Вы можете легко переопределить это в Вашем [[devel:css#user_styles|userstyle.css]].

===== Плагины списков =====

Есть несколько плагинов, которые реализуют альтернативный синтаксис для списков, включая определение списков, и могут сделать возможными вещи, которые нельзя реализовать с помощью синтаксиса по умолчанию. Смотрите [[plugintag>list|плагины, отмеченные тегом list]].