webgen 1.3.0 → 1.4.0

data/lib/webgen/path.rb

@@ -251,7 +251,8 @@ module Webgen
     # For a description of the parameter +mode+ see #io.
     #
     # An error is raised, if no IO object is associated with the Path instance.
-    def data(mode = 'r')
+    def data(mode = nil)
+      mode ||= @meta_info['io_open_mode'] || 'r'
       io(mode) {|io| io.read}
     end
 
@@ -304,7 +305,11 @@ module Webgen
       else
         analyse_file
       end
-      @meta_info['title'] ||= @basename.tr('_-', ' ').capitalize
+      @meta_info['title'] ||= begin
+                                name = @basename.tr('_-', ' ')
+                                name[0] = name[0].upcase
+                                name
+                              end
       @ext ||= ''
       raise "The basename of a path may not be empty: #{@path}" if @basename.empty? || @basename == '#'
       raise "The parent path must start with a slash: #{@path}" if @path[0] != ?/
@@ -323,9 +328,16 @@ module Webgen
       @parent_path = File.join(File.dirname(@path), '/')
       match_data = FILENAME_RE.match(File.basename(@path))
 
-      if !match_data[1].nil? && match_data[3].nil? && match_data[4].nil? # handle special case of sort_info.basename as basename.ext
+      if !match_data[1].nil? && match_data[3].nil? && match_data[4].nil?
+        # handle special case of sort_info.basename as basename.ext
         @basename = match_data[1]
         @ext = match_data[2]
+      elsif !match_data[1].nil? && match_data[3].nil? && !match_data[4].nil? &&
+          (lang = Webgen::LanguageManager.language_for_code(match_data[2]))
+        # handle special case of sort_info.basename.ext as basename.lang.ext if basename is a lang
+        @basename = match_data[1]
+        @meta_info['lang'] = lang
+        @ext = match_data[4]
       else
         @meta_info['sort_info'] ||= match_data[1].to_i unless match_data[1].nil?
         @basename               = match_data[2]

data/lib/webgen/path_handler/api.rb

@@ -43,10 +43,12 @@ module Webgen
         api.file_nodes = {}
 
         rdoc.store.all_classes_and_modules.sort.each do |klass|
+          adapt_rdoc_class(path, klass)
           klass_node = create_page_node_for_class(path, dir_node, klass, output_flag_file)
           api.class_nodes[klass.full_name] = klass_node
           klass_node.node_info[:api] = api
           klass.each_method {|method| create_fragment_node_for_method(path, klass_node, method)}
+          klass.each_attribute {|attr| create_fragment_node_for_method(path, klass_node, attr)}
         end
 
         rdoc.store.all_files.sort.each do |file|
@@ -137,16 +139,35 @@ module Webgen
       end
       protected :rdoc_store
 
+      # Adapt a RDoc class/module object to provide a different output path depending on the
+      # output_structure meta information of the API path.
+      def adapt_rdoc_class(api_path, klass)
+        case api_path['output_structure']
+        when 'hierarchical'
+          api_path['use_proxy_path'] = false
+          def klass.http_url(prefix)
+            if classes_and_modules.size > 0
+              super(prefix).sub(/\.html/, '/index.html')
+            else
+              super(prefix)
+            end
+          end
+        else
+          api_path['use_proxy_path'] = true
+        end
+      end
+      protected :adapt_rdoc_class
+
       # Create a page node for the given class +klass+ and return it.
       #
       # A link definition entry for the class is also created.
       def create_page_node_for_class(api_path, dir_node, klass, output_flag_file)
         klass_path_str = klass.http_url(dir_node.alcn)
 
-        create_directory(api_path, Webgen::Path.new(File.dirname(klass_path_str) + '/'))
+        create_directory(api_path, Webgen::Path.new(File.dirname(klass_path_str) + '/'), api_path['use_proxy_path'])
 
         path = Webgen::Path.new(klass_path_str, 'handler' => 'page', 'modified_at' => api_path['modified_at'],
-                                'title' => "#{klass.type} #{klass.full_name}", 'api_class_name' => klass.full_name,
+                                'title' => "#{klass.full_name}", 'api_class_name' => klass.full_name,
                                 'api_name' => api_path['api_name'], 'template' => api_path['api_template'])
         node = @website.ext.path_handler.create_secondary_nodes(path).first
 

data/lib/webgen/path_handler/page_utils.rb

@@ -39,9 +39,11 @@ module Webgen
 
           context.content = blocks[name].dup
           context[:block_name] = name
