Generating permalink from string in Ruby

Dmytro Shteflyuk — Mon, 14 May 2007 15:27:39 +0000

If you are creating Ruby on Rails application like a blog, you most probably want to generate URLs using post titles. It’s good practice, because search engines like keywords in URL, and it looks more human-readable. Just compare: http://example.com/posts/10 and http://example.com/posts/generating-permalinks-from-string (yeah, it’s long, but self-descriptive). Anyways, this is small post about converting a title to a permalink.

First thing I love in Ruby is an ability to extend classes with my own methods. I could just add method to_permalink to any string and then everywhere I could write something like @post.title.to_permalink. It’s amazing!

Here is my version of to_permalink method:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

class String
def to_permalink
result = strip_tags
# Preserve escaped octets.
result.gsub!(/-+/, '-')
result.gsub!(/%([a-f0-9]{2})/i, '--\1--')
# Remove percent signs that are not part of an octet.
result.gsub!('%', '-')
# Restore octets.
result.gsub!(/--([a-f0-9]{2})--/i, '%\1')

result.gsub!(/&.+?;/, '-') # kill entities
result.gsub!(/[^%a-z0-9_-]+/i, '-')
result.gsub!(/-+/, '-')
result.gsub!(/(^-+|-+$)/, '')
return result.downcase
end

private

def strip_tags
return clone if blank?
if index('<')
text = ''
tokenizer = HTML::Tokenizer.new(self)

while token = tokenizer.next
node = HTML::Node.parse(nil, 0, 0, token, false)
# result is only the content of any Text nodes
text << node.to_s if node.class == HTML::Text
end
# strip any comments, and if they have a newline at the end (ie. line with
# only a comment) strip that too
text.gsub(/[\n]?/m, '')
else
clone # already plain text
end
end
end

How it’s working? First thing you would see is a private method strip_tags. Yes, I know about ActionView::Helpers::TextHelper::strip_tags, and this is almost 100% copy of Rails version (the only difference is that my version always returns clone of the original string). I just don’t want to rely on the Rails library.

Then my method replaces all special characters with dashes (only octets like %A0 would be kept), and trims dashed from the beginning and the end of the string. Finally full string will be lowercased.

Of course, in your application you should check collisions (several posts which have the same title should have unique permalinks, for example you could append numbers starting from 1: hello, hello-1, hello-2, etc). This is not my goal to cover all difficulties you could face, it’s small post, do you remember?

Just for your pleasure, here are the RSpec tests for this method:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

describe 'String.to_permalink from extensions.rb' do
it 'should replace all punctuation marks and spaces with dashes' do
"!.@#$\%^&*()Test case\n\t".to_permalink.should == 'test-case'
end

it 'should preserve _ symbol' do
"Test_case".to_permalink.should == 'test_case'
end

it 'should preserve escaped octets and remove redundant %' do
'Test%%20case'.to_permalink.should == 'test-%20case'
end

it 'should strip HTML tags' do
'Test case'.to_permalink.should == 'test-case'
end

it 'should strip HTML entities and insert dashes' do
'Test case'.to_permalink.should == 'test-case'
end

it 'should trim beginning and ending dashes' do
'-. Test case .-'.to_permalink.should == 'test-case'
end

it 'should not use ---aa--- as octet' do
'b---aa---b'.to_permalink.should == 'b-aa-b'
end

it 'should replace % with -' do
'Hello%world'.to_permalink.should == 'hello-world'
end

it 'should not modify original string' do
s = 'Hello, world%20'
s.to_permalink.should == 'hello-world%20'
s.should == 'Hello, world%20'

s = 'Hello'
s.to_permalink.should == 'hello'
s.should == 'Hello'
end
end

It’s funny, right?

The post Generating permalink from string in Ruby first appeared on Dmytro Shteflyuk's Home.

New administrator’s blog has been founded

Dmytro Shteflyuk — Sun, 26 Feb 2006 21:42:00 +0000

My best friend Alexey Kovyrin founded new blog — Homo-Adminus Blog. As he mentioned in our conversation this blog was intended for improve his english skills. I think we’ll find many interesting news and ideas on this page.

Here You will be able to read my notes about my admin’s life, about some interesting news in IT world, maybe some links to interesting web resources.

The post New administrator’s blog has been founded first appeared on Dmytro Shteflyuk's Home.

Links | Dmytro Shteflyuk's Home

Generating permalink from string in Ruby

New administrator’s blog has been founded