mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-26 18:10:27 +00:00
ee9d19d299
TiddlyWiki passes the MIME type of the tiddler to highlight.js as the "language brush", but it turns out that highlight.js doesn't actually understand MIME types. This commit introduces a configuration mapping between common MIME types and highlight.js language brushes Fixes #2535
40 lines
1.2 KiB
Plaintext
40 lines
1.2 KiB
Plaintext
caption: codeblock
|
|
created: 20151103160200000
|
|
modified: 20160817175325205
|
|
tags: Widgets
|
|
title: CodeBlockWidget
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
The ''codeblock'' widget renders text in `<pre>` and `<code>` blocks, causing it to be
|
|
displayed monospace. A language may optionally be specified using the
|
|
''language'' attribute, however syntax highlighting will only be used if the
|
|
[[Highlight Plugin]] is installed.
|
|
|
|
! Content and Attributes
|
|
|
|
The content of the `<$codeblock>` widget is ignored.
|
|
|
|
|!Attribute |!Description |
|
|
|code |Contents of the block to render as code |
|
|
|language |Programming language for syntax highlighting |
|
|
|
|
The `language` attribute accepts either:
|
|
|
|
* a Highlight.js language code (see https://highlightjs.org/static/demo/ for a list)
|
|
* a MIME type (eg, `text/html` or `image/svg+xml`)
|
|
|
|
! Examples
|
|
|
|
Here is an example embedding the contents of a tiddler as a code block.
|
|
|
|
<$macrocall $name='wikitext-example-without-html'
|
|
src='<$codeblock code={{$:/editions/tw5.com/macro-examples/say-hi}} />' />
|
|
|
|
A codeblock may also specify a language.
|
|
|
|
<$macrocall $name='wikitext-example-without-html'
|
|
src='<$codeblock code="SELECT * FROM users WHERE deleted = false" language="sql" />' />
|
|
|