Skip to content

A WordPress plugin which extends Gutenberg adding color syntax highlighting to the code block.

Notifications You must be signed in to change notification settings

dmhendricks/code-syntax-block

 
 

Repository files navigation

Code Syntax Highlighting Block

A WordPress plugin which extends Gutenberg by adding syntax highlighting to the core code block.

Example:

screen shot

Usage

Install code-syntax-block plugin to your WordPress plugins directory and activate. You can download a zip from the releases page.

When creating a new code block, select Code block, and then in the Inspector (Block Controls on the Right) select the language for the code. The code will not change within the editor, but you'll see a small label with the selected language.

On the front-end when the post is being viewed, the code will be color syntax highlighted.

Customize

The default install uses a limited set of languages from Prism (bash, css, clike, html/markup git, go, javascript, json, php, python, react jsx, sql). If your language is not included, you can build and download a new prism.js using this form. Just replace assets/prism.js with the new file. You will also need to edit the langs array in code-syntax.js and rebuild.

Changing color theme, the default color theme is based off GHColors. You can download a new theme from the link above, or from the Prism themes repo. The easiest way would be to download and customize the new css and replace assets/prism.css.

Build requirements

Build steps

$ npm run build
$ npm run zip

Generated zip can be installed via Admin UI Plugins page

Contribute

See Github issues for list of current issues with the plugin. Please feel free to file any additional issues or requests that you may come across. Pull requests are welcome to help extend.

Colophon

License

Copyright (c) 2018 Marcus Kazmierczak.

Licensed under GPL 2.0 or later .

About

A WordPress plugin which extends Gutenberg adding color syntax highlighting to the code block.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 86.4%
  • PHP 7.0%
  • CSS 6.6%