hanna-nouveau 1.0.4 → 1.3.0

data/lib/hanna-nouveau.rb

@@ -1,62 +1,28 @@
+# frozen-string-literal: true
+
 # = A better RDoc HTML template
-#
-# Code rewritten by:
-#   Erik Hollensbe <erik@hollensbe.org>
-#
-# RubyGems integration properly done by:
-#   James Tucker (aka raggi)
-#
-# Original Authors:
-#   Mislav Marohnic <mislav.marohnic@gmail.com>
-#   Tony Strauss (http://github.com/DesigningPatterns)
-#   Michael Granger <ged@FaerieMUD.org>, who had maintained the original RDoc template
 
 require 'pathname'
-require 'haml'
-require 'sass'
-require 'rdoc/rdoc'
+require 'erb'
+# :nocov:
+require 'rdoc/rdoc' unless defined?(RDoc::Markup::ToHtml)
+# :nocov:
 require 'rdoc/generator'
 
-class RDoc::Markup::ToHtml
-  LIST_TYPE_TO_HTML[:LABEL] = ['<table class="rdoc-list label-list"><tbody>', '</tbody></table>']
-  LIST_TYPE_TO_HTML[:NOTE]  = ['<table class="rdoc-list note-list"><tbody>',  '</tbody></table>']
-
-  def list_item_start(list_item, list_type)
-    case list_type
-    when :BULLET, :LALPHA, :NUMBER, :UALPHA then
-      "<li>"
-    when :LABEL, :NOTE then
-      "<tr><td class='label'>#{Array(list_item.label).map{|label| to_html(label)}.join("<br />")}</td><td>"
-    else
-      raise RDoc::Error, "Invalid list type: #{list_type.inspect}"
-    end
-  end
-
-  def list_end_for(list_type)
-    case list_type
-    when :BULLET, :LALPHA, :NUMBER, :UALPHA then
-      "</li>"
-    when :LABEL, :NOTE then
-      "</td></tr>"
-    else
-      raise RDoc::Error, "Invalid list type: #{list_type.inspect}"
-    end
-  end
-end
-
+# Hanna version of RDoc::Generator
 class RDoc::Generator::Hanna 
-  STYLE            = 'styles.sass'
-  LAYOUT           = 'layout.haml'
+  STYLE            = 'styles.css'
+  LAYOUT           = 'layout.erb'
 
-  INDEX_PAGE       = 'index.haml'
-  CLASS_PAGE       = 'page.haml'
-  METHOD_LIST_PAGE = 'method_list.haml'
+  INDEX_PAGE       = 'index.erb'
+  CLASS_PAGE       = 'page.erb'
+  METHOD_LIST_PAGE = 'method_list.erb'
   FILE_PAGE        = CLASS_PAGE
-  SECTIONS_PAGE    = 'sections.haml'
+  SECTIONS_PAGE    = 'sections.erb'
 
-  FILE_INDEX       = 'file_index.haml'
-  CLASS_INDEX      = 'class_index.haml'
-  METHOD_INDEX     = 'method_index.haml'
+  FILE_INDEX       = 'file_index.erb'
+  CLASS_INDEX      = 'class_index.erb'
+  METHOD_INDEX     = 'method_index.erb'
 
   CLASS_DIR        = 'classes'
   FILE_DIR         = 'files'
@@ -67,13 +33,14 @@ class RDoc::Generator::Hanna
   METHOD_INDEX_OUT = 'fr_method_index.html'
   STYLE_OUT        = File.join('css', 'style.css')
 
-  DESCRIPTION = 'a HAML-based HTML generator that scales'
+  METHOD_SEARCH_JS = "method_search.js"
+
+  DESCRIPTION = 'RDoc generator designed with simplicity, beauty and ease of browsing in mind'
 
-  # EPIC CUT AND PASTE TIEM NAO -- GG
   RDoc::RDoc.add_generator( self )
 
-  def self::for( options )
-    new( options )
+  class << self
+    alias for new
   end
 
   def initialize( store, options )
