compass/doc-src/lib/default.rb

# All files in the 'lib' directory will be loaded
# before nanoc starts compiling.

include Nanoc3::Helpers::LinkTo
include Nanoc3::Helpers::Capturing
include Nanoc3::Helpers::Rendering
include Nanoc3::Helpers::Breadcrumbs

def body_class(item)
  (["docs"] + (item[:classnames] || [])).join(" ")
end

def body_id(item)
  if item[:body_id]
    item[:body_id]
  elsif id = item.identifier.chop[1..-1]
    id.gsub(/\/|_/, "-")
  end
end

def body_attributes(item)
  {
    :id => body_id(item),
    :class => body_class(item)
  }
end

class Recycler
  attr_accessor :values
  attr_accessor :index
  def initialize *values
    self.values = values
    self.index = 0
  end
  def next
    values[index]
  ensure
    self.index += 1
    self.index = 0 if self.index >= self.values.size
  end
  def reset!
    self.index = 0
  end
end

def cycle(*args)
  yield Recycler.new *args
end

def default_path(item)
  item.reps.find{|r| r.name == :default}.path
end

def find(identifier)
  @items.find{|i| i.identifier == identifier}
end

def get_var(instance_var)
  instance_variable_defined?("@#{instance_var}") ? instance_variable_get("@#{instance_var}") : yield
end
  

def item_tree(item, options = {})
  crumb = item[:crumb] || item[:title]
  options[:heading_level] ||= 1 if options.fetch(:headings, true)
  child_html = ""
  if options.fetch(:depth,1) > 0
    if item.children.any?
      child_html << "<ul>"
      item.children.sort_by{|c| c[:crumb] || c[:title]}.each do |child|
        child_opts = options.dup
        child_opts[:depth] -= 1 if child_opts.has_key?(:depth)
        child_opts[:heading_level] += 1 if child_opts[:heading_level]
        child_opts.delete(:omit_self)
        child_html << item_tree(child, child_opts)
      end
      child_html << "</ul>"
    end
  else
    options.delete(:heading_level)
  end
  css_class = nil
  prefix = nil
  suffix = nil
  if item.identifier == @item.identifier
    css_class = %Q{class="selected"}
  end
  contents = unless options[:omit_self]
    hl = if options[:heading_level]
      "h#{options[:heading_level]}"
    else
      "span"
    end
    %Q{<li><#{hl}><a href="#{default_path(item)}"#{css_class}>#{crumb}</a></#{hl}></li>}
  end
  %Q{#{contents}#{child_html}}
end

def tutorial_item(path)
  path = "" if path == :root
  @items.detect do |i|
    i.identifier == "/tutorials/#{path}"
  end
end