slideshow 2.0.0 → 2.0.1

data/README.markdown

@@ -14,38 +14,105 @@ using a wiki-style markup language that's easy-to-write and easy-to-read.
 The Slide Show (S9) project also collects and welcomes themes and ships
 "out-of-the-gem" with built-in support for "loss-free" gradient vector graphics themes.
 
-## SYNOPSIS
-
-    Slide Show (S9) is a free web alternative to PowerPoint or Keynote in Ruby
-    
-    Usage: slideshow [options] name
-      -o, --output PATH                Output Path (default is .)
-      -t, --template MANIFEST          Template Manifest (default is s6.txt)
-          --h1                         Set Header Level to 1 (default)
-          --h2                         Set Header Level to 2
-      -f, --fetch URI                  Fetch Templates
-      -l, --list                       List Installed Templates
-      -c, --config PATH                Configuration Path (default is ~/.slideshow)
-      -g, --generate                   Generate Slide Show Templates (using built-in S6 Pack)
-      -q, --quick                      Generate Quickstart Slide Show Sample
-      -v, --version                    Show version
-          --verbose                    Show debug trace
-      -h, --help                       Show this message
-
-    Examples:
-      slideshow microformats
-      slideshow microformats.text            # Process slides using Markdown
-      slideshow microformats.textile         # Process slides using Textile
-      slideshow microformats.rst             # Process slides using reStructuredText
-      slideshow -o slides microformats       # Output slideshow to slides folder
-    
-    More examles:
-      slideshow -q                           # Generate quickstart slide show sample
-      slideshow -g                           # Generate slide show templates using built-in S6 pack
-      
-      slideshow -l                           # List installed slide show templates
-      slideshow -f s5blank                   # Fetch (install) S5 blank starter template from internet
-      slideshow -t s5blank microformats      # Use your own slide show templates (e.g. s5blank)
+~~~
+SYNOPSIS
+    slideshow [global options] command [command options] [arguments...]
+
+VERSION
+    2.0.0
+
+GLOBAL OPTIONS
+    -c, --config=PATH - Configuration Path (default: ~/.slideshow)
+    --verbose         - (Debug) Show debug messages
+    --version         - Show version
+
+COMMANDS
+    build, b           - Build slideshow
+    install, i         - Install template pack
+    list, ls, l        - List installed template packs
+    new, n             - Generate quick starter sample
+    about, a           - (Debug) Show more version info
+    help               - Shows a list of commands or help for one command
+~~~
+
+
+### `build` Command
+
+~~~
+NAME
+    build - Build slideshow
+
+SYNOPSIS
+    slideshow [global options] build [command options] FILE
+
+COMMAND OPTIONS
+    --h1                    - Set Header Level to 1 (default)
+    --h2                    - Set Header Level to 2
+    --takahashi             - Allow // for slide breaks
+    --slide                 - Use only !SLIDE for slide breaks (Showoff Compatible)
+    -o, --output=PATH       - Output Path (default: .)
+    -t, --template=MANIFEST - Template Manifest (default: s6)
+
+EXAMPLES
+    slideshow build microformats
+    slideshow build microformats.text            # Process slides using Markdown
+    slideshow build microformats.textile         # Process slides using Textile
+    slideshow build microformats.rst             # Process slides using reStructuredText
+    slideshow build microformats -o slides       # Output slideshow to slides folder
+    slideshow build microformats -t s5blank      # Use your own slide show templates (e.g. s5blank)
+~~~
+
+
+### `list` Command
+
+~~~
+NAME
+    list - List installed template packs
+
+SYNOPSIS
+    slideshow [global options] list [command options] 
+
+EXAMPLES
+    slideshow list
+    slideshow ls
+~~~
+
+
+### `install` Command
+
+~~~
+NAME
+    install - Install template pack
+
+SYNOPSIS
+    slideshow [global options] install [command options] MANIFEST
+
+COMMAND OPTIONS
+    -a, --all - Template Packs (s5blank, s5themes, slidy, g5, csss, deck.js, impress.js)
+
+EXAMPLES
+    slideshow install impress.js
+    slideshow install https://raw.github.com/.../impress.js.txt
+~~~
+
+
+### `new` Command
+
+~~~
+NAME
+    new - Generate quick starter sample
+
+SYNOPSIS
+    slideshow [global options] new [command options] 
+
+COMMAND OPTIONS
+    -o, --output=PATH       - Output Path (default: .)
+    -t, --template=MANIFEST - Template Manifest (default: welcome)
+
+EXAMPLES
+    slideshow new
+    slideshow new -t impress.js
+~~~
 
 
 ## INSTALL

data/lib/slideshow/cli/commands/plugins.rb

@@ -29,7 +29,9 @@ class Plugins
       puts "    -- none --"
     else
       plugins.each do |plugin|
-        puts "    #{plugin}"
+        ## NB: use full_path - since Ruby 1.9.2 - ./ no longer included in load path for security
+        plugin_fullpath = File.expand_path( plugin )
+        puts "    #{plugin} (#{plugin_fullpath})"
       end
     end
   end

data/lib/slideshow/cli/main_utils.rb

@@ -95,12 +95,23 @@ EOS
   # dump Markdown settings
   Markdown.dump
   puts
-      
+
   # todo:
   # add verison for rubygems
 
   ## todo: add more gem version info
   #- redcloth
   #- kramdown
