====== DokuPrism Plugin ======

---- plugin ----
description: Use prism.js for syntax highlight
author     : amnemonic 
email      : adam85mn@gmail.com 
type       : syntax
lastupdate : 2023-11-25
compatible : Greebo, Jack Jackrum
depends    : 
conflicts  : 
similar    : 
tags       : code, documentation, formatting, syntaxhighlight, prismjs

downloadurl: https://github.com/amnemonic/dokuprism/archive/master.zip
bugtracker : https://github.com/amnemonic/dokuprism/issues
sourcerepo : https://github.com/amnemonic/dokuprism/
donationurl: 

screenshot_img : 
----

This plugin replaces DokuWiki's [[wiki:syntax#syntax_highlighting|built-in syntax]] with a JavaScript based approach using [[https://prismjs.com/|Prism.js]].

===== Installation =====

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

By default this plugin override builtin ''<code>'' and ''<file>'' tags. You can change this in DokuWiki settings.

You can see Prism JS in action [[https://prismjs.com/index.html#examples|here]].

===== Syntax =====

  <code html> ... </code>

  <file py> ... </file>

Full list of available languages can be found on [[https://prismjs.com/index.html#supported-languages|prismjs site]].

===== Configuration and Settings =====

After plugin installation two new options will appear in your //Configuration Manager// in section //Dokuprism//:

  * plugin dokuprism override code
  * plugin dokuprism override file

By default both are enabled which mean that PrismJS will be used for both tags.

=== Change Log ===

  * **2023-06-23**
    * Fixed padding in code block
    * Upgraded [[https://prismjs.com/|Prism]] version from 1.19.0 to 1.29.0
  * **2020-02-05**
    * Initial release

=== Known Bugs and Issues ===

  * Lack of translation for settings