parade 0.8.0

data/lib/parade/commands/static_html.rb

@@ -0,0 +1,38 @@
+require_relative 'html_output'
+
+module Parade
+  module Commands
+
+    #
+    # Saves an html representation of the presentation to a single HTML file.
+    # 
+    # @see HtmlOutput
+    # 
+    class StaticHtml
+      include RenderFromTemplate
+
+      def description
+        "Output into a single HTML file"
+      end
+
+      def generate(options)
+        options.merge!('template' => 'onepage')
+
+        html_generator = HtmlOutput.new
+        html_content = html_generator.generate(options)
+
+        output_file = options[:output] || default_html_output
+
+        if create_file_with_contents output_file, html_content, options
+          puts "Saved HTML to #{output_file}"
+        end
+      end
+
+      def default_html_output
+        "presentation.html"
+      end
+
+    end
+
+  end
+end

data/lib/parade/commands/static_pdf.rb

@@ -0,0 +1,39 @@
+require_relative 'html_output'
+
+module Parade
+  module Commands
+
+    #
+    # Saves a PDF version of the presentation that is from the HtmlOutput
+    # 
+    class StaticPdf
+
+      def description
+        "Output into a PDF format"
+      end
+
+      def generate(options)
+        options.merge!('template' => 'pdf')
+
+        html_generator = HtmlOutput.new
+        html_content = html_generator.generate(options)
+
+        kit = PDFKit.new(html_content,:page_size => 'Letter', :orientation => 'Landscape')
+
+        output_file = options[:output] || default_pdf_output
+
+        return if (File.exists?(output_file) and not options.key?(:force))
+
+        kit.to_file(output_file)
+
+        puts "Saved PDF to #{output_file}"
+      end
+
+      def default_pdf_output
+        "presentation.pdf"
+      end
+
+    end
+
+  end
+end

data/lib/parade/commands/unknown.rb

@@ -0,0 +1,23 @@
+
+module Parade
+  module Commands
+
+    #
+    # The Unknown Command is provided as the default for the command lists
+    # as a default to ensure that a nil is not returned, allowing a for
+    # an object that adheres to the generate method.
+    # 
+    class Unknown
+
+      def description
+        "Could not find the command specified"
+      end
+
+      def generate(options)
+        puts description
+      end
+
+    end
+
+  end
+end

data/lib/parade/features/live_ruby.rb

@@ -0,0 +1,18 @@
+module Parade
+
+  module LiveRuby
+
+    def self.included(server)
+      server.get '/eval_ruby' do
+        eval_ruby(params[:code])
+      end
+    end
+
+    def eval_ruby(code)
+      eval(code).to_s
+    rescue => exception
+      exception.message
+    end
+  end
+
+end

data/lib/parade/features/pdf_presentation.rb

@@ -0,0 +1,24 @@
+module Parade
+  module PDFPresentation
+    def self.included(server)
+
+      server.get '/pdf' do
+        
+        # TODO: Find the presentation file and/or regenerate it every time
+        
+        template_options = {  'erb_template_file' => File.join(File.dirname(__FILE__), "..", "..", "views", "pdf.erb"),
+                              'custom_asset_path' => settings.presentation_directory,
+                              'slides' => slides }
+        
+        html_content = TemplateGenerator.new(template_options).render
+        
+        # TODO the image references here are not full filepaths. creating issues
+
+        kit = PDFKit.new(html_content,:page_size => 'Letter', :orientation => 'Landscape')
+
+        send_file kit.to_file('presentation.pdf')
+      end
+
+    end
+  end
+end

data/lib/parade/features/preshow.rb

@@ -0,0 +1,11 @@
+module Parade
+  module Preshow
+    def self.included(server)
+
+      server.get "/preshow" do
+        Dir.glob("#{settings.presentation_directory}/preshow/*").map { |path| File.basename(path) }.to_json
+      end
+
+    end
+  end
+end

data/lib/parade/helpers/encode_image.rb

