ragadjust 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8b9adc04576f171cf9c4c6083dd77cb3a4c6405c
+  data.tar.gz: ccb09b86ef96d2fedcd1c7ddc67e13e08ecdc6ae
+SHA512:
+  metadata.gz: da9ca50b1b6138c211ec192d52177b79a9b8cd894d6d2f6294e4dc0dc25b70a819fff2e06b16a0c215a353817771afbe85c8b800c48d6459afe44168575bc6a1
+  data.tar.gz: ea343d4ce197007782587202f8e80860df02769f9cfb1e4a7303d478d92b77f43c3114cdb4681532e062e30e85252feac5cfae998fdb63a2da690a1755b5450e

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Adam Perfect
+
+MIT License
+
+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.md

@@ -0,0 +1,41 @@
+# Ragadjust
+
+Gem to rag-adjust text content based on Mark Boulton's 24ways article: http://24ways.org/2013/run-ragged/ and Nathan Ford's JS implementation: https://github.com/nathanford/ragadjust
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ragadjust', github: 'aperfect/ragadjust'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ragadjust
+
+## Usage
+
+    Ragadjust::Adjust.ragadjust_content(text_to_adjust, selector, method = 'all')
+
+`selector` takes a CSS selector and defaults to:
+
+     'p, li, dd, figcaption'
+
+`method` options:
+
+    'all' - default: apply adjustment to all the below
+    'prepositions' - only rag-adjust prepositions
+    'small-words' - only adjust 1-/2-letter words
+    'dashes' - only adjust space after dashes
+    'emphasis' - only adjust within emphasis tags (em, strong, i, b)
+
+## Contributing
+
+1. Fork it ( https://github.com/aperfect/ragadjust/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

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

data/lib/ragadjust/adjust.rb

@@ -0,0 +1,73 @@
+require 'nokogiri'
+
+module Ragadjust
+
+  class Adjust
+
+    # Rag-adjust the content. Based on Nathan Ford's ragadjust JS
+    # https://github.com/nathanford/ragadjust
+    def self.ragadjust_content(text_to_adjust, selector = 'p, li, dd, figcaption', method = 'all')
+      html = Nokogiri::HTML(text_to_adjust) # Not using .fragment() as .search() doesn't seem to work?
+
+      preps = /(?<=\s|^|;)((aboard|about|above|across|after|against|along|amid|among|anti|around|before|behind|below|beneath|beside|besides|between|beyond|concerning|considering|despite|down|during|except|excepting|excluding|following|from|inside|into|like|minus|near|onto|opposite|outside|over|past|plus|regarding|round|save|since|than|that|this|through|toward|towards|under|underneath|unlike|until|upon|versus|with|within|without)\s)+/i
+          
+      smallwords = /(?<=\s|^|;)\b(([[:word:]]{1,2})\b\s)/i
+      
+      dashes = /([-–—])\s/i
+
+    
+      elements = html.css(selector)
+
+      elements.search('//text()').each do |node|
+
+        if node.text?
+          content = node.content
+
+          # prepositions
+          if %w{prepositions all}.include? method
+            content = content.gsub preps, '\2'+nbsp
+          end
+
+          # small words
+          if %w{small-words all}.include? method
+            content = content.gsub smallwords, '\2'+nbsp
+          end
+
+          # dashes
+          if %w{dashes all}.include? method
+            content = content.gsub dashes, '\1'+nbsp
+          end
+
+          node.content = content
+        end
+
+      end
+
+      # emphasized text
+      if %w{emphasis all}.include? method
+        elements.css('strong,em,b,i').each do |el|
+          # Only emphasized phrases of 2/3 words
+          s = el.content.split.size
+          if s > 1 && s < 4
+            # Get text nodes
+            el.search('//text()').each do |n|
+              if n.text?
+                Ragadjust::Adjust.text_node_replace n, /\s+/, nbsp
+              end
+            end
+          end
+        end # elements.css().each
+      end
+
+      html.css('body').inner_html
+
+    end # def self.ragadjust_content
+
+    def self.nbsp
+      ' '
+    end
+
+
+  end
+
+end

data/lib/ragadjust/version.rb

@@ -0,0 +1,3 @@
+module Ragadjust
+  VERSION = "0.0.2"
+end

data/lib/ragadjust.rb

@@ -0,0 +1,6 @@
+require "ragadjust/version"
+require "ragadjust/adjust"
+
+module Ragadjust
+  # Your code goes here...
+end

data/ragadjust.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ragadjust/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ragadjust"
+  spec.version       = Ragadjust::VERSION
+  spec.authors       = ["Adam Perfect"]
+  spec.email         = ["gems@adamperfect.com"]
+  spec.summary       = "Apply rag-adjustment to HTML content"
+  spec.description   = "Gem to rag-adjust text content based on Mark Boulton's 24ways article: http://24ways.org/2013/run-ragged/ and Nathan Ford's JS implementation: https://github.com/nathanford/ragadjust"
+  spec.homepage      = "https://github.com/aperfect/ragadjust"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+
+  spec.add_runtime_dependency "nokogiri"
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: ragadjust
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Adam Perfect
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'Gem to rag-adjust text content based on Mark Boulton''s 24ways article:
+  http://24ways.org/2013/run-ragged/ and Nathan Ford''s JS implementation: https://github.com/nathanford/ragadjust'
+email:
+- gems@adamperfect.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/ragadjust.rb
+- lib/ragadjust/adjust.rb
+- lib/ragadjust/version.rb
+- ragadjust.gemspec
+homepage: https://github.com/aperfect/ragadjust
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Apply rag-adjustment to HTML content
+test_files: []