docubot 0.6.1 → 0.6.2

data/bin/docubot

@@ -1,125 +1,125 @@
-#!/usr/bin/env ruby -KU
-# encoding: UTF-8
-
-# Hack to allow the binary to be run without the gem installed
-$: << File.join( File.dirname( __FILE__ ), '..', 'lib' )
-
-require 'rubygems'
-require 'docubot'
-
-USAGE = <<ENDUSAGE
-Usage:
-   docubot [-h] [create [-s shell] [-f]] directory [-w writer] [-o output_file] [-n] [-l log_file]
-ENDUSAGE
-
-HELP = <<ENDHELP
-   -h, --help       Show this help.
-   create           Create a starter directory filled with example files;
-                    also copies the template for easy modification, if desired.
-   -s, --shell      The shell to copy from.
-                    Available shells: #{DocuBot::SHELLS.join(', ')}
-   -f, --force      Force create over an existing directory,
-                    deleting any existing files.
-   -w, --writer     The output type to create [Defaults to 'chm']
-                    Available writers: #{DocuBot::Writer::INSTALLED_WRITERS.join(', ')}
-   -o, --output     The file or folder (depending on the writer) to create.
-                    [Default value depends on the writer chosen.]
-   -n, --nopreview  Disable automatic preview of .chm.
-   -l, --logfile    Specify the filename to log to.
-
-ENDHELP
-
-ARGS = { :shell=>'default', :writer=>'chm' }
-UNFLAGGED_ARGS = [ :directory ]
-next_arg = UNFLAGGED_ARGS.first
-ARGV.each{ |arg|
-	case arg
-		when '-h','--help'
-		  ARGS[:help] = true
-		when 'create'
-		  ARGS[:create] = true
-		when '-f','--force'
-		  ARGS[:force] = true
-		when '-s','--shell'
-			next_arg = :shell
-		when '-w','--writer'
-			next_arg = :writer
-		when '-o','--output'
-			next_arg = :output
-		when '-n','--nopreview'
-			ARGS[:nopreview] = true
-		when '-l','--logfile'
-			next_arg = :logfile
-		else
-			if next_arg
-				ARGS[next_arg] = arg
-				UNFLAGGED_ARGS.delete( next_arg )
-			end
-			next_arg = UNFLAGGED_ARGS.first
-	end
-}
-
-if ARGS[:help] or !ARGS[:directory]
-	puts USAGE
-	puts HELP if ARGS[:help]
-	exit
-end
-
-if ARGS[:logfile]
-	$stdout.reopen( ARGS[:logfile], "w" )
-	$stdout.sync = true
-	$stderr.reopen( $stdout )
-end
-
-if ARGS[:create]
-	require 'fileutils'
-
-	unless DocuBot::SHELLS.include?( ARGS[:shell] )
-		puts "  Error: '#{ARGS[:shell]}' is not a valid shell.",
-		     "  Available shells: #{DocuBot::SHELLS.join(', ')}",
-		     "  (Shells are installed in #{DocuBot::DIR/'shells'})", ""
-		exit 1
-	end
-
-	if File.exist?( ARGS[:directory] )
-		if ARGS[:force]
-			# TODO: confirmation?
-			# TODO: May be able to just use :force=>true for cp_r
-			FileUtils.rm_rf( ARGS[:directory] )
-		else
-			puts "  Error: directory '#{ARGS[:directory]}' already exists.",
-			     "  Use the --force option to forcibly overwrite.", ""
-			exit 1
-		end
-	end
-
-	dest = File.expand_path( ARGS[:directory] )
-	src  = File.expand_path( DocuBot::SHELL_DIR/ARGS[:shell] )
-	puts "  Creating:   #{dest}",
-	     "  as copy of: #{src}", ""	
-	
-	# Copy template files first so that the shell can overwrite if it wants
-	FileUtils.mkdir_p( dest )
-	FileUtils.cp_r( DocuBot::TEMPLATE_DIR, dest/'_templates' )
-	
-	Dir.chdir src do
-		Dir['**/*.*'].each do |file|
-			dest_file = dest/file
-			dest_dir  = File.dirname(dest_file)
-			FileUtils.mkdir_p( dest_dir )
-			FileUtils.cp( file, dest_file )
-		end
-	end
-else
-	# require 'perftools'
-	start = Time.now
-	# bundle = nil
-	# PerfTools::CpuProfiler.start("/tmp/docubot") do
-		bundle = DocuBot::Bundle.new( ARGS[:directory] )
-	# end
-	lap = Time.now
-	puts "%.2fs to prepare the bundle..." % (lap-start)
-	bundle.write( ARGS[:writer], ARGS[:output] )
-	puts "%.2fs to write everything." % (Time.now-lap)
-end
-
+#!/usr/bin/env ruby -KU
+# encoding: UTF-8
+
+# Hack to allow the binary to be run without the gem installed
+$: << File.join( File.dirname( __FILE__ ), '..', 'lib' )
+
+require 'rubygems'
+require 'docubot'
+
+USAGE = <<ENDUSAGE
+Usage:
+   docubot [-h] [create [-s shell] [-f]] directory [-w writer] [-o output_file] [-n] [-l log_file]
+ENDUSAGE
+
+HELP = <<ENDHELP
+   -h, --help       Show this help.
+   create           Create a starter directory filled with example files;
+                    also copies the template for easy modification, if desired.
+   -s, --shell      The shell to copy from.
+                    Available shells: #{DocuBot::SHELLS.join(', ')}
+   -f, --force      Force create over an existing directory,
+                    deleting any existing files.
+   -w, --writer     The output type to create [Defaults to 'chm']
+                    Available writers: #{DocuBot::Writer::INSTALLED_WRITERS.join(', ')}
+   -o, --output     The file or folder (depending on the writer) to create.
+                    [Default value depends on the writer chosen.]
+   -n, --nopreview  Disable automatic preview of .chm.
+   -l, --logfile    Specify the filename to log to.
+
+ENDHELP
+
+ARGS = { :shell=>'default', :writer=>'chm' }
+UNFLAGGED_ARGS = [ :directory ]
+next_arg = UNFLAGGED_ARGS.first
+ARGV.each{ |arg|
+	case arg
+		when '-h','--help'
+		  ARGS[:help] = true
+		when 'create'
+		  ARGS[:create] = true
+		when '-f','--force'
+		  ARGS[:force] = true
+		when '-s','--shell'
+			next_arg = :shell
+		when '-w','--writer'
+			next_arg = :writer
+		when '-o','--output'
+			next_arg = :output
+		when '-n','--nopreview'
+			ARGS[:nopreview] = true
+		when '-l','--logfile'
+			next_arg = :logfile
+		else
+			if next_arg
+				ARGS[next_arg] = arg
+				UNFLAGGED_ARGS.delete( next_arg )
+			end
+			next_arg = UNFLAGGED_ARGS.first
+	end
+}
+
+if ARGS[:help] or !ARGS[:directory]
+	puts USAGE
+	puts HELP if ARGS[:help]
+	exit
+end
+
+if ARGS[:logfile]
+	$stdout.reopen( ARGS[:logfile], "w" )
+	$stdout.sync = true
+	$stderr.reopen( $stdout )
+end
+
+if ARGS[:create]
+	require 'fileutils'
+
+	unless DocuBot::SHELLS.include?( ARGS[:shell] )
+		puts "  Error: '#{ARGS[:shell]}' is not a valid shell.",
+		     "  Available shells: #{DocuBot::SHELLS.join(', ')}",
+		     "  (Shells are installed in #{DocuBot::DIR/'shells'})", ""
+		exit 1
+	end
+
+	if File.exist?( ARGS[:directory] )
+		if ARGS[:force]
+			# TODO: confirmation?
+			# TODO: May be able to just use :force=>true for cp_r
+			FileUtils.rm_rf( ARGS[:directory] )
+		else
+			puts "  Error: directory '#{ARGS[:directory]}' already exists.",
+			     "  Use the --force option to forcibly overwrite.", ""
+			exit 1
+		end
+	end
+
+	dest = File.expand_path( ARGS[:directory] )
+	src  = File.expand_path( DocuBot::SHELL_DIR/ARGS[:shell] )
+	puts "  Creating:   #{dest}",
+	     "  as copy of: #{src}", ""	
+	
+	# Copy template files first so that the shell can overwrite if it wants
+	FileUtils.mkdir_p( dest )
+	FileUtils.cp_r( DocuBot::TEMPLATE_DIR, dest/'_templates' )
+	
+	Dir.chdir src do
+		Dir['**/*.*'].each do |file|
+			dest_file = dest/file
+			dest_dir  = File.dirname(dest_file)
+			FileUtils.mkdir_p( dest_dir )
+			FileUtils.cp( file, dest_file )
+		end
+	end
+else
+	# require 'perftools'
+	start = Time.now
+	# bundle = nil
+	# PerfTools::CpuProfiler.start("/tmp/docubot") do
+		bundle = DocuBot::Bundle.new( ARGS[:directory] )
+	# end
+	lap = Time.now
+	puts "%.2fs to prepare the bundle..." % (lap-start)
+	bundle.write( ARGS[:writer], ARGS[:output] )
+	puts "%.2fs to write everything." % (Time.now-lap)
+end
+

