slideshow 2.3.0 → 2.4.0

data/lib/slideshow/helpers/syntax/sh_helper.rb

@@ -1,61 +0,0 @@
-module Slideshow
- module Syntax
-  module ShHelper
-
-  # sh option defaults
-  SH_LANG         = 'ruby'
-  SH_LINE_NUMBERS = 'true'
-
-def sh_worker( code, opts )
-  
-  lang         = opts.fetch( :lang, headers.get( 'code-language', SH_LANG ))
-  line_numbers_value = opts.fetch( :line_numbers, headers.get( 'code-line-numbers', SH_LINE_NUMBERS ))
-  line_numbers = (line_numbers_value =~ /true|yes|on/i) ? true : false
-     
-  # note: code gets highlighted at runtime in client (using JavaScript)  
-  code_highlighted = CGI::escapeHTML( code )
-  
-  css_class = 'code'
-  css_class_opt = opts.fetch( :class, nil ) #  large, small, tiny, etc.
-  css_class << " #{css_class_opt}" if css_class_opt   # e.g. use/allow multiple classes -> code small, code large, etc.
-   
-  out =  %{<div class='#{css_class}'><pre class='brush: #{lang} toolbar: false gutter: #{line_numbers ? 'true' : 'false'}'>}
-  out << code_highlighted
-  out << %{</pre></div>\n}
-    
-  name        = opts.fetch( :name, nil )
-  txmt_value  = opts.fetch( :txmt, headers.code_txmt )
-  txmt        = (txmt_value =~ /true|yes|on/i) ? true : false
-    
-  # add optional href link for textmate
-  if name
-    out << %{<div class="codeurl">}
-    out << %{<a href="txmt://open?url=file://#{File.expand_path(name)}">} if txmt  
-    out << name
-    out << %{</a>} if txmt
-    out << %{</div>\n}
-  end
-          
-  return out 
-end  
-
-def sv( *args, &blk )   
-  # check for optional hash for options
-  opts = args.last.kind_of?(Hash) ? args.pop : {}
-   
-  code = capture_erb(&blk)
-  return if code.empty?
-    
-  code_highlighted = sv_worker( code, opts )
-    
-  concat_erb( guard_block( code_highlighted ), blk.binding )
-  return
-end  
-    
-end   # module ShHelper
-end  # module Syntax
-end # module Slideshow
-
-class Slideshow::Gen
-  include Slideshow::Syntax::ShHelper
-end

data/lib/slideshow/helpers/syntax/uv_helper.rb

