2.7 KiB
layout | title | date | sidebar | footer |
---|---|---|---|---|
page | Codeblock | 2011-07-22 09:13 | false | false |
With this plugin you can write blocks of code directly in your posts and optionally add titles and links.
Syntax
{{ "{% codeblock [title] [lang:language] [start:#] [url] [link text]" }} %}
code snippet
{{ "{% endcodeblock" }} %}
Example 1
{{ "{% codeblock" }} %}
Awesome code snippet
{{ "{% endcodeblock" }} %}
{% codeblock %} Awesome code snippet {% endcodeblock %}
Syntax highlighting
You can also add syntax highlighting like this.
{% raw %}{% codeblock lang:objc %}
[rectangle setX: 10 y: 10 width: 20 height: 20];
{% endcodeblock %}{% endraw %}
{% codeblock lang:objc %} [rectangle setX: 10 y: 10 width: 20 height: 20]; {% endcodeblock %}
Syntax highlighting, alternate method
Including a file extension in the title enables highlighting
{{ "{% codeblock Time to be Awesome - awesome.rb" }} %}
puts "Awesome!" unless lame
{{ "{% endcodeblock" }} %}
{% codeblock Time to be Awesome - awesome.rb %} puts "Awesome!" unless lame {% endcodeblock %}
Force highlighting
Pygments supports many languages, but doesn't recognize some file extensions.
Add lang:your_language
to force highlighting if the filename doesn't work.
{{ "{% codeblock Here's an example .rvmrc file. lang:ruby" }} %}
rvm ruby-1.8.6 # ZOMG, seriously? We still use this version?
{{ "{% endcodeblock" }} %}
{% codeblock Here's an example .rvmrc file. lang:ruby %} rvm ruby-1.8.6 # ZOMG, seriously? We still use this version? {% endcodeblock %}
Add a URL
Add an optional URL to enable downloading or linking to source.
{% raw %}{% codeblock Javascript Array Syntax lang:js http://j.mp/pPUUmW MDN Documentation %}
var arr1 = new Array(arrayLength);
var arr2 = new Array(element0, element1, ..., elementN);
{% endcodeblock %}{% endraw %}
{% codeblock Javascript Array Syntax lang:js http://j.mp/pPUUmW MDN Documentation %} var arr1 = new Array(arrayLength); var arr2 = new Array(element0, element1, ..., elementN); {% endcodeblock %}
The last argument link_text
is optional. You may want to link to a source for download file, or documentation on some other site.
Start on a custom line number
{% raw %}{% codeblock Coffeescript Tricks lang:coffeescript start:51 %}
# Given an alphabet:
alphabet = 'abcdefghijklmnopqrstuvwxyz'
# Iterate over part of the alphabet:
console.log letter for letter in alphabet[4..8]
{% endcodeblock %}{% endraw %}
{% codeblock lang:coffeescript Coffeescript Tricks start:51 %}
Given an alphabet:
alphabet = 'abcdefghijklmnopqrstuvwxyz'
Iterate over part of the alphabet:
console.log letter for letter in alphabet[4..8] {% endcodeblock %}