webgen 0.5.11 → 0.5.12

data/ChangeLog

@@ -1,3 +1,177 @@
+commit 2edda2dbb4de4c0d4c7d2111f2636b238c1ce630
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Apr 14 08:05:43 2010 +0200
+
+    Updated website for release
+
+website/src/index.page
+website/src/news/index.page
+website/src/news/release_0_5_12.page
+
+commit fa69cc25564db37003613b087b510f35186404ae
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Apr 14 07:28:35 2010 +0200
+
+    Fixed problem where incorrect error file names were shown
+
+lib/webgen/common.rb
+lib/webgen/contentprocessor/builder.rb
+lib/webgen/contentprocessor/erb.rb
+lib/webgen/contentprocessor/erubis.rb
+lib/webgen/contentprocessor/haml.rb
+test/test_contentprocessor_builder.rb
+test/test_contentprocessor_erb.rb
+test/test_contentprocessor_erubis.rb
+test/test_contentprocessor_haml.rb
+website/src/news/release_0_5_12.page
+
+commit 66f78fa92704134bc8eb4b68e8e8f26fa3f4f8b1
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Feb 27 09:01:01 2010 +0100
+
+    Fixed problem where commands were not shown correctly on --help
+
+lib/webgen/cli.rb
+website/src/news/release_0_5_12.page
+
+commit aa374e66016e8f0f244a2fc3555f4df955a0610b
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Fri Feb 26 15:13:24 2010 +0100
+
+    Added an option for dis-/enabling the escaping of meta info values by the meta info tag
+
+doc/reference_configuration.page
+lib/webgen/default_config.rb
+lib/webgen/tag/metainfo.rb
+test/test_tag_metainfo.rb
+website/src/news/release_0_5_12.page
+
+commit 4975d97270d32e7b29ecfed866f907e7d8fff605
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 23 07:39:39 2010 +0100
+
+    Fixed bug in Tag::Metainfo where output was not correctly escaped
+
+lib/webgen/tag/metainfo.rb
+test/test_tag_metainfo.rb
+website/src/news/release_0_5_12.page
+
+commit 2e7c816f7551e4a8c9bd9b3f0f5e02c31e6bf079
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Mon Feb 22 14:09:41 2010 +0100
+
+    Fixed problem with unintentionally modified link metainfo
+
+lib/webgen/contentprocessor/head.rb
+test/test_contentprocessor_head.rb
+website/src/news/release_0_5_12.page
+
+commit 7e0cafa7f3e9eb5d7c51525b66240ce487ccf26f
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Fri Feb 19 15:41:01 2010 +0100
+
+    Updated release notes
+
+website/src/news/release_0_5_12.page
+
+commit f1851260d9fc44a6a2515ab6991d5e86e0ac403a
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Fri Feb 19 15:38:47 2010 +0100
+
+    Added a Rakefile task to show outdated translations of pages
+
+data/webgen/website_skeleton/Rakefile
+
+commit 9615064f5efabf517a8ee7a0d41e148fc7e4bf1f
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Fri Feb 19 15:11:15 2010 +0100
+
+    Small update to the style bundle creation documentation
+
+doc/manual.page
+
+commit 99ec6f4658a390be6469bd3946805e722ebc9574
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 18:04:03 2010 +0100
+
+    Fixed CSS of style andreas07, again
+
+data/webgen/website_bundles/style/andreas07/src/default.css
+
+commit 7a04abbf49245b85b77856e07893cf9b20741882
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 16:56:48 2010 +0100
+
+    Bumped version number and added release notes file
+
+lib/webgen/version.rb
+website/src/news/release_0_5_12.page
+
+commit eff54bac30139c9f76f6e4b4c70f7d149f0a6721
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 16:53:42 2010 +0100
+
+    Added Node#to_s, error classes now also accept nodes instead of alcns
+
+lib/webgen/contentprocessor/blocks.rb
+lib/webgen/contentprocessor/builder.rb
+lib/webgen/contentprocessor/erb.rb
+lib/webgen/contentprocessor/erubis.rb
+lib/webgen/contentprocessor/haml.rb
+lib/webgen/contentprocessor/head.rb
+lib/webgen/contentprocessor/kramdown.rb
+lib/webgen/contentprocessor/less.rb
+lib/webgen/contentprocessor/maruku.rb
+lib/webgen/contentprocessor/rdiscount.rb
+lib/webgen/contentprocessor/rdoc.rb
+lib/webgen/contentprocessor/redcloth.rb
+lib/webgen/contentprocessor/sass.rb
+lib/webgen/contentprocessor/tags.rb
+lib/webgen/contentprocessor/tidy.rb
+lib/webgen/contentprocessor/xmllint.rb
+lib/webgen/error.rb
+lib/webgen/node.rb
+lib/webgen/sourcehandler.rb
+lib/webgen/sourcehandler/base.rb
+lib/webgen/sourcehandler/page.rb
+lib/webgen/sourcehandler/template.rb
+lib/webgen/tag/base.rb
+lib/webgen/tag/breadcrumbtrail.rb
+lib/webgen/tag/coderay.rb
+lib/webgen/tag/link.rb
+lib/webgen/tag/metainfo.rb
+lib/webgen/tag/relocatable.rb
+lib/webgen/tree.rb
+test/test_error.rb
+test/test_node.rb
+
+commit e36a497c63a64500b276e584de2be09e8b857158
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 08:07:48 2010 +0100
+
+    Updated Rakefile
+    
+    * Merged release and announce tasks
+    * Some other small fixes
+
+Rakefile
+
+commit a966b141e1ec09fcac70d540cee33c958a847089
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 08:06:31 2010 +0100
+
+    Fixed stand-alone test failure
+
+lib/webgen/cache.rb
+
+commit 38e7aa38dfc0f811bea02d5b38918362fd422294
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Feb 16 07:59:57 2010 +0100
+
+    Fixed a warning message
+
+lib/webgen/tag/base.rb
+
 commit a80a2fea9db04394d580db0cfe49306b4e1ea820
 Author: Thomas Leitner <t_leitner@gmx.at>
 Date:   Mon Feb 15 10:49:52 2010 +0100