@@ -103,30 +70,23 @@ class RDoc::Generator::Hanna
     generate_indexes
     generate_class_files
     generate_file_files
-
-  rescue StandardError => err
-    p [ err.class.name, err.message, err.backtrace.join("\n  ") ]
-    raise
   end
 
   def write_static_files
     css_dir = outjoin('css')
-
-    unless File.directory?(css_dir)
-      FileUtils.mkdir css_dir
-    end
-
-    File.open(File.join(css_dir, 'style.css'), 'w') { |f| f << Sass::Engine.new(File.read(templjoin(STYLE))).to_css }
+    FileUtils.mkdir_p css_dir
+    File.binwrite(File.join(css_dir, 'style.css'), File.read(templjoin(STYLE)))
   end
 
-  # FIXME refactor
   def generate_indexes
     @main_page_uri = @files.find { |f| f.name == @options.main_page }.path rescue ''
-    File.open(outjoin(INDEX_OUT), 'w') { |f| f << haml_file(templjoin(INDEX_PAGE)).to_html(binding) }
+    File.binwrite(outjoin(INDEX_OUT), erb_template(templjoin(INDEX_PAGE)).to_html(binding))
 
     generate_index(FILE_INDEX_OUT,   FILE_INDEX,   'File',   { :files => @files})
     generate_index(CLASS_INDEX_OUT,  CLASS_INDEX,  'Class',  { :classes => @classes })
     generate_index(METHOD_INDEX_OUT, METHOD_INDEX, 'Method', { :methods => @methods, :attributes => @attributes })
+
+    File.binwrite(outjoin(METHOD_SEARCH_JS), File.binread(templjoin(METHOD_SEARCH_JS)))
   end
 
   def generate_index(outfile, templfile, index_name, values)
@@ -135,20 +95,15 @@ class RDoc::Generator::Hanna
       :list_title => "#{index_name} Index"
     })
 
-    index = haml_file(templjoin(templfile))
+    index = erb_template(templjoin(templfile))
 
-    File.open(outjoin(outfile), 'w') do |f| 
-      f << with_layout(values) do
-             index.to_html(binding, values)
-           end
-    end
+    File.binwrite(outjoin(outfile), with_layout(values){index.to_html(binding, values)})
   end
 
   def generate_file_files
-    file_page = haml_file(templjoin(FILE_PAGE))
-    method_list_page = haml_file(templjoin(METHOD_LIST_PAGE))
+    file_page = erb_template(templjoin(FILE_PAGE))
+    method_list_page = erb_template(templjoin(METHOD_LIST_PAGE))
 
-    # FIXME non-Ruby files
     @files.each do |file|
       path = Pathname.new(file.path)
       stylesheet = Pathname.new(STYLE_OUT).relative_path_from(path.dirname)
@@ -169,21 +124,16 @@ class RDoc::Generator::Hanna
         end
       end
 
-      # FIXME XXX sanity check
       dir = path.dirname
-      unless File.directory? dir
-        FileUtils.mkdir_p dir
-      end
-
-      File.open(outjoin(file.path), 'w') { |f| f << result }
+      FileUtils.mkdir_p dir
+      File.binwrite(outjoin(file.path), result)
     end
   end
 
   def generate_class_files
-    class_page       = haml_file(templjoin(CLASS_PAGE))
-    method_list_page = haml_file(templjoin(METHOD_LIST_PAGE))
-    sections_page    = haml_file(templjoin(SECTIONS_PAGE))
-    # FIXME refactor
+    class_page       = erb_template(templjoin(CLASS_PAGE))
+    method_list_page = erb_template(templjoin(METHOD_LIST_PAGE))
+    sections_page    = erb_template(templjoin(SECTIONS_PAGE))
 
     @classes.each do |klass|
       outfile = classfile(klass)
@@ -220,35 +170,19 @@ class RDoc::Generator::Hanna
         end
       end
 
-      # FIXME XXX sanity check
       dir = outfile.dirname
-      unless File.directory? dir
-        FileUtils.mkdir_p dir
-      end
-
-      File.open(outfile, 'w') { |f| f << result }
+      FileUtils.mkdir_p dir
+      File.binwrite(outfile, result)
     end
   end
 
   def with_layout(values)
