======StepByStep для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Отображает пошаговые руководства, спойлеры или дополнительную информацию по теме. Целью плагина является отображение информации (в виде поля), которое можно развернуть, щелкнув по нему, чтобы показать более подробную информацию.


  * **Релиз:** 2023-08-25. 
  * **Репозиторий:**https://github.com/saggi-dw/dokuwiki-plugin-stepbystep/
  * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" 

=====Совместимость=====

    * :!: [[config:defer_js| Параметр конфигурации: для параметра defer_js]] должно быть установлено значение true!
=====Монтаж=====
Используйте менеджер плагинов для установки или…

  - скачать zip-файл
  - распаковать его в<dokuwiki>/lib/plugins/
  - войдите как администратор и измените плагин в менеджере конфигурации
=====Применение=====
Простое поле с заголовком создается следующим образом:
<code>
#: Название скрытого контента.
Здесь находится скрытый контент
:#
</code>
#: Название скрытого контента.
Здесь находится скрытый контент
:#

На изображении показано следующее:
<code>
#: Шаг 1
Если вы это уже знаете, вы также можете продолжить с [[#шага 3]].

еще текст...
:#

#: Шаг 2
Еще больше текста...
:#

#: Шаг 3 ||open

Наконец, сделали :-)
:#
</code>
#: Шаг 1
Если вы это уже знаете, вы также можете продолжить с [[#шага 3]].

еще текст...
:#

#: Шаг 2
Еще больше текста...
:#

#: Шаг 3 ||open

Наконец, сделали :-)
:#


===== Конфигурация и настройки =====

Имеется два начальных ( %%''#:''%%, %%''##:''%%) и два закрывающих ( %%'':#''%%, %%'':##''%%) тега. Полноценная коробочка создается по следующей схеме:

  - Начало: ''#'': ''title''[ ''||options'']''/n''
  - Содержание:''content''
  - Конец:'':#'' ''/n''
Это ''title'' необязательно, но без заголовка оно не имеет смысла. Здесь разметка «ДокуВики» не анализируется. Каждый заголовок становится якорем блока в соответствии с соглашениями об именах «ДокуВики». Недопустимые символы заменяются на ''_''. Это также относится к '':''. Это позволяет (например, в инструкциях) пропускать шаги, указав соответствующий целевой шаг в ссылке (например: ''%%[[#step_3|step 3]]%%'' ссылка на поле с заголовком ''Step 3'' на той же странице).

:!:Теги должны располагаться отдельно в одной строке.

Это ''content'' также необязательно. Но и без контента работать бессмысленно. Понимает ''content'' разметку DokuWiki.

''Options'' возможны в начальном теге. Они отделены от заголовка двойной чертой (''||''). Каждая отдельная опция должна быть отделена от следующей пробелом. На данный момент поддерживаются следующие опции:



^Value^Description^Example^
|open|развернуть поле по умолчанию|%%''#: Step 1||open''%%|
|preview:''xxx''|расширить часть поля до указанной высоты, где ''xxx'' указана длина CSS|%%''#: Step 1||preview:5em''%%|

Возможна вложенность уровней, <del>но только если теги используются поочередно.</del>.

<code>
Вот еще информация
о последней книге, которую я прочитал.

#: Это история о...
...здесь можно писать много
о содержании

Lorem ipsum dolor сидеть amet...

##: Следующий раздел содержит спойлеры...
Duis autem vel eum iriure...
:##

Ut wisi enim ad minim veniam, ...
:#

Мне это очень понравилось!

#: Джордж Оруэлл: 1984 (подробнее) ||open

\\  
^Название:|1984 |
^Автор:|Оруэлл, Джордж|
:#
</code>

Вот еще информация
о последней книге, которую я прочитал.

#: Это история о...
...здесь можно писать много
о содержании

Lorem ipsum dolor сидеть amet...

##: Следующий раздел содержит спойлеры...
Duis autem vel eum iriure...
:##

Ut wisi enim ad minim veniam, ...
:#

Мне это очень понравилось!

#: Джордж Оруэлл: 1984 (подробнее) ||open

\\  
^Название:|1984 |
^Автор:|Оруэлл, Джордж|
:#

Дополнительных настроек нет.

Используются следующие цвета, которые зависят от выбранного стиля:

|Элемент	|Цвет в стиле	|style.ini|
|Фон заголовка окна	|Нейтральный цвет фона	|@ini_background_neu|
|Заголовок коробки прочитал/открылся	|Общий цвет ссылки	|@ini_link|
|Фон коробки	|Основной цвет фона	|@ini_background|
|Граница коробки	|Общий цвет ссылки	|@ini_link|
|Текст	|Основной цвет текста	|@ini_text|

Эти цвета легко меняются. Входящий в комплект плагин стилизации, доступный через «Администратор» → «Настройка стиля шаблона», позволяет легко вносить изменения. Альтернативно можно напрямую редактировать файл [[devel:style.ini|style.ini]]

=====Обновление=====
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
=====Файл для загрузки=====
{{ :wiki:plugin:saggi-dw-dokuwiki-plugin-stepbystep-2c9f467.zip |}}
=====Лицензия=====
  * **Author:** [[saggi@gmx.de|saggi]]
  * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]

Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:stepbystep#stepbystep_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.