worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======Wrap для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Универсальный плагин, сочетающий в себе функционал многих других плагинов. Оберните вики-текст внутри контейнеров (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'' [[#configuration_options|параметра конфигурации]].  . Следующий синтаксис будет создавать два разных типа эмулируемых заголовков внутри любой обертки:
    * %%//**__Большой подчеркнутый заголовок__**//%% (В примечаниях по технике безопасности они будут выглядеть немного иначе.)
    * %%//**Малый заголовок**//%%
  * не включайте ~~DISCUSSION~~ в блок WRAP <fc #ed1c24>noprint</fc>
=====Монтаж=====
Используйте менеджер плагинов для установки или…

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

Основной синтаксис:
  <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 />

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

<WRAP group>
<WRAP half column>
колонки
</WRAP>

<WRAP half column>
колонка 2
</WRAP>
</WRAP>

<wrap hi>выделить (маркер)</wrap>

<wrap lo>пометить неважным</wrap>

<WRAP дуае round box 100%>
простой центрированный блок
</WRAP>



==== Классы ====

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


{{:wiki:plugin:wrap_plugin_example10.png?|}}

^ имя класса                                                                                        ^ описание/примечания                                                                                                                                     ^
^ __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''**                                                                                   | помещается в четыре столбца подряд, следует использовать в четырехугольниках                                                                                                   |
^ **__выравнивания__ — аналогично <fc #22b14c>divalign , columns , styler</fc> —** :!: **не работают с промежутками!**                                                                                                                                                         ||
| **''leftalign''**                                                                                 | выравнивает текст по левому краю                                                                                                                               |
| **''rightalign''**                                                                                | выравнивает текст по правому краю                                                                                                                              |
| **''centeralign''**                                                                               | центрирует текст                                                                                                                                      |
| **''justify''**                                                                                   | оправдывает текст                                                                                                                                    |
^ **__коробки и заметки__ - аналогично <fc #22b14c>коробке , заметке , подсказке</fc>**                                                                                                                                                                                            ||
| **''box''**                                                                                       | создает рамку вокруг контейнера (использует цвета из ''style.ini'')                                                                                  |
| **''info''** (было ''information'' в предыдущих версиях)                                               | создает синее поле со значком информации                                                                                                                  |
| **''important''**                                                                                 | создает оранжевое поле с важным значком                                                                                                          |
| **''alert''** (было:!: '' warning'' в предыдущих версиях)                                          | создает красное поле со значком предупреждения                                                                                                                  |
| **''tip''**                                                                                       | создает желтую коробку со значком подсказки                                                                                                                  |
| **''help''**                                                                                      | создает фиолетовое поле со значком помощи                                                                                                                 |
| **''todo''**                                                                                      | создает голубое поле со значком todo                                                                                                                 |
| **''download''**                                                                                  | создает зеленое поле со значком загрузки                                                                                                              |
| **''round''**                                                                                     | добавляет закругленные углы к любому контейнеру с цветом фона или рамкой (работает только в современных браузерах, т.е. без IE )                               |
| **''danger''**                                                                                    | создает красную заметку об опасности                                                                                                                      |
| **''warning''**                                                                                   | создает оранжевое предупреждение о безопасности                                                                                                                 |
| **''caution''**                                                                                   | создает предупреждение о безопасности желтого цвета                                                                                                                  |
| **''notice''**                                                                                    | создает синее уведомление о безопасности                                                                                                                     |
| **''safety''**                                                                                    | создает зеленую заметку о безопасности                                                                                                                           |
^ **__метки__ — похожие на выделение , <fc #22b14c>важный_параграф , важный текст</fc> **                                                                                                                                                                        ||
| **''hi''**                                                                                        | помечает текст как выделенный                                                                                                                             |
| **''lo''**                                                                                        | помечает текст как менее значимый                                                                                                                        |
| **''em''**                                                                                        | помечает текст как особо выделенный                                                                                                                   |
^ **__разнообразный__**                                                                                                                                                                                                                                      ||
| **''clear''**                                                                                     | similar to [[clearfloat]], похоже на <fc #22b14c>clearfloat</fc> , желательно использовать с div, т.е. с прописными ''%%<WRAP>%%''буквами                                                       |
| **''tabs''**                                                                                      | если обернуть список ссылок, они будут отображаться как вкладки                                                                                            |
| **''hide''**                                                                                      | скрывает текст для CSS (текст по-прежнему будет отображаться в исходном коде, в несовременных браузерах и доступен для поиска)                                      |
| **''noprint''**                                                                                   | выводит текст на экран, но не на печать, аналогично <fc #22b14c>noprint</fc>                                                                               |
| **''onlyprint''**                                                                                 | отображает текст только в печатном виде, но не на экране                                                                                                    |
| **''pagebreak''**                                                                                 | принудительно открывает новую страницу в распечатках (не отображается на экране), аналогично <fc #22b14c>разрыву страницы</fc>                                                                  |
| **''nopagebreak''**                                                                               | пытается избежать разрыва страницы в распечатках (не виден на экране)                                                                                   |
| **''spoiler''**                                                                                   | показывает белый текст на белом фоне, который раскрывается только при его выделении; похоже на <fc #22b14c>скрыть</fc>                                                  |
| **''button''**                                                                                    | при обертывании ссылки стилизует ее как кнопку                                                                                                   |
| **''tablewidth''**                                                                                | устанавливает ширину таблиц внутри в зависимости от ширины обертки, частично заменяет <fc #22b14c>ширину таблицы</fc>                                                         |
| **''indent''**                                                                                    | делает отступ в тексте, может использоваться вместо <fc #22b14c>табуляции</fc>                                                                                                    |
| **''outdent''**                                                                                   | «выступающий» текст, может быть частично использован вместо <fc #22b14c>«выступающий»</fc>                                                                                      |
| **''prewrap''**                                                                                   | оборачивает текст внутри предварительно отформатированных блоков кода, аналогично <fc #22b14c>wpre</fc>                                                                                      |

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

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

====Ширина====
Вы можете установить любую допустимую ширину для любого контейнера %%<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

Скругление углов
<code css>
/*____________ rounded corners ____________*/
/* (only for modern browsers) */

div.wrap_round {
    border-radius: 0.2em;
}
span.wrap_round {
    border-radius: 0.2em;
}
</code>

==== Демо ====

Вы можете увидеть демонстрацию плагина на [[http://demo.selfthinker.org/plugin:wrap|demo.selfthinker.org]].

[[https://yadi.sk/i/ycbENWFjWEduTA|«Примеры» (демо) на русском языке ]] (для v2011-05-15).[[http://pastebin.com/C9xjaEH9|Источник ]].

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