data/Rakefile

@@ -8,6 +8,7 @@ rescue LoadError
 end
 
 require 'rdoc/task'
+require 'rdoc/rdoc'
 
 begin
   require 'rubyforge'
@@ -72,7 +73,7 @@ rd = RDoc::Task.new do |rdoc|
   rdoc.rdoc_dir = 'htmldoc/rdoc'
   rdoc.title = 'webgen'
   rdoc.main = 'lib/webgen/website.rb'
-  rdoc.options << '--line-numbers' << '--all'
+  rdoc.options << '--line-numbers'
   rdoc.rdoc_files.include('lib')
 end
 
@@ -185,7 +186,7 @@ EOF
       #### Documentation
 
       s.has_rdoc = true
-      s.rdoc_options = ['--line-numbers', '--all', '--main', 'lib/webgen/website.rb']
+      s.rdoc_options = ['--line-numbers', '--main', 'lib/webgen/website.rb']
 
       #### Author and project details
 
@@ -202,17 +203,14 @@ EOF
 
   end
 
+  desc 'Release webgen version ' + Webgen::VERSION
+  task :release => [:clobber, :package, :publish_files, :publish_doc, :website, :publish_website, :post_news]
+
   desc "Upload webgen documentation to Rubyforge homepage"
   task :publish_doc => [:doc] do
     sh "rsync -avc --delete htmldoc/ gettalong@rubyforge.org:/var/www/gforge-projects/webgen/documentation/#{(Webgen::VERSION.split('.')[0..-2] + ['x']).join('.')}"
   end
 
-  desc 'Release webgen version ' + Webgen::VERSION
-  task :release => [:clobber, :package, :publish_files, :publish_doc]
-
-  desc 'Announce webgen version ' + Webgen::VERSION
-  task :announce => [:clobber, :post_news, :website, :publish_website]
-
   if defined? RubyForge
     desc "Upload the release to Rubyforge"
     task :publish_files => [:package] do
@@ -231,7 +229,6 @@ EOF
 
       rf.add_release('webgen', 'webgen', Webgen::VERSION, *files)
 
-      print 'Pushing gem to gemcutter'
       sh "gem push pkg/webgen-#{Webgen::VERSION}.gem"
 
       puts 'done'

data/VERSION

@@ -1 +1 @@
-0.5.11
+0.5.12

data/data/webgen/website_bundles/style/andreas07/src/default.css

