====== CodeMirror Plugin ======
---- plugin ----
description: Enhances DokuWiki's Editor with syntax highlighting
author : albertgasset, Cosmocode - Andi (only for Hogfather Support)
email : albertgasset@fsfe.org, andi@splitbrain.org
type : action
lastupdate : 2020-09-05
compatible : 2013-05-10, 2013-12-08, 2014-05-05, 2014-09-29, 2015-08-10, 2016-06-26, 2017-02-19, Greebo, Hogfather, Igor, "Jack Jackrum", Kaos
depends :
conflicts : ckgedit, toolbox, tagentry, linksuggest, fastwiki
similar : aceeditor, skydoku
tags : !discontinued, editing, codemirror, syntax, editor
downloadurl: https://github.com/cosmocode/dokuwiki-plugin-codemirror/releases/download/latest/dokuwiki-plugin-codemirror.tar.gz
screenshot_img : https://gitlab.com/albertgasset/dokuwiki-plugin-codemirror/raw/master/screenshot.png
----
:!: **This plugin is no longer maintained. You might want to check the [[plugin:prosemirror|prosemirror plugin]] as an alternative.**
===== Need new maintainer =====
FIXME Look for new maintainer - see https://forum.dokuwiki.org/d/18017-maintainer-for-codemirror-wanted
Unfortunately albertgasset has abandoned the project and stopped support. Fortunately Andi made the project at least Hogfather compatible. But now we are looking for a new maintainer who will take care of Codemirror and develop it further.
===== Installation =====
Search and install the plugin using the [[plugin:Extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
===== Examples/Usage =====
{{https://gitlab.com/albertgasset/dokuwiki-plugin-codemirror/raw/master/screenshot.png}}
{{https://gitlab.com/albertgasset/dokuwiki-plugin-codemirror/raw/master/screenshot-settings.png}}
===== Development =====
To build the plugin from source code, you need [[http://nodejs.org|Node.js]] and [[http://gruntjs.com/|Grunt]]:
# Go to the plugins folder of DokuWiki
cd dokuiki/lib/plugins
# Install Grunt globally
npm -g install grunt-cli
# Clone the repo
git clone https://github.com/albertgasset/dokuwiki-plugin-codemirror.git codemirror
# Install required Node.js modules
cd codemirror
npm install
# Build once
grunt
# Or, build and watch for modified files
grunt dev
=== Change Log ===
{{rss>https://gitlab.com/albertgasset/dokuwiki-plugin-codemirror/commits/master?format=atom date}}
=== ToDo/Wish List ===
* Autosave
* Section folding
* Syntax highlighting of more syntax plugins
* Syntax highlighting for the case **<**command**>**%%....%%****command**>** (e.g.: %%...%%)
* [F11]-[[https://codemirror.net/demo/fullscreen.html|Full Screen Editing]] (see [[https://codemirror.net/doc/manual.html#addon_fullscreen|addon]] "display/fullscreen.js")
===== FAQ =====
==== Which browsers are supported? ====
* Firefox: version 3 and up
* Chrome: any version
* Safari: version 5.2 and up
* Internet Explorer: version 8 and up
* Opera: version 9 and up
See [[http://codemirror.net/#browsersupport|CodeMirror browser support]].
==== Is the default editor still available? ====
Yes, You can disable this plugin with button in the editor control.
==== What syntax elements are highlighted? ====
Only syntax elements from core plugins and content inside '''', '''', '''' and '''' for [[http://codemirror.net/mode/index.html|languages supported by CodeMirror]].
==== Does it have a text search function? ====
Yes. ''CTRL+F'' (''CMD+F'' on a Mac) will being up a search box where you can enter a search string or a regular expression. CodeMirror will highlight all instances of matching strings throughout the document, and will scroll to the first match. On a Mac, ''CMD+G'' will find the next matching string.
===== Discussion =====
To report a bug, please use the [[https://gitlab.com/albertgasset/dokuwiki-plugin-codemirror/issues|issue tracker]].