Color для «ДокуВики»

Возможность писать цветной текст в «ДокуВики»

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

Кристофер Смит, кажется, оставил плагин без поддержки. Пользователь leeyc0 предоставил хостинг плагина на github, но и поддерживать его некогда. Harald Hanche-Olsen вступил во владение в октябре 2018 года. Тем не менее, плагин считается довольно стабильным, и новый сопровождающий не предвидит очень активного графика обслуживания. Запросы новых функций, скорее всего, будут отклонены.

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

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

Поместите этот пример кода на свою игровую площадку:

<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 и установите новую версию, как указано выше.

color.gz color.tar

• License: GNU GPL v2