@@ -71,10 +71,10 @@ body > #sidebar
 #menu a:hover, #menu span:hover
 {color:#303030; background:#f0f0f0 url(images/sidebarbg.gif) top right repeat-y;}
 
-#menu li.webgen-menu-item-selected a, #menu li.webgen-menu-item-selected span, #menu li.webgen-menu-submenu-inhierarchy span
+#menu li.webgen-menu-item-selected a, #menu li.webgen-menu-item-selected span, #menu li.webgen-menu-submenu-inhierarchy span, #menu li.webgen-menu-submenu-inhierarchy a
 {padding:5px 18px 5px 0; background:#fafafa; border-top:2px solid #c0c0c0; border-bottom:2px solid #c0c0c0;}
 
-#menu li.webgen-menu-item-selected a:hover, #menu li.webgen-menu-item-selected span:hover, #menu li.webgen-menu-submenu-inhierarchy span:hover
+#menu li.webgen-menu-item-selected a:hover, #menu li.webgen-menu-item-selected span:hover, #menu li.webgen-menu-submenu-inhierarchy span:hover, #menu li.webgen-menu-submenu-inhierarchy a:hover
 {color:#505050; background:#fafafa;}
 
 /**************** Content area styles ****************/

data/data/webgen/website_skeleton/Rakefile

@@ -9,13 +9,38 @@
 #
 
 require 'webgen/webgentask'
+require 'webgen/website'
 
 task :default => :webgen
 
+webgen_config = lambda do |config|
+  # you can set configuration options here
+end
+
 Webgen::WebgenTask.new do |website|
   website.clobber_outdir = true
-  website.config_block = lambda do |config|
-    # you can set configuration options here
+  website.config_block = webgen_config
+end
+
+desc "Show outdated translations"
+task :outdated do
+  puts "Listing outdated translations"
+  puts
+  puts "(Note: Information is taken from the last webgen run. To get the"
+  puts "       useful information, run webgen once before this task!)"
+  puts
+
+  website = Webgen::Website.new(Dir.pwd, Webgen::Logger.new($stdout), &webgen_config)
+  website.execute_in_env do
+    website.init
+    website.tree.node_access[:acn].each do |acn, versions|
+      main = versions.find {|v| v.lang == website.config['website.lang']}
+      next unless main
+      outdated = versions.select do |v|
+         main != v && main['modified_at'] > v['modified_at']
+      end.map {|v| v.lang}.join(', ')
+      puts "ACN #{acn}: #{outdated}" if outdated.length > 0
+    end
   end
 end
 

data/doc/manual.page

@@ -701,8 +701,8 @@ from <http://www.openwebdesign.org/>.
 * Unzip the the archive from OSWD and move the extracted files into the `BUNDLE/src` directory.
 
 * Rename the file `BUNDLE/src/index.html` (or whatever the main HTML file is called) to
-  `default.template`. Now go through this file and augment relative URLs to style sheets and images
-  with [relocatable tags](tag/relocatable.html).
+  `default.template`. Now go through this file and augment relative URLs to style sheets, images and
+  other files with [relocatable tags](tag/relocatable.html).
 
 * Identify the location of the main menu items, remove them and and use a [menu tag](tag/menu.html)
   instead. You may need to restrict the shown menu levels to a single level if the template is built
@@ -715,6 +715,13 @@ from <http://www.openwebdesign.org/>.
 * Adjust the `<title>` tag in the `<head>` section of the `default.template` file -- you can use the
   `\{title:}` to insert the title of the processed page file.
 
+* Identify the location where the page content should go and put `<webgen:block name="content' />`
+  there. This tells webgen to insert the block named `content` of the page file that uses the
+  template at this location.
+
+* If the template features a breadcrumb trail area, use the [breadcrumb trail
+  tag](tag/breadcrumbtrail.html) so that the breadcrumb trail gets created automatically.
+
 The BUNDLE directory can now be directly used since it is a valid webgen website directory. If you
 want to publish your style bundle, just create a (gzipped) tar archive from the contents of the
 BUNDLE directory.

data/doc/reference_configuration.page

@@ -959,6 +959,23 @@ shows how to set the option in the configuration file.
           You will find more info on the \{link: {path: docu.html, attr: {title: DocuPage}}} page!
 
 
+*   ### tag.metainfo.escape_html
+
+    Specifies whether special HTML characters in the meta information value should be escaped.
+
+    * Syntax: `BOOLEAN` where `BOOLEAN` is either `true` or `false`.
+
+    <%= show_default['tag.metainfo.escape_html'] %>
+
+    * Example for setting the option in the configuration file:
+
+          tag.metainfo.escape_html: false
+
+      Example for setting the option directly in a tag:
+
+          value of meta info `title` is not escaped \{title: {escape_html: false}}
+
+
 *   ### tag.menu.used_nodes
 
     Specifies the type of nodes that should be used for menu generation. If `all` is specified then

data/lib/webgen/cache.rb

@@ -1,6 +1,7 @@
 # -*- encoding: utf-8 -*-
 
 require 'set'
+require 'webgen/common'
 
 module Webgen
 

data/lib/webgen/cli.rb

@@ -119,14 +119,10 @@ module Webgen
 
       # :nodoc:
       def parse(argv = ARGV)
-        super do |level, cmd_name|
-          if level == 0
-            create_website.init
-            Webgen::CLI.constants.select {|c| c =~ /.+Command$/ }.each do |c|
-              self.add_command(Webgen::CLI.const_get(c).new, (c.to_s == 'RunCommand' ? true : false))
-            end
-          end
+        Webgen::CLI.constants.select {|c| c =~ /.+Command$/ }.each do |c|
+          self.add_command(Webgen::CLI.const_get(c).new, (c.to_s == 'RunCommand' ? true : false))
         end
+        super
       end
 
     end

data/lib/webgen/common.rb

@@ -17,6 +17,11 @@ module Webgen
       (error.is_a?(::SyntaxError) ? error.message : error.backtrace[0]).scan(/:(\d+)/).first.first.to_i rescue nil
     end
 
+    # Return the file name where the error occured.
+    def self.error_file(error)
+      (error.is_a?(::SyntaxError) ? error.message : error.backtrace[0]).scan(/(?:^|\s)(.*?):(\d+)/).first.first
+    end
+
   end
 
 end

data/lib/webgen/contentprocessor/blocks.rb

@@ -52,8 +52,8 @@ module Webgen::ContentProcessor
           temp_node = context.ref_node.resolve(path.strip, context.dest_node.lang)
           if temp_node.nil?
             raise Webgen::RenderError.new("Could not resolve <#{path.strip}>",
-                                          self.class.name, context.dest_node.alcn,
-                                          context.ref_node.alcn, (options[:line_nr_proc].call if options[:line_nr_proc]))
+                                          self.class.name, context.dest_node,
+                                          context.ref_node, (options[:line_nr_proc].call if options[:line_nr_proc]))
           end
           temp_node
         end.compact
@@ -72,13 +72,13 @@ module Webgen::ContentProcessor
         if options[:notfound] == 'ignore'
           return ''
         elsif block_node
-          raise Webgen::RenderError.new("No block named '#{options[:name]}' found in <#{block_node.alcn}>",
-                                        self.class.name, context.dest_node.alcn,
-                                        context.ref_node.alcn, (options[:line_nr_proc].call if options[:line_nr_proc]))
+          raise Webgen::RenderError.new("No block named '#{options[:name]}' found in <#{block_node}>",
+                                        self.class.name, context.dest_node,
+                                        context.ref_node, (options[:line_nr_proc].call if options[:line_nr_proc]))
         else
           raise Webgen::RenderError.new("No node in the render chain has a block named '#{options[:name]}'",
-                                        self.class.name, context.dest_node.alcn,
-                                        context.ref_node.alcn, (options[:line_nr_proc].call if options[:line_nr_proc]))
+                                        self.class.name, context.dest_node,
+                                        context.ref_node, (options[:line_nr_proc].call if options[:line_nr_proc]))
         end
       end
 

data/lib/webgen/contentprocessor/builder.rb

@@ -18,9 +18,10 @@ module Webgen::ContentProcessor
       context.content = xml.target!
       context
     rescue LoadError
-      raise Webgen::LoadError.new('builder', self.class.name, context.dest_node.alcn, 'builder')
+      raise Webgen::LoadError.new('builder', self.class.name, context.dest_node, 'builder')
     rescue Exception => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, Webgen::Common.error_line(e))
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node,
+                                    Webgen::Common.error_file(e), Webgen::Common.error_line(e))
     end
 
   end

data/lib/webgen/contentprocessor/erb.rb

@@ -17,7 +17,8 @@ module Webgen::ContentProcessor
       context.content = erb.result(binding)
       context
     rescue Exception => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, Webgen::Common.error_line(e))
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node,
+                                    Webgen::Common.error_file(e), Webgen::Common.error_line(e))
     end
 
   end

data/lib/webgen/contentprocessor/erubis.rb

@@ -28,9 +28,10 @@ module Webgen::ContentProcessor
       context.content = erubis.result(binding)
       context
     rescue LoadError
-      raise Webgen::LoadError.new('erubis', self.class.name, context.dest_node.alcn, 'erubis')
+      raise Webgen::LoadError.new('erubis', self.class.name, context.dest_node, 'erubis')
     rescue Exception => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, Webgen::Common.error_line(e))
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node,
+                                    Webgen::Common.error_file(e), Webgen::Common.error_line(e))
     end
 
   end

