html_slicer 0.1.1 → 0.1.2

data/README.rdoc

@@ -228,6 +228,7 @@ Controller:
   @article_paged = @article.paged.slice!(params[:slice])
 
 On a View just call the +slice+ helper:
+
   <%= slice @article_paged %>
 
 This will render several <tt>?slice=N</tt> slicing links surrounded by an HTML5 <+nav+> tag.
@@ -353,6 +354,24 @@ In fact, caching ActiveModel not so significant in most cases, but still works.
 
 == More
 
+=== Page breaks with links!
+
+Passing the option <tt>:text_break => "..."</tt> is for mainly decorative purpose. Within the slice (page), the final textual content is complemented by ellipsis or any other symbol you like.
+If we'd like to place the URL link at the end, we can pass static link as well ("Read mode" or something...), but what if we'd like to pass dynamic link generated within the +view+ using the full power of ActionView and +@template+?
+
+So, we have:
+
+  @article = Article.find(1)
+  @article_paged = @article.paged.slice!(params[:slice])
+
+On a View we call <tt>.to_s()</tt> method and pass it the block:
+
+  <%= @article_paged.to_s {|slicer, text| text << link_to("Read more", url_for(url), :class => "read-more")} %>
+
+where:
+* <tt>slicer</tt> is a slicer object itself.
+* <tt>text</tt> is a final textual content of the current slice (page) which we complete with the generated link inside the block code.
+
 === Slicing a general String or ActiveModel (or any other) object
 
 There is no apecific approach to it. Just extend target class to HtmlSlicer::Installer and call the method slice as described before:

data/html_slicer.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
   s.email       = ["addagger@gmail.com"]
   s.homepage    = %q{http://vkvon.ru/projects/html_slicer}
   s.summary     = %q{HTML text pagination for Ruby on Rails}
-  s.description = %q{HtmlSlicer is a smart way to cut an HTML text into pieces. It also provides on option to resize "width"/"height" attributes of HTML tags, such as <iframe>, <object>, <img> or any other.}
+  s.description = %q{HTML truncation & pagination for Rails 3. It also provides on option to resize "width"/"height" HTML tags (also as CSS elements in "style="), such as <iframe>, <object>, <img> or any other.}
   
   s.add_development_dependency "actionpack", ['>= 3.0.0']
   s.add_development_dependency "activesupport", ['>= 3.0.0']

data/lib/html_slicer/cached_stuff.rb

@@ -6,10 +6,11 @@ module HtmlSlicer
   # During the runtime object is used as an +maps+ accessor too.
   
   class CachedStuff
-    attr_reader :hexdigest, :resizing, :slicing
+    attr_reader :version, :hexdigest, :resizing, :slicing
     attr_accessor :changed, :time
     
     def initialize(text = nil)
+      @version = HtmlSlicer::VERSION
       @changed = false
       self.hexdigest_for = text if text
     end

data/lib/html_slicer/interface.rb

@@ -46,7 +46,13 @@ module HtmlSlicer
       @cached_stuff ||= 
       begin
         if options[:cache_to] # Getting recorded hash dump
-          Marshal.load(Base64.decode64(@env.send(options[:cache_to])))
+          Marshal.load(Base64.decode64(@env.send(options[:cache_to]))).tap do |cached_stuff|
+            if cached_stuff.time < Date.new(2012,7,25)
+              #### CACHE OUT OF DATE ####
+              warn "WARNING: html_slicer's cached stuff for #{@env.class.name} records has become unacceptable because of code changes. Update each record again. Visit http://vkvon.ru/projects/html_slicer for further details."
+              raise Exception 
+            end
+          end
         else
           raise Exception
         end
@@ -97,13 +103,9 @@ module HtmlSlicer
       self
     end
 
-    def to_s
+    def to_s(&block)
       load!
-      view(document.root, @current_slice)
-    end
-    
-    def inspect
-      to_s
+      view(document.root, @current_slice, &block)
     end
     
     def method_missing(*args, &block)
@@ -123,16 +125,16 @@ module HtmlSlicer
     # Return the current slice is a last or not?
     def last_slice?
       current_slice == slice_number
-    end    
+    end
 
     private
 
     # Return a textual representation of the node including all children.
-    def view(node, slice)
+    def view(node, slice, &block)
       slice = slice.to_i
       case node
       when HTML::Tag then
-        children_view = node.children.collect {|child| view(child, slice)}.compact.join
+        children_view = node.children.collect {|child| view(child, slice, &block)}.compact.join
         if resized?
           resizing.resize_node(node)
         end
@@ -159,7 +161,14 @@ module HtmlSlicer
       when HTML::Text then
         if sliced?
           if range = slicing.map.get(node, slice)
-            "#{node.content[Range.new(*range)]}#{slicing.options.text_break unless range.last == -1 || !slicing.map.get(node, slice+1)}"
+            (range.is_a?(Array) ? node.content[Range.new(*range)] : node.content).tap do |export|
+              unless range == true || (range.is_a?(Array) && range.last == -1) # broken text
+                export << slicing.options.text_break if slicing.options.text_break
+                if block_given?
+                  yield self, export
+                end
+              end
+            end
           end
         else
           node.to_s
@@ -167,7 +176,7 @@ module HtmlSlicer
       when HTML::CDATA then
         node.to_s
       when HTML::Node then
-        node.children.collect {|child| view(child, slice)}.compact.join
+        node.children.collect {|child| view(child, slice, &block)}.compact.join
       end
     end
 

data/lib/html_slicer/mappers/slicing.rb

@@ -8,6 +8,7 @@ module HtmlSlicer
         include HtmlSlicer::Utilities::NodeIdent
 
         def commit(node, number, value)
+          value = true if value == [0, -1]
           self[node_identify(node)] ||= {}
           self[node_identify(node)].merge!(number => value)
         end
@@ -33,37 +34,33 @@ module HtmlSlicer
       def process_by_text!(root)
         units_count = 0
         parse(root) do |node|
-          if node.is_a?(HTML::Text)
-            if sliceable?(node)
-              sanitize_content!(node)
-              content = node.to_s
-              begin
-                start_index = 0
-                last_index = 0
-                content.scan(@options.unit) do
-                  if $~.begin(0) >= start_index
-                    units_count += 1
-                    index = $~.end(0)
-                    if units_count == @options.maximum
-                      units_count = 0
-                      if complete_regexp = @options.complete
-                        index = content.match(complete_regexp, index).try(:begin, 0)||index
-                        start_index = index
-                      end
-                      @map.commit(node, @slice_number, [last_index, index-1])
-                      last_index = index
-                      limited? ? raise(Exception) : @slice_number += 1
+          if node.is_a?(HTML::Text) && sliceable?(node)
+            sanitize_content!(node)
+            content = node.to_s
+            begin
+              start_index = 0
+              last_index = 0
+              content.scan(@options.unit) do
+                if $~.begin(0) >= start_index
+                  units_count += 1
+                  index = $~.end(0)
+                  if units_count == @options.maximum
+                    units_count = 0
+                    if complete_regexp = @options.complete
+                      index = content.match(complete_regexp, index).try(:begin, 0)||index
+                      start_index = index
                     end
+                    @map.commit(node, @slice_number, [last_index, index-1])
+                    last_index = index
+                    limited? ? raise(Exception) : @slice_number += 1
                   end
                 end
-                if units_count > 0
-                  @map.commit(node, @slice_number, [last_index, -1])
-                end
-              rescue Exception
-                break
               end
-            else
-              @map.commit(node, @slice_number, [0, -1])
+              if units_count > 0
+                @map.commit(node, @slice_number, [last_index, -1])
+              end
+            rescue Exception
+              break
             end
           else
             @map.commit(node, @slice_number, true)
@@ -74,11 +71,7 @@ module HtmlSlicer
       def process_by_node!(root)
         units_count = 0
         parse(root) do |node|
-          if node.is_a?(HTML::Text)
-            @map.commit(node, @slice_number, [0, -1])
-          else
-            @map.commit(node, @slice_number, true)
-          end
+          @map.commit(node, @slice_number, true)
           if node.match(@options.unit) && sliceable?(node)
             units_count += 1
             if units_count == @options.maximum

data/lib/html_slicer/version.rb

@@ -1,3 +1,3 @@
 module HtmlSlicer
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: html_slicer
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-16 00:00:00.000000000 Z
+date: 2012-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -43,9 +43,9 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
-description: HtmlSlicer is a smart way to cut an HTML text into pieces. It also provides
-  on option to resize "width"/"height" attributes of HTML tags, such as <iframe>,
-  <object>, <img> or any other.
+description: HTML truncation & pagination for Rails 3. It also provides on option
+  to resize "width"/"height" HTML tags (also as CSS elements in "style="), such as
+  <iframe>, <object>, <img> or any other.
 email:
 - addagger@gmail.com
 executables: []