-    layout = haml_file(templjoin(LAYOUT))
+    layout = erb_template(templjoin(LAYOUT))
     layout.to_html(binding, :values => values) { yield }
   end
 
-  def sanitize_code_blocks(text)
-    text.gsub(/<pre>(.+?)<\/pre>/m) do
-      code = $1.sub(/^\s*\n/, '')
-      indent = code.gsub(/\n[ \t]*\n/, "\n").scan(/^ */).map{ |i| i.size }.min
-      code.gsub!(/^#{' ' * indent}/, '') if indent > 0
-
-        "<pre>#{code}</pre>"
-    end
-  end
-
-  # probably should bring in nokogiri/libxml2 to do this right.. not sure if
-  # it's worth it.
   def frame_link(content)
-    content.gsub(%r!<a href="http://[^>]*>!).each do |tag|
+    content.gsub(%r!<a[ \n]href="https?://[^>]*>!).each do |tag|
       a_tag, rest = tag.split(' ', 2)
       rest.gsub!(/target="[^"]*"/, '')
       a_tag + ' target="_top" ' + rest
@@ -264,75 +198,48 @@ class RDoc::Generator::Hanna
   end
 
   def h(html)
-    CGI::escapeHTML(html)
+    CGI::escapeHTML(html.to_s)
   end
 
-  # XXX may my sins be not visited upon my sons.
-  def render_class_tree(entries, parent=nil)
+  def render_class_tree(entries, prefix=nil, out=String.new)
     namespaces = { }
 
-    entries.sort.inject('') do |out, klass|
-      unless namespaces[klass.full_name]
-        if parent
-          text = '<span class="parent">%s::</span>%s' % [parent.full_name, klass.name]
-        else
-          text = klass.name
-        end
-
-        if klass.document_self
-          out << '<li>'
-          out << link_to(text, classfile(klass))
-        end
-
-        subentries = @classes.select { |x| x.full_name[/^#{klass.full_name}::/] }
-        subentries.each { |x| namespaces[x.full_name] = true }
-        out << "\n<ol>" + render_class_tree(subentries, klass) + "\n</ol>"
-
-        if klass.document_self
-          out << '</li>'
-        end
+    entries.sort.each do |klass|
+      full_name = klass.full_name
+      next if namespaces[full_name]
+
+      class_prefix = "#{full_name}::"
+      subentries = @classes.select{|c| c.full_name.start_with?(class_prefix)}
+      subentries.each { |x| namespaces[x.full_name] = true }
+
+      text = prefix ? (prefix + klass.name) : klass.name
+      link = link_to(text, classfile(klass))
+
+      if subentries.empty?
+        out << "<span class=\"class-link\">" << link << "</span>\n"
+      else
+        out << '<details'
+        out << ' open' if full_name.count(':') == 0
+        out << '><summary>' << link << "</summary>\n"
+        render_class_tree(subentries, "<span class=\"parent\">#{full_name}::</span>", out)
+        out << "</details>"
       end
-
-      out
     end
+
+    out
   end
     
-  def build_javascript_search_index(entries)
-    result = "var search_index = [\n"
-    entries.each do |entry|
-      method_name = entry.name
-      module_name = entry.parent_name
-      # FIXME link
-      html = link_to_method(entry, [classfile(entry.parent), (entry.aref rescue "method-#{entry.html_name}")].join('#'))
-      result << "  { method: '#{method_name.downcase}', " +
-                      "module: '#{module_name.downcase}', " +
-                      "html: '#{html}' },\n"
-    end
-    result << "]"
-    result
+  def link_to(text, url)
+    %[<a href="#{url}">#{text}</a>]
   end
 
-  def link_to(text, url = nil, classname = nil)
-    class_attr = classname ? ' class="%s"' % classname : ''
-
-    if url
-        %[<a href="#{url}"#{class_attr}>#{text}</a>]
-    elsif classname
-        %[<span#{class_attr}>#{text}</span>]
-    else
-      text
-    end
-  end
-
-  # +method_text+ is in the form of "ago (ActiveSupport::TimeWithZone)".
-  def link_to_method(entry, url = nil, classname = nil)
+  def link_to_method(entry, url)
     method_name = entry.pretty_name rescue entry.name
     module_name = entry.parent_name rescue entry.name
-    link_to %Q(<span class="method_name">#{h method_name}</span> <span class="module_name">(#{h module_name})</span>), url, classname
+    link_to %Q(<span class="method_name" value="#{entry.name}">#{h method_name}</span> <span class="module_name">(#{h module_name})</span>), url
   end
 
   def classfile(klass)
-    # FIXME sloooooooow
     Pathname.new(File.join(CLASS_DIR, klass.full_name.split('::')) + '.html')
   end
 
@@ -344,7 +251,50 @@ class RDoc::Generator::Hanna
     File.join(@templatedir, name)
   end
 
-  def haml_file(file)
-    Haml::Engine.new(File.read(file), :format => :html4)
+  class ERB < ::ERB
+    def to_html(binding, values = nil, &block)
+      local_values = {}
+      binding.local_variables.each do |lv|
+        local_values[lv] = binding.local_variable_get(lv)
+      end
+      binding.local_variable_set(:values, values) if values
+      binding.local_variable_set(:block, block) if block
+      html = result(binding)
+      local_values.each do |lv, val|
+        binding.local_variable_set(lv, val)
+      end
+      html
+    end
+  end
+
+  def erb_template(file)
+    ERB.new(File.read(file))
+  end
+
+  module LabelListTable
+    def list_item_start(list_item, list_type)
+      case list_type
+      when :LABEL, :NOTE
+        "<tr><td class='label'>#{Array(list_item.label).map{|label| to_html(label)}.join("<br />")}</td><td>"
+      else
+        super
+      end
+    end
+
+    def list_end_for(list_type)
+      case list_type
+      when :LABEL, :NOTE then
+        "</td></tr>"
+      else
+        super
+      end
+    end
   end
 end 
+
+class RDoc::Markup::ToHtml
+  LIST_TYPE_TO_HTML[:LABEL] = ['<table class="rdoc-list label-list"><tbody>', '</tbody></table>']
+  LIST_TYPE_TO_HTML[:NOTE]  = ['<table class="rdoc-list note-list"><tbody>',  '</tbody></table>']
+
+  prepend RDoc::Generator::Hanna::LabelListTable
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hanna-nouveau
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.3.0
 platform: ruby
 authors:
 - Jeremy Evans
@@ -11,10 +11,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-24 00:00:00.000000000 Z
+date: 2022-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: haml
+  name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -28,13 +28,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4'
 - !ruby/object:Gem::Dependency
-  name: sass
+  name: minitest-hooks
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -42,52 +42,51 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rdoc
+  name: minitest-global_expectations
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
-description: |
-  RDoc generator designed with simplicity, beauty and ease of browsing in mind
-
-  Based on the original Hanna by Mislav, with many changes so it works
-  on modern verions of RDoc, Haml, and Sass.
+        version: '0'
+description: RDoc generator designed with simplicity, beauty and ease of browsing
+  in mind
 email: code@jeremyevans.net
 executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE
 - README.rdoc
+- CHANGELOG
 files:
+- CHANGELOG
 - LICENSE
 - README.rdoc
-- Rakefile
-- VERSION
 - lib/hanna-nouveau.rb
-- lib/hanna-nouveau/template_files/class_index.haml
-- lib/hanna-nouveau/template_files/file_index.haml
-- lib/hanna-nouveau/template_files/index.haml
-- lib/hanna-nouveau/template_files/layout.haml
-- lib/hanna-nouveau/template_files/method_index.haml
-- lib/hanna-nouveau/template_files/method_list.haml
+- lib/hanna-nouveau/template_files/class_index.erb
+- lib/hanna-nouveau/template_files/file_index.erb
+- lib/hanna-nouveau/template_files/index.erb
+- lib/hanna-nouveau/template_files/layout.erb
+- lib/hanna-nouveau/template_files/method_index.erb
+- lib/hanna-nouveau/template_files/method_list.erb
 - lib/hanna-nouveau/template_files/method_search.js
-- lib/hanna-nouveau/template_files/page.haml
-- lib/hanna-nouveau/template_files/prototype-1.6.0.3.js
-- lib/hanna-nouveau/template_files/sections.haml
-- lib/hanna-nouveau/template_files/styles.sass
+- lib/hanna-nouveau/template_files/page.erb
+- lib/hanna-nouveau/template_files/sections.erb
+- lib/hanna-nouveau/template_files/styles.css
 - lib/rdoc/discover.rb
 homepage: https://github.com/jeremyevans/hanna-nouveau
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/jeremyevans/hanna-nouveau/issues
+  mailing_list_uri: https://github.com/jeremyevans/hanna-nouveau/discussions
+  source_code_uri: https://github.com/jeremyevans/hanna-nouveau
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -96,14 +95,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
 summary: RDoc generator designed with simplicity, beauty and ease of browsing in mind

data/Rakefile

@@ -1,13 +0,0 @@
-require "rake/clean"
-CLEAN.include ["rdoc", "*.gem"]
-
-require "rdoc/task"
-RDoc::Task.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.generator = 'hanna'
-  rdoc.title = "hanna-nouveau #{version}"
-  rdoc.options = ['--main', 'README.rdoc', '--title', 'Hanna-nouveau: RDoc generator designed with simplicity, beauty and ease of browsing in mind']
-  rdoc.rdoc_files.add %w"README.rdoc LICENSE lib"
-end

data/VERSION

@@ -1 +0,0 @@
-1.0.4

data/lib/hanna-nouveau/template_files/class_index.haml

@@ -1,3 +0,0 @@
-%h1= values[:list_title]
-%ol#index-entries.classes
-  = render_class_tree values[:classes].select { |x| x.full_name !~ /::/ }

data/lib/hanna-nouveau/template_files/file_index.haml

@@ -1,12 +0,0 @@
-%h1= values[:list_title]
-- any_hidden = false
-
-%ol#index-entries{ :class => 'files' }
-  - values[:files].each do |file|
-    - hide = file.name =~ /\.rb$/
-    - any_hidden = true if hide
-    %li{ :class => hide ? 'other' : nil }= link_to file.name, file.path
-
-  - if any_hidden
-    %li
-      %a.show{ :href => '#', :onclick => 'this.parentNode.parentNode.className += " expanded"; this.parentNode.removeChild(this); return false' } show all

data/lib/hanna-nouveau/template_files/index.haml

@@ -1,11 +0,0 @@
-!!! Frameset
-%html{ "xml:lang" => "en", :lang => "en", :xmlns => "http://www.w3.org/1999/xhtml" }
-  %head
-    %title= @options.title
-    %meta{ :content => "text/html; charset=#{@options.charset}", "http-equiv" => "Content-Type" }
-  %frameset{ :cols => "20%, *", :border => "1", :frameborder => "1", :bordercolor => "gray" }
-    %frameset{ :rows => "15%, 35%, 50%" }
-      %frame{ :name => "Files", :title => "Files", :src => "fr_file_index.html" }
-      %frame{ :name => "Classes", :src => "fr_class_index.html" }
-      %frame{ :name => "Methods", :src => "fr_method_index.html" }
-    %frame{ :name => "docwin", :src => @main_page_uri }=""

data/lib/hanna-nouveau/template_files/layout.haml

@@ -1,34 +0,0 @@
-!!! strict
-- index = values[:list_title]
-%html{ :lang => "en" }
-  %head
-    %title= values[:title]
-    %meta{ 'http-equiv' => "Content-Type", :content => "text/html; charset=#{@options.charset}" }
-    %link{ :rel => "stylesheet", :href => values[:stylesheet], :type => "text/css", :media => "screen" }
-    - unless index
-      :javascript
-        function popupCode(url) {
-          window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-        }
-
-        function toggleCode(id) {
-          var code = document.getElementById(id)
-
-          code.style.display = code.style.display != 'block' ? 'block' : 'none'
-          return true
-        }
-
-        // Make codeblocks hidden by default
-        document.writeln('<' + 'style type="text/css">.method .source pre { display: none }<\/style>')
-    - else
-      %base{ :target => 'docwin' }/
-        
-  %body{ :class => index ? 'list' : 'page' }
-    - if index
-      #index= yield
-    - else
-      #wrapper{ :class => values[:classmod] ? 'class' : 'file' }
-        = yield
-        #footer-push
-      #footer
-        = link_to '<strong>Hanna Nouveau</strong> RDoc template', 'https://github.com/rdoc/hanna-nouveau'

data/lib/hanna-nouveau/template_files/method_index.haml

@@ -1,13 +0,0 @@
-%h1= values[:list_title]
-
-%script{:type => 'text/javascript'}
-  = File.read(File.join(@templatedir, "prototype-1.6.0.3.js"))
-  = build_javascript_search_index(values[:methods] + values[:attributes])
-  = File.read(File.join(@templatedir, "method_search.js"))
-%form{:onsubmit => 'return performSearch()'}
-  %input{:type => 'text', :id => 'search', :class => 'untouched', :value => 'Enter search terms...'}
-%ol#search-results{ :class => 'methods', :style => 'display: none' }
-
-%ol#index-entries{ :class => 'methods' }
-  - (values[:attributes] + values[:methods]).uniq.each do |entry|
-    %li= link_to_method entry, [classfile(entry.parent), entry.aref].join('#')

data/lib/hanna-nouveau/template_files/method_list.haml

@@ -1,56 +0,0 @@
-- entry = values[:entry]
-- sections = values[:sections].keys if values.has_key?(:sections)
-- methods = entry.method_list + entry.attributes
-- unless methods.empty?
-  #method-list
-    %h2 Methods
-    - %w[attr attr_accessor attr_reader attr_writer class instance].each do |type|
-      - (RDoc::VISIBILITIES rescue RDoc::Context::VISIBILITIES).each do |vis|
-        -# FIXME ugly
-        - list = methods.reject { |x| x.respond_to?(:is_alias_for) && x.is_alias_for }.select { |x| x.visibility == vis && x.type == type.to_s }.sort
-        - unless list.empty?
-          - type_result = ""
-          - if type =~ /^attr_/
-            - type_result += type.sub(/^attr_/, '').capitalize
-          - else
-            - type_result += type.capitalize
-          - type_result = "#{vis.to_s.capitalize} #{type_result}"
-          %h3= type_result
-          %ol
-            - list.each do |method|
-              - if method.respond_to?(:aref)
-                - if method.name.to_s.empty? && method.call_seq
-                  %li= link_to method.call_seq.gsub(/<br\s*\/?>/, "").split(/[\r\n]+/).map{ |s| s.split(/([({]+|\[\{|\s+(#?=>|&rarr;)\s+)/).first.sub(/^[A-Za-z0-9_:]+\./, "").sub(/\s+=\s+.*/, "=").strip }.uniq.join("<br />\n"), '#' + method.aref
-                - else
-                  %li= link_to method.name, '#' + method.aref
-              - elsif method.respond_to?(:html_name)
-                %li= link_to method.name, "#method-#{method.html_name}"
-              - else
-                %li= method.name
-
-- if entry.requires or sections or entry.includes
-  #context
-    - unless entry.requires.empty?
-      #requires
-        %h2 Required files
-        %ol
-          - entry.requires.each do |req|
-            %li= req.name
-
-    - if sections && (sections.length > 1 || sections.first.title.to_s != '')
-      #contents
-        %h2 Contents
-        %ol
-          - sections.sort_by{|s| s.title.to_s}.each do |section|
-            %li= link_to section.title, "##{section.aref}"
-
-    - unless entry.includes.empty?
-      #includes
-        %h2 Included modules
-        %ol
-          - entry.includes.each do |inc|
-            - if (mod = inc.module).is_a?(String)
-              %li= inc.name
-            - else
-              %li= link_to inc.name, entry.aref_to(mod.path)
-