data/lib/webgen/contentprocessor/haml.rb

@@ -16,16 +16,17 @@ module Webgen::ContentProcessor
         render(Object.new, locals)
       context
     rescue LoadError
-      raise Webgen::LoadError.new('haml', self.class.name, context.dest_node.alcn, 'haml')
+      raise Webgen::LoadError.new('haml', self.class.name, context.dest_node, 'haml')
     rescue ::Haml::Error => e
       line = if e.line
                e.line + 1
              else
                Webgen::Common.error_line(e)
              end
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, line)
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node, context.ref_node, line)
     rescue Exception => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, Webgen::Common.error_line(e))
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node,
+                                    Webgen::Common.error_file(e), Webgen::Common.error_line(e))
     end
 
   end

data/lib/webgen/contentprocessor/head.rb

@@ -72,7 +72,7 @@ module Webgen::ContentProcessor
           result += "/>"
         end
 
-        link = (context.node['link'] || {}).dup
+        link = Marshal.load(Marshal.dump(context.node['link'] || {}))
 
         handle_files = lambda do |files|
           [files].flatten.compact.collect do |file|
@@ -82,7 +82,7 @@ module Webgen::ContentProcessor
                 context.dest_node.node_info[:used_meta_info_nodes] << file.alcn
                 file = context.dest_node.route_to(file)
               else
-                log(:error) { "Could not resolve path '#{file}' used in 'link' meta information in <#{context.node.alcn}>" }
+                log(:error) { "Could not resolve path '#{file}' used in 'link' meta information in <#{context.node}>" }
                 context.dest_node.flag(:dirty)
               end
             end
@@ -101,14 +101,14 @@ module Webgen::ContentProcessor
         # add generic links specified via the +link+ meta information
         link.sort.each do |link_type, vals|
           link_type = link_type.downcase
-          [vals.dup].flatten.each do |val|
+          [vals].flatten.each do |val|
             val = {'href' => val} if val.kind_of?(String)
             val['rel'] ||= link_type
             val = LINK_DOCUMENT_ATTRS.merge(val) if LINK_DOCUMENT_TYPES.include?(link_type)
             if href = val.delete('href')
               href = handle_files.call(href).first
             else
-              log(:error) { "No link target specified for link type '#{link_type}' in 'link' meta information in <#{context.node.alcn}>" }
+              log(:error) { "No link target specified for link type '#{link_type}' in 'link' meta information in <#{context.node}>" }
             end
             if href
               s = "\n<link href=\"#{href}\" "

data/lib/webgen/contentprocessor/kramdown.rb

@@ -14,11 +14,11 @@ module Webgen::ContentProcessor
       doc = ::Kramdown::Document.new(context.content, context.website.config['contentprocessor.kramdown.options'])
       context.content = KramdownHtmlConverter.convert(doc, context)
       doc.warnings.each do |warn|
-        log(:warn) { "Warning while parsing <#{context.ref_node.alcn}> with kramdown: #{warn}" }
+        log(:warn) { "Warning while parsing <#{context.ref_node}> with kramdown: #{warn}" }
       end
       context
     rescue LoadError
-      raise Webgen::LoadError.new('kramdown', self.class.name, context.dest_node.alcn, 'kramdown')
+      raise Webgen::LoadError.new('kramdown', self.class.name, context.dest_node, 'kramdown')
     end
 
   end

data/lib/webgen/contentprocessor/less.rb

@@ -14,20 +14,20 @@ module Webgen::ContentProcessor
       context
     rescue ::Less::SyntaxError => e
       line = e.message.scan(/on line (\d+):/).first.first.to_i rescue nil
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, line)
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node, context.ref_node, line)
     rescue ::Less::MixedUnitsError => e
       raise Webgen::RenderError.new("Can't mix different units together: #{e}",
-                                    self.class.name, context.dest_node.alcn, context.ref_node.alcn)
+                                    self.class.name, context.dest_node, context.ref_node)
     rescue ::Less::VariableNameError => e
       raise Webgen::RenderError.new("Variable name is undefined: #{e}",
-                                    self.class.name, context.dest_node.alcn, context.ref_node.alcn)
+                                    self.class.name, context.dest_node, context.ref_node)
     rescue ::Less::MixinNameError => e
       raise Webgen::RenderError.new("Mixin name is undefined: #{e}",
-                                    self.class.name, context.dest_node.alcn, context.ref_node.alcn)
+                                    self.class.name, context.dest_node, context.ref_node)
     rescue ::Less::ImportError => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn)
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node, context.ref_node)
     rescue LoadError
-      raise Webgen::LoadError.new('less', self.class.name, context.dest_node.alcn, 'less')
+      raise Webgen::LoadError.new('less', self.class.name, context.dest_node, 'less')
     end
 
   end

data/lib/webgen/contentprocessor/maruku.rb

@@ -26,9 +26,9 @@ module Webgen::ContentProcessor
       context.content = ::Maruku.new(context.content, :on_error => :raise).to_html
       context
     rescue LoadError
-      raise Webgen::LoadError.new('maruku', self.class.name, context.dest_node.alcn, 'maruku')
+      raise Webgen::LoadError.new('maruku', self.class.name, context.dest_node, 'maruku')
     rescue Exception => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn)
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node, context.ref_node)
     end
 
   end

data/lib/webgen/contentprocessor/rdiscount.rb

@@ -11,7 +11,7 @@ module Webgen::ContentProcessor
       context.content = ::RDiscount.new(context.content).to_html
       context
     rescue LoadError
-      raise Webgen::LoadError.new('rdiscount', self.class.name, context.dest_node.alcn, 'rdiscount')
+      raise Webgen::LoadError.new('rdiscount', self.class.name, context.dest_node, 'rdiscount')
     end
 
   end

data/lib/webgen/contentprocessor/rdoc.rb

@@ -12,7 +12,7 @@ module Webgen::ContentProcessor
       context.content = ::RDoc::Markup::ToHtml.new.convert(context.content)
       context
     rescue LoadError
