juli 2.0.0

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/juli.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'juli/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "juli"
+  spec.version       = Juli::VERSION
+  spec.authors       = ["ido"]
+  spec.email         = ["fuminori_ido@yahoo.co.jp"]
+
+  spec.summary       = %q{Offline wiki, and idea processor}
+  spec.description   = %q{Offline wiki, and idea processor}
+  spec.homepage      = "https://github.com/fuminori-ido/juli"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'racc'
+  spec.add_runtime_dependency 'simplecov'
+  spec.add_runtime_dependency 'RMagick'
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/juli.rb

@@ -0,0 +1,21 @@
+require 'i18n'
+require 'pathname'
+require "juli/version"
+
+# namespace for all of Juli library elements
+module Juli
+  # sentinel to search juli-repo.  Also it's a directory name to sotre config.
+  REPO          = '.juli'
+  LIB           = File.join(Pathname.new(File.dirname(__FILE__)).realpath, 'juli')
+  TEMPLATE_PATH = File.join(LIB, 'template')
+
+  class JuliError       < StandardError; end
+    class NoConfig        < JuliError; end
+    class NotImplemented  < JuliError; end
+
+  class << self
+    def init
+      I18n.enforce_available_locales = false
+    end
+  end
+end

data/lib/juli/absyn.rb

@@ -0,0 +1,206 @@
+require 'juli/wiki'
+
+# Abstract tree nodes
+module Juli::Absyn
+  class Node
+    attr_accessor :parent
+
+    def accept(visitor)
+      visitor.visit_node(self)
+    end
+  end
+
+  # StrNode adds 'concat' string manupilation method
+  #
+  # StrNode is also an element of ListItem
+  class StrNode < Node
+    attr_accessor :str, :level
+
+    def initialize(str = '', level = 0)
+      @str    = str
+      @level  = level
+    end
+
+    def concat(str)
+      @str += str
+    end
+
+    def accept(visitor)
+      visitor.visit_str(self)
+    end
+  end
+
+  class Verbatim < Node
+    attr_accessor :str
+
+    def initialize(str)
+      @str    = str
+    end
+
+    def accept(visitor)
+      visitor.visit_verbatim(self)
+    end
+  end
+
+  class ArrayNode < Node
+    attr_accessor :array
+
+    def initialize
+      @array  = Array.new
+    end
+
+    def accept(visitor)
+      visitor.visit_array(self)
+    end
+
+    def add(child)
+      @array << child
+      child.parent = self
+      self
+    end
+  end
+
+  # NOTE: @dom_id will be used for only Html visitor and contents helper.
+  class Chapter < Node
+    attr_accessor :level, :str, :blocks, :dom_id
+
+    def initialize(level, str, blocks)
+      super()
+      @level  = level
+      @str    = str
+      @blocks = blocks
+    end
+  
+    def accept(visitor)
+      visitor.visit_chapter(self)
+    end
+  end
+
+  # abstract List.
+  class List < ArrayNode
+  end
+
+  class OrderedList < List
+    def accept(visitor)
+      visitor.visit_ordered_list(self)
+    end
+  end
+
+   class UnorderedList < List
+    def accept(visitor)
+      visitor.visit_unordered_list(self)
+    end
+  end
+
+  # CompactDictionary list as follows:
+  #   term1:: description1
+  #   term2:: description2
+  #   ...
+  #
+  # === SEE ALSO
+  # DictionaryList
+  class CompactDictionaryList < ArrayNode
+    def accept(visitor)
+      visitor.visit_compact_dictionary_list(self)
+    end
+  end
+
+  class CompactDictionaryListItem < Node
+    attr_accessor :term, :str
+
+    def initialize(term, str)
+      @term = term
+      @str  = str
+    end
+  
+    def accept(visitor)
+      visitor.visit_compact_dictionary_list_item(self)
+    end
+  end
+
+  # Dictionary list as follows:
+  #   term1::
+  #     description1
+  #     description1(cont'd)
+  #   term2::
+  #     description2
+  #   ...
+  #
+  # Description can be in multilines.
+  #
+  # === SEE ALSO
+  # CompactDictionaryList
+  class DictionaryList < List
+    def accept(visitor)
+      visitor.visit_dictionary_list(self)
+    end
+  end
+
+  class DictionaryListItem < CompactDictionaryListItem
+    def accept(visitor)
+      visitor.visit_dictionary_list_item(self)
+    end
+  end
+
+  # Abstract VISITOR-pattern around Absyn tree.
+  #
+  # === How to add new generator
+  # Document generator, which juli(1) command says, points to 'visitor'
+  # internally because it is VISITOR-pattern.
+  # After adding new visitor, for example PDF-generator,
+  # it can be used by 'juli -g pdf' (let me assume the file name is pdf.rb).
+  # Follow the steps below to add new visitor:
+  #
+  # 1. create LIB/juli/visitor/pdf.rb.  Probably, it is easy to copy
+  #    from another visitor file (e.g. html.rb) as the skelton.
+  #    Where, LIB is 'lib/' directory in package environment, or
+  #    one of $LOAD_PATH in installed environment.
+  # 1. implement the pdf.rb.  It's the most important task, of course...
+  #
+  class Visitor
+    # Visitor object is initialized when juli(1) gen command is executed.
+    # In other words, it is *NOT* initialized for each input text file.
+    # Some global initialization can be done here.
+    #
+    # Take care that this is executed every juli(1) execution.
+    def initialize(opts = {})
+      @opts = opts.dup
+    end
+
+    # 'run' bulk-mode (when no files are specified at
+    # juli(1) command line).  Derived class should implement this.
+    def run_bulk; end
+
+    # run for a file and its node-tree.
+    # Here is just sample implementation.
+    # Derived class can re-implement this.
+    #
+    # === INPUTS
+    # in_file::   input filename
+    # root::      Absyn tree root
+    def run_file(in_file, root)
+      root.accept(self)
+    end
+
+    # Methods for each Absyn node. Derived class should implement
+    # these.
+    #
+    # === INPUTS
+    # n:: Absyn node
+    def visit_node(n); end
+    def visit_str(n); end
+    def visit_verbatim(n); end
+    def visit_array(n)
+      for node in n.array do
+        node.accept(self)
+      end
+    end
+    def visit_chapter(n); end
+    def visit_ordered_list(n); end
+    def visit_unordered_list(n); end
+    def visit_compact_dictionary_list(n); end
+    def visit_compact_dictionary_list_item(n); end
+    def visit_dictionary_list(n); end
+    def visit_dictionary_list_item(n); end
+  end
+end