@@ -1,90 +0,0 @@
-require 'uv'
-
-module Slideshow
- module Syntax
-  module UvHelper
-
-  # uv option defaults
-  UV_LANG         = 'ruby'
-  UV_LINE_NUMBERS = 'true'
-  UV_THEME        = 'amy'
-
-def uv_worker( code, opts )
-  
-  lang         = opts.fetch( :lang, UV_LANG )  
-  line_numbers_value = opts.fetch( :line_numbers, headers.get( 'code-line-numbers', UV_LINE_NUMBERS ))
-  line_numbers = (line_numbers_value =~ /true|yes|on/i) ? true : false
-  
-  # change all-hallows-eve (CSS-style/convention) to all_hallows_eve (uv internal-style)
-  theme   = opts.fetch( :theme, headers.get( 'code-theme', UV_THEME )).tr( '-', '_' )
-    
-  code_highlighted = Uv.parse( code, "xhtml", lang, line_numbers, theme )
-
-  # first time? copy all uv built-in themes (css styles) to temporary cache (~/.slideshow/*)
-  uv_first_time = session.fetch( :uv_first_time, true )
-  if uv_first_time
-    session[ :uv_first_time ] = false
-    logger.debug "cache_dir=#{config.cache_dir}"
-
-    FileUtils.mkdir(config.cache_dir) unless File.exists?(config.cache_dir) if config.cache_dir
-    Uv.copy_files "xhtml", config.cache_dir
-  end
-    
-  # first time this theme gets used add it to content_for hash for templates to include   
-  uv_themes = session[ :uv_themes ] ||= {} 
-  if uv_themes[ theme ].nil?
-    uv_themes[ theme ] = true
-    
-    theme_content = File.read( "#{config.cache_dir}/css/#{theme}.css" )
-
-    theme_out =  %{/* styles for ultraviolet code syntax highlighting theme '#{theme}' */\n\n}
-    theme_out << theme_content
-    theme_out << %{\n\n}
-
-    content_for( :css, theme_out ) 
-  end  
-
-  css_class = 'code'
-  css_class_opt = opts.fetch( :class, nil ) #  large, small, tiny, etc.
-  css_class << " #{css_class_opt}" if css_class_opt   # e.g. use/allow multiple classes -> code small, code large, etc.
- 
-  name        = opts.fetch( :name, nil )
-  txmt_value  = opts.fetch( :txmt, headers.code_txmt )
-  txmt        = (txmt_value =~ /true|yes|on/i) ? true : false
-  
-  out =  %{<pre class='#{css_class}'>\n}
-  out << code_highlighted
-  out << %{</pre>\n}
-  
-  # add optional href link for textmate
-  if name
-    out << %{<div class="codeurl">}
-    out << %{<a href="txmt://open?url=file://#{File.expand_path(name)}">} if txmt  
-    out << name
-    out << %{</a>} if txmt
-    out << %{</div>\n}
-  end
-  
-  return out 
-end  
-
-def uv( *args, &blk )   
-  # check for optional hash for options
-  opts = args.last.kind_of?(Hash) ? args.pop : {}
-   
-  code = capture_erb(&blk)
-  return if code.empty?
-    
-  code_highlighted = uv_worker( code, opts )
-    
-  concat_erb( wrap_markup( code_highlighted ), blk.binding )
-  return
-end  
-    
-end   # module UvHelper
-end  # module Syntax
-end # module Slideshow
-
-class Slideshow::Gen
-  include Slideshow::Syntax::UvHelper
-end

data/lib/slideshow/helpers/text_helper.rb

