html_slicer 0.0.4

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/CHANGELOG

@@ -0,0 +1,16 @@
+== 0.0.4
+
+* Bugfixes: with param names again... sorry
+
+== 0.0.3
+
+* Bugfixes: block-style configuration return blank hash (override Hash::slice method)
+* Bugfixes: inherited configuration isn't pure (added deepcopy method of Hash/Array)
+
+== 0.0.2
+
+* Added :text_break slicing option.
+
+== 0.0.1
+
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in html_slicer.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Valery Kvon
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,336 @@
+= HtmlSlicer
+
+A little gem for Rails 3 helps you to implement smart way to split textual content, the quick approach to create 'pageable' views for ActiveRecord Model's attributes or just independent strings or any other Ruby classes.
+Or course it can split HTML content. More over, it can 'resize' HTML tags having <tt>width=</tt> attribute*.
+
+  * Imagine you want to resize <iframe> embeddings from YouTube saved in static content.
+
+
+== Features
+
+=== Clean
+Does not globally pollute +Array+, +Hash+, +Object+ or <tt>AR::Base</tt>.
+
+=== Easy to use
+Bundle the gem, then your models are ready to implement slicing ability.
+
+=== Flexible configuration
+Besides global configuration (default), you can create stylized app-level configurations, also any configuration can be tuned for each single one implementation.
+
+=== Flexible options
+You can split your text by any Regexp clause, set up which node of HTML content you want to split, or which you don't. You can also use <tt>processor(s)</tt> to transform the content before it has to be sliced. Param name, used as slice number key accessor, supports to be nested in other one param key (nested params).
+<tt>Resizing</tt> HTML tags having <tt>width=</tt> attribute - is a nice feature too.
+
+=== ORM & template engine agnostic
+Supports Rails 3 and multiple template engines (ERB, Haml).
+
+=== Modern
+The slicer helper outputs the HTML5 <nav> tag by default. Plus, the helper supports Rails 3 unobtrusive Ajax.
+
+
+== Supported versions
+
+* Ruby 1.9.2, 1.9.3
+
+* Rails 3.0.x, 3.1, 3.2
+
+* Haml 3+
+
+
+== Install
+
+Put this line in your Gemfile:
+  gem 'html_slicer'
+
+Then bundle:
+  % bundle
+
+
+== Implementation
+
+=== Basic approach
+
+  slice <method_name>, <configuration>, [:config => <:style>]*
+
+where: 
+* <method_name> - any method or local variable which returns source String (can be called with .send()).
+* <configuration> - Hash of configuration options and/or +:config+ parameter.
+
+=== Basic example
+
+  class Article < ActiveRecord::Base
+    slice :content, :as => :paged, :slice => {:maximum => 20}, :resize => {:width => 300}
+  end
+  
+where:
+* <tt>:content</tt> is an attribute accessor for Article which return a target String object.
+* <tt>:as</tt> is a name of basic accessor for result.
+* <tt>:slice</tt> is a hash of <tt>slicing options</tt> as a part of configuration.
+* <tt>:resize</tt> is a hash of <tt>resizing options</tt> as a part of configuration.
+
+You can define any key of configuration you want. Otherwise, default configuration options (if available) will be picked up automatically.
+  
+Console:
+  
+  @article = Article.find(1)
+  @article.content
+  # => "Words like violence break the silence\r\nCome crashing in into my little world\r\n<iframe width=\"560\" height=\"315\" src=\"http://www.youtube.com/embed/ms0bd_hCZsk\" frameborder=\"0\" allowfullscreen></iframe>\r\nPainful to me, pierce right through me\r\nCan't you understand, oh my little girl?"
+  
+  @article_paged = @article.paged
+  # => "Words like violence bre"
+
+* the +nil+ argument assumes it is number +1+.
+  
+  @article_paged.slice!(2)
+  # => "ak the silence"
+  
+  * the passed slice number is remembered.
+  
+  @article_paged.slice!(4)
+  # => "rld
+  <iframe width="300" height="169" src="http://www.youtube.com/embed/ms0bd_hCZsk" frameborder="0" allowfullscreen></iframe>"
+
+=== Configuration options
+
+All configuration keys:
+* <tt>:as</tt> is a name of basic accessor for sliced +object+ (result).
+* <tt>:slice</tt> is a hash of slicing options.
+* <tt>:resize</tt> is a hash of resizing options.
+* <tt>:processors</tt> - processors names.
+* <tt>:window</tt> - parameter for ActionView: The "inner window" size (4 by default).
+* <tt>:outer_window</tt> - parameter for ActionView: The "outer window" size (0 by default).
+* <tt>:left</tt> - parameter for ActionView: The "left outer window" size (0 by default).
+* <tt>:right</tt> - parameter for ActionView: The "right outer window" size (0 by default).
+* <tt>:params</tt> - parameter for ActionView: url_for parameters for the links (:controller, :action, etc.)
+* <tt>:param_name</tt> - parameter for ActionView: parameter name for slice number in the links. Accepts +Symbol+, +String+, +Array+.
+* <tt>:remote</tt> - parameter for ActionView: Ajax? (false by default)
+
+* <tt>:config</tt> - special key for using stylized configuration (premature configuration).
+
+=== Slicing options
+
+* <tt>:unit</tt> is a +Regexp/String/Hash+ description of text's units counted to split the text by slices.
+When value is a +Hash+, it assumes the unit is a HTML tag (look at <tt>:only/:except</tt> options for details).
+Undefined value or +nil+ assumes it default Regexp /&#?\w+;|\S/. As you see it counts any regular character/or HTML special character as a unit.
+* <tt>:maximum</tt> is a +Fixnum+ number of units to be a one slice.
+
+If +:unit+ defined as Regexp or String, default value is 300.
+
+If +:unit+ defined as Hash, default value is 10.
+
+If +:unit+ is default, default value is 2000.
+
+* <tt>:complete</tt> is a +Regexp+ description of a character used to complete the slice.
+For example in case you want to end the slice with the complete word, using :complete => /\s+|\z/ the counter would continue the slice until the first whitespace character.
+* <tt>:limit</tt> - a +Fixnum+ limit number of slices.
+In many cases we just need the first slice to perform it as a partial.
+* <tt>:text_break</tt> - a responsible <tt>.to_s</tt> value of text breaks between slices.
+It can be suspension points or any other symbol.
+* <tt>:only</tt> is a +Hash+ or +Array+ of hashes, describes which exactly nodes of HTML content to slice.*
+* <tt>:except</tt> is a +Hash+ or +Array+ of hashes, describes which exactly nodes of HTML content NOT to slice.*
+
+  * Actually the hash is a argument for HTML::Conditions class (the part of ActionPack's html_scanner block). Look at http://github.com/rails/rails/blob/master/actionpack/lib/action_controller/vendor/html-scanner/html/node.rb
+  This is a very flexible utility to navigate via HTML content. Read native documentation for details.
+  
+  For example: ID for <tt><hr class="break"> tag</tt> is a hash: <tt>{:tag => "hr", :attributes => {:class => "break"}}</tt>
+
+=== Resizing options
+
+* <tt>:width</tt> is a Fixnum number of pixels as a target value to squeeze the HTML tag. It does automatically proportional with the +:height+ (if existed). The percentage values ignored.
+* <tt>:only</tt> is a +Hash+ or +Array+ of hashes, describes which exactly nodes of HTML content to resize.
+* <tt>:except</tt> is a +Hash+ or +Array+ of hashes, describes which exactly nodes of HTML content NOT to resize.
+
+=== Processors
+
+Used to transform the source text before it sliced. Many of us are using any markup languages for dynamic contents.
+This is it. Just create any class as a subclass of HtmlSlicer::Processor, put it in +/lib/html_slicer_processors+ directory and define its name within the +:processors+ option.
+
+Example:
+  
+  # /lib/html_slicer_processors/textilized.rb:
+
+  class Textilized < HtmlSlicer::Processor
+    def make
+      ERB::Util.textilize(content)
+    end
+  end
+
+Processor class have to include +make+ method, which return transformed String. The +content+ accessor is a source String.
+
+Then you can pass the option <tt>:processors=>:textilized</tt>
+The value of option can be +Array+ of names, if you use more than one processors.
+
+=== Configuration levels
+
+There are three levels of configuration. Missing options inherited from upper-level.
+
+=== Global configuration
+
+The top-level configuration at +HtmlSlicer.config+, set required options:
+
+  window = 4
+  outer_window = 0
+  left = 0
+  right = 0
+  param_name = :slice
+
+You can override/complete global configuration like:
+
+  HtmlSlicer.configure do |config|
+    config.slice = {:complete => /\s+|\z/, :maximum => 2000}
+    config.resize = {:width => 300, :only => {:tag => 'iframe'}}
+    config.window = 5
+    config.param_name = :any_other_param_name
+  end
+
+=== Stylized configuration
+
+Along with common global configuration, you can define stylized configuration passing argument like:
+
+  HtmlSlicer.configure(:paged) do |config|
+    config.as = :page
+    config.param_name = :page
+  end
+
+Missing options inherited from global.
+
+=== Instance configuration
+  
+Implementing HtmlSlicer accessor as:
+
+  slice <method_name>, <configuration>, [:config => <:style>]*
+
+we can override/complete any configuration.
+  
+Using +:config+ key we can use one of stylized configurations like:
+  
+  class Post < ActiveRecord::Base
+    slice :content, :config => :paged, :slice = {:complete => /\s+/, :maximum => 3000}
+  end
+
+Passing the block we get more flexible approach to configure slicer like:
+  
+  class Post < ActiveRecord::Base
+    slice :content, :config => :paged, :as => :blabla do |config|
+      config.slice[:maximum] = 3000 
+      config.resize.merge! :only => {:tag => "p"}
+      config.processors << :decorated
+    end
+  end
+
+== Views
+
+=== Presumption
+
+Model:
+
+  class Article < ActiveRecord::Base
+    slice :content, :as => :paged, :slice => {:maximum => 1000, :complete => /\s+|\z/}
+  end
+
+Controller:
+
+  @article = Article.find(1)
+  @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.
+
+=== Helpers
+
+* the +slice+ helper method
+
+    <%= slice @article_paged %>
+  This would output several slicing links such as <tt>« First ‹ Prev ... 2 3 4 5 6 7 8 9 10 ... Next › Last »</tt>
+
+* specifing the "inner window" size (4 by default)
+
+    <%= slicing @article_paged, :window => 2 %>
+  This would output something like <tt>... 5 6 7 8 9 ...</tt> when 7 is the current page.
+
+* specifing the "outer window" size (0 by default)
+
+    <%= slicing @article_paged, :outer_window => 3 %>
+  This would output something like <tt>1 2 3 4 ...(snip)... 17 18 19 20</tt> while having 20 slices in total.
+
+* outer window can be separetely specified by +left+, +right+ (0 by default)
+
+    <%= slicing @article_paged, :left => 1, :right => 3 %>
+  This would output something like <tt>1 ...(snip)... 18 19 20</tt> while having 20 slices in total.
+
+* changing the parameter name (+:param_name+) for the links
+
+    <%= slicing @article_paged, :param_name => :page %>
+  This would modify the query parameter name on each links.
+
+* extra parameters (:+params+) for the links
+
+    <%= slicing @article_paged, :params => {:controller => 'foo', :action => 'show', :id => 21} %>
+  This would modify each link's +url_option+. :+controller+ and :+action+ might be the keys in common.
+
+* Ajax links (crazy simple, but works perfectly!)
+
+    <%= slicing @article_paged, :remote => true %>
+  This would add <tt>data-remote="true"</tt> to all the links inside.
+
+* the +link_to_next_page+ helper method
+
+    <%= link_to_next_slice @article_paged, 'Next Page' %>
+  This simply renders a link to the next slice. This would be helpful for creating "Twitter like" pagination feature.
+
+* the +slice_entries_info+ helper method
+
+    <%= slice_entries_info @users %>
+  This renders a helpful message with numbers of displayed vs. total entries.
+
+=== I18n and labels
+
+The default labels for 'first', 'last', 'previous', '...' and 'next' are stored in the I18n yaml inside the engine, and rendered through I18n API. You can switch the label value per I18n.locale for your internationalized application.
+Keys and the default values are the following. You can override them by adding to a YAML file in your <tt>Rails.root/config/locales</tt> directory.
+
+  en:
+    views:
+      html_slicer:
+        first: "&laquo; First"
+        last: "Last &raquo;"
+        previous: "&lsaquo; Prev"
+        next: "Next &rsaquo;"
+        truncate: "..."
+
+=== Param name
+
+You can define +:param_name+ as a +symbol+ or +string+, or as an +array+ of any object that responses +.to_s+ method and returns +string+.
+Passing +array+ is the way to define nested :param_name.
+
+Examples:
+
+  :param_name => :page
+  # means you define params[:page] as a slice key.
+
+  :param_name => [:article, :page]
+  # means you define params[:article][:page] as a slice key.
+
+== More
+
+=== Slicing a general String or ActiveModel (or any other) object
+
+There is no special approaches. Just +extend+ target class to +HtmlSlicer::Installer+ and call the method +slice+ as described before, like:
+
+  String.extend HtmlSlicer::Installer
+  String.slice :to_s, :as => :page, :config => :for_string
+
+== Questions, Feedback
+
+Message me, I'll try to help everybody. Github (addagger), no Twitter account, Facebook (http://www.facebook.com/profile.php?id=100002178326782)
+
+
+== Contributing to HtmlSlicer
+
+* Fork, fix, then send me a pull request.
+
+
+== Copyright
+
+Copyright (c) 2012 Valery Kvon. See MIT-LICENSE for further details.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/app/views/html_slicer/_first_slice.html.erb

@@ -0,0 +1,10 @@
+<%# Link to the "First" slice
+  - available local variables
+    url:           url to the first slice
+    current_slice: a slice object for the currently displayed slice
+    slice_number:  total number of slices
+    remote:        data-remote
+-%>
+<span class="first">
+  <%= link_to_unless current_slice.first?, raw(t 'views.html_slicer.first'), url, :remote => remote %>
+</span>

data/app/views/html_slicer/_first_slice.html.haml

@@ -0,0 +1,8 @@
+-#  Link to the "First" slice
+-#  available local variables
+-#    url:           url to the first slice
+-#    current_slice: a slice object for the currently displayed slice
+-#    slice_number:  total number of slices
+-#    remote:        data-remote
+%span.first
+  = link_to_unless current_slice.first?, raw(t 'views.html_slicer.first'), url, :remote => remote

data/app/views/html_slicer/_first_slice.html.slim

@@ -0,0 +1,9 @@
+/ Link to the "First" slice
+  - available local variables
+    url           : url to the first slice
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span.first
+  == link_to_unless current_slice.first?, raw(t 'views.html_slicer.first'), url, :remote => remote
+'

data/app/views/html_slicer/_gap.html.erb

@@ -0,0 +1,7 @@
+<%# Non-link tag that stands for skipped slices...
+  - available local variables
+    current_slice:  a slice object for the currently displayed slice
+    slice_number:   total number of slices
+    remote:         data-remote
+-%>
+<span class="slice gap"><%= raw(t 'views.html_slicer.truncate') %></span>

data/app/views/html_slicer/_gap.html.haml

@@ -0,0 +1,7 @@
+-#  Non-link tag that stands for skipped slices...
+-#  available local variables
+-#    current_slice:  a slice object for the currently displayed slice
+-#    slice_number:   total number of slices
+-#    remote:         data-remote
+%span.slice.gap
+  = raw(t 'views.html_slicer.truncate')

data/app/views/html_slicer/_gap.html.slim

@@ -0,0 +1,8 @@
+/ Non-link tag that stands for skipped slices...
+  - available local variables
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span.slice.gap
+  == raw(t 'views.html_slicer.truncate')
+'

data/app/views/html_slicer/_last_slice.html.erb

@@ -0,0 +1,10 @@
+<%# Link to the "Last" slice
+  - available local variables
+    url:           url to the last slice
+    current_slice: a slice object for the currently displayed slice
+    slice_number:  total number of slices
+    remote:        data-remote
+-%>
+<span class="last">
+  <%= link_to_unless current_slice.last?, raw(t 'views.html_slicer.last'), url, {:remote => remote} %>
+</span>

data/app/views/html_slicer/_last_slice.html.haml

@@ -0,0 +1,8 @@
+-#  Link to the "Last" slice
+-#  available local variables
+-#    url:           url to the last slice
+-#    current_slice: a slice object for the currently displayed slice
+-#    slice_number:  total number of slices
+-#    remote:        data-remote
+%span.last
+  = link_to_unless current_slice.last?, raw(t 'views.html_slicer.last'), url, {:remote => remote}

data/app/views/html_slicer/_last_slice.html.slim

@@ -0,0 +1,9 @@
+/ Link to the "Last" slice
+  - available local variables
+    url           : url to the last slice
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span.last
+  == link_to_unless current_slice.last?, raw(t 'views.html_slicer.last'), url, {:remote => remote}
+'

data/app/views/html_slicer/_next_slice.html.erb

@@ -0,0 +1,10 @@
+<%# Link to the "Next" slice
+  - available local variables
+    url:           url to the next slice
+    current_slice: a slice object for the currently displayed slice
+    slice_number:  total number of slices
+    remote:        data-remote
+-%>
+<span class="next">
+  <%= link_to_unless current_slice.last?, raw(t 'views.html_slicer.next'), url, :rel => 'next', :remote => remote %>
+</span>

data/app/views/html_slicer/_next_slice.html.haml

@@ -0,0 +1,8 @@
+-#  Link to the "Next" slice
+-#  available local variables
+-#    url:           url to the next slice
+-#    current_slice: a slice object for the currently displayed slice
+-#    slice_number:  total number of slices
+-#    remote:        data-remote
+%span.next
+  = link_to_unless current_slice.last?, raw(t 'views.html_slicer.next'), url, :rel => 'next', :remote => remote

data/app/views/html_slicer/_next_slice.html.slim

@@ -0,0 +1,9 @@
+/ Link to the "Next" slice
+  - available local variables
+    url           : url to the next slice
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span.next
+  == link_to_unless current_slice.last?, raw(t 'views.html_slicer.next'), url, :rel => 'next', :remote => remote
+'

data/app/views/html_slicer/_prev_slice.html.erb

@@ -0,0 +1,10 @@
+<%# Link to the "Previous" slice
+  - available local variables
+    url:           url to the previous slice
+    current_slice: a slice object for the currently displayed slice
+    slice_number:  total number of slices
+    remote:        data-remote
+-%>
+<span class="prev">
+  <%= link_to_unless current_slice.first?, raw(t 'views.html_slicer.previous'), url, :rel => 'prev', :remote => remote %>
+</span>

data/app/views/html_slicer/_prev_slice.html.haml

@@ -0,0 +1,8 @@
+-#  Link to the "Previous" slice
+-#  available local variables
+-#    url:           url to the previous slice
+-#    current_slice: a slice object for the currently displayed slice
+-#    slice_number:  total number of slices
+-#    remote:        data-remote
+%span.prev
+  = link_to_unless current_slice.first?, raw(t 'views.html_slicer.previous'), url, :rel => 'prev', :remote => remote

data/app/views/html_slicer/_prev_slice.html.slim

@@ -0,0 +1,9 @@
+/ Link to the "Previous" slice
+  - available local variables
+    url           : url to the previous slice
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span.prev
+  == link_to_unless current_slice.first?, raw(t 'views.html_slicer.previous'), url, :rel => 'prev', :remote => remote
+'

data/app/views/html_slicer/_slice.html.erb

@@ -0,0 +1,11 @@
+<%# Link showing slice number
+  - available local variables
+    slice:          a slice object for "this" slice
+    url:            url to this slice
+    current_slice:  a slice object for the currently displayed slice
+    slice_number:   total number of slices
+    remote:         data-remote
+-%>
+<span class="slice<%= ' current' if slice.current? %>">
+  <%= link_to_unless slice.current?, slice, url, opts = {:remote => remote, :rel => slice.next? ? 'next' : slice.prev? ? 'prev' : nil} %>
+</span>

data/app/views/html_slicer/_slice.html.haml

@@ -0,0 +1,9 @@
+-#  Link showing slice number
+-#  available local variables
+-#    slice:          a slice object for "this" slice
+-#    url:            url to this slice
+-#    current_slice:  a slice object for the currently displayed slice
+-#    slice_number:   total number of slices
+-#    remote:         data-remote
+%span{:class => "slice#{' current' if slice.current?}"}
+  = link_to_unless slice.current?, slice, url, {:remote => remote, :rel => slice.next? ? 'next' : slice.prev? ? 'prev' : nil}

data/app/views/html_slicer/_slice.html.slim

@@ -0,0 +1,10 @@
+/ Link showing slice number
+  - available local variables
+    slice         : a slice object for "this" slice
+    url           : url to this slice
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+span class="slice#{' current' if slice.current?}"
+  == link_to_unless slice.current?, slice, url, {:remote => remote, :rel => slice.next? ? 'next' : slice.prev? ? 'prev' : nil}
+'

data/app/views/html_slicer/_slicer.html.erb

@@ -0,0 +1,22 @@
+<%# The container tag
+  - available local variables
+    current_slice:  a slice object for the currently displayed slice
+    slice_number:   total number of slices
+    remote:         data-remote
+    slicer:         the slicer that renders the slicer tags inside
+-%>
+<%= slicer.render do -%>
+  <nav class="slicer">
+    <%= first_slice_tag unless current_slice.first? %>
+    <%= prev_slice_tag unless current_slice.first? %>
+    <% each_slice do |slice| -%>
+      <% if slice.left_outer? || slice.right_outer? || slice.inside_window? -%>
+        <%= slice_tag slice %>
+      <% elsif !slice.was_truncated? -%>
+        <%= gap_tag %>
+      <% end -%>
+    <% end -%>
+    <%= next_slice_tag unless current_slice.last? %>
+    <%= last_slice_tag unless current_slice.last? %>
+  </nav>
+<% end -%>

data/app/views/html_slicer/_slicer.html.haml

@@ -0,0 +1,17 @@
+-#  The container tag
+-#  available local variables
+-#    current_slice:  a slice object for the currently displayed slice
+-#    slice_number:   total number of slices
+-#    remote:         data-remote
+-#    slicer:         the slicer that renders the slicer tags inside
+= slicer.render do
+  %nav.slicer
+    = first_slice_tag unless current_slice.first?
+    = prev_slice_tag unless current_slice.first?
+    - each_slice do |slice|
+      - if slice.left_outer? || slice.right_outer? || slice.inside_window?
+        = slice_tag slice
+      - elsif !slice.was_truncated?
+        = gap_tag
+    = next_slice_tag unless current_slice.last?
+    = last_slice_tag unless current_slice.last?

data/app/views/html_slicer/_slicer.html.slim

@@ -0,0 +1,18 @@
+/ The container tag
+  - available local variables
+    current_slice : a slice object for the currently displayed slice
+    slice_number  : total number of slices
+    remote        : data-remote
+    slicer        : the slicer that renders the slicer tags inside
+
+== slicer.render do
+  nav.slicer
+    == first_slice_tag unless current_slice.first?
+    == prev_slice_tag unless current_slice.first?
+    - each_slice do |slice|
+      - if slice.left_outer? || slice.right_outer? || slice.inside_window?
+        == slice_tag slice
+      - elsif !slice.was_truncated?
+        == gap_tag
+    == next_slice_tag unless current_slice.last?
+    == last_slice_tag unless current_slice.last?

data/config/locales/html_slicer.yml

@@ -0,0 +1,8 @@
+en:
+  views:
+    html_slicer:
+      first: "« First"
+      last: "Last »"
+      previous: "‹ Prev"
+      next: "Next ›"
+      truncate: "..."