-      raise Webgen::LoadError.new('rdoc/markup/to_html', self.class.name, context.dest_node.alcn, 'rdoc')
+      raise Webgen::LoadError.new('rdoc/markup/to_html', self.class.name, context.dest_node, 'rdoc')
     end
 
   end

data/lib/webgen/contentprocessor/redcloth.rb

@@ -13,7 +13,7 @@ module Webgen::ContentProcessor
       context.content = doc.to_html
       context
     rescue LoadError
-      raise Webgen::LoadError.new('redcloth', self.class.name, context.dest_node.alcn, 'RedCloth')
+      raise Webgen::LoadError.new('redcloth', self.class.name, context.dest_node, 'RedCloth')
     end
 
   end

data/lib/webgen/contentprocessor/sass.rb

@@ -12,9 +12,9 @@ module Webgen::ContentProcessor
       context.content = ::Sass::Engine.new(context.content, :filename => context.ref_node.alcn).render
       context
     rescue LoadError
-      raise Webgen::LoadError.new('sass', self.class.name, context.dest_node.alcn, 'haml')
+      raise Webgen::LoadError.new('sass', self.class.name, context.dest_node, 'haml')
     rescue ::Sass::SyntaxError => e
-      raise Webgen::RenderError.new(e, self.class.name, context.dest_node.alcn, context.ref_node.alcn, (e.sass_line if e.sass_line))
+      raise Webgen::RenderError.new(e, self.class.name, context.dest_node, context.ref_node, (e.sass_line if e.sass_line))
     end
 
   end

data/lib/webgen/contentprocessor/tags.rb

@@ -23,7 +23,7 @@ module Webgen::ContentProcessor
     # Replace all webgen tags in the content of +context+ with the rendered content.
     def call(context)
       replace_tags(context) do |tag, param_string, body|
-        log(:debug) { "Replacing tag #{tag} with data '#{param_string}' and body '#{body}' in <#{context.ref_node.alcn}>" }
+        log(:debug) { "Replacing tag #{tag} with data '#{param_string}' and body '#{body}' in <#{context.ref_node}>" }
         process_tag(tag, param_string, body, context)
       end
       context
@@ -48,7 +48,7 @@ module Webgen::ContentProcessor
         result = call(context.clone(:content => result)).content if process_output
       else
         raise Webgen::RenderError.new("No tag processor for '#{tag}' found", self.class.name,
-                                      context.dest_node.alcn, context.ref_node.alcn)
+                                      context.dest_node, context.ref_node)
       end
       result
     end
@@ -87,7 +87,7 @@ module Webgen::ContentProcessor
           data.brackets += (scanner[1] == '{' ? 1 : -1) while data.brackets != 0 && scanner.skip_until(BRACKETS_RE)
           if data.brackets != 0
             raise Webgen::RenderError.new("Unbalanced curly brackets for tag '#{data.tag}'", self.class.name,
-                                          context.dest_node.alcn, context.ref_node.alcn)
+                                          context.dest_node, context.ref_node)
           else
             data.params_end_pos = data.body_end_pos = data.end_pos = scanner.pos - 1
             data.state = (data.simple_tag ? :process : :in_body)
@@ -139,7 +139,7 @@ module Webgen::ContentProcessor
             data.body_end_pos = scanner.pos - scanner.matched.length + scanner[1].length / 2
           else
             raise Webgen::RenderError.new("Invalid body part - no end tag found for '#{data.tag}'", self.class.name,
-                                          context.dest_node.alcn, context.ref_node.alcn)
+                                          context.dest_node, context.ref_node)
           end
 
         when :done

data/lib/webgen/contentprocessor/tidy.rb

@@ -15,7 +15,7 @@ module Webgen::ContentProcessor
 
       `tidy -v 2>&1`
       if $?.exitstatus != 0
-        raise Webgen::CommandNotFoundError.new('tidy', self.class.name, context.dest_node.alcn)
+        raise Webgen::CommandNotFoundError.new('tidy', self.class.name, context.dest_node)
       end
 
       cmd = "tidy -q -f #{error_file.path} #{context.website.config['contentprocessor.tidy.options']}"
@@ -26,7 +26,7 @@ module Webgen::ContentProcessor
       end
       if $?.exitstatus != 0
         File.readlines(error_file.path).each do |line|
-          log($?.exitstatus == 1 ? :warn : :error) { "Tidy reported problems for <#{context.dest_node.alcn}>: #{line}" }
+          log($?.exitstatus == 1 ? :warn : :error) { "Tidy reported problems for <#{context.dest_node}>: #{line}" }
         end
       end
       context.content = result

data/lib/webgen/contentprocessor/xmllint.rb

@@ -15,7 +15,7 @@ module Webgen::ContentProcessor
 
       `xmllint --version 2>&1`
       if $?.exitstatus != 0
-        raise Webgen::CommandNotFoundError.new('xmllint', self.class.name, context.dest_node.alcn)
+        raise Webgen::CommandNotFoundError.new('xmllint', self.class.name, context.dest_node)
       end
 
       cmd = "xmllint #{context.website.config['contentprocessor.xmllint.options']} - 2>'#{error_file.path}'"
@@ -26,7 +26,7 @@ module Webgen::ContentProcessor
       end
       if $?.exitstatus != 0
         File.read(error_file.path).scan(/^-:(\d+):(.*?\n)(.*?\n)/).each do |line, error_msg, line_context|
-          log(:warn) { "xmllint reported problems for <#{context.dest_node.alcn}:~#{line}>: #{error_msg.strip} (context: #{line_context.strip})" }
+          log(:warn) { "xmllint reported problems for <#{context.dest_node}:~#{line}>: #{error_msg.strip} (context: #{line_context.strip})" }
         end
       end
       context

data/lib/webgen/default_config.rb

