markdown 0.4.0 → 0.5.0.beta1

data/Manifest.txt

@@ -4,6 +4,9 @@ README.markdown
 Rakefile
 bin/markdown
 lib/markdown.rb
+lib/markdown/cli/gen.rb
+lib/markdown/cli/opts.rb
+lib/markdown/cli/runner.rb
 lib/markdown/config.rb
 lib/markdown/engines/bluecloth.rb
 lib/markdown/engines/kramdown.rb
@@ -12,6 +15,6 @@ lib/markdown/engines/pandoc_ruby.rb
 lib/markdown/engines/rdiscount.rb
 lib/markdown/engines/redcarpet.rb
 lib/markdown/engines/rpeg_markdown.rb
-lib/markdown/gen.rb
+lib/markdown/version.rb
 lib/markdown/wrapper.rb
 test/test_kramdown.rb

data/README.markdown

@@ -1,71 +1,145 @@
-# Markdown Engine Wrapper - Use Your Markdown Library of Choice
+# Markdown Engine Wrapper - Use Your Markdown Library of Choice in Ruby
 
 * [geraldb.github.com/markdown](http://geraldb.github.com/markdown)
 
-## Description
-
 The Markdown Engine Wrapper (`markdown`) Ruby gem lets you use
-your markdown library of choice. Preconfigured markdown libraries include:
+your markdown library of choice. Preconfigured markdown libraries include
 
 * `kramdown`
+* `redcarpet`
 * `bluecloth`
 * `maruku`
 * `rpeg-markdown`
 * `rdiscount`
 * `pandoc-ruby`
 
-
-## Usage
+## Usage - Ruby Code
 
     require 'markdown'
     
     Markdown.new( 'Hello World' ).to_html
+    
+    # => "<p>Hello World</p>\n"
 
 
-## Install
+## Usage - Command Line
 
-Just install the gem:
+The `markdown` gem includes a little command line tool. Try `markdown -h` for details:
 
-    $ gem install markdown
+```
+markdown - Lets you convert plain text documents to hypertext with your Markdown engine of choice
+  and preprocessing text filters.
 
+Usage: markdown [options] files_or_dirs
+    -o, --output PATH                Output Path
+    -v, --verbose                    Show debug trace
 
-## Configuration - Markdown Engine Loading Order
 
-The default fallback loading order is:
+Examples:
+  markdown                   # Process all documents in working folder (that is, .)
+  markdown quickref          # Process document or folder using Markdown
+  markdown quickref.text     # Process document using Markdown
+  markdown -o site quickref  # Output documents to site folder
+```
 
-`pandoc-ruby`, `kramdown`, `bluecloth`, `maruku`, `rpeg-markdown`, `rdiscount`
+## Configuration - Markdown Engine Loading Order
 
-To use your markdown engine of choice configure the wrapper. The wrapper
-uses the following lookup order to find the markdown engine to configure:
+The default (fallback) Markdown library is `kramdown`. To use your markdown engine of choice
+configure the wrapper. The wrapper
+uses the following lookup order to find the markdown engine:
 
-1) `MARKDOWN_LIB` environment variable
+### 1) `MARKDOWN_LIB` Environment Variable
 
 Example:
 
     set MARKDOWN_LIB=kramdown
 
-2) `lib` property (in `./markdown.yml` or `~/markdown.yml`)
+### 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).
+### 3) `libs` Property (in `./markdown.yml` or `~/markdown.yml`)
 
 Example:
 
     libs:
-      - rdiscount
+      - redcarpet
       - kramdown
 
 
-## Converters
+Markdown libraries in the list get loaded on a first-come first-serve principle,
+that is, the first library `require`'d successfully will get used.
 
