Embed code from specified file(s)
Parameters:
String|File
: path to the file you want to embed
String|Language (optional)
: Optional second parameter to "force" a specific language to use fo syntax highlighting.
Unless overridden by a given extension, the helper will automatically use the extension of the specified file as the language to use for syntax highlighting. You may also force the helper to use a language that is different than the extension of the file.
For example, here we will force highlighting as javascript
instead of json
{{ embed 'src/example.json' 'js' }}
When embedding a markdown snippet (.md|markdown|markd
), the helper automatically converts any code fences inside the snippet (```
) to their unicode equivalent ("```
")
{{embed 'src/example.md'}}
File globbing
The embed
helper also accepts globbing patterns:
{{embed 'src/code-examples/*.*'}}
When globbing file is used, the code from each file will be embedded separately, and the file extension of each file will be used to identify the language to use for syntax highlighting. You may of course override the language, but whatever language you use will be applied to every embedded file.
use globbing carefully! Until you have the hang of it try to be on the safe side and be more specific with your patterns
Embed public GitHub Gists by adding only the Id of the Gist. The helper also accepts an optional second parameter for targeting a specific file on the Gist..
Parameters: String
Default: undefined
Usage: {{ gist [id] }}
Example:
{{gist '5193239'}}
Output:
<script src="https://gist.github.com/5193239.js"></script>
Easily embed a jsFiddle in a page, requiring only the ID of the fiddle.
Credit: octopress
Parameters: {{ jsfiddle "id" "tabs" "skin" "height" "width" }}
id
: full URL to the fiddle excluding http://jsfiddle.net
tabs
: tabs to be displayed, and the order specifiedskin
: the skin to be used, light
or presentation
are the only options available.height
: the height of the rendered <iframe>
width
: the width of the rendered <iframe>
Template:
{{ jsfiddle 'ccWP7' }}
You may also adjust the tabs shown and/or the order in which tabs are displayed.
Default tabs and display order: js,resources,html,css,result
Options:
js
, html
, css
: tabs for displaying coderesult
: tab for displaying the rendered result of the coderesources
: tabs for displaying the list of external resources used. This tab will not be displayed if no resources were used.Template:
{{jsfiddle 'ccWP7' 'result,js,html,css'}}
Renders to:
<iframe
style="width: 100%; height: 210px"
src="http://jsfiddle.net/ccWP7/embedded/
result,js,html,css/"></iframe>
You may remove the tabs you don't need:
Template:
{{jsfiddle 'ccWP7' 'js,result'}}
Renders to:
<iframe style="width: 100%; height: 210px"
src="http://jsfiddle.net/abc123/embedded/js,
result/"></iframe>
A third optional parameter may be used to specify the "skin" for the fiddle. At time of writing, the only skins available are light
and presentation
. However as
jsFiddle announces new skins they may be used immediately.
Default: light
Template:
{{jsfiddle 'ccWP7' 'result,js,html,css' 'presentation'}}
Renders to:
<iframe style="width: 100%; height: 210px"
src="http://jsfiddle.net/ccWP7/embedded/js,
result/presentation/"></iframe>
See the template for this page →
Find an error? Let us know →