| Следующая версия | Предыдущая версия |
| wiki:plugin:wrap [2023/08/10 23:00] – создано vladpolskiy | wiki:plugin:wrap [2025/02/01 10:00] (текущий) – внешнее изменение 127.0.0.1 |
|---|
| |
| =====Совместимость===== | =====Совместимость===== |
| * **2009-05-28 «Манеры Фрустерика» ** | * WRAP экспортируются в формат ODT, но не все работает на 100% |
| * Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL . | * Скругленные углы работают только в современных браузерах (без IE8 и ниже). |
| | * Несколько столбцов работают только в современных браузерах (без IE9 и ниже). |
| | * Классы ширины являются экспериментальными и работают только в современных браузерах (без IE8 и ниже). |
| | * Обычные заголовки «ДокуВики» раньше не работали, поэтому был добавлен обходной путь. Теперь, когда заголовки работают, обходной путь больше не нужен, но сохранен для обратной совместимости. Он устарел в версии 2018-04-22 и отключен по умолчанию. Их можно включить с помощью ''emulatedHeadlines'' [[#configuration_options|параметра конфигурации]]. . Следующий синтаксис будет создавать два разных типа эмулируемых заголовков внутри любой обертки: |
| | * %%//**__Большой подчеркнутый заголовок__**//%% (В примечаниях по технике безопасности они будут выглядеть немного иначе.) |
| | * %%//**Малый заголовок**//%% |
| | * не включайте ~~DISCUSSION~~ в блок WRAP <fc #ed1c24>noprint</fc> |
| =====Монтаж===== | =====Монтаж===== |
| Используйте менеджер плагинов для установки или… | Используйте менеджер плагинов для установки или… |
| - войдите как администратор и измените плагин в менеджере конфигурации | - войдите как администратор и измените плагин в менеджере конфигурации |
| =====Применение===== | =====Применение===== |
| ==== Syntax ==== | ==== Синтаксис ==== |
| |
| Основной синтаксис: | Основной синтаксис: |
| Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже). | Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже). |
| |
| | <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 и установите новую версию, как указано выше. | Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше. |
| =====Файл для загрузки===== | =====Файл для загрузки===== |
| {{ :wiki:plugin:citations.zip |}} | {{ :wiki:plugin:wrap.zip |}} |
| =====Лицензия===== | =====Лицензия===== |
| * **Author:** [[tjgrant@tatewake.com|Terence J. Grant]] | * **Author:** [[anika@selfthinker.org|Anika Henke]] |
| * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]] | * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]] |
| * **Donate:** [[https://www.paypal.com/xclick/business=tjgrant%40tatewake.com&item_name=Citations%20for%20DokuWiki%20Donation&no_shipping=1&no_note=1&tax=0¤cy_code=USD&lc=US|Click here.]] | |
| Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:cite#license|эту страницу]] с вашего сайта, если вам нравится этот продукт. | |
| | |