@@ -180,6 +180,8 @@ config.contentprocessor.kramdown.options({:auto_ids => true}, :doc => 'The optio
 config.contentprocessor.kramdown.handle_links(true, :doc => 'Whether all links in a kramdown document should be handled by webgen')
 
 
+config.tag.metainfo.escape_html(true, :doc => 'Special HTML characters in the output will be escaped if true')
+
 config.tag.relocatable.path(nil, :doc => 'The path which should be made relocatable', :mandatory => 'default')
 
 config.tag.menu.start_level(1, :doc => 'The level at which the menu starts.')

data/lib/webgen/error.rb

@@ -27,7 +27,7 @@ module Webgen
         set_backtrace(msg_or_error.backtrace)
         @plain_message = msg_or_error.message
       end
-      @class_name, @alcn = class_name, alcn
+      @class_name, @alcn = class_name, (alcn.kind_of?(Node) ? alcn.to_s : alcn)
     end
 
     def message # :nodoc:
@@ -68,7 +68,7 @@ module Webgen
     # exception is wrapped.
     def initialize(msg_or_error, class_name = nil, alcn = nil, error_alcn = nil, line = nil)
       super(msg_or_error, class_name, alcn)
-      @error_alcn, @line = error_alcn, line
+      @error_alcn, @line = (error_alcn.kind_of?(Node) ? error_alcn.to_s : error_alcn), line
     end
 
     def message # :nodoc:

data/lib/webgen/node.rb

@@ -191,6 +191,11 @@ module Webgen
       flagged?(:dirty_meta_info)
     end
 
+    # Return the string representation of the node which is just the alcn.
+    def to_s
+      @alcn
+    end
+
     # Return an informative representation of the node.
     def inspect
       "<##{self.class.name}: alcn=#{@alcn}>"
@@ -314,7 +319,7 @@ module Webgen
           index_node = resolve(index_path, lang)
           if index_node
             vcache[key] = index_node
-            log(:info) { "Directory index path for <#{alcn}> => <#{index_node.alcn}>" }
+            log(:info) { "Directory index path for <#{alcn}> => <#{index_node}>" }
           elsif log_warning
             vcache[key] = self
             log(:warn) { "No directory index path found for directory <#{alcn}>" }

data/lib/webgen/sourcehandler.rb

@@ -120,7 +120,7 @@ module Webgen
               e.alcn = node.alcn unless e.alcn
               raise
             rescue Exception => e
-              raise Webgen::Error.new(e, nil, node.alcn)
+              raise Webgen::Error.new(e, nil, node)
             end
           end
 
@@ -167,7 +167,7 @@ module Webgen
             e.alcn = node.alcn unless e.alcn
             raise
           rescue Exception => e
-            raise Webgen::RenderError.new(e, nil, node.alcn)
+            raise Webgen::RenderError.new(e, nil, node)
           end
         end
       end

data/lib/webgen/sourcehandler/base.rb

@@ -235,7 +235,7 @@ module Webgen::SourceHandler
       end
 
       if !node['modified_at'].kind_of?(Time)
-        log(:warn) { "Meta information 'modified_at' set to current time in <#{node.alcn}> since its value '#{node['modified_at']}' was of type #{node['modified_at'].class}" } unless node['modified_at'].nil?
+        log(:warn) { "Meta information 'modified_at' set to current time in <#{node}> since its value '#{node['modified_at']}' was of type #{node['modified_at'].class}" } unless node['modified_at'].nil?
         node['modified_at'] = Time.now
       end
       node.node_info[:src] = path.source_path

data/lib/webgen/sourcehandler/page.rb

@@ -36,7 +36,7 @@ module Webgen::SourceHandler
         context.content
       else
         raise Webgen::RenderError.new("No block named '#{block_name}'",
-                                      self.class.name, node.alcn, chain.first.alcn)
+                                      self.class.name, node, chain.first)
       end
     end
     alias_method :content, :render_node

data/lib/webgen/sourcehandler/template.rb

@@ -25,14 +25,14 @@ module Webgen::SourceHandler
       elsif node['template'].kind_of?(String)
         template_node = node.resolve(node['template'], lang)
         if template_node.nil?
-          log(:warn) { "Specified template '#{node['template']}' for <#{node.alcn}> not found, using default template!" }
+          log(:warn) { "Specified template '#{node['template']}' for <#{node}> not found, using default template!" }
           template_node = default_template(node.parent, lang)
         end
         cached_template[lang] = template_node
       elsif node.meta_info.has_key?('template') && node['template'].nil?
         template_node = cached_template[lang] = nil
       else
-        log(:info) { "Using default template in language '#{lang}' for <#{node.alcn}>" }
+        log(:info) { "Using default template in language '#{lang}' for <#{node}>" }
         template_node = default_template(node.parent, lang)
         if template_node == node && !node.parent.is_root?
           template_node = default_template(node.parent.parent, lang)

data/lib/webgen/tag/base.rb

@@ -71,7 +71,7 @@ module Webgen::Tag::Base
       config = YAML::load("--- #{tag_config}")
     rescue ArgumentError => e
       raise Webgen::RenderError.new("Could not parse the tag params '#{tag_config}': #{e.message}",
-                                    self.class.name, nil, ref_node.alcn)
+                                    self.class.name, nil, ref_node)
     end
     create_params_hash(config, ref_node)
   end
@@ -85,11 +85,11 @@ module Webgen::Tag::Base
              when NilClass then {}
              else
                raise Webgen::RenderError.new("Invalid parameter type (#{config.class})",
-                                             self.class.name, nil, node.alcn)
+                                             self.class.name, nil, node)
              end
 
     unless params.all? {|k| !website.config.meta_info[k][:mandatory] || result.has_key?(k)}
-      raise Webgen::RenderError.new("Not all mandatory parameters set", self.class.name, nil, node.alcn)
+      raise Webgen::RenderError.new("Not all mandatory parameters set", self.class.name, nil, node)
     end
 
     result
@@ -103,7 +103,7 @@ module Webgen::Tag::Base
   # Retrieve the parameter value for +name+. The value is taken from the current parameter
   # configuration if the parameter is specified there or from the website configuration otherwise.
   def param(name)