data/lib/juli/command.rb

@@ -0,0 +1,180 @@
+require 'juli/util'
+require 'juli/parser.tab'
+Dir.glob(File.join(File.dirname(__FILE__), 'command/*.rb')){|sub_command_file|
+  require sub_command_file
+}
+
+module Juli
+  # This is a top level module for juli(1) command execution.
+  # Each juli(1) command corresponds to each method here.
+  module Command
+    class Error < Exception; end
+
+    # top level command execution.  command_str will be checked and
+    # dispatched to each method.
+    def run(command_str, opts = {})
+      if command_str == 'init'
+        init(opts)
+      else
+        Juli::Util::JuliI18n.new(conf, juli_repo)
+        case command_str
+        when 'gen';           gen(opts)
+        when 'sitemap';       Juli::Command::Sitemap.new.run(opts)
+        when 'recent_update'; Juli::Command::RecentUpdate.new.run(opts)
+        when 'tag';           Juli::Command::Tag.new.run(opts)
+        else
+          STDERR.print "Unknown juli command: '#{command_str}'\n\n", usage, "\n"
+          raise Error
+        end
+      end
+    end
+
+OUTPUT_TOP_COMMENT = <<EOM
+# Juli-repo config file.
+#
+# This is YAML format.
+#
+# Starting '#' at each line means just comment.
+# You can delete these comments.
+#
+# The commented-out settings shown in this file represent the default values.
+
+
+# Locale(default = en)
+#
+#locale: en
+
+# show_indent_toggle_button (default = true) to show/hide the toggle button
+# for indented scope of the text.  NOTE: toggle action still works even
+# though button is hidden.
+#
+#show_indent_toggle_button: true
+
+
+# Specify output top directory (default = ../html).
+
+EOM
+TEMPLATE_COMMENT = <<EOM
+
+# Specify html template when generating (default = 'default.html', which 
+# means that RUBY_LIB/juli/template/default.html is used).
+#
+# Current available templates are under RUBY_LIB/juli/template/, where
+# RUBY_LIB is the directory which juli library is installed
+# (e.g. /usr/local/lib/ruby/site_ruby/1.9/).
+#
+# You can put your customized template under JULI_REPO/.juli/
+# rather than ruby standard library directory.  For example,
+# if you want to use your customized template 'blue_ocean.html',
+# create it under JULI_REPO/ and specify it at config as follows:
+#
+#   $ cp RUBY_LIB/juli/template/default.html JULI_REPO/.juli/blue_ocean.html
+#   (edit JULI_REPO/.juli/blue_ocean.html as you like)
+#   (edit JULI_REPO/.juli/config as follows:
+#
+#   template: blue_ocean.html
+#
+# File extention (e.g. .html) is required in this config.
+# -t option at 'juli gen' command line execution can be also supported.
+# 
+
+EOM
+EXT_COMMENT = <<EOM
+
+# Generated file's extention (default = .shtml).
+# The reason why '.shtml' is because to use SSI (server side include)
+# for recent_update.  Of course, it depends on web-server configuration and
+# you may not use SSI.  In such a case, you can change to '.html'.
+
+EOM
+    # init does:
+    #
+    # 1. create juli-repository at the current directory, if not yet.
+    # 1. create config file under the juli-repo, if not yet.
+    #    This stores juli-repo dependent information.
+    # 1. if parameters are specified, store it in config file under juli-repo.
+    #
+    # === OPTIONS
+    # -o output_top
+    # -t template
+    # -e ext
+    def init(opts)
+      if !File.directory?(Juli::REPO)
+        FileUtils.mkdir(Juli::REPO)
+      else
+        STDERR.print "WARN: juli-repo is already created\n"
+      end
+
+      config_file = File.join(Juli::REPO, 'config')
+      if !File.exist?(config_file)
+        File.open(config_file, 'w') do |f|
+          f.print OUTPUT_TOP_COMMENT
+          write_config(f, 'output_top', opts[:o])
+          f.print TEMPLATE_COMMENT
+          write_config(f, 'template',   opts[:t])
+          f.print EXT_COMMENT
+          write_config(f, 'ext',        opts[:e])
+          write_macro_conf(f)
+          write_helper_conf(f)
+        end
+      else
+        STDERR.print "WARN: config file is already created\n"
+      end
+    end
+
+    # generate command
+    #
+    # === OPTIONS
+    # -g generator::    specify generator
+    # -f::              force update
+    # -t template::     specify template
+    # -o output_path::  specify output file path (only non-bulk-mode)
+    def gen(opts)
+      o = opts.dup
+      o.delete(:g)
+      # executes each generator's init here:
+      v = visitor(opts[:g]).new(o)
+
+      if ARGV.empty?
+        print "bulk mode\n"
+        if opts[:o]
+          STDERR.print "ERROR: -o #{opts[:o]} is specified in bulk-mode\n"
+        else
+          v.run_bulk
+        end
+      else
+        for file in ARGV do
+          Juli::Parser.new.parse(file, v)
+        end
+      end
+    end
+
+  private
+    def write_config(f, key, value)
+      if value
+        f.printf("%s: %s\n", key, value)
+      end
+    end
+
+    # write each macro conf sample to initial .juli/conf file
+    # by calling 'conf_template' method on each macro.
+    def write_macro_conf(f)
+      for macro_symbol in Juli::Macro.constants do
+        next if macro_symbol == :Base
+        macro_class = Juli::Macro.module_eval(macro_symbol.to_s)
+        f.print "\n", macro_class.conf_template
+      end
+    end
+
+    # write each helper conf sample to initial .juli/conf file
+    # by calling 'conf_template' method on each macro.
+    def write_helper_conf(f)
+      for helper_symbol in Juli::Visitor::Html::Helper.constants do
+        next if helper_symbol == :AbstractHelper
+        helper_class = Juli::Visitor::Html::Helper.module_eval(helper_symbol.to_s)
+        f.print "\n", helper_class.conf_template
+      end
+    end
+  end
+end
+