data/lib/docubot.rb

@@ -1,43 +1,43 @@
-# encoding: UTF-8
-# Assume all files read in are UTF-8 format
-if Object.const_defined? "Encoding"
-	Encoding.default_external = Encoding.default_internal = 'UTF-8'
-end
-
-# Wicked monkey patch to avoid File.join verbosity everywhere
-class String
-	def / ( other )
-		File.join( self, other )
-	end
-end
-
-require 'fileutils'
-
-module FileUtils
-	def self.win_path( path )
-		path.gsub( '/', '\\' )
-	end
-end
-
-module DocuBot
-	VERSION = '0.6.1'
-	DIR     = File.expand_path( File.dirname( __FILE__ ) )
-	
-	TEMPLATE_DIR = DIR / 'docubot/templates'
-	SHELL_DIR    = DIR / 'docubot/shells'
-	Dir.chdir( SHELL_DIR ){ SHELLS = Dir['*'] }
-	
-	def self.id_from_text( text )
-		"#" << text.strip.gsub(/[^\w.:-]+/,'-').gsub(/^[^a-z]+|-+$/i,'')
-	end
-end
-
-require 'docubot/link_tree'
-require 'docubot/metasection'
-require 'docubot/snippet'
-require 'docubot/converter'
-require 'docubot/writer'
-require 'docubot/page'
-require 'docubot/glossary'
-require 'docubot/index'
-require 'docubot/bundle'
+# encoding: UTF-8
+# Assume all files read in are UTF-8 format
+if Object.const_defined? "Encoding"
+	Encoding.default_external = Encoding.default_internal = 'UTF-8'
+end
+
+# Wicked monkey patch to avoid File.join verbosity everywhere
+class String
+	def / ( other )
+		File.join( self, other )
+	end
+end
+
+require 'fileutils'
+
+module FileUtils
+	def self.win_path( path )
+		path.gsub( '/', '\\' )
+	end
+end
+
+module DocuBot
+	VERSION = '0.6.2'
+	DIR     = File.expand_path( File.dirname( __FILE__ ) )
+	
+	TEMPLATE_DIR = DIR / 'docubot/templates'
+	SHELL_DIR    = DIR / 'docubot/shells'
+	Dir.chdir( SHELL_DIR ){ SHELLS = Dir['*'] }
+	
+	def self.id_from_text( text )
+		"#" << text.strip.gsub(/[^\w.:-]+/,'-').gsub(/^[^a-z]+|-+$/i,'')
+	end
+end
+
+require 'docubot/link_tree'
+require 'docubot/metasection'
+require 'docubot/snippet'
+require 'docubot/converter'
+require 'docubot/writer'
+require 'docubot/page'
+require 'docubot/glossary'
+require 'docubot/index'
+require 'docubot/bundle'

