A creole markup converter for Holocron
Creole is a lightweight markup language, aimed at being a common markup language for wikis, enabling and simplifying the transfer of content between different wiki engines.
holocron-creole is a Creole markup converter for Holocron, an extendable static blog generator powered by the Force
Holocron uses entry-points based extension discovery mechanism, and that means it’s enough to use pip to install creole converter:
$ [sudo] pip install holocron-creole
Usage experience is similar to Markdown or reStructuredText builtin converters.
Ensure that creole extension is enabled in your _config.yml:
ext: enabled: - markdown - restructuredtext - creole # inserted line - index - feed - sitemap - tags
Create posts and/or pages with .creole extension. Similar to builtin converters, a meta information header could be places on the top of *.creole files.
--- tags: [jedi, thoughts, any-custom-tag] --- = Jedis in Real World = Jedi is ...
Creole converter supports code syntax highlighting feature. It could be turned on/off by editing the following option:
ext: creole: syntax_highlight: true
When it’s turned on, the <<code>> macros is available for using. Example:
<<code ext=".py">> def add(x, y): return x + y <</code>>
Despite the fact Holocron is distributed under BSD license, holocron-creole is licensed under GPLv3. The reason is that the project depends on python-creole library, and it’s distributed under GPLv3. That means we have no choice but to use GPL.