JekyllHtmlTruncatewords

WIP: This gem is not ready for production use yet.`

A Jekyll filter to truncate HTML to a specified number of words. The Liquid truncatewords filter can't operate on HTML because it isn't aware of tags. But Jekyll blog posts usually contain HTML, so this makes it difficult to, for example, use the first 50 words of a blog post as the preview. jekyll_html_truncatewords solves that problem. It works the same as truncatewords, but it is aware of HTML tags so it counts words correctly within HTML and won't break HTML.

Installation

This is a Jekyll plugin, and can be installed using any of the supported methods.

We recommend simply adding the gem to the :jekyll_plugins group in your Gemfile:

group :jekyll_plugins do
  gem 'jekyll_html_truncatewords', '~> 0.1'
end

Usage

{{ post.content | html_truncatewords: 50 }}

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/mkasberg/jekyll_html_truncatewords.

License

The gem is available as open source under the terms of the MIT License.