+
+      
+    dump_load_path   # helps debugging pluggin loading (e.g. Ruby 1.9.2> no longer includes ./ in load path)
   end
+
+  def dump_load_path
+    puts 'load path:'
+    $LOAD_PATH.each_with_index do |path,i|
+      puts "  [#{i+1}] #{path}"
+    end
+  end
+
 end # class SysInfo

data/lib/slideshow/plugin_helpers.rb

@@ -29,8 +29,10 @@ module PluginHelper
       pattern.gsub!( '\\', '/')  # normalize path; make sure all path use / only
       Dir.glob( pattern ) do |plugin|
         begin
-          puts "Loading plugins in '#{plugin}'..."
-          require( plugin )
+          ## NB: use full_path - since Ruby 1.9.2 - ./ no longer included in load path for security
+          plugin_fullpath = File.expand_path( plugin )  # nb: will use Dir.pwd (e.g. ./) as second arg
+          puts "Loading plugins in '#{plugin}' (#{plugin_fullpath})..."
+          require( plugin_fullpath )
         rescue Exception => e
           puts "** error: failed loading plugins in '#{plugin}': #{e}"
         end

data/lib/slideshow/version.rb

@@ -1,3 +1,3 @@
 module Slideshow
-  VERSION = '2.0.0'
-end
+  VERSION = '2.0.1'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slideshow
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-19 00:00:00.000000000 Z
+date: 2013-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: props
-  requirement: &82743930 !ruby/object:Gem::Requirement
+  requirement: &83862160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *82743930
+  version_requirements: *83862160
 - !ruby/object:Gem::Dependency
   name: markdown
-  requirement: &82743710 !ruby/object:Gem::Requirement
+  requirement: &83861940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *82743710
+  version_requirements: *83861940
 - !ruby/object:Gem::Dependency
   name: textutils
-  requirement: &82743490 !ruby/object:Gem::Requirement
+  requirement: &83861720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 0.2.0
   type: :runtime
   prerelease: false
-  version_requirements: *82743490
+  version_requirements: *83861720
 - !ruby/object:Gem::Dependency
   name: pakman
-  requirement: &82743270 !ruby/object:Gem::Requirement
+  requirement: &83861500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 0.4.0
   type: :runtime
   prerelease: false
-  version_requirements: *82743270
+  version_requirements: *83861500
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &82743060 !ruby/object:Gem::Requirement
+  requirement: &83861290 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: 3.2.6
   type: :runtime
   prerelease: false
-  version_requirements: *82743060
+  version_requirements: *83861290
 - !ruby/object:Gem::Dependency
   name: RedCloth
-  requirement: &82742840 !ruby/object:Gem::Requirement
+  requirement: &83861070 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: 4.2.9
   type: :runtime
   prerelease: false
-  version_requirements: *82742840
+  version_requirements: *83861070
 - !ruby/object:Gem::Dependency
   name: logutils
-  requirement: &82742620 !ruby/object:Gem::Requirement
+  requirement: &83860850 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: 0.6.0
   type: :runtime
   prerelease: false
-  version_requirements: *82742620
+  version_requirements: *83860850
 - !ruby/object:Gem::Dependency
   name: gli
-  requirement: &82758790 !ruby/object:Gem::Requirement
+  requirement: &83860630 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +98,10 @@ dependencies:
         version: 2.5.6
   type: :runtime
   prerelease: false
-  version_requirements: *82758790
+  version_requirements: *83860630
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &82758570 !ruby/object:Gem::Requirement
+  requirement: &83860410 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -109,10 +109,10 @@ dependencies:
         version: '3.10'
   type: :development
   prerelease: false
-  version_requirements: *82758570
+  version_requirements: *83860410
 - !ruby/object:Gem::Dependency
   name: hoe
-  requirement: &82758350 !ruby/object:Gem::Requirement
+  requirement: &83860190 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -120,12 +120,20 @@ dependencies:
         version: '3.3'
   type: :development
   prerelease: false
-  version_requirements: *82758350
+  version_requirements: *83860190
 description: ! "The Slide Show (S9) Ruby gem lets you create slide shows and author
   slides in plain text\r\nusing a wiki-style markup language that's easy-to-write
   and easy-to-read.\r\nThe Slide Show (S9) project also collects and welcomes themes
   and ships\r\n\"out-of-the-gem\" with built-in support for \"loss-free\" gradient
-  vector graphics themes."
+  vector graphics themes.\r\n\r\n~~~\r\nSYNOPSIS\r\n    slideshow [global options]
+  command [command options] [arguments...]\r\n\r\nVERSION\r\n    2.0.0\r\n\r\nGLOBAL
+  OPTIONS\r\n    -c, --config=PATH - Configuration Path (default: ~/.slideshow)\r\n
+  \   --verbose         - (Debug) Show debug messages\r\n    --version         - Show
+  version\r\n\r\nCOMMANDS\r\n    build, b           - Build slideshow\r\n    install,
+  i         - Install template pack\r\n    list, ls, l        - List installed template
+  packs\r\n    new, n             - Generate quick starter sample\r\n    about, a
+  \          - (Debug) Show more version info\r\n    help               - Shows a
+  list of commands or help for one command\r\n~~~"
 email: webslideshow@googlegroups.com
 executables:
 - slideshow