-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`).
 
-...
+
+## Configuration - Markdown Engine Options
+
+You can also pass along options to your Markdown library. Example:
+
+    ## Let's use the Redcarpet library
+    
+    lib: redcarpet
+    
+    redcarpet:
+      extensions:
+        - no_intra_emphasis
+        - fenced_code_blocks
+        - tables
+        - strikethrough
+
+
+## Configuration -Filters (Command Line Only)
+
+For the command line tool only you can configure preprocessing filters to
+allow comments, Ruby helpers, and much more. Example:
+
+    ## Let's use percent style comments
+    
+    filters:
+      - comments-percent-style
+
+Now the filter will strip comment lines starting with percent (that is, %). Example:
+
+    %%%%%%%%%%%%%%%%
+    % Some Headers
+    
+    Title: Web Services REST-Style: Universal Identifiers, Formats & Protocols
+
+Becomes
+
+    Title: Web Services REST-Style: Universal Identifiers, Formats & Protocols
+
+before the text gets passed along to the markdown engine. The filter
+also supports multiline comments with `%begin`|`comment`|`comments`/`%end` pairs. Example:
+
+    %begin
+    Using modern browser such as Firefox, Chrome and Safari you can
+    now theme your slide shows using using "loss-free" vector graphics
+    in plain old CSS. Thanks to gradient support in backgrounds in CSS3.
+    %end
+
+or
+
+    %comment
+    Using modern browser such as Firefox, Chrome and Safari you can
+    now theme your slide shows using using "loss-free" vector graphics
+    in plain old CSS. Thanks to gradient support in backgrounds in CSS3.
+    %end
+
+Note: As a shortcut using a single `%end` directive (that is, without a leading `%begin`)
+will skip everything until the end of the document.
+
+For more about filters see the [`textutils`](http://geraldb.github.com/textutils) gem.
+
+
+## Configuration - 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:
 
@@ -73,19 +147,24 @@ Example:
       converter: pandoc-ruby-to-s5
 
 
+## Install
+
+Just install the gem:
+
+    $ gem install markdown
+
 
 ## 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.
+and author slides in plain text using a wiki-style markup language that's easy-to-write and easy-to-read.
 
 
 ## Alternatives
 
-[`multi_markdown`](https://github.com/postmodern/multi_markdown) gem by Hal Brodigan 
-
+* [`multi_markdown`](https://github.com/postmodern/multi_markdown) gem by Hal Brodigan (aka postmodern)
+* [`markdown_meta`](https://github.com/headius/markdown_meta) gem by Charles Oliver Nutter (aka headius)
 
 ## Questions? Comments?
 

data/Rakefile

@@ -1,5 +1,5 @@
 require 'hoe'
-require './lib/markdown.rb'
+require './lib/markdown/version.rb'
 
 Hoe.spec 'markdown' do
   

data/lib/markdown.rb

@@ -28,6 +28,7 @@ require 'textutils'  # text filters and helpers
 
 # our own code
 
+require 'markdown/version'
 require 'markdown/config'
 require 'markdown/engines/bluecloth'
 require 'markdown/engines/kramdown'
@@ -37,16 +38,17 @@ require 'markdown/engines/rdiscount'
 require 'markdown/engines/redcarpet'
 require 'markdown/engines/rpeg_markdown'
 require 'markdown/wrapper'
-require 'markdown/gen'
 
+require 'markdown/cli/gen'
+require 'markdown/cli/opts'
+require 'markdown/cli/runner'
 
-module Markdown
 
-  VERSION = '0.4.0'
+module Markdown
 
   # version string for generator meta tag (includes ruby version)
   def self.banner
-    "Markdown #{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+    "markdown #{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
   end
 
   def self.main
@@ -59,7 +61,7 @@ module Markdown
     args += markdownopt.split if markdownopt
     args += ARGV.dup
     
-    Gen.new.run(args)
+    Runner.new.run(args)
   end
 
 end  # module Markdown

data/lib/markdown/cli/gen.rb

@@ -0,0 +1,89 @@
+module Markdown
+
+class Gen
+
+  include TextUtils::Filter   # include filters such as comments_percent_style, etc. (see textutils gem)
+
+  attr_reader :logger
+  attr_reader :opts
+    
+  def initialize( logger, opts )
+    @logger = logger
+    @opts   = opts
+  end
+
+    def create_doc( fn )
+      dirname  = File.dirname(  fn )
+      basename = File.basename( fn, '.*' )
+      extname  = File.extname(  fn )
+
+      logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
+
+      if opts.output_path == '.'
+        # expand output path in current dir
+        outpath = File.expand_path( dirname ) 
+      else
+        # expand output path in user supplied dir and make sure output path exists
+        outpath = File.expand_path( opts.output_path ) 
+        FileUtils.makedirs( outpath ) unless File.directory? outpath 
+      end
+      logger.debug "outpath=#{outpath}"
+      
+      # todo: add a -c option to commandline? to let you set cwd?
+
+
+      # change working dir to sourcefile dir (that is, dirname); push working folder/dir
+      newcwd  = File.expand_path( dirname )
+      oldcwd  = File.expand_path( Dir.pwd )
+    
+      unless newcwd == oldcwd
+        logger.debug "oldcwd=>#{oldcwd}<, newcwd=>#{newcwd}<"
+        Dir.chdir( newcwd )
+      end  
+
+      inname  = "#{basename}#{extname}"
+      outname = "#{basename}.html"
+      
+      logger.debug "inname=#{inname}, outname=#{outname}"
+      
+      puts "*** #{inname} (#{dirname}) => #{outname} (#{(opts.output_path == '.') ? dirname : opts.output_path})..."
+      
+      content = File.read( inname )
+      
+      # step 1) run (optional) preprocessing text filters
+      Markdown.filters.each do |filter|
+        mn = filter.tr( '-', '_' ).to_sym  # construct method name (mn)
+        content = send( mn, content )   # call filter e.g.  include_helper_hack( content )  
+      end
+
+      # step 2) convert light-weight markup to hypertext
+      content = Markdown.new( content ).to_html
+
+
+## todo: add Markdown.lib_options inspect/dump to banner
+            
+      banner =<<EOS
+<!-- ======================================================================
+      generated by #{Markdown.banner}
+                on #{Time.now} with Markdown engine '#{Markdown.lib}'
+     ====================================================================== -->
+EOS
+      
+      out = File.new( File.join( outpath, outname ), "w+" )
+####      out << banner
+      out << content
+      out.flush
+      out.close
+
+      ## pop/restore working folder/dir
+      unless newcwd == oldcwd
+        logger.debug "oldcwd=>#{oldcwd}<, newcwd=>#{newcwd}<"
+        Dir.chdir( oldcwd )
+      end  
+            
+    end # method create_doc
+
+
+    
+end # class Gen
+end # module Markdown

data/lib/markdown/cli/opts.rb

@@ -0,0 +1,14 @@
+module Markdown
+
+class Opts
+  
+  def output_path=(value)
+    @output_path = value
+  end
+  
+  def output_path
+    @output_path || '.'
+  end
+
+end # class Opts
+end # module Markdown

data/lib/markdown/cli/runner.rb

@@ -0,0 +1,173 @@
+module Markdown
+
+class Runner
+
+  attr_reader :logger
+  attr_reader :opts
+    
+  def initialize
+    @logger       = Logger.new(STDOUT)
+    @logger.level = Logger::INFO
+    @opts         = Opts.new
+  end
+
+  def has_markdown_extension?( fn )
+    dirname  = File.dirname( fn )
+    basename = File.basename( fn, '.*' )
+    extname  = File.extname( fn )
+    logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
+
+    return false if extname.empty?   # no extension
+      
+    Markdown.extnames.include?( extname.downcase )
+  end
+    
+  def find_file_with_markdown_extension( fn )
+    dirname  = File.dirname( fn )
+    basename = File.basename( fn, '.*' )
+    extname  = File.extname( fn )
+    logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
+
+    Markdown.extnames.each do |e|
+      newname = File.join( dirname, "#{basename}#{e}" ) 
+      logger.debug "File.exists? #{newname}"
+      return newname if File.exists?( newname )
+    end  # each extension (e)
+      
+    nil   # not found; return nil
+  end
+
+    
+  def find_files( file_or_dir_or_pattern )
+
+    filtered_files = []
+      
+    # assume pattern if includes * or ? or {} or []
+    if file_or_dir_or_pattern =~ /[*?{}\[\]]/
+      puts "searching glob pattern '#{file_or_dir_or_pattern}'..."
+      Dir.glob( file_or_dir_or_pattern ).each do |file|
+        if File.directory?( file )  # skip (sub)directories
+          puts "  skipping folder '#{file}'..."
+          next
+        else
+          if has_markdown_extension?( file )
+            logger.debug "  adding file '#{file}'..."
+            filtered_files << file
+          else
+            puts "  skipping file   '#{file}'..."
+          end
+        end
+      end
+    elsif File.directory?(file_or_dir_or_pattern)
+      puts "searching folder '#{file_or_dir_or_pattern}'..."
+      Dir.entries( file_or_dir_or_pattern ).each do |entry|
+        next if entry == '.' || entry == '..' # silently skip current and up dirs
+          
+        if file_or_dir_or_pattern == '.'
+          file = entry
+        else  # add dir (if not working dir)
+          file = File.join( file_or_dir_or_pattern, entry )  
+        end
+           
+        if File.directory?( file )  # skip (sub)directories
+          puts "  skipping folder '#{file}'..."
+          next
+        else
+          if has_markdown_extension?( file )
+            logger.debug "  adding file '#{file}'..."
+            filtered_files << file
+          else
+            puts "  skipping file   '#{file}'..."
+          end
+        end
+      end
+    else  # assume it's a single file (check for missing extension)
+      if File.exists?( file_or_dir_or_pattern )
+        file = file_or_dir_or_pattern
+        if has_markdown_extension?( file )
+          logger.debug "  adding file '#{file}'..."
+          filtered_files << file
+        else
+          puts "  skipping file   '#{file}'..."
+        end
+      else  # check for existing file w/ missing extension
+        file = find_file_with_markdown_extension( file_or_dir_or_pattern )
+        if file.nil?
+          puts "  skipping missing file '#{file_or_dir_or_pattern}{#{Markdown.extnames.join(',')}}'..."
+        else
+          logger.debug "  adding file '#{file}'..."
+          filtered_files << file
+        end
+      end
+    end
+
+    filtered_files
+  end  # find_files
+  
+    
+    def run( args )
+      opt=OptionParser.new do |cmd|
+    
+        cmd.banner = "Usage: markdown [options] files_or_dirs"
+    
+        cmd.on( '-o', '--output PATH', "Output Path (default is #{opts.output_path})" ) { |path| opts.output_path = path }
+
+        cmd.on( '-v', '--version', "Show version" ) do
+          puts Markdown.banner
+          exit
+        end
+
+        cmd.on( "--verbose", "Show debug trace" )  do
+           logger.datetime_format = "%H:%H:%S"
+           logger.level = Logger::DEBUG
+        end
+ 
+## todo: add markdown.lib options (e.g. extensions,etc)
+ 
+        cmd.on_tail( "-h", "--help", "Show this message" ) do
+           puts <<EOS
+
+markdown - Lets you convert plain text documents (#{Markdown.extnames.join(', ')}) to hypertext (.html) with your Markdown engine of choice (#{Markdown.lib}) and preprocessing text filters (#{Markdown.filters.join(', ')}).
+
+#{cmd.help}
+
+Examples:
+  markdown                   # Process all documents in working folder (that is, .)
+  markdown quickref          # Process document or folder using Markdown
+  markdown quickref.text     # Process document using Markdown
+  markdown -o site quickref  # Output documents to site folder
+
+Further information:
+  http://geraldb.github.com/markdown
+  
+EOS
+           exit
+        end
+      end
+
+      opt.parse!( args )
+  
+      puts Markdown.banner
+      
+      # force loading of config
+      Markdown.lib
+      
+      logger.debug "args.length: #{args.length}"
+      logger.debug "args: >#{args.join(',')}<"
+      
+      # if no file args given; default to working folder (that is, .)
+      args = ['.'] if args.length == 0
+
+      args.each do |arg|
+        files = find_files( arg )
+        files.each do |file|
+          Gen.new( logger, opts ).create_doc( file )
+        end
+      end
+      
+      puts "Done."
+      
+    end   # method run 
+
+end # class Runner
+end # module Markdown

data/lib/markdown/version.rb

@@ -0,0 +1,3 @@
+module Markdown
+  VERSION = '0.5.0.beta1'
+end

metadata

@@ -1,13 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: markdown
 version: !ruby/object:Gem::Version 
-  hash: 15
-  prerelease: 
+  hash: 123249068
+  prerelease: 6
   segments: 
   - 0
-  - 4
+  - 5
   - 0
-  version: 0.4.0
+  - beta
+  - 1
+  version: 0.5.0.beta1
 platform: ruby
 authors: 
 - Gerald Bauer
@@ -15,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-06-10 00:00:00 Z
+date: 2012-06-18 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: props
@@ -110,6 +112,9 @@ files:
 - Rakefile
 - bin/markdown
 - lib/markdown.rb
+- lib/markdown/cli/gen.rb
+- lib/markdown/cli/opts.rb
+- lib/markdown/cli/runner.rb
 - lib/markdown/config.rb
 - lib/markdown/engines/bluecloth.rb
 - lib/markdown/engines/kramdown.rb
@@ -118,7 +123,7 @@ files:
 - lib/markdown/engines/rdiscount.rb
 - lib/markdown/engines/redcarpet.rb
 - lib/markdown/engines/rpeg_markdown.rb
-- lib/markdown/gen.rb
+- lib/markdown/version.rb
 - lib/markdown/wrapper.rb
 - test/test_kramdown.rb
 - .gemtest
@@ -143,12 +148,14 @@ 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

data/lib/markdown/gen.rb

@@ -1,260 +0,0 @@
-module Markdown
-
-
-  class Opts
-  
-    def output_path=(value)
-      @output_path = value
-    end
-  
-    def output_path
-      @output_path ||= '.'
-    end
-
-  end # class Opts
-
-
-  class Gen
-
-    include TextUtils::Filter   # include filters such as comments_percent_style, etc. (see textutils gem)
-
-    attr_reader :logger
-    attr_reader :opts
-    
-    def initialize
-      @logger       = Logger.new(STDOUT)
-      @logger.level = Logger::INFO
-      @opts         = Opts.new
-    end
-
-    def create_doc( fn )
-      dirname  = File.dirname(  fn )    
-      basename = File.basename( fn, '.*' )
-      extname  = File.extname(  fn )
-
-      logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
-
-      if opts.output_path == '.'
-        # expand output path in current dir
-        outpath = File.expand_path( dirname ) 
-      else
-        # expand output path in user supplied dir and make sure output path exists
-        outpath = File.expand_path( opts.output_path ) 
-        FileUtils.makedirs( outpath ) unless File.directory? outpath 
-      end
-      logger.debug "outpath=#{outpath}"
-      
-      # todo: add a -c option to commandline? to let you set cwd?
-
-
-      # change working dir to sourcefile dir (that is, dirname); push working folder/dir
-      newcwd  = File.expand_path( dirname )
-      oldcwd  = File.expand_path( Dir.pwd )
-    
-      unless newcwd == oldcwd
-        logger.debug "oldcwd=>#{oldcwd}<, newcwd=>#{newcwd}<"
-        Dir.chdir( newcwd )
-      end  
-
-      inname  = "#{basename}#{extname}"
-      outname = "#{basename}.html"
-      
-      logger.debug "inname=#{inname}, outname=#{outname}"
-      
-      puts "*** #{inname} (#{dirname}) => #{outname} (#{(opts.output_path == '.') ? dirname : opts.output_path})..."
-      
-      content = File.read( inname )
-      
-      # step 1) run (optional) preprocessing text filters
-      Markdown.filters.each do |filter|
-        mn = filter.tr( '-', '_' ).to_sym  # construct method name (mn)
-        content = send( mn, content )   # call filter e.g.  include_helper_hack( content )  
-      end
-
-      # step 2) convert light-weight markup to hypertext
-      content = Markdown.new( content ).to_html
-
-
-## todo: add Markdown.lib_options inspect/dump to banner
-            
-      banner =<<EOS
-<!-- ======================================================================
-      generated by #{Markdown.banner}
-                on #{Time.now} with Markdown engine '#{Markdown.lib}'
-     ====================================================================== -->
-EOS
-      
-      out = File.new( File.join( outpath, outname ), "w+" )
-####      out << banner
-      out << content
-      out.flush
-      out.close
-
-      ## pop/restore working folder/dir
-      unless newcwd == oldcwd
-        logger.debug "oldcwd=>#{oldcwd}<, newcwd=>#{newcwd}<"
-        Dir.chdir( oldcwd )
-      end  
-            
-    end # method create_doc
-
-
-    def has_markdown_extension?( fn )
-      dirname  = File.dirname( fn )
-      basename = File.basename( fn, '.*' )
-      extname  = File.extname( fn )
-      logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
-
-      return false if extname.empty?   # no extension
-      
-      Markdown.extnames.include?( extname.downcase )
-    end
-    
-    def find_file_with_markdown_extension( fn )
-      dirname  = File.dirname( fn )
-      basename = File.basename( fn, '.*' )
-      extname  = File.extname( fn )
-      logger.debug "dirname=#{dirname}, basename=#{basename}, extname=#{extname}"
-
-      Markdown.extnames.each do |e|
-        newname = File.join( dirname, "#{basename}#{e}" ) 
-        logger.debug "File.exists? #{newname}"
-        return newname if File.exists?( newname )
-      end  # each extension (e)
-      
-      nil   # not found; return nil
-    end
-
-    
-    def find_files( file_or_dir_or_pattern )
-
-      filtered_files = []
-      
-      # assume pattern if includes * or ? or {} or []
-      if file_or_dir_or_pattern =~ /[*?{}\[\]]/
-        puts "searching glob pattern '#{file_or_dir_or_pattern}'..."
-        Dir.glob( file_or_dir_or_pattern ).each do |file|
-          if File.directory?( file )  # skip (sub)directories
-            puts "  skipping folder '#{file}'..."
-            next
-          else
-            if has_markdown_extension?( file )
-              logger.debug "  adding file '#{file}'..."
-              filtered_files << file
-            else
-              puts "  skipping file   '#{file}'..."
-            end
-          end
-        end
-      elsif File.directory?(file_or_dir_or_pattern)
-        puts "searching folder '#{file_or_dir_or_pattern}'..."
-        Dir.entries( file_or_dir_or_pattern ).each do |entry|
-          next if entry == '.' || entry == '..' # silently skip current and up dirs
-          
-          if file_or_dir_or_pattern == '.'
-            file = entry
-          else  # add dir (if not working dir)
-            file = File.join( file_or_dir_or_pattern, entry )  
-          end
-           
-          if File.directory?( file )  # skip (sub)directories
-            puts "  skipping folder '#{file}'..."
-            next
-          else
-            if has_markdown_extension?( file )
-              logger.debug "  adding file '#{file}'..."
-              filtered_files << file
-            else
-              puts "  skipping file   '#{file}'..."
-            end
-          end
-        end
-      else  # assume it's a single file (check for missing extension)
-        if File.exists?( file_or_dir_or_pattern )
-          file = file_or_dir_or_pattern
-          if has_markdown_extension?( file )
-            logger.debug "  adding file '#{file}'..."
-            filtered_files << file
-          else
-            puts "  skipping file   '#{file}'..."
-          end
-        else  # check for existing file w/ missing extension
-          file = find_file_with_markdown_extension( file_or_dir_or_pattern )
-          if file.nil?
-            puts "  skipping missing file '#{file_or_dir_or_pattern}{#{Markdown.extnames.join(',')}}'..."
-          else
-            logger.debug "  adding file '#{file}'..."
-            filtered_files << file
-          end
-        end
-      end
-
-      filtered_files
-    end  # find_files
-    
-    def run( args )
-      opt=OptionParser.new do |cmd|
-    
-        cmd.banner = "Usage: markdown [options] files_or_dirs"
-    
-        cmd.on( '-o', '--output PATH', 'Output Path' ) { |path| opts.output_path = path }
-
-        # 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
- 
-
-## todo: add markdown.lib options (e.g. extensions,etc)
- 
-        usage =<<EOS
-
-markdown - Lets you convert plain text documents (#{Markdown.extnames.join(', ')}) to hypertext (.html) with your Markdown engine of choice (#{Markdown.lib}) and preprocessing text filters (#{Markdown.filters.join(', ')}).
-
-#{cmd.help}
-
-Examples:
-  markdown                   # Process all documents in working folder (that is, .)
-  markdown quickref          # Process document or folder using Markdown
-  markdown quickref.text     # Process document using Markdown
-  markdown -o site quickref  # Output documents to site folder
-
-Further information:
-  http://geraldb.github.com/markdown
-  
-EOS
-
-        cmd.on_tail( "-h", "--help", "Show this message" ) do
-           puts usage
-           exit
-        end
-      end
-
-      opt.parse!( args )
-  
-      puts Markdown.banner
-      
-      # force loading of config
-      Markdown.lib
-      
-      logger.debug "args.length: #{args.length}"
-      logger.debug "args: >#{args.join(',')}<"
-      
-      # if no file args given; default to working folder (that is, .)
-      args = ['.'] if args.length == 0
-
-      args.each do |arg|
-        files = find_files( arg )
-        files.each do |file|
-          create_doc( file )
-        end
-      end
-      
-      puts "Done."
-      
-    end   # method run 
-    
-  end # class Gen
-
-end # module Markdown