Универсальный плагин, сочетающий в себе функционал многих других плагинов. Оберните вики-текст внутри контейнеров (divs или spans) и задайте им класс (выберите из множества предустановленных классов), ширину и/или язык с соответствующим направлением текста. Этот плагин дает вам возможность оборачивать вики-текст внутри контейнеров (div или span) и давать им

определенный класс (с множеством полезных предустановленных классов) ширина язык с соответствующим направлением текста Он потенциально заменяет множество других плагинов и, ИМХО, является лучшей альтернативой для многих.

Он полностью заменяет: class, clearfloat, div_span_shorthand, divalign2, divalign, emphasis, hide, important_paragraf, importanttext, lang, ltr, noprint, pagebreak, side_note, tip, wpre

Частично заменяет: box, button, Color для «ДокуВики», columns, fontcolor, fontfamily, fontsize2, fontsize, highlight, layout, note, styler, tab, tablewidth, typography

• Релиз: 2022-08-10.
• Репозиторий:https://github.com/selfthinker/dokuwiki_plugin_wrap
• Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

• WRAP экспортируются в формат ODT, но не все работает на 100%
• Скругленные углы работают только в современных браузерах (без IE8 и ниже).
• Несколько столбцов работают только в современных браузерах (без IE9 и ниже).
• Классы ширины являются экспериментальными и работают только в современных браузерах (без IE8 и ниже).
• Обычные заголовки «ДокуВики» раньше не работали, поэтому был добавлен обходной путь. Теперь, когда заголовки работают, обходной путь больше не нужен, но сохранен для обратной совместимости. Он устарел в версии 2018-04-22 и отключен по умолчанию. Их можно включить с помощью emulatedHeadlines параметра конфигурации. . Следующий синтаксис будет создавать два разных типа эмулируемых заголовков внутри любой обертки:
  • //**__Большой подчеркнутый заголовок__**// (В примечаниях по технике безопасности они будут выглядеть немного иначе.)
  • //**Малый заголовок**//
• не включайте ~~DISCUSSION~~ в блок WRAP noprint

Используйте менеджер плагинов для установки или…

1. скачать zip-файл
2. распаковать его в<dokuwiki>/lib/plugins/
3. войдите как администратор и измените плагин в менеджере конфигурации

Основной синтаксис:

<WRAP classes #id width :language>
"big" content
</WRAP>

**or**
<block classes #id width :language>
"big" content
</block>

or
<div classes #id width :language>
"big" content
</div>

<WRAP> в верхнем регистре (или, альтернативно, <block> или <div>) создает div и должен использоваться для «больших» контейнеров, окружающих абзацы, списки, таблицы и т. д.

<wrap classes #id width :language>"small" content</wrap>

или
<inline classes #id width :language>"small" content</inline>

или
<span classes #id width :language>"small" content</span>

<wrap> в нижнем регистре (или альтернативно <inline> or <span>) создает span и должен использоваться для «маленьких» контейнеров, внутри абзацев, списков, таблиц и т. д.

Начиная с версии 2013-06-13 также используется сокращенный синтаксис (для оберток без содержимого):

<WRAP classes #id /> или <block classes #id /> или <div classes #id />

и

<wrap classes #id /> или <inline classes #id /> или <span classes #id />

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

Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже).

На данный момент доступны следующие классы:

имя класса	описание/примечания
columns – аналогично columns, side_note, styler, tip
column	так же, как left в языках LTR и так же, как right в языках с письмом справа налево
left	то же, что и column, позволит вам разместить контейнер слева
right	позволит контейнеру плавать правильно
center	расположит контейнер в горизонтальном центре страницы
col2..col5	будет показывать текст в нескольких столбцах в зависимости от их количества (2, 3, 4 или 5), работает только в современных браузерах (без IE9 и ниже)
colsmall, colmedium, collarge	также будет отображаться текст в нескольких столбцах, но в зависимости от их ширины (маленький, средний или большой), работает только в современных браузерах (без IE9 и ниже)
ширина — экспериментальная , может работать не так, как ожидалось, включает поддержку мобильных устройств
half	подходит для двух столбцов подряд, следует использовать парами
third	подходит для трех или двух столбцов подряд, следует использовать в тройках или вместе с twothirds
twothirds	подходит для двух столбцов подряд при использовании вместе с third, один шириной 1/3, а другой шириной 2/3
quarter	помещается в четыре столбца подряд, следует использовать в четырехугольниках
выравнивания — аналогично divalign , columns , styler — не работают с промежутками!
leftalign	выравнивает текст по левому краю
rightalign	выравнивает текст по правому краю
centeralign	центрирует текст
justify	оправдывает текст
коробки и заметки - аналогично коробке , заметке , подсказке
box	создает рамку вокруг контейнера (использует цвета из style.ini)
info (было information в предыдущих версиях)	создает синее поле со значком информации
important	создает оранжевое поле с важным значком
alert (было warning в предыдущих версиях)	создает красное поле со значком предупреждения
tip	создает желтую коробку со значком подсказки
help	создает фиолетовое поле со значком помощи
todo	создает голубое поле со значком todo
download	создает зеленое поле со значком загрузки
round	добавляет закругленные углы к любому контейнеру с цветом фона или рамкой (работает только в современных браузерах, т.е. без IE )
danger	создает красную заметку об опасности
warning	создает оранжевое предупреждение о безопасности
caution	создает предупреждение о безопасности желтого цвета
notice	создает синее уведомление о безопасности
safety	создает зеленую заметку о безопасности
метки — похожие на выделение , важный_параграф , важный текст
hi	помечает текст как выделенный
lo	помечает текст как менее значимый
em	помечает текст как особо выделенный
разнообразный
clear	similar to clearfloat, похоже на clearfloat , желательно использовать с div, т.е. с прописными <WRAP>буквами
tabs	если обернуть список ссылок, они будут отображаться как вкладки
hide	скрывает текст для CSS (текст по-прежнему будет отображаться в исходном коде, в несовременных браузерах и доступен для поиска)
noprint	выводит текст на экран, но не на печать, аналогично noprint
onlyprint	отображает текст только в печатном виде, но не на экране
pagebreak	принудительно открывает новую страницу в распечатках (не отображается на экране), аналогично разрыву страницы
nopagebreak	пытается избежать разрыва страницы в распечатках (не виден на экране)
spoiler	показывает белый текст на белом фоне, который раскрывается только при его выделении; похоже на скрыть
button	при обертывании ссылки стилизует ее как кнопку
tablewidth	устанавливает ширину таблиц внутри в зависимости от ширины обертки, частично заменяет ширину таблицы
indent	делает отступ в тексте, может использоваться вместо табуляции
outdent	«выступающий» текст, может быть частично использован вместо «выступающий»
prewrap	оборачивает текст внутри предварительно отформатированных блоков кода, аналогично wpre

Возможно, вам придется настроить несколько классов в соответствии с потребностями вашего шаблона, особенно hi, lo and em. Если у вас темная или ярко окрашенная тема, используйте darkTpl параметр конфигурации ..

Классы легко настраиваются и расширяются. Любые пожелания приветствуются.

Вы можете установить любую допустимую ширину для любого контейнера <WRAP> в верхнем регистре %, px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in. Просто установите ширину до или после или с классами, например

<WRAP какой-то класс 50% другой класс>...

Все, кроме процентов, будет уменьшено, чтобы иметь максимальную ширину, доступную на небольших экранах.

Вы также можете использовать ключевые слова ширины half, third, twothirds and quarter. Для правильной работы им нужна еще одна обертка вокруг них. Например

<WRAP group>
  <WRAP half column>...</WRAP>
  <WRAP half column>...</WRAP>
</WRAP>

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

Для определения привязки применяется следующий синтаксис:

<wrap #ankername />

Якорь доступен через: #ankername

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

<wrap :en>Этот текст явно помечен как английский.</wrap>

Направление текста (rtl, справа налево или ltr, слева направо) вставляется автоматически и зависит исключительно от языка. Список поддерживаемых в настоящее время языков взят из: http://meta.wikimedia.org/wiki/Template:List_of_language_names_ordered_by_code

Если вы хотите пометить текст с другим направлением текста, чем направление по умолчанию, вы должны использовать div, т.е. <WRAP>символы верхнего регистра. В противном случае выравнивание текста также не изменится.

Это делает его лучшей заменой ltr (и lang).

Файл CSS - lib/plugen/wrap/all.less

Скругление углов

/*____________ rounded corners ____________*/
/* (only for modern browsers) */
 
div.wrap_round {
    border-radius: 0.2em;
}
span.wrap_round {
    border-radius: 0.2em;
}

Вы можете увидеть демонстрацию плагина на demo.selfthinker.org.

«Примеры» (демо) на русском языке (для v2011-05-15).Источник .

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

wrap.zip

• Author: Anika Henke
• License: GNU GPL v2