@@ -0,0 +1,24 @@
+require 'base64'
+
+module Parade
+  module Helpers
+
+    module EncodeImage
+
+      def image_path_to_base64
+        $stderr.puts "Please install `rmagick` to allow images to be included in content"
+        ''
+      end
+
+      if defined?(Magick)
+        def image_path_to_base64(path)
+          magick_image = Magick::Image.read(path).first
+          data = Base64.encode64(magick_image.to_blob).gsub("\n",'').strip
+          "data:image/#{magick_image.format};base64,#{data}"
+        end
+      end
+
+    end
+
+  end
+end

data/lib/parade/helpers/template_generator.rb

@@ -0,0 +1,130 @@
+require 'ostruct'
+
+module Parade
+
+  #
+  # TemplateGenator uses ERB to generate a template and uses itself as the
+  # reference as the binding. This template generator is being used primarily
+  # as a way to generate static versions of the content in HTML.
+  #
+  # When created an :erb_template_file needs to be specified in the Hash, all
+  # other fields are dependent on what is contained within the template itself
+  #
+  class TemplateGenerator < OpenStruct
+
+    #
+    # @param [String] filepath the filepath to load
+    #
+    def css_template(filepath)
+      CSSTemplateGenerator.new :filepath => filepath
+    end
+
+    def js_template(filepath)
+      JSTemplateGenerator.new :filepath => filepath
+    end
+
+    #
+    # Return javascript to be inlined in a template
+    #
+    # @param [String] filepath the filepath to the javascript file
+    # @return [String] HTML content that is inlined javascript data
+    def js(filepath)
+      js_template(filepath).render
+    end
+
+    #
+    # Return stylesheet to be inlined in a template
+    #
+    # @param [String] filepath the filepath to the stylesheet file
+    # @return [String] HTML content that is inlined stylesheet data
+    #
+    def css(filepath)
+      css_template(filepath).render
+    end
+
+    def custom_css_files
+      if custom_asset_path
+        Dir.glob("#{custom_asset_path}**/*.css").map do |path|
+          css_template(path).render
+        end.join("\n")
+      end
+    end
+
+    def custom_js_files
+      if custom_asset_path
+        Dir.glob("#{custom_asset_path}**/*.js").map do |path|
+          js_template(path).render
+        end.join("\n")
+      end
+    end
+
+    #
+    # To provide support of having references to other templates, this will
+    # handle erb method calls and in-line that template's content
+    #
+    # @param [Strign] filepath the filepath to another template
+    # @return [String] HTML content of the specfied template at the filepath
+    #
+    def erb(filepath)
+      template_filepath = File.join File.dirname(erb_template_file), "#{filepath}.erb"
+      template_file = ERB.new File.read(template_filepath)
+      template_file.result(binding)
+    end
+
+    #
+    # @return [Types] the HTML content of the template specified
+    #
+    def render
+      template_file = ERB.new File.read(erb_template_file)
+      template_file.result(binding)
+    end
+  end
+
+  #
+  # Generate inline CSS assets. Using CssParser it is able to traverse imports
+  # to ensure all CSS is inlined within the document.
+  # 
+  # Also embeds all images contained within the CSS into the inlined CSS.
+  # 
+  class CSSTemplateGenerator < TemplateGenerator
+    include Helpers::EncodeImage
+
+    def content
+      content_filepath = File.exists?(filepath) ? filepath : File.join(File.dirname(__FILE__), "..", "..", "public", "css", filepath)
+      parser = CssParser::Parser.new
+      parser.load_file!(content_filepath)
+
+      css_contents = parser.to_s
+
+      css_contents.gsub(/url\([\s"']*([^\)"'\s]*)[\s"']*\)/m) do |image_uri|
+        image_name = Regexp.last_match(1)
+        image_path = File.join File.dirname(content_filepath), image_name
+        base64_data = image_path_to_base64(image_path)
+        "url(#{base64_data})"
+      end
+
+    end
+
+    def erb_template_file
+      File.join File.dirname(__FILE__), "..", "..", "views", "inline_css.erb"
+    end
+
+  end
+
+  #
+  # Inline the specified javascript
+  #
+  class JSTemplateGenerator < TemplateGenerator
+
+    def content
+      content_filepath = File.exists?(filepath) ? filepath : File.join(File.dirname(__FILE__), "..", "..", "public", "js", filepath)
+      File.read content_filepath
+    end
+
+    def erb_template_file
+      File.join File.dirname(__FILE__), "..", "..", "views", "inline_js.erb"
+    end
+
+  end
+
+end

