The XML file in this repository (pmwiki.xml) contains rules for highlighting the syntax of PmWiki markup files in Kate, the default text editor for KDE. This can be helpful if you want to edit wiki pages offline before saving them to PmWiki, and is similar to the existing syntax highlighter for MediaWiki.
Once installed, opening any file with the .pmwiki extension should automatically highlight PmWiki syntax as in the example below:
This highlighter works fine with Kate or Kwrite (which are both based on KatePart), and should also work with any version of PmWiki.
Steps to install the PmWiki syntax highlighting file:
- Download the file
pmwiki.xmlor clone this repository - Find the folder
~/.kde/share/apps/katepart/syntax/on your system (create it if it does not already exist) - Move
pmwiki.xmlinto~/.kde/share/apps/katepart/syntax/ - Open or restart Kate to use the syntax highlighter.
Default syntax highlighting files for Kate are usually stored in the folder /usr/share/kde4/apps/katepart/syntax/. However, custom syntax highlighters should probably be saved in the local syntax highlighting folder (~/.kde/share/apps/katepart/syntax/) in the user's home directory so that they don't get accidentally overwritten during an update.
NOTE: The above applies to KDE 4. If you are using Plasma 5, the local folder for Kate syntax files has changed to ~/.local/share/katepart5/syntax/.
Files with the extension .pmwiki will automatically be highlighted using the rules in pmwiki.xml. Plain text or other files can be forced to use PmWiki highlighting rules by selecting PmWiki from the Highlighting menu:
- Tools > Highlighting > Markup > PmWiki
Based on kate-markdown by Claes Holmerson.
Dual-licensed under both GPL and BSD licenses.