======CodePrettifier для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Подсветка синтаксиса фрагментов исходного кода на вики-странице с использованием google-code-prettify (модуль javascript с файлами CSS).
Этот плагин включает подсветку синтаксиса фрагментов кода на вашей странице с помощью преттификатора кода Javascript (бывший «google-code-prettify»). Этот пакет плагинов включает подмножество преттификаторов кода Javascript, они лицензируются отдельно в соответствии с лицензией Apache, версия 2.0.
Вы можете настроить плагин Code Prettifier, чтобы переопределить встроенный синтаксис «Докувики» %% %% для блоков кода.
вы можете использовать скин (файл css) для блока кода.
* **Релиз:** 2019-09-29.
* **Репозиторий:**https://github.com/ssahara/dw-plugin-codeprettify
* **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам"
=====Совместимость=====
* Не работает: Требуется PHP 7.0.x или выше!
=====Монтаж=====
Используйте менеджер плагинов для установки или…
- скачать zip-файл
- распаковать его в
%% и %%
%%, чтобы они отображались красиво на вики-странице.
* Модуль Prettify делает все возможное, чтобы угадать язык, но лучше всего работает с C-подобными и HTML -подобными языками.
* Чтобы указать языковую подсказку для Prettify, вы можете использовать
* %%%% вариант
* Например, используйте %%
%% чтобы указать, что код представляет собой каскадные таблицы стилей ( CSS ).
* используйте %%linenums%% или %%nolinenums%% для включения/выключения нумерации строк. Вы можете добавить двоеточие и число в конце опции, например. %%linenums:12%% указать номер начальной строки.
* Если вы хотите добавить заголовок для блока кода, вы можете указать его после %%|%%того, как он будет отображаться прямо над полем кода.
* :!: Теги %%
%% и %%
%% пишутся с **Большой** буквы.
%% for [[:wiki:syntax#для блоков кода]].|
|''linenums'' |включить нумерацию строк неявно. |
|''url_loader'' |URL загрузчика prettify (по умолчанию пустой)\\ :!: устарел с выпуска 2015-09-12|
|''url_prettify_handlers'' |Базовый URL-адрес для prettify.js и необязательных сценариев обработчика языка, например: https://cdn.rawgit.com/google/code-prettify/master/src/ (по умолчанию пусто)\\ :!: доступно в выпуске 2015-09-12. |
|''url_prettify_skins'' |Базовый URL-адрес для цветовой темы для code-prettify (css), например: https://cdn.rawgit.com/google/code-prettify/master/styles/ (по умолчанию пусто)\\ :!: доступно в версии 2015-09-12.|
|''lang_handlers'' |дополнительный обработчик языка (через запятую)|
|''skin'' |цветовая тема/скин для code-prettify ( имя файла CSS в code-prettify/styles/)|
Подробная информация о преттификаторе кода Javascript доступна по адресу:
* https://github.com/google/code-prettify/blob/master/docs/getting_started.md
Этот пакет плагинов содержит некоторые скины, найденные в [[https://cdn.rawgit.com/google/code-prettify/master/styles/index.html|галерее Prettify Themes]]. Вы можете установить одно из следующих имен файла css в ''skin'' поле.
* desert.css
* doxy.css
* sons-of-obsidian.css
* sunburst.css
Другие цветовые темы для Prettify можно найти по адресу: http://jmblog.github.io/color-themes-for-google-code-prettify/
=====Обновление=====
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
=====Файл для загрузки=====
{{ :wiki:plugin:ssahara-dw-plugin-codeprettify-2019-03-09-10-g914e649.zip |}}
=====Лицензия=====
* **Author:** [[sahara.satoshi@gmail.com|s.sahara]]
* **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]
[[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:codeprettify#configuration_and_settings|эту страницу]] с вашего сайта, если вам нравится этот продукт.