data/lib/docubot/bundle.rb

@@ -1,182 +1,182 @@
-# encoding: UTF-8
-require 'pathname'
-class DocuBot::Bundle
-	attr_reader :toc, :extras, :glossary, :index, :source, :global
-	attr_reader :internal_links, :external_links, :file_links, :broken_links
-	attr_reader :pages, :pages_by_title, :page_by_file_path, :page_by_html_path
-	def initialize( source_directory )
-		@source = File.expand_path( source_directory )
-		raise "DocuBot cannot find directory #{@source}. Exiting." unless File.exists?( @source )
-		@pages  = []
-		@extras = []
-		@pages_by_title    = Hash.new{ |h,k| h[k]=[] }
-		@page_by_file_path = {}
-		@page_by_html_path = {}
-
-		@glossary = DocuBot::Glossary.new( self, @source/'_glossary' )
-		@index    = DocuBot::Index.new( self )
-		@toc      = DocuBot::LinkTree::Root.new( self )
-
-		Dir.chdir( @source ) do
-			# This might be nil; MetaSection.new is OK with that.
-			index_file = Dir[ *DocuBot::Converter.types.map{|t| "index.#{t}"} ][ 0 ]
-			@global = DocuBot::MetaSection.new( {:title=>'DocuBot Documentation'}, index_file )
-			@global.glossary = @glossary
-			@global.index    = @index
-			@global.toc      = @toc
-
-			files_and_folders = Dir[ '**/*' ]
-			
-			# index files are handled by Page.new for a directory; no sections for special folders (but process contents)
-			files_and_folders.reject!{ |path| name = File.basename( path ); name =~ /^(?:index\.[^.]+)$/ }
-			
-			# All files in the _templates directory should be ignored
-			files_and_folders.reject!{ |f| f =~ /(?:^|\/)_/ }
-			files_and_folders.concat Dir[ '_static/**/*' ]
-			files_and_folders.concat Dir[ '_glossary/**/*' ]
-
-			@global.ignore.as_list.each do |glob|
-				files_and_folders = files_and_folders - Dir[glob]
-			end
-			
-			create_pages( files_and_folders )			
-		end
-		# puts @toc.to_txt
-		
-		# Regenerate pages whose templates require full scaning to have completed
-		# TODO: make this based off of a metasection attribute.
-		@pages.select do |page|
-			%w[ glossary ].include?( page.template )
-		end.each do |page|
-			page.dirty_template
-		end
-		
-		# TODO: make this optional via global variable
-		validate_links
-		warn_for_broken_links
-		
-		# TODO: make this optional via global variable
-		warn_for_missing_glossary_terms
-		
-		find_page_collisions
-	end
-	
-	def create_pages( files_and_folders )
-		files_and_folders.each do |path|
-			extension = File.extname( path )[ 1..-1 ]
-			item_is_page = File.directory?(path) || DocuBot::Converter.by_type[extension]
-			if !item_is_page
-				@extras << path
-			else
-				page = DocuBot::Page.new( self, path )
-
-				if path =~ %r{^_glossary/}
-					@glossary << page
-				else
-					@pages                            << page
-					@page_by_file_path[path]           = page
-					@page_by_html_path[page.html_path] = page
-					@pages_by_title[page.title]       << page
-					@index.process_page( page )
-
-					# Add the page (and any sub-links) to the toc
-					unless page.hide
-						@toc.add_to_link_hierarchy( page.title, page.html_path, page )
-						page.toc.as_list.each do |id_or_text|
-							id = id_or_text[0..0] == '#' ? id_or_text : DocuBot.id_from_text(id_or_text)
-							if ele = page.nokodoc.at_css(id)
-								@toc.add_to_link_hierarchy( ele.inner_text, page.html_path + id, page )
-							else
-								warn "Could not find requested toc anchor #{id.inspect} based on #{id_or_text.inspect} on #{page.html_path}"
-							end
-						end
-					end
-					
-				end
-			end
-		end		
-	end
-
-	def validate_links
-		@external_links = Hash.new{ |h,k| h[k]=[] }
-		@internal_links = Hash.new{ |h,k| h[k]=[] }
-		@file_links     = Hash.new{ |h,k| h[k]=[] }
-		@broken_links   = Hash.new{ |h,k| h[k]=[] }
-
-		Dir.chdir( @source ) do 
-			@pages.each do |page|
-				# TODO: set the xpath to .//a/@href once this is fixed: http://github.com/tenderlove/nokogiri/issues/#issue/213
-				page.nokodoc.xpath('.//a').each do |a|
-					next unless href = a['href']
-					href = CGI.unescape(href)
-					if href=~%r{^[a-z]+://}i
-						@external_links[page] << href
-					else
-						id   = href[/#([a-z][\w.:-]*)?/i]
-						file = href.sub(/#.*/,'')
-						path = file.empty? ? page.html_path : Pathname.new( File.dirname(page.html_path) / file ).cleanpath.to_s
-						if target=@page_by_html_path[path]
-							if !id || id == "#" || target.nokodoc.at_css(id)
-								@internal_links[page] << href
-							else
-								warn "Could not find internal link for #{id.inspect} on #{page.html_path.inspect}" if id 
-								@broken_links[page] << href
-							end
-						else
-							if File.file?(path) && !@page_by_file_path[path]
-								@file_links[page] << href
-							else
-								@broken_links[page] << href
-							end
-						end
-					end
-				end
-			end
-		end
-	end
-	
-	def warn_for_broken_links
-		@broken_links.each do |page,links|
-			links.each do |link|
-				warn "Broken link on #{page.file}: '#{link}'"
-			end
-		end
-	end
-	
-	def warn_for_missing_glossary_terms
-		@glossary.missing_terms.each do |term,referrers|
-			warn "Glossary term '#{term}' never defined."
-			referrers.each do |referring_page|
-				warn "...seen on #{referring_page.file}."
-			end
-		end		
-	end
-	
-	def find_page_collisions
-		# Find any and all pages that would collide
-		pages_by_html_path = Hash.new{ |h,k| h[k] = [] }
-		@pages.each do |page|
-			pages_by_html_path[page.html_path] << page
-		end
-		collisions = pages_by_html_path.select{ |path,pages| pages.length>1 }
-		unless collisions.empty?
-			message = collisions.map do |path,pages|
-				"#{path}: #{pages.map{ |page| "'#{page.title}' (#{page.file})" }.join(', ')}"
-			end.join("\n")
-			raise PageCollision.new, message
-		end		
-	end
-
-	def write( writer_type, destination=nil )
-		writer = DocuBot::Writer.by_type[ writer_type.to_s.downcase ]
-		if writer
-			writer.new( self ).write( destination )
-		else
-			raise "Unknown writer '#{writer_type}'; available types: #{DocuBot::Writer::INSTALLED_WRITERS.join ', '}"
-		end
-	end
-	
-end
-
-class DocuBot::Bundle::PageCollision < RuntimeError; end
-
+# encoding: UTF-8
+require 'pathname'
+class DocuBot::Bundle
+	attr_reader :toc, :extras, :glossary, :index, :source, :global
+	attr_reader :internal_links, :external_links, :file_links, :broken_links
+	attr_reader :pages, :pages_by_title, :page_by_file_path, :page_by_html_path
+	def initialize( source_directory )
+		@source = File.expand_path( source_directory )
+		raise "DocuBot cannot find directory #{@source}. Exiting." unless File.exists?( @source )
+		@pages  = []
+		@extras = []
+		@pages_by_title    = Hash.new{ |h,k| h[k]=[] }
+		@page_by_file_path = {}
+		@page_by_html_path = {}
+
+		@glossary = DocuBot::Glossary.new( self, @source/'_glossary' )
+		@index    = DocuBot::Index.new( self )
+		@toc      = DocuBot::LinkTree::Root.new( self )
+
+		Dir.chdir( @source ) do
+			# This might be nil; MetaSection.new is OK with that.
+			index_file = Dir[ *DocuBot::Converter.types.map{|t| "index.#{t}"} ][ 0 ]
+			@global = DocuBot::MetaSection.new( {:title=>'DocuBot Documentation'}, index_file )
+			@global.glossary = @glossary
+			@global.index    = @index
+			@global.toc      = @toc
+
+			files_and_folders = Dir[ '**/*' ]
+			
+			# index files are handled by Page.new for a directory; no sections for special folders (but process contents)
+			files_and_folders.reject!{ |path| name = File.basename( path ); name =~ /^(?:index\.[^.]+)$/ }
+			
+			# All files in the _templates directory should be ignored
+			files_and_folders.reject!{ |f| f =~ /(?:^|\/)_/ }
+			files_and_folders.concat Dir[ '_static/**/*' ]
+			files_and_folders.concat Dir[ '_glossary/**/*' ]
+
+			@global.ignore.as_list.each do |glob|
+				files_and_folders = files_and_folders - Dir[glob]
+			end
+			
+			create_pages( files_and_folders )			
+		end
+		# puts @toc.to_txt
+		
+		# Regenerate pages whose templates require full scaning to have completed
+		# TODO: make this based off of a metasection attribute.
+		@pages.select do |page|
+			%w[ glossary ].include?( page.template )
+		end.each do |page|
+			page.dirty_template
+		end
+		
+		# TODO: make this optional via global variable
+		validate_links
+		warn_for_broken_links
+		
+		# TODO: make this optional via global variable
+		warn_for_missing_glossary_terms
+		
+		find_page_collisions
+	end
+	
+	def create_pages( files_and_folders )
+		files_and_folders.each do |path|
+			extension = File.extname( path )[ 1..-1 ]
+			item_is_page = File.directory?(path) || DocuBot::Converter.by_type[extension]
+			if !item_is_page
+				@extras << path
+			else
+				page = DocuBot::Page.new( self, path )
+
+				if path =~ %r{^_glossary/}
+					@glossary << page
+				else
+					@pages                            << page
+					@page_by_file_path[path]           = page
+					@page_by_html_path[page.html_path] = page
+					@pages_by_title[page.title]       << page
+					@index.process_page( page )
+
+					# Add the page (and any sub-links) to the toc
+					unless page.hide
+						@toc.add_to_link_hierarchy( page.title, page.html_path, page )
+						page.toc.as_list.each do |id_or_text|
+							id = id_or_text[0..0] == '#' ? id_or_text : DocuBot.id_from_text(id_or_text)
+							if ele = page.nokodoc.at_css(id)
+								@toc.add_to_link_hierarchy( ele.inner_text, page.html_path + id, page )
+							else
+								warn "Could not find requested toc anchor #{id.inspect} based on #{id_or_text.inspect} on #{page.html_path}"
+							end
+						end
+					end
+					
+				end
+			end
+		end		
+	end
+
+	def validate_links
+		@external_links = Hash.new{ |h,k| h[k]=[] }
+		@internal_links = Hash.new{ |h,k| h[k]=[] }
+		@file_links     = Hash.new{ |h,k| h[k]=[] }
+		@broken_links   = Hash.new{ |h,k| h[k]=[] }
+
+		Dir.chdir( @source ) do 
+			@pages.each do |page|
+				# TODO: set the xpath to .//a/@href once this is fixed: http://github.com/tenderlove/nokogiri/issues/#issue/213
+				page.nokodoc.xpath('.//a').each do |a|
+					next unless href = a['href']
+					href = CGI.unescape(href)
+					if href=~%r{^[a-z]+://}i
+						@external_links[page] << href
+					else
+						id   = href[/#([a-z][\w.:-]*)?/i]
+						file = href.sub(/#.*/,'')
+						path = file.empty? ? page.html_path : Pathname.new( File.dirname(page.html_path) / file ).cleanpath.to_s
+						if target=@page_by_html_path[path]
+							if !id || id == "#" || target.nokodoc.at_css(id)
+								@internal_links[page] << href
+							else
+								warn "Could not find internal link for #{id.inspect} on #{page.html_path.inspect}" if id 
+								@broken_links[page] << href
+							end
+						else
+							if File.file?(path) && !@page_by_file_path[path]
+								@file_links[page] << href
+							else
+								@broken_links[page] << href
+							end
+						end
+					end
+				end
+			end
+		end
+	end
+	
+	def warn_for_broken_links
+		@broken_links.each do |page,links|
+			links.each do |link|
+				warn "Broken link on #{page.file}: '#{link}'"
+			end
+		end
+	end
+	
+	def warn_for_missing_glossary_terms
+		@glossary.missing_terms.each do |term,referrers|
+			warn "Glossary term '#{term}' never defined."
+			referrers.each do |referring_page|
+				warn "...seen on #{referring_page.file}."
+			end
+		end		
+	end
+	
+	def find_page_collisions
+		# Find any and all pages that would collide
+		pages_by_html_path = Hash.new{ |h,k| h[k] = [] }
+		@pages.each do |page|
+			pages_by_html_path[page.html_path] << page
+		end
+		collisions = pages_by_html_path.select{ |path,pages| pages.length>1 }
+		unless collisions.empty?
+			message = collisions.map do |path,pages|
+				"#{path}: #{pages.map{ |page| "'#{page.title}' (#{page.file})" }.join(', ')}"
+			end.join("\n")
+			raise PageCollision.new, message
+		end		
+	end
+
+	def write( writer_type, destination=nil )
+		writer = DocuBot::Writer.by_type[ writer_type.to_s.downcase ]
+		if writer
+			writer.new( self ).write( destination )
+		else
+			raise "Unknown writer '#{writer_type}'; available types: #{DocuBot::Writer::INSTALLED_WRITERS.join ', '}"
+		end
+	end
+	
+end
+
+class DocuBot::Bundle::PageCollision < RuntimeError; end
+