Rocco (Docco) rake-pipeline filter

rocco_filter.rb

require "rocco"

#
# Run rocco to generate documentation on provided files
#
class RoccoFilter < Rake::Pipeline::Filter
  def initialize(options={}, &block)
    super(&block)
    @sources = options.delete(:sources)
    @options = options
  end

  def generate_output(inputs, output)
    inputs.each do |input|
      rocco = Rocco.new(input.fullpath, @sources, @options) do
        input.read
      end
      output.write rocco.to_html
    end
  end
end

This simple filter ingests source files and runs them through Rocco, the Docco Ruby port. Options can be passed directly to Rocco and additional html files may be linked via the :sources options.