-          pipeline ||= ((self['blocks'] || {})[name] || {})['pipeline'] ||
-            ((self['blocks'] || {})['defaults'] || {})['pipeline'] ||
-            []
+          pipeline ||= if (t = self['blocks']) && (t = t[name] || t['defaults']) && t.key?('pipeline')
+                         t['pipeline']
+                       else
+                         []
+                       end
           content_processor.normalize_pipeline(pipeline).each do |processor|
             content_processor.call(processor, context)
           end

data/lib/webgen/path_handler/sitemap.rb

@@ -46,7 +46,7 @@ module Webgen
         path['node_class'] = Node.to_s
         create_node(path) do |node|
           set_blocks(node, blocks)
-          node.node_info[:entries] = {:flatten => true, :and => node['entries']}
+          node.node_info[:entries] = {:flatten => true, :not => {:mi => {'no_output' => true}}, :and => node['entries']}
           @website.ext.item_tracker.add(node, :nodes, :node_finder_option_set,
                                         {:opts => node.node_info[:entries], :ref_alcn => node.alcn}, :meta_info)
         end

data/lib/webgen/version.rb

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

data/test/webgen/path_handler/test_api.rb

@@ -5,6 +5,9 @@ require 'webgen/path_handler/api'
 
 class TestPathHandlerApi < Minitest::Test
 
+  class SampleTestSubclass
+  end
+
   include Webgen::TestHelper
 
   def setup
@@ -26,26 +29,41 @@ class TestPathHandlerApi < Minitest::Test
     FileUtils.rm_rf(@website.directory)
   end
 
-  def test_create_nodes
+  def setup_for_create_nodes
     @website.ext.path_handler = Webgen::PathHandler.new(@website)
     @website.ext.path_handler.register('Directory')
     @website.ext.path_handler.register('Page')
     @website.ext.path_handler.register('Copy')
     @website.ext.link_definitions = {}
-    @api.create_nodes(@path, nil)
+  end
 
