Table of Contents

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

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

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

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

Пример:

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

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

  1. Первый элемент
  2. Второй элемент с переносом строки
    вторая строка
  3. Третий элемент с тэгом code:
    Немного кода
    здесь
  4. Четвертый элемент

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

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

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

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

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

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

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

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

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

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

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

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

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; }

Вы можете просмотреть все допустимые значения для list-style-type в руководстве CSS, например MDN.

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

:!: The bullet format для неупорядоченных списков также определен с помощью 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__;
}

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

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; }

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

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: '✩';}

Вы можете легко переопределить это в Вашем userstyle.css.

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

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