-    (@params && @params.has_key?(name) ? @params[name] : website.config[name])
+    (defined?(@params) && @params.has_key?(name) ? @params[name] : website.config[name])
   end
 
   # Default implementation for processing a tag. The parameter +tag+ specifies the name of the tag
@@ -150,7 +150,7 @@ module Webgen::Tag::Base
       elsif params.include?(tag_config_base + '.' + key)
         result[tag_config_base + '.' + key] = value
       else
-        log(:warn) { "Invalid parameter '#{key}' for tag '#{self.class.name}' in <#{node.alcn}>" }
+        log(:warn) { "Invalid parameter '#{key}' for tag '#{self.class.name}' in <#{node}>" }
       end
     end
     result
@@ -160,7 +160,7 @@ module Webgen::Tag::Base
   def create_from_string(value, params, node)
     param_name = params.find {|k| website.config.meta_info[k][:mandatory] == 'default'}
     if param_name.nil?
-      log(:error) { "No default mandatory parameter specified for tag '#{self.class.name}' but set in <#{node.alcn}>"}
+      log(:error) { "No default mandatory parameter specified for tag '#{self.class.name}' but set in <#{node}>"}
       {}
     else
       {param_name => value}

data/lib/webgen/tag/breadcrumbtrail.rb

@@ -19,7 +19,7 @@ module Webgen::Tag
       (context.dest_node.node_info[:tag_breadcrumb_trail] ||= {})[[@params.to_a.sort, context.content_node.alcn]] = out.map {|n| n.alcn}
       out = out.map {|n| context.dest_node.link_to(n, :lang => context.content_node.lang) }.
         join(param('tag.breadcrumbtrail.separator'))
-      log(:debug) { "Breadcrumb trail for <#{context.content_node.alcn}>: #{out}" }
+      log(:debug) { "Breadcrumb trail for <#{context.content_node}>: #{out}" }
       out
     end
 

data/lib/webgen/tag/coderay.rb

@@ -34,7 +34,7 @@ module Webgen::Tag
       end
       CodeRay.scan(body, param('tag.coderay.lang').to_sym).html(options)
     rescue LoadError
-      raise Webgen::LoadError.new('coderay', self.class.name, context.dest_node.alcn, 'coderay')
+      raise Webgen::LoadError.new('coderay', self.class.name, context.dest_node, 'coderay')
     end
 
   end

data/lib/webgen/tag/link.rb

@@ -13,7 +13,7 @@ module Webgen::Tag
         context.dest_node.node_info[:used_meta_info_nodes] << dest_node.alcn
         context.dest_node.link_to(dest_node, param('tag.link.attr').merge(:lang => context.content_node.lang))
       else
-        log(:error) { "Could not resolve path '#{param('tag.link.path')}' in <#{context.ref_node.alcn}>" }
+        log(:error) { "Could not resolve path '#{param('tag.link.path')}' in <#{context.ref_node}>" }
         context.dest_node.flag(:dirty)
         ''
       end

data/lib/webgen/tag/metainfo.rb

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8 -*-
+require 'cgi'
 
 module Webgen::Tag
 
@@ -14,8 +15,9 @@ module Webgen::Tag
         output = context.content_node.lang
       elsif context.content_node[tag]
         output = context.content_node[tag].to_s
+        output = CGI::escapeHTML(output) if param('tag.metainfo.escape_html')
       else
-        log(:error) { "No value for meta info key '#{tag}' in <#{context.ref_node.alcn}> found in <#{context.content_node.alcn}>" }
+        log(:error) { "No value for meta info key '#{tag}' in <#{context.ref_node}> found in <#{context.content_node}>" }
       end
       output
     end

data/lib/webgen/tag/relocatable.rb

@@ -39,7 +39,7 @@ module Webgen::Tag
         context.dest_node.node_info[:used_meta_info_nodes] << dest_node.alcn
         context.dest_node.route_to(dest_node)
       else
-        log(:error) { "Could not resolve path '#{path}' in <#{context.ref_node.alcn}>" }
+        log(:error) { "Could not resolve path '#{path}' in <#{context.ref_node}>" }
         context.dest_node.flag(:dirty)
         ''
       end

data/lib/webgen/tree.rb

@@ -48,7 +48,7 @@ module Webgen
     # A utility method called by Node#initialize. This method should not be used directly!
     def register_node(node)
       if @node_access[:alcn].has_key?(node.alcn)
-        raise "Can't have two nodes with same absolute lcn: #{node.alcn}"
+        raise "Can't have two nodes with same absolute lcn: #{node}"
       else
         @node_access[:alcn][node.alcn] = node
       end

data/lib/webgen/version.rb

@@ -3,6 +3,6 @@
 module Webgen
 
   # The version of webgen.
-  VERSION = '0.5.11'
+  VERSION = '0.5.12'
 
 end

data/test/test_contentprocessor_builder.rb

@@ -27,6 +27,13 @@ class TestContentProcessorBuilder < Test::Unit::TestCase
     context.content = "xml.div do \n5+5\nunknown\n++6\nend"
     assert_error_on_line(Webgen::RenderError, 3) { obj.call(context) }
 
+    context.content = "context.node.link_to(nil)"
+    begin
+      obj.call(context)
+    rescue Webgen::RenderError => e
+      assert(e.error_alcn =~ /\/lib\/webgen\/node.rb$/)
+    end
+
     def obj.require(lib); raise LoadError; end
     assert_raise(Webgen::LoadError) { obj.call(context) }
   end

data/test/test_contentprocessor_erb.rb

@@ -22,8 +22,12 @@ class TestContentProcessorErb < Test::Unit::TestCase
     context.content = "\n<%= 5* %>"
     assert_error_on_line(Webgen::RenderError, 2) { obj.call(context) }
 
-    context.content = "\n\n<% unknown %>"
-    assert_error_on_line(Webgen::RenderError, 3) { obj.call(context) }
+    context.content = "<% context.node.link_to(nil) %>"
+    begin
+      obj.call(context)
+    rescue Webgen::RenderError => e
+      assert(e.error_alcn =~ /\/lib\/webgen\/node.rb$/)
+    end
   end
 
 end

