truncateHTML 0.0.1 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.md +38 -0
- data/lib/truncateHTML.rb +2 -2
- data/lib/truncateHTML/version.rb +1 -1
- metadata +5 -11
data/README.md
ADDED
@@ -0,0 +1,38 @@
|
|
1
|
+
truncateHTML
|
2
|
+
==============
|
3
|
+
`truncateHTML` truncates text like the Rails `truncate` helper but doesn't break HTML tags, entities, and optionally words.
|
4
|
+
|
5
|
+
Installation
|
6
|
+
------------
|
7
|
+
|
8
|
+
The `truncateHTML` gem can be installed by running:
|
9
|
+
|
10
|
+
gem install truncateHTML
|
11
|
+
|
12
|
+
Usage
|
13
|
+
-----
|
14
|
+
|
15
|
+
require 'rubygems'
|
16
|
+
require 'truncateHTML'
|
17
|
+
|
18
|
+
A string `html_string` can be truncated by running:
|
19
|
+
|
20
|
+
truncateHTML.truncate(`html_string`)
|
21
|
+
|
22
|
+
The following options can be passed to the `trucate` method:
|
23
|
+
|
24
|
+
- `:max_length` The maximum length of the out put. Defaults to 40
|
25
|
+
- `:ellipsis` The last few characters , in case the string is truncated. Defaults to `...`
|
26
|
+
- `:words` Splicing words will be avoided if set to ttrue. Defaults to false.
|
27
|
+
- `:link` A link will be appended to the truncated string if explicitely passed. Its by default nil.
|
28
|
+
|
29
|
+
Author
|
30
|
+
------
|
31
|
+
|
32
|
+
B V Satyaram <[bvsatyaram.com](http://bvsatyaram.com)>
|
33
|
+
|
34
|
+
- Initially authored By Henrik Nyh <[henrik.nyh.se](http://henrik.nyh.se)> 2008-01-30. Free to modify and redistribute with credit.
|
35
|
+
- Modified by Dave Nolan <[textgoeshere.org.uk](http://textgoeshere.org.uk)> 2008-02-06. Ellipsis appended to text of last HTML node. Ellipsis inserted after final word break
|
36
|
+
- Modified by Mark Dickson <mark@sitesteaders.com> 2008-12-18. Option to truncate to last full word. Option to include a 'more' link. Check for nil last child
|
37
|
+
- Modified by Ken-ichi Ueda <[kueda.net](http://kueda.net)> 2009-09-02. Rails 2.3 compatability (chars -> mb_chars), via Henrik. Hpricot 0.8 compatability (avoid dup on Hpricot::Elem)
|
38
|
+
- Modified by B V Satyaram <[bvsatyaram.com](http://bvsatyaram.com)> 2011-03-24. Rails version independent. Making this a gem. Removed mb_chars
|
data/lib/truncateHTML.rb
CHANGED
@@ -23,7 +23,7 @@ require "hpricot"
|
|
23
23
|
require "truncateHTML/hpricot_truncator"
|
24
24
|
|
25
25
|
module TruncateHTML
|
26
|
-
# Like the Rails _truncate_ helper but doesn't break HTML tags, entities, and optionally
|
26
|
+
# Like the Rails _truncate_ helper but doesn't break HTML tags, entities, and optionally words.
|
27
27
|
def self.truncate(text, options={})
|
28
28
|
return if text.nil?
|
29
29
|
|
@@ -57,4 +57,4 @@ module TruncateHTML
|
|
57
57
|
|
58
58
|
return status ? [return_string, return_status] : return_string
|
59
59
|
end
|
60
|
-
end
|
60
|
+
end
|
data/lib/truncateHTML/version.rb
CHANGED
metadata
CHANGED
@@ -1,13 +1,12 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: truncateHTML
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
hash: 29
|
5
4
|
prerelease: false
|
6
5
|
segments:
|
6
|
+
- 1
|
7
7
|
- 0
|
8
8
|
- 0
|
9
|
-
|
10
|
-
version: 0.0.1
|
9
|
+
version: 1.0.0
|
11
10
|
platform: ruby
|
12
11
|
authors:
|
13
12
|
- Satyaram B V
|
@@ -15,18 +14,16 @@ autorequire:
|
|
15
14
|
bindir: bin
|
16
15
|
cert_chain: []
|
17
16
|
|
18
|
-
date: 2011-
|
17
|
+
date: 2011-05-04 00:00:00 +05:30
|
19
18
|
default_executable:
|
20
19
|
dependencies:
|
21
20
|
- !ruby/object:Gem::Dependency
|
22
21
|
name: hpricot
|
23
22
|
prerelease: false
|
24
23
|
requirement: &id001 !ruby/object:Gem::Requirement
|
25
|
-
none: false
|
26
24
|
requirements:
|
27
25
|
- - ">="
|
28
26
|
- !ruby/object:Gem::Version
|
29
|
-
hash: 3
|
30
27
|
segments:
|
31
28
|
- 0
|
32
29
|
version: "0"
|
@@ -44,6 +41,7 @@ extra_rdoc_files: []
|
|
44
41
|
files:
|
45
42
|
- .gitignore
|
46
43
|
- Gemfile
|
44
|
+
- README.md
|
47
45
|
- Rakefile
|
48
46
|
- lib/truncateHTML.rb
|
49
47
|
- lib/truncateHTML/hpricot_truncator.rb
|
@@ -60,27 +58,23 @@ rdoc_options: []
|
|
60
58
|
require_paths:
|
61
59
|
- lib
|
62
60
|
required_ruby_version: !ruby/object:Gem::Requirement
|
63
|
-
none: false
|
64
61
|
requirements:
|
65
62
|
- - ">="
|
66
63
|
- !ruby/object:Gem::Version
|
67
|
-
hash: 3
|
68
64
|
segments:
|
69
65
|
- 0
|
70
66
|
version: "0"
|
71
67
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
72
|
-
none: false
|
73
68
|
requirements:
|
74
69
|
- - ">="
|
75
70
|
- !ruby/object:Gem::Version
|
76
|
-
hash: 3
|
77
71
|
segments:
|
78
72
|
- 0
|
79
73
|
version: "0"
|
80
74
|
requirements: []
|
81
75
|
|
82
76
|
rubyforge_project: truncateHTML
|
83
|
-
rubygems_version: 1.3.
|
77
|
+
rubygems_version: 1.3.6
|
84
78
|
signing_key:
|
85
79
|
specification_version: 3
|
86
80
|
summary: Truncate HTML without breaking HTML tags, entities, and optionally words
|