flatpress-plugin-syntaxhigh.../README.md

2.1 KiB

syntaxhighlighter-ng

Origin: https://git.la10cy.net/DeltaLima/flatpress-plugin-syntaxhighlighter-ng

Demo: https://deltalima.org/blog/index.php/syntaxhighlighter-ng-testpage/

based on the original FlatPress plugin syntaxhighlighter from 2005, updated in 2023 to prism.js

installation

Download the latest release and extract syntaxhighlighter-ng_v1.x.x.zip to your fp-plugins/ folder.

If you want to use git, use

$ git clone https://git.la10cy.net/DeltaLima/flatpress-plugin-syntaxhighlighter-ng.git /pathto/flatpress/fp-plugins/syntaxhighlighter/

codeblock with language syntax highlightning

When you just create an [code][/code] block, then there will be no syntax highlightning.

To enable it, you have to specify the language you want to get highlighted, for example:

[code=bash]
if [ "$1" == "bash" ] 
then
  echo "Yeah :)"
else 
  echo "something else"
fi
[/code]

For all language tags see https://prismjs.com/#supported-languages Not all listed languages are available by default, please see the configuration below!

configuration

You can configure the used size of prismjs and it's theme. For that just edit config.php and set your favorite.

The default values are small for size (see available languages below) and okaidia for the theme.

<?php
/*
 * size: tiny, small, full
 *
 * 	tiny: 21KB (Markup, HTML, XML, SVG, MathML, SSML, Atom, RSS, CSS, C-like, JavaScript)
 *
 *	small: 95KB (Markup, HTML, XML,SVG, MathML, SSML, Atom, RSS, CSS, C-Linke, JavaScript
 *		     Apache, Bash, Batch, BBCode, C, C#, C++, CSV, Diff, Go, HTTP, ini, Java
 *		     JSON, Makefile, Markdown, nginx, Perl, PHP, PowerShell, Python, Ruby
 *		     Shell session, SQL, VB.Net, Wiki markup, YML)
 *
 *	full: 567KB (see https://prismjs.com/index.html#supported-languages for list of supported languages)
 *
 * theme: coy, dark, default, funky, okaidia, solarizedlight, tomorrow, twilight
 * 	 
 */

return [
	// change here
	'size' => 'small',
	'theme' => 'okaidia',
]
?>