data/lib/parade/metadata.rb

@@ -0,0 +1,73 @@
+require_relative 'metadata/assignment'
+require_relative 'metadata/css_classes'
+require_relative 'metadata/html_id'
+require_relative 'metadata/template'
+
+module Parade
+
+  #
+  # Slides within Parade contain metadata. This metadata allows you to set
+  # CSS classes and IDs. You are also able, as well to assigna unique
+  # transitions between each slide.
+  #
+  class Metadata
+
+    #
+    # @example Raw Metadata that contains CSS Class, ID, transitions, and template data
+    #
+    #     metadata = Metadata.parse "transition=fade one two #id three tpl=template_name"
+    #     metadata.classes # => [ 'one', 'two', 'three' ]
+    #     metadata.transition # => 'fade'
+    #     metadata.id # => 'id'
+    #     metadata.template # => 'template_name'
+    #
+    # @param [String] metadata a single string that contains all the raw metadata.
+    #
+    def self.parse(metadata)
+
+      metadata_hash = {}
+
+      metadata.to_s.split(' ').each do |term|
+        metadata_type = parsers.find {|parser| parser.match? term }
+        metadata_type.apply(term,metadata_hash)
+      end
+
+      self.new metadata_hash
+    end
+
+    #
+    # The list of the parsers that are used to parse the metadata string.
+    # 
+    def self.parsers
+      [ Template.new,
+        Assignment.new,
+        HTMLId.new,
+        CSSClasses.new ]
+    end
+
+    #
+    # The initialize method is generally not called directly and instead is
+    # used through the `Metadata.parse` method.
+    # 
+    # @param [Hash] params this hash contains the key-value pairs that map
+    #   directly to accessor methods within the Metadata class.
+    #
+    # @see Metadata.parse
+    # 
+    def initialize(params = {})
+      params.each {|k,v| send("#{k}=",v) if respond_to? "#{k}=" }
+    end
+
+    attr_writer :classes
+
+    def classes
+      @classes || []
+    end
+
+    attr_accessor :id
+    attr_accessor :transition
+    attr_accessor :template
+
+  end
+
+end

data/lib/parade/metadata/assignment.rb

@@ -0,0 +1,38 @@
+module Parade
+  class Metadata
+
+    #
+    # The Assignment metadata parser is a general parser that allows the ability
+    # to assign a value to the specified field of the metadata. This is
+    # usually used for assigning the *transition* field but could be used to set
+    # the *id* in the metadata.
+    #
+    # @example Settings the Metadata id
+    #
+    #     metadata = Metadata.parse "id=unique-slide-id"
+    #     metadata.id # => "unique-slide-id"
+    #
+    # @see Metadata
+    #
+    class Assignment
+
+      def match?(term)
+        term =~ /.+=.+/
+      end
+
+      def apply(term,hash)
+        key, value = parse(term)
+        hash[key] = value
+        hash
+      end
+
+      private
+
+      def parse(term)
+        term.split('=')
+      end
+
+    end
+
+  end
+end

data/lib/parade/metadata/css_classes.rb

@@ -0,0 +1,22 @@
+module Parade
+  class Metadata
+
+    #
+    # By default the CSS Class metadata parser is a catch all parser that will
+    # use all the terms and create CSS classes.
+    # 
+    class CSSClasses
+
+      def match?(term)
+        true
+      end
+
+      def apply(term,hash)
+        (hash[:classes] ||= []) << term
+        hash
+      end
+
+    end
+
+  end
+end