| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| wiki:plugin:wrap [2023/08/10 23:35] – [Примеры] 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> |
| =====Монтаж===== | =====Монтаж===== |
| Используйте менеджер плагинов для установки или… | Используйте менеджер плагинов для установки или… |
| ====Примеры==== | ====Примеры==== |
| Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже). | Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже). |
| | |
| | <WRAP group> |
| | <WRAP half column> |
| | колонки |
| | </WRAP> |
| | |
| | <WRAP half column> |
| | колонка 2 |
| | </WRAP> |
| | </WRAP> |
| | |
| | <wrap hi>выделить (маркер)</wrap> |
| | |
| | <wrap lo>пометить неважным</wrap> |
| | |
| | <WRAP дуае round box 100%> |
| | простой центрированный блок |
| | </WRAP> |
| | |
| | |
| |
| ==== Классы ==== | ==== Классы ==== |
| | **''twothirds''** | подходит для двух столбцов подряд при использовании вместе с ''third'', один шириной 1/3, а другой шириной 2/3 | | | **''twothirds''** | подходит для двух столбцов подряд при использовании вместе с ''third'', один шириной 1/3, а другой шириной 2/3 | |
| | **''quarter''** | помещается в четыре столбца подряд, следует использовать в четырехугольниках | | | **''quarter''** | помещается в четыре столбца подряд, следует использовать в четырехугольниках | |
| ^ **__выравнивания__ — аналогично <color #22b14c>divalign , columns , styler</color> —** :!: **не работают с промежутками!** || | ^ **__выравнивания__ — аналогично <fc #22b14c>divalign , columns , styler</fc> —** :!: **не работают с промежутками!** || |
| | **''leftalign''** | выравнивает текст по левому краю | | | **''leftalign''** | выравнивает текст по левому краю | |
| | **''rightalign''** | выравнивает текст по правому краю | | | **''rightalign''** | выравнивает текст по правому краю | |
| | **''centeralign''** | центрирует текст | | | **''centeralign''** | центрирует текст | |
| | **''justify''** | оправдывает текст | | | **''justify''** | оправдывает текст | |
| ^ **__коробки и заметки__ - аналогично <color #22b14c>коробке , заметке , подсказке</color>** || | ^ **__коробки и заметки__ - аналогично <fc #22b14c>коробке , заметке , подсказке</fc>** || |
| | **''box''** | создает рамку вокруг контейнера (использует цвета из ''style.ini'') | | | **''box''** | создает рамку вокруг контейнера (использует цвета из ''style.ini'') | |
| | **''info''** (было ''information'' в предыдущих версиях) | создает синее поле со значком информации | | | **''info''** (было ''information'' в предыдущих версиях) | создает синее поле со значком информации | |
| | **''notice''** | создает синее уведомление о безопасности | | | **''notice''** | создает синее уведомление о безопасности | |
| | **''safety''** | создает зеленую заметку о безопасности | | | **''safety''** | создает зеленую заметку о безопасности | |
| ^ **__метки__ — похожие на выделение , <color #22b14c>важный_параграф , важный текст</color> ** || | ^ **__метки__ — похожие на выделение , <fc #22b14c>важный_параграф , важный текст</fc> ** || |
| | **''hi''** | помечает текст как выделенный | | | **''hi''** | помечает текст как выделенный | |
| | **''lo''** | помечает текст как менее значимый | | | **''lo''** | помечает текст как менее значимый | |
| | **''em''** | помечает текст как особо выделенный | | | **''em''** | помечает текст как особо выделенный | |
| ^ **__разнообразный__** || | ^ **__разнообразный__** || |
| | **''clear''** | similar to [[clearfloat]], похоже на <color #22b14c>clearfloat</color> , желательно использовать с div, т.е. с прописными ''%%<WRAP>%%''буквами | | | **''clear''** | similar to [[clearfloat]], похоже на <fc #22b14c>clearfloat</fc> , желательно использовать с div, т.е. с прописными ''%%<WRAP>%%''буквами | |
| | **''tabs''** | если обернуть список ссылок, они будут отображаться как вкладки | | | **''tabs''** | если обернуть список ссылок, они будут отображаться как вкладки | |
| | **''hide''** | скрывает текст для CSS (текст по-прежнему будет отображаться в исходном коде, в несовременных браузерах и доступен для поиска) | | | **''hide''** | скрывает текст для CSS (текст по-прежнему будет отображаться в исходном коде, в несовременных браузерах и доступен для поиска) | |
| | **''noprint''** | выводит текст на экран, но не на печать, аналогично <color #22b14c>noprint</color> | | | **''noprint''** | выводит текст на экран, но не на печать, аналогично <fc #22b14c>noprint</fc> | |
| | **''onlyprint''** | отображает текст только в печатном виде, но не на экране | | | **''onlyprint''** | отображает текст только в печатном виде, но не на экране | |
| | **''pagebreak''** | принудительно открывает новую страницу в распечатках (не отображается на экране), аналогично <color #22b14c>разрыву страницы</color> | | | **''pagebreak''** | принудительно открывает новую страницу в распечатках (не отображается на экране), аналогично <fc #22b14c>разрыву страницы</fc> | |
| | **''nopagebreak''** | пытается избежать разрыва страницы в распечатках (не виден на экране) | | | **''nopagebreak''** | пытается избежать разрыва страницы в распечатках (не виден на экране) | |
| | **''spoiler''** | показывает белый текст на белом фоне, который раскрывается только при его выделении; похоже на <color #22b14c>скрыть</color> | | | **''spoiler''** | показывает белый текст на белом фоне, который раскрывается только при его выделении; похоже на <fc #22b14c>скрыть</fc> | |
| | **''button''** | при обертывании ссылки стилизует ее как кнопку | | | **''button''** | при обертывании ссылки стилизует ее как кнопку | |
| | **''tablewidth''** | устанавливает ширину таблиц внутри в зависимости от ширины обертки, частично заменяет <color #22b14c>ширину таблицы</color> | | | **''tablewidth''** | устанавливает ширину таблиц внутри в зависимости от ширины обертки, частично заменяет <fc #22b14c>ширину таблицы</fc> | |
| | **''indent''** | делает отступ в тексте, может использоваться вместо <color #22b14c>табуляции</color> | | | **''indent''** | делает отступ в тексте, может использоваться вместо <fc #22b14c>табуляции</fc> | |
| | **''outdent''** | «выступающий» текст, может быть частично использован вместо <color #22b14c>«выступающий»</color> | | | **''outdent''** | «выступающий» текст, может быть частично использован вместо <fc #22b14c>«выступающий»</fc> | |
| | **''prewrap''** | оборачивает текст внутри предварительно отформатированных блоков кода, аналогично <color #22b14c>wpre</color> | | | **''prewrap''** | оборачивает текст внутри предварительно отформатированных блоков кода, аналогично <fc #22b14c>wpre</fc> | |
| |
| === Known restrictions === | Возможно, вам придется настроить несколько классов в соответствии с потребностями вашего шаблона, особенно ''hi'', ''lo'' and ''em''. Если у вас темная или ярко окрашенная тема, используйте ''darkTpl'' [[#configuration_options|параметр конфигурации .]]. |
| |
| * WRAPs export to ODT format but not everything works 100% | Классы легко настраиваются и расширяются. Любые пожелания приветствуются. |
| * Round corners only work in modern browsers (no IE8 and below). | |
| * Multiple columns only work in modern browsers (no IE9 and below). | |
| * Width classes are experimental and only work in modern browsers (no IE8 and below). | |
| * Normal DokuWiki Headlines used to not work and a work-around was added. Now that headlines do work, the work-around is not needed anymore but kept for backwards-compatibility. It was deprecated in version 2018-04-22 and disabled by default. They can be enabled by using the ''emulatedHeadlines'' [[#configuration_options|config option]]. The following syntax would then produce two different kinds of emulated headlines inside any wrap: | |
| * %%//**__Big Underlined Headline__**//%% (They will look a bit different in safety notes.) | |
| * %%//**Small Headline**//%% | |
| * do not include ~~DISCUSSION~~ within a WRAP noprint block | |
| |
| You might need to adjust a few of the classes to your template's needs, especially ''hi'', ''lo'' and ''em''. If you have a dark or otherwise heavily coloured theme, please use the ''darkTpl'' [[#configuration_options|config option]]. | ====Ширина==== |
| | Вы можете установить любую допустимую ширину для любого контейнера %%<WRAP>%% в верхнем регистре ''%, px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in''. Просто установите ширину до или после или с классами, например |
| | <WRAP какой-то класс 50% другой класс>... |
| | Все, кроме процентов, будет уменьшено, чтобы иметь максимальную ширину, доступную на небольших экранах. |
| |
| The classes are easily adjustable and extensible. Any wishes are welcome. | Вы также можете использовать ключевые слова ширины ''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|эту страницу]] с вашего сайта, если вам нравится этот продукт. | |
| | |