@@ -1,130 +0,0 @@
-module Slideshow
-  module TextHelper
-  
-def s9_include( name, opts = {} )
-  puts "  Including '#{name}'..." 
-  content = File.read( name )
-end
-
-
-# Usage example:
-#  <%= code 'code/file.rb#section', :lang => 'ruby', :class => 'small' %>
-#    or
-#  <% code :lang => 'ruby' do %>
-#    code goes here
-#  <% end %>
-#
-
-def code( *args, &blk )
-  # check for optional hash for options
-  opts = args.last.kind_of?(Hash) ? args.pop : {}
-  
-  name_plus_part = args.first   # check for optional filename
-    
-  if name_plus_part 
-    name, part = name_plus_part.split( '#' ) # split off optional part/anchor 
-    
-    content = find_content_from( name, part ) 
-    
-    # add name and part to opts so engine can use paras too  
-    opts[ :name ] = name  
-    opts[ :part ] = part if part
-    
-    return format_code( content, opts )
-  elsif blk # inline code via block?
-    content = capture_erb(&blk)
-    return if content.empty?
-
-    concat_erb( format_code( content, opts ), blk.binding )
-    return
-  else
-    msg = '*** warning: empty code directive; inline code or file para expected'
-    puts msg 
-    return wrap_markup( "<!-- #{msg} -->" )
-  end
-end
-
-
-def find_content_from( name, part )
-  begin
-    content = File.read( name )
-
-    # note: for now content with no parts selected gets filtered too and (part) marker lines get removed from source
-    lines = find_part_lines_in( content, part )
-
-    if part
-      puts "  Including code part '#{part}' in '#{name}' [#{lines.size} lines]..."
-      ## todo: issue warning if no lines found?
-    else
-      puts "  Including code in '#{name}' [#{lines.size} lines]..."
-    end
-  
-    return lines.join
-  rescue Exception => e
-    puts "*** error: reading '#{name}': #{e}"
-    exit 2
-  end
-end
-
-def find_part_lines_in( content, part )
-  result = []
-  state = part.nil? ? :normal : :skipping 
-  content.each_line do |line|
-    if line =~ /(START|END):(\w+)/
-      if $2 == part
-        if $1 == "START"
-          state = :normal
-        else
-          state = :skipping
-        end
-      end
-      next 
-    end
-    result << line unless state == :skipping
-  end
-  result
-end
-
-
-def format_code( code, opts )
-  
-  engine    = opts.fetch( :engine, headers.code_engine ).to_s.downcase  
-  
-  if engine == 'uv' || engine == 'ultraviolet'
-    if respond_to?( :uv_worker )
-      code_highlighted = uv_worker( code, opts )
-    else
-      puts "** error: ultraviolet gem required for syntax highlighting; install with gem install ultraviolet (or use a different engine)"
-      exit 2
-    end
-  elsif engine == 'cr' || engine == 'coderay'
-    if respond_to?( :coderay_worker )
-      code_highlighted = coderay_worker( code, opts )
-    else
-      puts "*** error: coderay gem required for syntax highlighting; install with gem install coderay (or use a different engine)"
-      exit 2
-    end
-  else
-    method_name = "#{engine}_worker".to_sym
-    if respond_to?( method_name )
-      # try to call custom syntax highlighting engine
-      code_highlighted = send( method_name, code, opts )
-    else
-      msg = "*** error: unkown syntax highlighting engine '#{engine}'; available built-in options include: uv, ultraviolet, cr, coderay"
-      puts msg
-      code_highlighted = "<!-- #{msg} -->"
-    end
-  end
- 
-  out =  %{<!-- begin code#{opts.inspect} -->\n}
-  out << code_highlighted
-  out << %{<!-- end code -->\n}
-  
-  guard_block( out ) # saveguard with notextile wrapper etc./no further processing needed
-end
-
-
-end # module TextHelper
-end # module Slideshow
-
-Slideshow::Gen.__send__( :include, Slideshow::TextHelper )

data/lib/slideshow/manifest_helpers.rb

@@ -1,94 +0,0 @@
-module Slideshow
-
-module ManifestHelper
-
-  ## shared methods for handling manifest lookups
-
-  def installed_plugin_manifest_patterns
-    # 1) search ./plugins
-    # 2) search config_dir/plugins
-
-    config_patterns  = [
-      "#{config.config_dir}/plugins/*.{txt.plugin,plugin.txt}",
-      "#{config.config_dir}/plugins/*/*.{txt.plugin,plugin.txt}"
-    ]
-    current_patterns = [
-      "plugins/*.{txt.plugin,plugin.txt}",
-      "plugins/*/*.{txt.plugin,plugin.txt}"
-    ]
-    
-    patterns = []
-    patterns += current_patterns
-    patterns += config_patterns
-  end
-
-  def installed_plugin_manifests  # quickstarter templates
-    Pakman::Finder.new( logger ).find_manifests( installed_plugin_manifest_patterns )
-  end
-
-
-  def installed_template_manifest_patterns
-    # 1) search ./templates
-    # 2) search config_dir/templates
-    # 3) search gem/templates
-
-    builtin_patterns = [
-      "#{Slideshow.root}/templates/*.txt"
-    ]
-    config_patterns  = [
-      "#{config.config_dir}/templates/*.txt",
-      "#{config.config_dir}/templates/*/*.txt"
-    ]
-    current_patterns = [
-      "templates/*.txt",
-      "templates/*/*.txt"     # todo: use all in one line? {*.txt,*/*.txt} does it work?
-    ]
-    
-    patterns = []
-    patterns += current_patterns  unless Slideshow.root == File.expand_path( '.' )  # don't include working dir if we test code from repo (don't include slideshow/templates)
-    patterns += config_patterns
-    patterns += builtin_patterns
-  end
-
-  def installed_template_manifests
-    ## note: code moved to its own gem, that is, pakman
-    ## see https://github.com/geraldb/pakman
-  
-    ## exclude manifest.txt/i  (avoid confusion w/ ruby gem manifest; not a specific name anyway)
-    ##  also exclude patterns for quickstarter templates
-    
-    excludes = [
-      'manifest.txt',
-      '*/manifest.txt',
-      '*.{txt.quick,quick.txt}',
-      '*/*.{txt.quick,quick.txt}'
-    ]
-  
-    Pakman::Finder.new( logger ).find_manifests( installed_template_manifest_patterns, excludes )
-  end
-  
-
-  def installed_quick_manifest_patterns
-    # 1) search config_dir/templates
-    # 2) search gem/templates 
- 
-    builtin_patterns = [
-      "#{Slideshow.root}/templates/*.{txt.quick,quick.txt}"
-    ]
-    config_patterns  = [
-      "#{config.config_dir}/templates/*.{txt.quick,quick.txt}",
-      "#{config.config_dir}/templates/*/*.{txt.quick,quick.txt}"
-    ]
-    
-    patterns = []
-    patterns += config_patterns
-    patterns += builtin_patterns
-  end
-
-  def installed_quick_manifests  # quickstarter templates
-    Pakman::Finder.new( logger ).find_manifests( installed_quick_manifest_patterns )
-  end
-  
-
-end # module Manifest
-end # module Slideshow

data/lib/slideshow/markup/markdown.rb

@@ -1,18 +0,0 @@
-module Slideshow
-  module MarkdownEngines
-
-  ## note: code moved to its own gem, that is, markdown
-  ## see https://github.com/geraldb/markdown
-  
-  def markdown_to_html( content )
-    ##  puts "  Converting Markdown-text (#{content.length} bytes) to HTML using library '#{@markdown_libs.first}' calling '#{mn}'..."
-    
-    Markdown.new( content ).to_html
-  end
-
-end   # module MarkdownEngines
-end # module Slideshow
-
-class Slideshow::Gen
-  include Slideshow::MarkdownEngines
-end

data/lib/slideshow/markup/mediawiki.rb

@@ -1,38 +0,0 @@
-module Slideshow
-  module MediawikiEngines
-
-
-  def setup_mediawiki_engine
-    return if @mediawiki_engine_setup
-    logger.debug 'require wikicloth  -- load mediawiki library'
-    require 'wikicloth'          # default mediawiki library
-    @mediawiki_engine_setup = true
-  rescue LoadError
-    puts "You're missing a library required for Mediawiki to Hypertext conversion. Please run:"
-    puts "   $ gem install wikicloth"
-    #  check: raise exception instead of exit e.g
-    #  raise FatalException.new( 'Missing library dependency: wikicloth' )
-    exit 1
-  end
-
-
-  def mediawiki_to_html( content )
-    
-    setup_mediawiki_engine()
-    
-    puts "  Converting Mediawiki-text (#{content.length} bytes) to HTML..."
-
-    # NB: turn off table_of_contents (TOC) auto-generation with __NOTOC__
-    # NB: turn off adding of edit section/markers for headings (noedit:true)
-
-    wiki = WikiCloth::Parser.new( data: "__NOTOC__\n"+content, params: {} )
-
-    content = wiki.to_html( noedit: true )
-  end
-
-  end  # module MediawikiEngines
-end # module Slideshow
-
-class Slideshow::Gen
-  include Slideshow::MediawikiEngines
-end

data/lib/slideshow/markup/rest.rb

@@ -1,17 +0,0 @@
-require 'pandoc-ruby'
-
-module Slideshow
-  module RestEngines  # reStructuredText
-
-  def rest_to_html( content )
-    puts "  Converting reStructuredText (#{content.length} bytes) to HTML..."
-
-    content = PandocRuby.new( content, :from => :rst, :to => :html ).convert
-  end
-    
-end   # module RestEngines
-end # module Slideshow
-
-class Slideshow::Gen
-  include Slideshow::RestEngines
-end