-    assert(@website.tree['/my_dir/TestPathHandlerApi.en.html'])
-    assert_equal(['/my_dir/TestPathHandlerApi.en.html', 'TestPathHandlerApi'],
+  def assert_common_tests_for_create_nodes(test_alcn)
+    assert(@website.tree[test_alcn])
+    assert_equal([test_alcn, 'TestPathHandlerApi'],
                  @website.ext.link_definitions['my_api:TestPathHandlerApi'])
-    assert(@website.tree['/my_dir/TestPathHandlerApi.en.html#method-i-setup'])
-    assert_equal(['/my_dir/TestPathHandlerApi.en.html#method-i-setup', 'TestPathHandlerApi#setup'],
+    assert(@website.tree["#{test_alcn}#method-i-setup"])
+    assert_equal(["#{test_alcn}#method-i-setup", 'TestPathHandlerApi#setup'],
                  @website.ext.link_definitions['my_api:TestPathHandlerApi#setup'])
     assert(@website.tree['/my_dir/API_rdoc.en.html'])
+    assert(@website.tree['/my_dir/TestPathHandlerApi/SampleTestSubclass.en.html'])
 
     cache_dir = @website.tmpdir(File.join('path_handler.api', 'my_api'))
     assert(File.directory?(cache_dir))
   end
 
+  def test_create_nodes
+    setup_for_create_nodes
+    @api.create_nodes(@path, nil)
+    assert_common_tests_for_create_nodes('/my_dir/TestPathHandlerApi.en.html')
+  end
+
+  def test_create_nodes_hierarchical
+    setup_for_create_nodes
+    @path['output_structure'] = 'hierarchical'
+    @api.create_nodes(@path, nil)
+    assert_common_tests_for_create_nodes('/my_dir/TestPathHandlerApi/index.en.html')
+  end
+
   def test_rdoc_options
     data_methods = [:verbosity, :dry_run, :update_output_dir,
                     :force_output, :files]

data/test/webgen/path_handler/test_page_utils.rb

@@ -82,6 +82,11 @@ class TestPageUtils < Minitest::Test
 
     node.render_block('content', @context, ['test', 'test'])
     assert_equal('testtestmycontent', @context.content)
+
+    # with no content processor
+    node.meta_info['blocks'] = {'content' => {'pipeline' => nil}}
+    node.render_block('content', @context)
+    assert_equal('mycontent', @context.content)
   end
 
 end

data/test/webgen/test_cli.rb

@@ -7,7 +7,7 @@ class TestCLICommandParser < Minitest::Test
 
   class SampleCommand < CmdParse::Command
     def initialize
-      super('sample', false)
+      super('sample', takes_commands: false)
     end
   end
 
@@ -30,11 +30,11 @@ class TestCLICommandParser < Minitest::Test
     out, err = capture_io do
       begin
         @cli.parse(['help'])
-        assert_equal(Dir.pwd, @cli.directory + '/')
+        assert_equal(Dir.pwd, @cli.directory)
       rescue SystemExit
       end
     end
-    assert_match(/Global options:/, out)
+    assert_match(/Global Options:/, out)
     assert_match(/create.*generate.*help.*install.*sample.*.*show.*config.*deps.*extensions.*version/m, out)
   end
 

data/test/webgen/test_content_processor.rb

@@ -76,6 +76,7 @@ class TestContentProcessor < Minitest::Test
   def test_normalize_pipeline
     @cp.register('MyProcessor')
     @cp.register('MyProcessor', :name => 'other')
+    assert_equal([], @cp.normalize_pipeline(nil))
     assert_equal(['my_processor', 'other', 'other'], @cp.normalize_pipeline('my_processor,other,other'))
     assert_equal(['my_processor', 'other', 'other'], @cp.normalize_pipeline('my_processor, other, other'))
     assert_equal(['my_processor', 'other', 'other'], @cp.normalize_pipeline(['my_processor','other','other']))

data/test/webgen/test_node_finder.rb

@@ -62,10 +62,11 @@ class TestNodeFinder < Minitest::Test
     check.call(%w[/dir/subfile.html /other.en.html /other.html /dir2/index.en.html /dir2/index.de.html
                    /german.de.html /dir/dir/file.html /file.de.html /file.en.html],
                @nf.find({:alcn => '/**/*.html', :flatten => true, :sort => true, :reverse => true}, tree['/']))
-    check.call(%w[/german.de.html /other.en.html /other.html /file.en.html /file.de.html],
-               @nf.find({:alcn => '/*.html', :flatten => true, :sort => 'sort_info'}, tree['/']))
-    check.call(%w[/file.de.html /file.en.html /other.html /other.en.html /german.de.html],
-               @nf.find({:alcn => '/*.html', :flatten => true, :sort => 'sort_info', :reverse => true}, tree['/']))
+    # deactivated tests because of change in "unstable" sort of Ruby between 2.1.2 and 2.2.0
+    #check.call(%w[/german.de.html /other.en.html /other.html /file.en.html /file.de.html],
+    #           @nf.find({:alcn => '/*.html', :flatten => true, :sort => 'sort_info'}, tree['/']))
+    #check.call(%w[/file.de.html /file.en.html /other.html /other.en.html /german.de.html],
+    #           @nf.find({:alcn => '/*.html', :flatten => true, :sort => 'sort_info', :reverse => true}, tree['/']))
     check.call(%w[/dir/dir/file.html /file.de.html /file.en.html /german.de.html /dir2/index.de.html /dir2/index.en.html
                   /other.html /other.en.html /dir/subfile.html],
                @nf.find({:alcn => '/**/*.html', :name => 'test', :flatten => true, :sort => 'title'}, tree['/']))

data/test/webgen/test_path.rb

@@ -110,7 +110,11 @@ class TestPath < Minitest::Test
     check_proc.call(Webgen::Path.new('/5.png'),
                     '/', '5', nil, 'png', '5.png', '5.png', '/5.png', '/5.png', nil, '5')
     check_proc.call(Webgen::Path.new('/5.de.png'),
-                    '/', 'de', nil, 'png', 'de.png', 'de.png', '/de.png', '/de.png', 5, 'De')
+                    '/', '5', 'de', 'png', '5.png', '5.de.png', '/5.png', '/5.de.png', nil, '5')
+    check_proc.call(Webgen::Path.new('/5.de.png.gz'),
+                    '/', 'de', nil, 'png.gz', 'de.png.gz', 'de.png.gz', '/de.png.gz', '/de.png.gz', 5, 'De')
+    check_proc.call(Webgen::Path.new('/5.de.en.gz'),
+                    '/', 'de', 'en', 'gz', 'de.gz', 'de.en.gz', '/de.gz', '/de.en.gz', 5, 'De')
     check_proc.call(Webgen::Path.new('/5.66.png'),
                     '/', '66', nil, 'png', '66.png', '66.png', '/66.png', '/66.png', 5, '66')
 
@@ -129,6 +133,10 @@ class TestPath < Minitest::Test
     check_proc.call(Webgen::Path.new('/dir/file.en.png', 'cn' => '<basename>(-<version>)<ext>', 'version' => 'hallo'),
                     '/dir/', 'file', 'en', 'png', 'file-hallo.png', 'file-hallo.en.png', '/dir/file-hallo.png', '/dir/file-hallo.en.png', nil, 'File')
 
+    # Check title generation
+    check_proc.call(Webgen::Path.new('/someFile.png'),
+                    '/', 'someFile', nil, 'png', 'someFile.png', 'someFile.png', '/someFile.png', '/someFile.png', nil, 'SomeFile')
+
     # Check general exceptions
     assert_raises(RuntimeError) { Webgen::Path.new('/no_basename#').basename }
     assert_raises(RuntimeError) { Webgen::Path.new('relative.page').basename }
@@ -219,10 +227,12 @@ class TestPath < Minitest::Test
     assert_equal('hallo', path.io {|f| f.read })
 
     Dir.mktmpdir('webgen-path') do |dir|
-      File.open(File.join(dir, 'src'), 'wb+') {|f| f.write("\303\274")}
+      File.open(File.join(dir, 'src'), 'wb+') {|f| f.write("\xEF\xBB\xBF\303\274")}
       path = Webgen::Path.new('/test') {|mode| File.open(File.join(dir, 'src'), mode) }
-      assert_equal(1, path.data('r:UTF-8').length)
-      assert_equal(2, path.data('rb').length)
+      assert_equal(2, path.data('r:UTF-8').length)
+      assert_equal(5, path.data('rb').length)
+      path['io_open_mode'] = 'r:BOM|UTF-8'
+      assert_equal(1, path.data.length)
     end
 
     path = Webgen::Path.new('/test.page')

metadata

@@ -1,243 +1,243 @@
 --- !ruby/object:Gem::Specification
 name: webgen
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Thomas Leitner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-15 00:00:00.000000000 Z
+date: 2015-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cmdparse
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-    - - '>='
+        version: '3.0'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 3.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-    - - '>='
+        version: '3.0'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 3.0.1
 - !ruby/object:Gem::Dependency
   name: systemu
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
 - !ruby/object:Gem::Dependency
   name: kramdown
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.8.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.8.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
 - !ruby/object:Gem::Dependency
   name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: maruku
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
 - !ruby/object:Gem::Dependency
   name: RedCloth
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.1'
 - !ruby/object:Gem::Dependency
   name: haml
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
 - !ruby/object:Gem::Dependency
   name: sass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
 - !ruby/object:Gem::Dependency
   name: builder
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
 - !ruby/object:Gem::Dependency
   name: coderay
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: erubis
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
 - !ruby/object:Gem::Dependency
   name: rdiscount
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: archive-tar-minitar
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.5'
 description: |
@@ -252,17 +252,17 @@ extensions: []
 extra_rdoc_files:
 - API.rdoc
 files:
-- Rakefile
-- setup.rb
-- VERSION
+- API.rdoc
 - AUTHORS
-- THANKS
 - COPYING
 - GPL
-- API.rdoc
 - README.md
+- Rakefile
+- THANKS
+- VERSION
 - bin/webgen
 - data/webgen/basic_website_template/ext/init.rb
+- data/webgen/basic_website_template/src/.gitignore
 - data/webgen/basic_website_template/webgen.config
 - data/webgen/bundle_template_files/README.md.erb
 - data/webgen/bundle_template_files/Rakefile.erb
@@ -278,7 +278,6 @@ files:
 - data/webgen/passive_sources/templates/sitemap.template
 - data/webgen/passive_sources/templates/tag.template
 - data/webgen/passive_sources/templates/tikz.template
-- data/webgen/basic_website_template/src/.gitignore
 - lib/webgen/blackboard.rb
 - lib/webgen/bundle/built-in-show-changes/info.yaml
 - lib/webgen/bundle/built-in-show-changes/init.rb
@@ -388,6 +387,7 @@ files:
 - lib/webgen/version.rb
 - lib/webgen/website.rb
 - man/man1/webgen.1
+- setup.rb
 - test/test_documentation.rb
 - test/webgen/cli/test_logger.rb
 - test/webgen/content_processor/test_blocks.rb
@@ -484,24 +484,24 @@ post_install_message: |2+
   Have fun!
 
 rdoc_options:
-- --line-numbers
-- --main
+- "--line-numbers"
+- "--main"
 - API.rdoc
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: webgen is a fast, powerful, and extensible static website generator.