data/test/test_contentprocessor_erubis.rb

@@ -26,6 +26,13 @@ class TestContentProcessorErubis < Test::Unit::TestCase
     context.content = "\n\n<% unknown %>"
     assert_error_on_line(Webgen::RenderError, 3) { obj.call(context) }
 
+    context.content = "<% context.node.link_to(nil) %>"
+    begin
+      obj.call(context)
+    rescue Webgen::RenderError => e
+      assert(e.error_alcn =~ /\/lib\/webgen\/node.rb$/)
+    end
+
     context.content = "<% for i in [1] %>\n<%= i %>\n<% end %>"
     assert_equal("1\n", obj.call(context).content)
     @website.config['contentprocessor.erubis.options'][:trim] = false

data/test/test_contentprocessor_haml.rb

@@ -25,6 +25,13 @@ class TestContentProcessorHaml < Test::Unit::TestCase
     context.content = "#cont\n  = unknown"
     assert_error_on_line(Webgen::RenderError, 2) { obj.call(context) }
 
+    context.content = "#cont\n  = context.node.link_to(nil)"
+    begin
+      obj.call(context)
+    rescue Webgen::RenderError => e
+      assert(e.error_alcn =~ /\/lib\/webgen\/node.rb$/)
+    end
+
     def obj.require(lib); raise LoadError; end
     assert_raise(Webgen::LoadError) { obj.call(context) }
   end

data/test/test_contentprocessor_head.rb

@@ -85,6 +85,12 @@ class TestContentProcessorHead < Test::Unit::TestCase
                  "\n<link href=\"test.en\" rel=\"alternate\" type=\"text/html\" />" +
                  "\n<link href=\"test.en\" rel=\"next\" type=\"text/html\" />" +
                  "\n<link href=\"http://example.org\" rel=\"start\" type=\"text/xhtml\" /></head>", context.content)
+    context.content = '</head>'
+    @obj.call(context)
+    assert_equal("\n<link href=\"test.en\" rel=\"alternate\" />" +
+                 "\n<link href=\"test.en\" rel=\"alternate\" type=\"text/html\" />" +
+                 "\n<link href=\"test.en\" rel=\"next\" type=\"text/html\" />" +
+                 "\n<link href=\"http://example.org\" rel=\"start\" type=\"text/xhtml\" /></head>", context.content)
   end
 
 end

data/test/test_error.rb

@@ -1,6 +1,8 @@
 # -*- encoding: utf-8 -*-
 
 require 'test/unit'
+require 'webgen/tree'
+require 'webgen/node'
 require 'webgen/error'
 
 class TestError < Test::Unit::TestCase
@@ -21,6 +23,9 @@ class TestError < Test::Unit::TestCase
     assert_equal('/path', e.alcn)
     assert_match(/Error while working on <\/path> with KlassName:/, e.message)
 
+    e = Webgen::Error.new("test", 'KlassName', Webgen::Node.new(Webgen::Tree.new.dummy_root, '/hallo', '/hallo'))
+    assert_equal('/hallo', e.alcn)
+
     e = Webgen::Error.new(Exception.new("test"))
     assert_equal("test", e.plain_message)
     assert_match(/Error while working:/, e.message)
@@ -48,6 +53,9 @@ class TestRenderError < Test::Unit::TestCase
     e = Webgen::RenderError.new("test", 'KlassName', '/path', '/error', 5)
     assert_equal("/error", e.error_alcn)
     assert_match(/Error in <\/error:~5> while rendering <\/path>/, e.message)
+
+    e = Webgen::RenderError.new("test", 'KlassName', '/path', Webgen::Node.new(Webgen::Tree.new.dummy_root, '/hallo', '/hallo'), 5)
+    assert_equal('/hallo', e.error_alcn)
   end
 
 end

data/test/test_node.rb

@@ -182,6 +182,11 @@ class TestNode < Test::Unit::TestCase
     assert(node.inspect =~ /alcn=\//)
   end
 
+  def test_to_s
+    node = Webgen::Node.new(@tree.dummy_root, '/', '/', {'lang' => 'de', :test => :value})
+    assert_equal(node.alcn, node.to_s)
+  end
+
   def test_changed
     node = Webgen::Node.new(@tree.dummy_root, 'test/', 'test', {'lang' => 'de', :test => :value})
     node.unflag(:dirty, :dirty_meta_info, :created)

data/test/test_tag_metainfo.rb

@@ -8,13 +8,19 @@ require 'webgen/tag'
 
 class TestTagMetainfo < Test::Unit::TestCase
 
+  include Test::WebsiteHelper
+
   def test_call
     @obj = Webgen::Tag::Metainfo.new
-    node = Webgen::Node.new(Webgen::Tree.new.dummy_root, 'hallo.page', 'hallo.page', 'test' => 10, 'lang' => 'en')
+    node = Webgen::Node.new(Webgen::Tree.new.dummy_root, 'hallo.page', 'hallo.page', 'test' => 10, 'lang' => 'en',
+                            'bad' => 'Something <&>" Bad')
     c = Webgen::Context.new(:chain => [node])
     assert_equal('', @obj.call('invalid', '', c))
     assert_equal('10', @obj.call('test', '', c))
     assert_equal('en', @obj.call('lang', '', c))
+    assert_equal('Something &lt;&amp;&gt;&quot; Bad', @obj.call('bad', '', c))
+    @obj.set_params('tag.metainfo.escape_html' => false)
+    assert_equal('Something <&>" Bad', @obj.call('bad', '', c))
   end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: webgen
 version: !ruby/object:Gem::Version 
-  version: 0.5.11
+  version: 0.5.12
 platform: ruby
 authors: 
 - Thomas Leitner
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-15 00:00:00 +01:00
+date: 2010-04-14 00:00:00 +02:00
 default_executable: webgen
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -539,7 +539,6 @@ post_install_message: |+
   
 rdoc_options: 
 - --line-numbers
-- --all
 - --main
 - lib/webgen/website.rb
 require_paths: