markdown 0.0.1 → 0.1.0.beta1

data/Manifest.txt

@@ -2,7 +2,15 @@ History.markdown
 Manifest.txt
 README.markdown
 Rakefile
-lib/markdown_select.rb
-lib/markdown_select/config.rb
-lib/markdown_select/engine.rb
-lib/markdown_select/markdown_select.rb
+bin/markdown
+lib/markdown.rb
+lib/markdown/config.rb
+lib/markdown/engines/bluecloth.rb
+lib/markdown/engines/kramdown.rb
+lib/markdown/engines/maruku.rb
+lib/markdown/engines/pandoc_ruby.rb
+lib/markdown/engines/rdiscount.rb
+lib/markdown/engines/rpeg_markdown.rb
+lib/markdown/gen.rb
+lib/markdown/wrapper.rb
+test/test_kramdown.rb

data/README.markdown

@@ -1,11 +1,11 @@
-# Markdown Select - Use Your Markdown Library of Choice
+# Markdown Engine Wrapper - Use Your Markdown Library of Choice
 
-* [geraldb.github.com/markdown_select](http://geraldb.github.com/markdown_select)
+* [geraldb.github.com/markdown](http://geraldb.github.com/markdown)
 
 ## Description
 
-The Markdown Select (`markdown_select`) Ruby gem lets you use your markdown library of choice.
-Preconfigured markdown libraries include:
+The Markdown Engine Wrapper (`markdown`) Ruby gem lets you use
+your markdown library of choice. Preconfigured markdown libraries include:
 
 * `kramdown`
 * `bluecloth`
@@ -17,16 +17,74 @@ Preconfigured markdown libraries include:
 
 ## Usage
 
-    require 'markdown_select'
+    require 'markdown'
     
-    MarkdownSelect.new( 'Hello World' ).to_html
+    Markdown.new( 'Hello World' ).to_html
 
 
 ## Install
 
 Just install the gem:
 
-    $ gem install markdown_select
+    $ gem install markdown
+
+
+## Configuration - Markdown Engine Loading Order
+
+The default fallback loading order is:
+
+`pandoc-ruby`, `kramdown`, `bluecloth`, `maruku`, `rpeg-markdown`, `rdiscount`
+
+To use your markdown engine of choice configure the wrapper. The wrapper
+uses the following lookup order to find the markdown engine to configure:
+
+1) `MARKDOWN_LIB` environment variable
+
+Example:
+
+    set MARKDOWN_LIB=kramdown
+
+2) `lib` property (in `./markdown.yml` or `~/markdown.yml`)
+
+Example:
+
+    lib: kramdown
+
+3) `libs` property (in `./markdown.yml` or `~/markdown.yml`) - first-come first-serve markdown engine loading list (defaults to builtin list).
+
+Example:
+
+    libs:
+      - rdiscount
+      - kramdown
+
+
+## Converters
+
+The Markdown Wrapper lets you configure different converter methods for each markdown engine. By default
+the converter method *<lib>*_to_html gets used
+(for example, the default converter for `kramdown` is `kramdown_to_html`).
+
+...
+
+Example:
+
+    pandoc-ruby:
+      converter: pandoc-ruby-to-s5
+
+
+
+## Real World Usage
+
+The [`slideshow`](http://slideshow.rubyforge.org) (also known as Slide Show (S9)) gem
+that lets you create slide shows
+and author slides in plain text using a wiki-style markup language that's easy-to-write and easy-to-read
+ships with the `markdown` gem.
+
+
+## Alternatives
+
+[`multi_markdown`](https://github.com/postmodern/multi_markdown) gem by Hal Brodigan 
 
 
 ## Questions? Comments?
@@ -38,5 +96,5 @@ Thanks!
 
 ## License
 
-The `markdown_select` scripts are dedicated to the public domain.
+The `markdown` scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.

data/Rakefile

@@ -1,12 +1,14 @@
 require 'hoe'
-require './lib/markdown_select.rb'
+require './lib/markdown.rb'
 
 Hoe.spec 'markdown' do
   
-  self.version = MarkdownSelect::VERSION
+  self.version = Markdown::VERSION
   
-  self.summary = 'Markdown - Use Your Markdown Library of Choice'
-  self.url     = 'http://geraldb.github.com/markdown_select'
+  self.summary = 'Markdown Engine Wrapper - Use Your Markdown Library of Choice'
+  self.description = summary
+
+  self.urls    = ['http://geraldb.github.com/markdown']
   
   self.author  = 'Gerald Bauer'
   self.email   = 'webslideshow@googlegroups.com'

data/bin/markdown

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+###################
+# == DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/markdown
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/markdown
+#
+
+
+require 'rubygems'
+require 'markdown'
+
+Markdown.main

data/lib/markdown.rb

@@ -0,0 +1,54 @@
+###
+# NB: for local testing run like:
+#
+# 1.8.x: ruby -Ilib -rrubygems lib/markdown.rb
+# 1.9.x: ruby -Ilib lib/markdown.rb
+
+# core and stlibs
+
+require 'yaml'
+require 'pp'
+require 'logger'
+require 'optparse'
+require 'fileutils'
+
+
+# our own code
+
+require 'markdown/config'
+require 'markdown/engines/bluecloth'
+require 'markdown/engines/kramdown'
+require 'markdown/engines/maruku'
+require 'markdown/engines/pandoc_ruby'
+require 'markdown/engines/rdiscount'
+require 'markdown/engines/rpeg_markdown'
+require 'markdown/wrapper'
+require 'markdown/gen'
+
+
+module Markdown
+
+  VERSION = '0.1.0.beta1'
+
+  # version string for generator meta tag (includes ruby version)
+  def self.banner
+    "Markdown #{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.main
+    
+    # allow env variable to set RUBYOPT-style default command line options
+    #   e.g. -o site 
+    markdownopt = ENV[ 'MARKDOWNOPT' ]
+    
+    args = []
+    args += markdownopt.split if markdownopt
+    args += ARGV.dup
+    
+    Gen.new.run(args)
+  end
+
+end  # module Markdown
+
+
+Markdown.main if __FILE__ == $0

data/lib/markdown/config.rb

@@ -0,0 +1,168 @@
+module Markdown
+
+  class Env
+    def self.home
+      path = if( ENV['HOME'] || ENV['USERPROFILE'] )
+               ENV['HOME'] || ENV['USERPROFILE']
+             elsif( ENV['HOMEDRIVE'] && ENV['HOMEPATH'] )
+               "#{ENV['HOMEDRIVE']}#{ENV['HOMEPATH']}"
+             else
+               begin
+                 File.expand_path('~')
+               rescue
+                 if File::ALT_SEPARATOR
+                   'C:/'
+                 else
+                   '/'
+                 end
+               end
+             end
+      
+      puts "env home=>#{path}<"
+      path
+    end
+    
+    def self.markdown_lib
+      ENV['MARKDOWN_LIB']
+    end    
+  end # class Env
+
+  class Props
+
+    attr_reader :path
+    attr_reader :parent
+    
+    def initialize( hash, path, parent=nil)
+      @hash   = hash
+      @path   = path
+      @parent = parent
+    end
+    
+    def self.load_file( path, parent=nil )
+      h = YAML.load_file( path )
+      puts "dump of >#{path}<:"      
+      pp h    # todo: add debug flag (turn off for default)
+      Props.new( h, path, parent )
+    end
+    
+    def [](key)  get( key );  end
+    
+    def fetch(key, default)
+      value = get( key )
+      value.nil? ? default : value
+    end
+
+private
+    def get( key )
+      value = @hash[ key.to_s ]
+      # if not found try lookup in parent hash
+      (value.nil? && parent) ? parent[key] : value
+    end
+    
+  end # class props
+
+
+  class Config
+
+# note: only kramdown is listed as a dependency in gem specs (because it's Ruby only and, thus, easy to install)
+#  if you want to use other markdown libs install the required/desired lib e.g.
+#  use  gem install rdiscount for rdiscount and so on
+#
+# also note for now the first present markdown library gets used
+#  the search order is first come, first serve, that is: rdiscount, rpeg-markdown, maruku, bluecloth, kramdown (fallback, always present)
+
+#  DEFAULTS = {
+#    'libs' => [ 'pandoc-ruby',
+#                'rdiscount',
+#                'rpeg-markdown',
+#                'maruku',
+#                'bluecloth',
+#                'kramdown' ] }
+
+# note: make kramdown default engine
+DEFAULTS = { 'libs' => [ 'kramdown' ] }
+
+  
+    def initialize
+      @props = @props_default = Props.new( DEFAULTS, 'DEFAULTS' )
+
+      # check for user settings (markdown.yml) in home folder 
+
+      ## todo/fix: use join path???
+      ## todo: use .markdown.yml?? or differnt name ??
+      props_home_file = "#{Env.home}/markdown.yml"      
+      if File.exists?( props_home_file )
+        puts "Loading settings from '#{props_home_file}'..."
+        @props = @props_home = Props.load_file( props_home_file, @props )
+      end
+      
+      # check for user settings (markdown.yml) in working folder 
+    
+      props_work_file = "./markdown.yml"
+      if File.exists?( props_work_file )
+        puts "Loading settings from '#{props_work_file}'..."
+        @props = @props_work = Props.load_file( props_work_file, @props )
+      end
+
+      @libs   = []
+      @mn     = nil   # markdown converter method name (mn) e.g. kramdown_to_html
+      
+      require_markdown_libs()      
+    end
+
+    def known_markdown_libs
+      # returns an array of known markdown engines e.g.
+      # [ 'pandoc-ruby', 'rdiscount', 'rpeg-markdown', 'maruku', 'bluecloth', 'kramdown' ]
+    
+      ## todo: allow single lib para instead of libs    
+      ##  todo: allow ENV setting markdown_[select]_lib=xxxx
+    
+      ## todo/fix: use lookup with config parent cascade
+    
+    
+      ## lookup order
+      ## 1)  env variable MARKDOWN_LIB
+      ## 2)  lib property (single markdown engine)
+      ## 3)  libs property (first-come first-serve markdown engine list)
+
+      user_lib = Env.markdown_lib || @props.fetch( 'lib', nil )      
+
+      if user_lib.nil?         
+        user_libs = @props.fetch( 'libs', nil )
+      else
+        [ user_lib ]  # return as array (wrap single lib entry)  
+      end      
+    end
+
+      
+    def require_markdown_libs
+
+      # check for available markdown libs/gems
+      # try to require each lib and remove any not installed
+
+      known_markdown_libs.each do |lib|
+        begin
+          require lib
+          @libs << lib
+        rescue LoadError => ex
+          ## todo: use logger.debug  instead of puts        
+          puts "Markdown library #{lib} not found. Use gem install #{lib} to install."
+        end
+      end
+
+      puts "  Found #{@libs.length} Markdown libraries: #{@libs.join(', ')}"
+    end
+
+    def markdown_lib
+      @libs.first
+    end
+    
+    def markdown_to_html_method
+      lib  = @libs.first
+      opts = @props.fetch( lib, {} )
+      method = opts.fetch( 'converter', "#{lib.downcase}_to_html" )  # default to <lib>_to_html if converter prop not found    
+      method.tr('-','_').to_sym
+    end      
+
+  end # class Config
+end # module Markdown

data/lib/markdown/engines/bluecloth.rb

@@ -0,0 +1,9 @@
+module Markdown
+  module Engine
+
+    def bluecloth_to_html( content )
+      BlueCloth.new( content ).to_html
+    end
+    
+  end # module Engine
+end # module Markdown            

data/lib/markdown/engines/kramdown.rb

@@ -0,0 +1,9 @@
+module Markdown
+  module Engine
+
+    def kramdown_to_html( content )
+      Kramdown::Document.new( content ).to_html
+    end      
+
+  end # module Engine
+end # module Markdown    

data/lib/markdown/engines/maruku.rb

@@ -0,0 +1,9 @@
+module Markdown
+  module Engine
+   
+    def maruku_to_html( content )
+      Maruku.new( content, {:on_error => :raise} ).to_html
+    end
+
+  end # module Engine
+end # module Markdown        

data/lib/{markdown_select/engine.rb → markdown/engines/pandoc_ruby.rb}

@@ -1,4 +1,4 @@
-module MarkdownSelect
+module Markdown
   module Engine
    
     def pandoc_ruby_to_html( content )
@@ -30,30 +30,5 @@ module MarkdownSelect
       content = content.to_a[13..-1].join # remove the layout div
     end
     
-
-    def rdiscount_to_html( content )
-      RDiscount.new( content ).to_html
-    end
-  
-
-    def rpeg_markdown_to_html( content )
-      PEGMarkdown.new( content ).to_html
-    end
-  
-
-    def maruku_to_html( content )
-      Maruku.new( content, {:on_error => :raise} ).to_html
-    end
-  
-
-    def bluecloth_to_html( content )
-      BlueCloth.new( content ).to_html
-    end
-  
-
-    def kramdown_to_html( content )
-      Kramdown::Document.new( content ).to_html
-    end      
-  
   end # module Engine
-end # module MarkdownSelect  
+end # module Markdown

data/lib/markdown/engines/rdiscount.rb

@@ -0,0 +1,9 @@
+module Markdown
+  module Engine
+   
+    def rdiscount_to_html( content )
+      RDiscount.new( content ).to_html
+    end
+
+  end # module Engine
+end # module Markdown    

data/lib/markdown/engines/rpeg_markdown.rb

@@ -0,0 +1,9 @@
+module Markdown
+  module Engine
+
+    def rpeg_markdown_to_html( content )
+      PEGMarkdown.new( content ).to_html
+    end
+
+  end # module Engine
+end # module Markdown        

data/lib/markdown/gen.rb

@@ -0,0 +1,151 @@
+module Markdown
+
+
+  class Opts
+  
+    def initialize
+      @hash = {}
+    end
+    
+    def put( key, value )
+      @hash[ key.to_s ] = value
+    end    
+  
+    def output_path
+      @hash.fetch( 'output', '.' )
+    end
+
+  end # class Opts
+
+
+
+  class Gen
+
+    attr_reader :logger
+    attr_reader :opts
+    
+    def initialize
+      @logger       = Logger.new(STDOUT)
+      @logger.level = Logger::INFO
+      @opts         = Opts.new
+    end
+
+    def with_output_path( dest, output_path )
+      dest_full = File.expand_path( dest, output_path )
+      logger.debug "dest_full=#{dest_full}"
+      
+      # make sure dest path exists
+      dest_path = File.dirname( dest_full )
+      logger.debug "dest_path=#{dest_path}"
+      FileUtils.makedirs( dest_path ) unless File.directory? dest_path
+      dest_full
+    end
+
+    def create_doc( fn )
+ 
+      # expand output path in current dir and make sure output path exists
+      outpath = File.expand_path( opts.output_path ) 
+      logger.debug "outpath=#{outpath}"
+      FileUtils.makedirs( outpath ) unless File.directory? outpath 
+
+      dirname  = File.dirname( fn )    
+      basename = File.basename( fn, '.*' )
+      extname  = File.extname( fn )
+      logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
+
+      # change working dir to sourcefile dir
+      # todo: add a -c option to commandline? to let you set cwd?
+    
+      newcwd  = File.expand_path( dirname )
+      oldcwd  = File.expand_path( Dir.pwd )
+    
+      unless newcwd == oldcwd then
+        logger.debug "oldcwd=#{oldcwd}"
+        logger.debug "newcwd=#{newcwd}"
+        Dir.chdir newcwd
+      end  
+                
+      if extname.empty? then
+        extname  = ".markdown"   # default to .markdown 
+    
+        [ '.markdown', '.m', '.mark', '.mkdn', '.md', '.txt', '.text' ].each do |e|
+          logger.debug "File.exists? #{dirname}/#{basename}#{e}"
+          if File.exists?( "#{dirname}/#{basename}#{e}" ) then         
+            extname = e
+            logger.debug "extname=#{extname}"
+            break
+          end
+        end  # each extension (e)
+      end
+
+      inname  =  "#{dirname}/#{basename}#{extname}"
+
+      puts "Reading document '#{basename}#{extname}'..."
+      
+      
+      logger.debug "inname=#{inname}"
+    
+      content = File.read( inname )
+
+      # convert light-weight markup to hypertext
+
+      content = Markdown.new( content ).to_html
+
+      outname = "#{basename}.html"
+      puts "Preparing #{outname}..."      
+
+      out = File.new( with_output_path( outname, outpath ), "w+" )
+      out << "<!-- ======================================================================\n"
+      out << "      generated by #{Markdown.banner}\n"
+      out << "                on #{Time.now} with Markdown engine '#{Markdown.lib}'\n"
+      out << "     ====================================================================== -->\n"
+      out << content
+      out.flush
+      out.close
+
+    end # method create_doc
+    
+    
+    def run( args )
+      opt=OptionParser.new do |cmd|
+    
+        cmd.banner = "Usage: markdown [options] name"
+    
+        cmd.on( '-o', '--output PATH', 'Output Path' ) { |s| opts.put( 'output', s ) }
+
+        # todo: find different letter for debug trace switch (use v for version?)
+        cmd.on( "-v", "--verbose", "Show debug trace" )  do
+           logger.datetime_format = "%H:%H:%S"
+           logger.level = Logger::DEBUG      
+        end
+ 
+        cmd.on_tail( "-h", "--help", "Show this message" ) do
+           puts 
+           puts "Markdown is ..."
+           puts
+           puts cmd.help
+           puts
+           puts "Examples:"
+           puts "  markdown microformats"
+           puts "  markdown microformats.text            # Process slides using Markdown"
+           puts "  markdown -o site microformats       # Output slideshow to slides folder"
+           puts
+           puts "Further information:"
+           puts "  http://geraldb.github.com/markdown" 
+           exit
+        end
+      end
+
+      opt.parse!( args )
+  
+      puts Markdown.banner
+
+      args.each { |fn| create_doc( fn ) }
+      
+      puts "Done."
+      
+    end   # method run 
+    
+  end # class Gen
+
+end # module Markdown

data/lib/markdown/wrapper.rb

@@ -0,0 +1,55 @@
+module Markdown
+ 
+  class Wrapper
+
+    def initialize( lib, mn, content, options={} )
+      @lib     = lib      
+      @mn      = mn
+      @content = content
+      @options = options
+    end
+        
+    def to_html
+      # call markdown filter; turn markdown lib name into method_name (mn)
+      # eg. rpeg-markdown =>  rpeg_markdown_to_html
+
+      puts "  Converting Markdown-text (#{@content.length} bytes) to HTML using library '#{@lib}' calling '#{@mn}'..."
+
+      send( @mn, @content )  # call 1st configured markdown engine e.g. kramdown_to_html( content )
+    end    
+
+    include Engine
+    
+  end # class Wrapper
+
+
+
+  @@config = nil
+  
+  def self.lib( value = nil )
+    if value.nil?    
+      if @@config.nil?
+        @@config = Config.new
+      end
+      @@config.markdown_lib
+    else
+      ## todo: lets you select your library
+    end
+  end
+  
+  def self.new( content, options={} )
+
+    ## todo: allow options to pass in
+    ##   lets you change markdown engine/converter for every call
+    ##   e.g. lets you add config properties (as headers) to your document (for example)
+    
+    if @@config.nil?
+      @@config = Config.new
+    end
+
+    lib = @@config.markdown_lib
+    mn  = @@config.markdown_to_html_method # lets you use differnt options/converters for a single markdown lib   
+    Wrapper.new( lib, mn, content, options )
+  end
+
+end # module Markdown

data/test/test_kramdown.rb

@@ -0,0 +1,35 @@
+###
+# NB: for local testing run like:
+#
+# 1.8.x: ruby -Ilib -rrubygems test/test_kramdown.rb
+# 1.9.x: ruby -Ilib test/test_kramdown.rb
+
+# core and stlibs
+
+require 'test/unit'
+require 'logger'
+require 'pp'
+
+# our own code
+
+require 'lib/markdown'
+
+
+class TestKramdown < Test::Unit::TestCase
+  
+  def setup
+    Markdown.lib( 'kramdown' )
+  end
+  
+  def test_lib
+    lib = Markdown.lib
+    assert_equal( 'kramdown', lib )  
+  end
+  
+  def test_to_html
+    html = Markdown.new( 'Hello World!' ).to_html
+    assert_equal( "<p>Hello World!</p>\n",  html )
+  end
+
+    
+end # class TestKramdown

metadata

@@ -1,13 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: markdown
 version: !ruby/object:Gem::Version 
-  hash: 29
-  prerelease: 
+  hash: 321068176
+  prerelease: 6
   segments: 
   - 0
+  - 1
   - 0
+  - beta
   - 1
-  version: 0.0.1
+  version: 0.1.0.beta1
 platform: ruby
 authors: 
 - Gerald Bauer
@@ -15,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-05-30 00:00:00 Z
+date: 2012-06-02 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: kramdown
@@ -56,26 +58,17 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 29
+        hash: 7
         segments: 
-        - 2
-        - 15
-        version: "2.15"
+        - 3
+        - 0
+        version: "3.0"
   type: :development
   version_requirements: *id003
-description: |-
-  The Markdown Select (`markdown_select`) Ruby gem lets you use your markdown library of choice.
-  Preconfigured markdown libraries include:
-  
-  * `kramdown`
-  * `bluecloth`
-  * `maruku`
-  * `rpeg-markdown`
-  * `rdiscount`
-  * `pandoc-ruby`
+description: Markdown Engine Wrapper - Use Your Markdown Library of Choice
 email: webslideshow@googlegroups.com
-executables: []
-
+executables: 
+- markdown
 extensions: []
 
 extra_rdoc_files: 
@@ -85,11 +78,20 @@ files:
 - Manifest.txt
 - README.markdown
 - Rakefile
-- lib/markdown_select.rb
-- lib/markdown_select/config.rb
-- lib/markdown_select/engine.rb
-- lib/markdown_select/markdown_select.rb
-homepage: http://geraldb.github.com/markdown_select
+- bin/markdown
+- lib/markdown.rb
+- lib/markdown/config.rb
+- lib/markdown/engines/bluecloth.rb
+- lib/markdown/engines/kramdown.rb
+- lib/markdown/engines/maruku.rb
+- lib/markdown/engines/pandoc_ruby.rb
+- lib/markdown/engines/rdiscount.rb
+- lib/markdown/engines/rpeg_markdown.rb
+- lib/markdown/gen.rb
+- lib/markdown/wrapper.rb
+- test/test_kramdown.rb
+- .gemtest
+homepage: http://geraldb.github.com/markdown
 licenses: []
 
 post_install_message: 
@@ -110,18 +112,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version 
-      hash: 3
+      hash: 25
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
 requirements: []
 
 rubyforge_project: markdown
 rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
-summary: Markdown - Use Your Markdown Library of Choice
-test_files: []
-
+summary: Markdown Engine Wrapper - Use Your Markdown Library of Choice
+test_files: 
+- test/test_kramdown.rb

data/lib/markdown_select.rb

@@ -1,22 +0,0 @@
-
-$LOAD_PATH.unshift( File.expand_path( File.dirname(__FILE__) ) )
-
-# core and stlibs
-
-require 'yaml'
-
-
-# our own code
-
-require 'markdown_select/config'
-require 'markdown_select/engine'
-require 'markdown_select/markdown_select'
-
-
-## todo: add main for bin (see slideshow)
-
-module MarkdownSelect
-
-  VERSION = '0.0.1'
-  
-end

data/lib/markdown_select/config.rb

@@ -1,64 +0,0 @@
-module MarkdownSelect
-
-  class Config
-  
-    def initialize
-      @hash = {}
-    end
-
-    
-    def load   
-      # todo/fix: check more locations; merge config files
-
-      # check for user settings in working folder (check for slideshow.yml)
-    
-      config_user_file = "./markdown.yml"
-      if File.exists?( config_user_file )
-        puts "Loading settings from '#{config_user_file}'..."
-        @hash[ 'user' ] = YAML.load_file( config_user_file )   
-      end         
-    end
-
-    
-    def markdown_to_html_method( lib )    
-      method = @hash.fetch( 'user', {} ).fetch( lib, {} ).fetch( 'converter', nil )
-    
-      # use default name
-      if method.nil?
-        method = "#{lib.downcase}_to_html"
-      end
-    
-      method.tr('-','_').to_sym
-    end  
-
-    
-# note: only kramdown is listed as a dependency in gem specs (because it's Ruby only and, thus, easy to install)
-#  if you want to use other markdown libs install the required/desired lib e.g.
-#  use  gem install rdiscount for rdiscount and so on
-#
-# also note for now the first present markdown library gets used
-#  the search order is first come, first serve, that is: rdiscount, rpeg-markdown, maruku, bluecloth, kramdown (fallback, always present)
-
-  BUILTIN_LIBS = [
-    'pandoc-ruby',
-    'rdiscount',
-    'rpeg-markdown',
-    'maruku',
-    'bluecloth',
-    'kramdown'    
-  ]
-  
-    def known_markdown_libs
-      # returns an array of known markdown engines e.g.
-      # [ pandoc-ruby, rdiscount, rpeg-markdown, maruku, bluecloth, kramdown ]
-    
-      ## todo: allow single lib para instead of libs    
-      ##  todo: allow ENV setting markdown_[select]_lib=xxxx
-    
-      user_libs = @hash.fetch( 'user', {} ).fetch( 'libs', [] )
-    
-      user_libs.length > 0 ? user_libs : BUILTIN_LIBS
-    end
-
-  end # class Config
-end # module MarkdownSelect

data/lib/markdown_select/markdown_select.rb

@@ -1,80 +0,0 @@
-module MarkdownSelect
- 
-  class Proxy   
-
-    def initialize( lib, mn, content, options={} )
-      @lib     = lib      
-      @mn      = mn
-      @content = content
-      @options = options
-    end
-        
-    def to_html
-      # call markdown filter; turn markdown lib name into method_name (mn)
-      # eg. rpeg-markdown =>  rpeg_markdown_to_html
-
-      puts "  Converting Markdown-text (#{@content.length} bytes) to HTML using library '#{@lib}' calling '#{@mn}'..."
-
-      send( @mn, @content )  # call 1st configured markdown engine e.g. kramdown_to_html( content )
-    end    
-
-    include Engine
-    
-  end # class Proxy
-
-  @@markdown_config = nil    
-  @@markdown_libs   = []
-  @@markdown_mn     = nil
-  
-  def self.load_markdown_libs
-
-    # check for available markdown libs/gems
-    # try to require each lib and remove any not installed
-
-    @@markdown_config.known_markdown_libs.each do |lib|
-      begin
-        require lib
-        @@markdown_libs << lib
-      rescue LoadError => ex
-        ## todo: use logger.debug  instead of puts        
-        puts "Markdown library #{lib} not found. Use gem install #{lib} to install."
-      end
-    end
-
-    puts "  Found #{@@markdown_libs.length} Markdown libraries: #{@@markdown_libs.join(', ')}"
-  end
-   
-  def self.lib
-    if @@markdown_config.nil?
-      @@markdown_config = Config.new
-      @@markdown_config.load
-      
-      load_markdown_libs
-    
-      # lets you use differnt options/converters for a single markdown lib
-      @@markdown_mn = @@markdown_config.markdown_to_html_method( @@markdown_libs.first )
-    end
-
-    @@markdown_libs.first
-  end
-  
-  def self.new( content, options={} )
-
-    ## todo: allow options to pass in
-    ##   lets you change markdown engine/converter for every call
-    ##   e.g. lets you add config properties (as headers) to your document (for example)
-    
-    if @@markdown_config.nil?
-      @@markdown_config = Config.new
-      @@markdown_config.load
-      
-      load_markdown_libs
-    
-      # lets you use differnt options/converters for a single markdown lib
-      @@markdown_mn = @@markdown_config.markdown_to_html_method( @@markdown_libs.first )    
-    end
-
-    Proxy.new( @@markdown_libs.first, @@markdown_mn, content, options )
-  end
-
-end # module MarkdownSelect