Sha256: c06686b81f5b8d2479496da7ebf56241b6910a7b398d198c1d6906885b56b6f0
Contents?: true
Size: 1.16 KB
Versions: 20
Compression:
Stored size: 1.16 KB
Contents
module Nanoc::Filters
# @api private
class Pandoc < Nanoc::Filter
identifier :pandoc
requires 'pandoc-ruby'
# Runs the content through [Pandoc](http://johnmacfarlane.net/pandoc/)
# using [PandocRuby](https://github.com/alphabetum/pandoc-ruby).
#
# Arguments can be passed to PandocRuby in two ways:
#
# * Use the `:args` option. This approach is more flexible, since it
# allows passing an array instead of a hash.
#
# * Pass the arguments directly to the filter. With this approach, only
# hashes can be passed, which is more limiting than the `:args` approach.
#
# The `:args` approach is recommended.
#
# @example Passing arguments using `:arg`
#
# filter :pandoc, args: [:s, {:f => :markdown, :to => :html}, 'no-wrap', :toc]
#
# @example Passing arguments not using `:arg`
#
# filter :pandoc, :f => :markdown, :to => :html
#
# @param [String] content The content to filter
#
# @return [String] The filtered content
def run(content, params = {})
args = params.key?(:args) ? params[:args] : params
PandocRuby.convert(content, *args)
end
end
end
Version data entries
20 entries across 20 versions & 1 rubygems