1fd21a6e |
# Title: Include Code Tag for Jekyll
# Author: Brandon Mathis http://brandonmathis.com
# Description: Import files on your filesystem into any blog post as embedded code snippets with syntax highlighting and a download link.
# Configuration: You can set default import path in _config.yml (defaults to code_dir: downloads/code)
#
# Syntax {% include_code path/to/file %}
# |
44e1351f |
# Example 1: |
1fd21a6e |
# {% include_code javascripts/test.js %}
#
# This will import test.js from source/downloads/code/javascripts/test.js
# and output the contents in a syntax highlighted code block inside a figure,
# with a figcaption listing the file name and download link
# |
44e1351f |
# Example 2:
# You can also include an optional title for the <figcaption>
#
# {% include_code Example 2 javascripts/test.js %}
#
# will output a figcaption with the title: Example 2 (test.js)
# |
1fd21a6e |
|
7b81aab5 |
require './plugins/pygments_code' |
3d2d1a8b |
require './plugins/raw' |
ab29d45a |
require 'pathname'
module Jekyll
class IncludeCodeTag < Liquid::Tag |
7b81aab5 |
include HighlightCode |
3d2d1a8b |
include TemplateWrapper |
c0305509 |
def initialize(tag_name, markup, tokens)
@title = nil
@file = nil |
089af26b |
if markup.strip =~ /\s*lang:(\w+)/i |
83d87f98 |
@filetype = $1 |
089af26b |
markup = markup.strip.sub(/lang:\w+/i,'') |
83d87f98 |
end |
c0305509 |
if markup.strip =~ /(.*)?(\s+|^)(\/*\S+)/i
@title = $1 || nil
@file = $3
end |
ab29d45a |
super
end
def render(context) |
20de1125 |
code_dir = (context.registers[:site].config['code_dir'].sub(/^\//,'') || 'downloads/code') |
ab29d45a |
code_path = (Pathname.new(context.registers[:site].source) + code_dir).expand_path
file = code_path + @file
if File.symlink?(code_path)
return "Code directory '#{code_path}' cannot be a symlink"
end
unless file.file?
return "File #{file} could not be found"
end
Dir.chdir(code_path) do
code = file.read |
83d87f98 |
@filetype = file.extname.sub('.','') if @filetype.nil? |
c0305509 |
title = @title ? "#{@title} (#{file.basename})" : file.basename |
11c6e1f7 |
url = "/#{code_dir}/#{@file}" |
3d2d1a8b |
source = "<figure role=code><figcaption><span>#{title}</span> <a href='#{url}'>download</a></figcaption>\n"
source += " #{highlight(code, @filetype)}</figure>"
safe_wrap(source) |
ab29d45a |
end
end
end
end
Liquid::Template.register_tag('include_code', Jekyll::IncludeCodeTag) |