======Color для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70|}} Возможность писать цветной текст в «ДокуВики»
  * **Релиз:** 2022-10-19. 
  * **Репозиторий:**https://github.com/hanche/dokuwiki_color_plugin
  * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" 

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

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

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

<code>
<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>
</code>

и вы увидите что-то вроде этого:

<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>

Спецификация цвета переднего плана или фона может быть любой допустимой спецификацией цвета CSS . Имейте в виду, что некоторые старые браузеры не распознают все спецификации цветов в последней версии CSS .

Если вы используете спецификацию цвета, которая содержит косую черту (''/''), вы должны использовать двоеточие ('':'') чтобы разделить спецификации цвета переднего плана и фона.

Точный синтаксис выглядит следующим образом. Квадратные скобки (''[]'') обозначают необязательные части и не должны включаться буквально:
<code>
<color [⟨fg-color⟩][/⟨bg-color⟩]>⟨text⟩</color>
<color [⟨fg-color⟩]:[⟨bg-color⟩]>⟨text⟩</color>
</code>
Вы должны использовать вторую форму, если спецификация цвета включает косую черту. Обратите внимание, что в этом случае разделитель двоеточия ('':'') является обязательным.

В настоящее время неизвестна действительная цветовая спецификация , включающая двоеточие, но если вам понадобится использовать ее в будущем, вы должны использовать первую форму. Этот плагин не позволяет их комбинировать.

В результате отображается ⟨текст⟩ с цветом переднего плана ⟨fg-color⟩ и цветом фона ⟨bg-color⟩. Если какой-либо цвет опущен или пуст, используется цвет переднего плана или фона окружающего текста.

Пример — обратите внимание на обязательное двоеточие здесь:

<code>
<color hwb(120 20% 30% / 50%):>some faded dark green semi-transparent text</color>
</code>

Безобидное ограничение: этот плагин теперь допускает любую спецификацию цвета, не содержащую одинарные или двойные кавычки или какие-либо символы ''%%< > & ; %%''. Он не пытается проверить, является ли спецификация допустимой для CSS . Это сделано для соответствия цветовым спецификациям CSS 4, а также любым будущим цветовым спецификациям — до тех пор, пока они не используют какие-либо «запрещенные» символы.

Справочник по спецификациям используемых цветов см. на
[[https://developer.mozilla.org/en-US/docs/Web/CSS/color_value|странице цветов]]  на сайте developer.mozilla.org. Имейте в виду, что не все спецификации цветов работают во всех браузерах. См. нижнюю часть указанной страницы для получения дополнительной информации или проверьте [[https://caniuse.com/|Могу ли я использовать]], если сомневаетесь.

  * Плагин работает, заключая содержимое в элемент <span> с подходящим атрибутом стиля. Поэтому вы не можете обернуть его вокруг элементов уровня блока, таких как заголовки, списки и таблицы.
  * Вы также не можете использовать его внутри заголовков, так как вы не можете использовать синтаксис вики внутри заголовка.
  * Использование двух или более разделителей (косая черта в первом синтаксисе, двоеточие во втором) внутри ''<color …>'' приводит к неопределенному поведению.

=====Обновление=====
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
=====Файл для загрузки=====
{{ :wiki:plugin:color.gz |}}
{{ :wiki:plugin:color.tar |}}
=====Лицензия=====

  * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]