2010-04-02 01:43:27 -04:00
|
|
|
# -*- mode: ruby; ruby-indent-level: 2; tab-width: 2 -*-
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
require 'erb'
|
2010-04-01 03:45:16 -04:00
|
|
|
require 'fileutils'
|
2012-11-26 23:28:14 -05:00
|
|
|
require 'pathname'
|
2010-04-01 03:45:16 -04:00
|
|
|
require 'rdoc/generator/markup'
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
2010-04-10 02:36:13 -04:00
|
|
|
# Darkfish RDoc HTML Generator
|
|
|
|
#
|
|
|
|
# $Id: darkfish.rb 52 2009-01-07 02:08:11Z deveiant $
|
|
|
|
#
|
|
|
|
# == Author/s
|
|
|
|
# * Michael Granger (ged@FaerieMUD.org)
|
|
|
|
#
|
|
|
|
# == Contributors
|
|
|
|
# * Mahlon E. Smith (mahlon@martini.nu)
|
|
|
|
# * Eric Hodel (drbrain@segment7.net)
|
|
|
|
#
|
|
|
|
# == License
|
|
|
|
#
|
|
|
|
# Copyright (c) 2007, 2008, Michael Granger. All rights reserved.
|
|
|
|
#
|
|
|
|
# Redistribution and use in source and binary forms, with or without
|
|
|
|
# modification, are permitted provided that the following conditions are met:
|
|
|
|
#
|
|
|
|
# * Redistributions of source code must retain the above copyright notice,
|
|
|
|
# this list of conditions and the following disclaimer.
|
|
|
|
#
|
|
|
|
# * Redistributions in binary form must reproduce the above copyright notice,
|
|
|
|
# this list of conditions and the following disclaimer in the documentation
|
|
|
|
# and/or other materials provided with the distribution.
|
|
|
|
#
|
|
|
|
# * Neither the name of the author/s, nor the names of the project's
|
|
|
|
# contributors may be used to endorse or promote products derived from this
|
|
|
|
# software without specific prior written permission.
|
|
|
|
#
|
|
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
|
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
|
|
|
|
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
|
|
# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
|
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
|
|
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2012-11-26 23:28:14 -05:00
|
|
|
#
|
|
|
|
# == Attributions
|
|
|
|
#
|
|
|
|
# Darkfish uses the {Silk Icons}[http://www.famfamfam.com/lab/icons/silk/] set
|
|
|
|
# by Mark James.
|
2011-02-07 02:07:12 -05:00
|
|
|
|
2010-04-01 03:45:16 -04:00
|
|
|
class RDoc::Generator::Darkfish
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
RDoc::RDoc.add_generator self
|
|
|
|
|
|
|
|
include ERB::Util
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
2010-12-19 22:22:49 -05:00
|
|
|
# Path to this file's parent directory. Used to find templates and other
|
|
|
|
# resources.
|
|
|
|
|
|
|
|
GENERATOR_DIR = File.join 'rdoc', 'generator'
|
|
|
|
|
|
|
|
##
|
|
|
|
# Release Version
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
VERSION = '3'
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2010-12-28 17:08:56 -05:00
|
|
|
##
|
|
|
|
# Description of this generator
|
|
|
|
|
|
|
|
DESCRIPTION = 'HTML generator, written by Michael Granger'
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
2012-11-26 23:28:14 -05:00
|
|
|
# The relative path to style sheets and javascript. By default this is set
|
|
|
|
# the same as the rel_prefix.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
attr_accessor :asset_rel_path
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# The path to generate files into, combined with <tt>--op</tt> from the
|
|
|
|
# options for a full path.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
attr_reader :base_dir
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# Classes and modules to be used by this generator, not necessarily
|
|
|
|
# displayed. See also #modsort
|
|
|
|
|
|
|
|
attr_reader :classes
|
|
|
|
|
|
|
|
##
|
|
|
|
# No files will be written when dry_run is true.
|
|
|
|
|
|
|
|
attr_accessor :dry_run
|
|
|
|
|
|
|
|
##
|
|
|
|
# When false the generate methods return a String instead of writing to a
|
|
|
|
# file. The default is true.
|
|
|
|
|
|
|
|
attr_accessor :file_output
|
|
|
|
|
|
|
|
##
|
|
|
|
# Files to be displayed by this generator
|
|
|
|
|
|
|
|
attr_reader :files
|
|
|
|
|
|
|
|
##
|
|
|
|
# The JSON index generator for this Darkfish generator
|
|
|
|
|
|
|
|
attr_reader :json_index
|
|
|
|
|
|
|
|
##
|
|
|
|
# Methods to be displayed by this generator
|
|
|
|
|
|
|
|
attr_reader :methods
|
|
|
|
|
|
|
|
##
|
|
|
|
# Sorted list of classes and modules to be displayed by this generator
|
|
|
|
|
|
|
|
attr_reader :modsort
|
|
|
|
|
|
|
|
##
|
|
|
|
# The RDoc::Store that is the source of the generated content
|
|
|
|
|
|
|
|
attr_reader :store
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# The output directory
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
attr_reader :outputdir
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# Initialize a few instance variables before we start
|
|
|
|
|
|
|
|
def initialize store, options
|
|
|
|
@store = store
|
|
|
|
@options = options
|
|
|
|
|
|
|
|
@asset_rel_path = ''
|
|
|
|
@base_dir = Pathname.pwd.expand_path
|
|
|
|
@dry_run = @options.dry_run
|
|
|
|
@file_output = true
|
|
|
|
@template_dir = Pathname.new options.template_dir
|
|
|
|
@template_cache = {}
|
|
|
|
|
|
|
|
@classes = nil
|
|
|
|
@context = nil
|
|
|
|
@files = nil
|
|
|
|
@methods = nil
|
|
|
|
@modsort = nil
|
|
|
|
|
|
|
|
@json_index = RDoc::Generator::JsonIndex.new self, options
|
|
|
|
end
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Output progress information if debugging is enabled
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
def debug_msg *msg
|
|
|
|
return unless $DEBUG_RDOC
|
|
|
|
$stderr.puts(*msg)
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Directory where generated class HTML files live relative to the output
|
|
|
|
# dir.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
def class_dir
|
|
|
|
nil
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Directory where generated class HTML files live relative to the output
|
|
|
|
# dir.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
def file_dir
|
|
|
|
nil
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Create the directories the generated docs will live in if they don't
|
|
|
|
# already exist.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
def gen_sub_directories
|
|
|
|
@outputdir.mkpath
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Copy over the stylesheet into the appropriate place in the output
|
|
|
|
# directory.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
def write_style_sheet
|
|
|
|
debug_msg "Copying static files"
|
2012-11-26 23:28:14 -05:00
|
|
|
options = { :verbose => $DEBUG_RDOC, :noop => @dry_run }
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
FileUtils.cp @template_dir + 'rdoc.css', '.', options
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
Dir[(@template_dir + "{js,images}/**/*").to_s].each do |path|
|
|
|
|
next if File.directory? path
|
|
|
|
next if File.basename(path) =~ /^\./
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
dst = Pathname.new(path).relative_path_from @template_dir
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
# I suck at glob
|
|
|
|
dst_dir = dst.dirname
|
|
|
|
FileUtils.mkdir_p dst_dir, options unless File.exist? dst_dir
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
FileUtils.cp @template_dir + path, dst, options
|
|
|
|
end
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Build the initial indices and output objects based on an array of TopLevel
|
|
|
|
# objects containing the extracted information.
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
def generate
|
|
|
|
setup
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
write_style_sheet
|
|
|
|
generate_index
|
|
|
|
generate_class_files
|
|
|
|
generate_file_files
|
2012-11-26 23:28:14 -05:00
|
|
|
generate_table_of_contents
|
|
|
|
@json_index.generate
|
|
|
|
|
|
|
|
copy_static
|
2010-04-01 03:45:16 -04:00
|
|
|
|
2011-02-07 02:07:12 -05:00
|
|
|
rescue => e
|
2010-12-19 22:22:49 -05:00
|
|
|
debug_msg "%s: %s\n %s" % [
|
2011-02-07 02:07:12 -05:00
|
|
|
e.class.name, e.message, e.backtrace.join("\n ")
|
2010-12-19 22:22:49 -05:00
|
|
|
]
|
|
|
|
|
|
|
|
raise
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
2012-11-26 23:28:14 -05:00
|
|
|
# Copies static files from the static_path into the output directory
|
|
|
|
|
|
|
|
def copy_static
|
|
|
|
return if @options.static_path.empty?
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
fu_options = { :verbose => $DEBUG_RDOC, :noop => @dry_run }
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
@options.static_path.each do |path|
|
|
|
|
unless File.directory? path then
|
|
|
|
FileUtils.install path, @outputdir, fu_options.merge(:mode => 0644)
|
|
|
|
next
|
|
|
|
end
|
|
|
|
|
|
|
|
Dir.chdir path do
|
|
|
|
Dir[File.join('**', '*')].each do |entry|
|
|
|
|
dest_file = @outputdir + entry
|
|
|
|
|
|
|
|
if File.directory? entry then
|
|
|
|
FileUtils.mkdir_p entry, fu_options
|
|
|
|
else
|
|
|
|
FileUtils.install entry, dest_file, fu_options.merge(:mode => 0644)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
2012-11-26 23:28:14 -05:00
|
|
|
end
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# Return a list of the documented modules sorted by salience first, then
|
|
|
|
# by name.
|
|
|
|
|
|
|
|
def get_sorted_module_list classes
|
|
|
|
classes.select do |klass|
|
2011-07-30 20:19:00 -04:00
|
|
|
klass.display?
|
2012-11-26 23:28:14 -05:00
|
|
|
end.sort
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generate an index page which lists all the classes which are documented.
|
|
|
|
|
|
|
|
def generate_index
|
2012-11-26 23:28:14 -05:00
|
|
|
setup
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
template_file = @template_dir + 'index.rhtml'
|
|
|
|
return unless template_file.exist?
|
|
|
|
|
|
|
|
debug_msg "Rendering the index page..."
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
out_file = @base_dir + @options.op_dir + 'index.html'
|
|
|
|
rel_prefix = @outputdir.relative_path_from out_file.dirname
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
# suppress 1.9.3 warning
|
|
|
|
asset_rel_prefix = asset_rel_prefix = rel_prefix + @asset_rel_path
|
|
|
|
|
|
|
|
@title = @options.title
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
render_template template_file, out_file do |io| binding end
|
2011-02-07 02:07:12 -05:00
|
|
|
rescue => e
|
|
|
|
error = RDoc::Error.new \
|
|
|
|
"error generating index.html: #{e.message} (#{e.class})"
|
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
##
|
2012-11-26 23:28:14 -05:00
|
|
|
# Generates a class file for +klass+
|
|
|
|
|
|
|
|
def generate_class klass, template_file = nil
|
|
|
|
setup
|
|
|
|
|
|
|
|
current = klass
|
|
|
|
|
|
|
|
template_file ||= @template_dir + 'class.rhtml'
|
|
|
|
|
|
|
|
debug_msg " working on %s (%s)" % [klass.full_name, klass.path]
|
|
|
|
out_file = @outputdir + klass.path
|
|
|
|
rel_prefix = @outputdir.relative_path_from out_file.dirname
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
# suppress 1.9.3 warning
|
|
|
|
asset_rel_prefix = asset_rel_prefix = rel_prefix + @asset_rel_path
|
|
|
|
svninfo = svninfo = get_svninfo(current)
|
|
|
|
|
|
|
|
@title = "#{klass.type} #{klass.full_name} - #{@options.title}"
|
|
|
|
|
|
|
|
debug_msg " rendering #{out_file}"
|
|
|
|
render_template template_file, out_file do |io| binding end
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generate a documentation file for each class and module
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
def generate_class_files
|
2012-11-26 23:28:14 -05:00
|
|
|
setup
|
|
|
|
|
|
|
|
template_file = @template_dir + 'class.rhtml'
|
|
|
|
template_file = @template_dir + 'classpage.rhtml' unless
|
|
|
|
template_file.exist?
|
2010-12-19 22:22:49 -05:00
|
|
|
return unless template_file.exist?
|
2011-02-07 02:07:12 -05:00
|
|
|
debug_msg "Generating class documentation in #{@outputdir}"
|
|
|
|
|
|
|
|
current = nil
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
@classes.each do |klass|
|
2011-02-07 02:07:12 -05:00
|
|
|
current = klass
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
generate_class klass, template_file
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
2011-02-07 02:07:12 -05:00
|
|
|
rescue => e
|
|
|
|
error = RDoc::Error.new \
|
|
|
|
"error generating #{current.path}: #{e.message} (#{e.class})"
|
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generate a documentation file for each file
|
|
|
|
|
|
|
|
def generate_file_files
|
2012-11-26 23:28:14 -05:00
|
|
|
setup
|
|
|
|
|
|
|
|
page_file = @template_dir + 'page.rhtml'
|
|
|
|
fileinfo_file = @template_dir + 'fileinfo.rhtml'
|
|
|
|
|
|
|
|
# for legacy templates
|
|
|
|
filepage_file = @template_dir + 'filepage.rhtml' unless
|
|
|
|
page_file.exist? or fileinfo_file.exist?
|
|
|
|
|
|
|
|
return unless
|
|
|
|
page_file.exist? or fileinfo_file.exist? or filepage_file.exist?
|
|
|
|
|
2011-02-07 02:07:12 -05:00
|
|
|
debug_msg "Generating file documentation in #{@outputdir}"
|
|
|
|
|
|
|
|
out_file = nil
|
2012-11-26 23:28:14 -05:00
|
|
|
current = nil
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
@files.each do |file|
|
2012-11-26 23:28:14 -05:00
|
|
|
current = file
|
|
|
|
|
|
|
|
if file.text? and page_file.exist? then
|
|
|
|
generate_page file
|
|
|
|
next
|
|
|
|
end
|
|
|
|
|
|
|
|
template_file = nil
|
|
|
|
out_file = @outputdir + file.path
|
2011-02-07 02:07:12 -05:00
|
|
|
debug_msg " working on %s (%s)" % [file.full_name, out_file]
|
2012-11-26 23:28:14 -05:00
|
|
|
rel_prefix = @outputdir.relative_path_from out_file.dirname
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
# suppress 1.9.3 warning
|
2012-11-26 23:28:14 -05:00
|
|
|
asset_rel_prefix = asset_rel_prefix = rel_prefix + @asset_rel_path
|
|
|
|
|
|
|
|
unless filepage_file then
|
|
|
|
if file.text? then
|
|
|
|
next unless page_file.exist?
|
|
|
|
template_file = page_file
|
|
|
|
@title = file.page_name
|
|
|
|
else
|
|
|
|
next unless fileinfo_file.exist?
|
|
|
|
template_file = fileinfo_file
|
|
|
|
@title = "File: #{file.base_name}"
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
@title += " - #{@options.title}"
|
|
|
|
template_file ||= filepage_file
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
render_template template_file, out_file do |io| binding end
|
|
|
|
end
|
2011-02-07 02:07:12 -05:00
|
|
|
rescue => e
|
|
|
|
error =
|
|
|
|
RDoc::Error.new "error generating #{out_file}: #{e.message} (#{e.class})"
|
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# Generate a page file for +file+
|
|
|
|
|
|
|
|
def generate_page file
|
|
|
|
setup
|
|
|
|
|
|
|
|
template_file = @template_dir + 'page.rhtml'
|
|
|
|
|
|
|
|
out_file = @outputdir + file.path
|
|
|
|
debug_msg " working on %s (%s)" % [file.full_name, out_file]
|
|
|
|
rel_prefix = @outputdir.relative_path_from out_file.dirname
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
# suppress 1.9.3 warning
|
|
|
|
current = current = file
|
|
|
|
asset_rel_prefix = asset_rel_prefix = rel_prefix + @asset_rel_path
|
|
|
|
|
|
|
|
@title = "#{file.page_name} - #{@options.title}"
|
|
|
|
|
|
|
|
debug_msg " rendering #{out_file}"
|
|
|
|
render_template template_file, out_file do |io| binding end
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generates the 404 page for the RDoc servlet
|
|
|
|
|
|
|
|
def generate_servlet_not_found path
|
|
|
|
setup
|
|
|
|
|
|
|
|
template_file = @template_dir + 'servlet_not_found.rhtml'
|
|
|
|
return unless template_file.exist?
|
|
|
|
|
2013-01-24 19:15:08 -05:00
|
|
|
debug_msg "Rendering the servlet 404 Not Found page..."
|
2012-11-26 23:28:14 -05:00
|
|
|
|
|
|
|
rel_prefix = rel_prefix = ''
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
# suppress 1.9.3 warning
|
|
|
|
asset_rel_prefix = asset_rel_prefix = ''
|
|
|
|
|
|
|
|
@title = 'Not Found'
|
|
|
|
|
|
|
|
render_template template_file do |io| binding end
|
|
|
|
rescue => e
|
|
|
|
error = RDoc::Error.new \
|
2012-11-28 02:41:19 -05:00
|
|
|
"error generating servlet_not_found: #{e.message} (#{e.class})"
|
2012-11-26 23:28:14 -05:00
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generates the servlet root page for the RDoc servlet
|
|
|
|
|
|
|
|
def generate_servlet_root installed
|
|
|
|
setup
|
|
|
|
|
|
|
|
template_file = @template_dir + 'servlet_root.rhtml'
|
|
|
|
return unless template_file.exist?
|
|
|
|
|
|
|
|
debug_msg 'Rendering the servlet root page...'
|
|
|
|
|
2012-11-29 18:34:29 -05:00
|
|
|
rel_prefix = '.'
|
|
|
|
asset_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix = asset_rel_prefix
|
2012-11-26 23:28:14 -05:00
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
@title = 'Local RDoc Documentation'
|
|
|
|
|
|
|
|
render_template template_file do |io| binding end
|
|
|
|
rescue => e
|
|
|
|
error = RDoc::Error.new \
|
|
|
|
"error generating servlet_root: #{e.message} (#{e.class})"
|
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Generate an index page which lists all the classes which are documented.
|
|
|
|
|
|
|
|
def generate_table_of_contents
|
|
|
|
setup
|
|
|
|
|
|
|
|
template_file = @template_dir + 'table_of_contents.rhtml'
|
|
|
|
return unless template_file.exist?
|
|
|
|
|
|
|
|
debug_msg "Rendering the Table of Contents..."
|
|
|
|
|
|
|
|
out_file = @outputdir + 'table_of_contents.html'
|
|
|
|
rel_prefix = @outputdir.relative_path_from out_file.dirname
|
|
|
|
search_index_rel_prefix = rel_prefix
|
|
|
|
search_index_rel_prefix += @asset_rel_path if @file_output
|
|
|
|
|
|
|
|
# suppress 1.9.3 warning
|
|
|
|
asset_rel_prefix = asset_rel_prefix = rel_prefix + @asset_rel_path
|
|
|
|
|
|
|
|
@title = "Table of Contents - #{@options.title}"
|
|
|
|
|
|
|
|
render_template template_file, out_file do |io| binding end
|
|
|
|
rescue => e
|
|
|
|
error = RDoc::Error.new \
|
|
|
|
"error generating table_of_contents.html: #{e.message} (#{e.class})"
|
|
|
|
error.set_backtrace e.backtrace
|
|
|
|
|
|
|
|
raise error
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Prepares for generation of output from the current directory
|
|
|
|
|
|
|
|
def setup
|
|
|
|
return if instance_variable_defined? :@outputdir
|
|
|
|
|
|
|
|
@outputdir = Pathname.new(@options.op_dir).expand_path @base_dir
|
|
|
|
|
|
|
|
return unless @store
|
|
|
|
|
|
|
|
@classes = @store.all_classes_and_modules.sort
|
|
|
|
@files = @store.all_files.sort
|
|
|
|
@methods = @classes.map { |m| m.method_list }.flatten.sort
|
|
|
|
@modsort = get_sorted_module_list @classes
|
|
|
|
end
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Return a string describing the amount of time in the given number of
|
|
|
|
# seconds in terms a human can understand easily.
|
|
|
|
|
|
|
|
def time_delta_string seconds
|
|
|
|
return 'less than a minute' if seconds < 60
|
|
|
|
return "#{seconds / 60} minute#{seconds / 60 == 1 ? '' : 's'}" if
|
|
|
|
seconds < 3000 # 50 minutes
|
|
|
|
return 'about one hour' if seconds < 5400 # 90 minutes
|
|
|
|
return "#{seconds / 3600} hours" if seconds < 64800 # 18 hours
|
|
|
|
return 'one day' if seconds < 86400 # 1 day
|
|
|
|
return 'about one day' if seconds < 172800 # 2 days
|
|
|
|
return "#{seconds / 86400} days" if seconds < 604800 # 1 week
|
|
|
|
return 'about one week' if seconds < 1209600 # 2 week
|
|
|
|
return "#{seconds / 604800} weeks" if seconds < 7257600 # 3 months
|
|
|
|
return "#{seconds / 2419200} months" if seconds < 31536000 # 1 year
|
|
|
|
return "#{seconds / 31536000} years"
|
|
|
|
end
|
|
|
|
|
|
|
|
# %q$Id: darkfish.rb 52 2009-01-07 02:08:11Z deveiant $"
|
|
|
|
SVNID_PATTERN = /
|
|
|
|
\$Id:\s
|
|
|
|
(\S+)\s # filename
|
|
|
|
(\d+)\s # rev
|
|
|
|
(\d{4}-\d{2}-\d{2})\s # Date (YYYY-MM-DD)
|
|
|
|
(\d{2}:\d{2}:\d{2}Z)\s # Time (HH:MM:SSZ)
|
|
|
|
(\w+)\s # committer
|
|
|
|
\$$
|
|
|
|
/x
|
|
|
|
|
|
|
|
##
|
|
|
|
# Try to extract Subversion information out of the first constant whose
|
|
|
|
# value looks like a subversion Id tag. If no matching constant is found,
|
|
|
|
# and empty hash is returned.
|
|
|
|
|
|
|
|
def get_svninfo klass
|
|
|
|
constants = klass.constants or return {}
|
|
|
|
|
|
|
|
constants.find { |c| c.value =~ SVNID_PATTERN } or return {}
|
|
|
|
|
|
|
|
filename, rev, date, time, committer = $~.captures
|
|
|
|
commitdate = Time.parse "#{date} #{time}"
|
|
|
|
|
|
|
|
return {
|
|
|
|
:filename => filename,
|
|
|
|
:rev => Integer(rev),
|
|
|
|
:commitdate => commitdate,
|
|
|
|
:commitdelta => time_delta_string(Time.now - commitdate),
|
|
|
|
:committer => committer,
|
|
|
|
}
|
|
|
|
end
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
##
|
|
|
|
# Creates a template from its components and the +body_file+.
|
|
|
|
#
|
|
|
|
# For backwards compatibility, if +body_file+ contains "<html" the body is
|
|
|
|
# used directly.
|
|
|
|
|
|
|
|
def assemble_template body_file
|
|
|
|
body = body_file.read
|
|
|
|
return body if body =~ /<html/
|
|
|
|
|
|
|
|
head_file = @template_dir + '_head.rhtml'
|
|
|
|
footer_file = @template_dir + '_footer.rhtml'
|
|
|
|
|
|
|
|
<<-TEMPLATE
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
|
|
|
<html>
|
|
|
|
<head>
|
|
|
|
#{head_file.read}
|
|
|
|
|
|
|
|
#{body}
|
|
|
|
|
|
|
|
#{footer_file.read}
|
|
|
|
TEMPLATE
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Renders the ERb contained in +file_name+ relative to the template
|
|
|
|
# directory and returns the result based on the current context.
|
|
|
|
|
|
|
|
def render file_name
|
|
|
|
template_file = @template_dir + file_name
|
|
|
|
|
|
|
|
template = template_for template_file, false, RDoc::ERBPartial
|
|
|
|
|
|
|
|
template.filename = template_file.to_s
|
|
|
|
|
|
|
|
template.result @context
|
|
|
|
end
|
|
|
|
|
2010-12-19 22:22:49 -05:00
|
|
|
##
|
|
|
|
# Load and render the erb template in the given +template_file+ and write
|
|
|
|
# it out to +out_file+.
|
|
|
|
#
|
|
|
|
# Both +template_file+ and +out_file+ should be Pathname-like objects.
|
|
|
|
#
|
|
|
|
# An io will be yielded which must be captured by binding in the caller.
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
def render_template template_file, out_file = nil # :yield: io
|
|
|
|
io_output = out_file && !@dry_run && @file_output
|
|
|
|
erb_klass = io_output ? RDoc::ERBIO : ERB
|
|
|
|
|
|
|
|
template = template_for template_file, true, erb_klass
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
if io_output then
|
2010-12-19 22:22:49 -05:00
|
|
|
debug_msg "Outputting to %s" % [out_file.expand_path]
|
|
|
|
|
|
|
|
out_file.dirname.mkpath
|
|
|
|
out_file.open 'w', 0644 do |io|
|
|
|
|
io.set_encoding @options.encoding if Object.const_defined? :Encoding
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
@context = yield io
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
template_result template, @context, template_file
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
else
|
2012-11-26 23:28:14 -05:00
|
|
|
@context = yield nil
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
output = template_result template, @context, template_file
|
2010-12-19 22:22:49 -05:00
|
|
|
|
|
|
|
debug_msg " would have written %d characters to %s" % [
|
|
|
|
output.length, out_file.expand_path
|
2012-11-26 23:28:14 -05:00
|
|
|
] if @dry_run
|
|
|
|
|
|
|
|
output
|
2010-12-19 22:22:49 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Creates the result for +template+ with +context+. If an error is raised a
|
|
|
|
# Pathname +template_file+ will indicate the file where the error occurred.
|
|
|
|
|
|
|
|
def template_result template, context, template_file
|
|
|
|
template.filename = template_file.to_s
|
|
|
|
template.result context
|
|
|
|
rescue NoMethodError => e
|
|
|
|
raise RDoc::Error, "Error while evaluating %s: %s" % [
|
|
|
|
template_file.expand_path,
|
|
|
|
e.message,
|
|
|
|
], e.backtrace
|
|
|
|
end
|
|
|
|
|
|
|
|
##
|
|
|
|
# Retrieves a cache template for +file+, if present, or fills the cache.
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
def template_for file, page = true, klass = ERB
|
2010-12-19 22:22:49 -05:00
|
|
|
template = @template_cache[file]
|
|
|
|
|
|
|
|
return template if template
|
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
template = if page then
|
|
|
|
assemble_template file
|
|
|
|
else
|
|
|
|
file.read
|
|
|
|
end
|
|
|
|
|
|
|
|
erbout = if page then
|
|
|
|
'io'
|
|
|
|
else
|
|
|
|
file_var = File.basename(file).sub(/\..*/, '')
|
|
|
|
"_erbout_#{file_var}"
|
|
|
|
end
|
2010-12-19 22:22:49 -05:00
|
|
|
|
2012-11-26 23:28:14 -05:00
|
|
|
template = klass.new template, nil, '<>', erbout
|
2010-12-19 22:22:49 -05:00
|
|
|
@template_cache[file] = template
|
|
|
|
template
|
|
|
|
end
|
2010-04-01 03:45:16 -04:00
|
|
|
|
|
|
|
end
|
|
|
|
|