Содержание
Color для «ДокуВики»
Возможность писать цветной текст в «ДокуВики»
- Релиз: 2022-10-19.
- Репозиторий:https://github.com/hanche/dokuwiki_color_plugin
- Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»
Совместимость
Кристофер Смит, кажется, оставил плагин без поддержки. Пользователь leeyc0 предоставил хостинг плагина на github, но и поддерживать его некогда. Harald Hanche-Olsen вступил во владение в октябре 2018 года. Тем не менее, плагин считается довольно стабильным, и новый сопровождающий не предвидит очень активного графика обслуживания. Запросы новых функций, скорее всего, будут отклонены.
Монтаж
Используйте менеджер плагинов для установки или…
- скачать zip-файл
- распаковать его в<dokuwiki>/lib/plugins/
- войдите как администратор и измените плагин в менеджере конфигурации
Применение
Поместите этот пример кода на свою игровую площадку:
<color green>text</color> <color blue/lightgrey>text</color> <color #FF0000>text</color> <color /#FFff00>text</color> <color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color> <color hsl(120,100%,30%):hsl(180,50%,90%)>text</color>
и вы увидите что-то вроде этого:
text text text text text text
Спецификация цвета переднего плана или фона может быть любой допустимой спецификацией цвета CSS . Имейте в виду, что некоторые старые браузеры не распознают все спецификации цветов в последней версии CSS .
Если вы используете спецификацию цвета, которая содержит косую черту (/
), вы должны использовать двоеточие (:
) чтобы разделить спецификации цвета переднего плана и фона.
Точный синтаксис выглядит следующим образом. Квадратные скобки ([]
) обозначают необязательные части и не должны включаться буквально:
<color [⟨fg-color⟩][/⟨bg-color⟩]>⟨text⟩</color> <color [⟨fg-color⟩]:[⟨bg-color⟩]>⟨text⟩</color>
Вы должны использовать вторую форму, если спецификация цвета включает косую черту. Обратите внимание, что в этом случае разделитель двоеточия (:
) является обязательным.
В настоящее время неизвестна действительная цветовая спецификация , включающая двоеточие, но если вам понадобится использовать ее в будущем, вы должны использовать первую форму. Этот плагин не позволяет их комбинировать.
В результате отображается ⟨текст⟩ с цветом переднего плана ⟨fg-color⟩ и цветом фона ⟨bg-color⟩. Если какой-либо цвет опущен или пуст, используется цвет переднего плана или фона окружающего текста.
Пример — обратите внимание на обязательное двоеточие здесь:
<color hwb(120 20% 30% / 50%):>some faded dark green semi-transparent text</color>
Безобидное ограничение: этот плагин теперь допускает любую спецификацию цвета, не содержащую одинарные или двойные кавычки или какие-либо символы < > & ;
. Он не пытается проверить, является ли спецификация допустимой для CSS . Это сделано для соответствия цветовым спецификациям CSS 4, а также любым будущим цветовым спецификациям — до тех пор, пока они не используют какие-либо «запрещенные» символы.
Справочник по спецификациям используемых цветов см. на странице цветов на сайте developer.mozilla.org. Имейте в виду, что не все спецификации цветов работают во всех браузерах. См. нижнюю часть указанной страницы для получения дополнительной информации или проверьте Могу ли я использовать, если сомневаетесь.
- Плагин работает, заключая содержимое в элемент <span> с подходящим атрибутом стиля. Поэтому вы не можете обернуть его вокруг элементов уровня блока, таких как заголовки, списки и таблицы.
- Вы также не можете использовать его внутри заголовков, так как вы не можете использовать синтаксис вики внутри заголовка.
- Использование двух или более разделителей (косая черта в первом синтаксисе, двоеточие во втором) внутри
<color …>
приводит к неопределенному поведению.
Обновление
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
Файл для загрузки
Лицензия
- License: GNU GPL v2