Repository is archived
No commit activity in last 3 years
No release in over 3 years
Jekyll Hyphenation Filter
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 3.0

Runtime

 Project Readme

Jekyll HyphenateFilter

Jekyll Liquid filter to apply Text::Hyphen to content.

Installation

Install the jekyll-hyphenate_filter gem in a Jekyll-approved manner.

Use

To hyphenate content, you can use the filter like this:

{{ content | hyphenate }}

Configuration

There are a few configurable parameters which control hyphenation behavior. These parameters are language, left, and right. These take the same values as Text::Hyphen. In brief:

  • language - language of the content. Defaults to en_us.
  • left - minimum number of characters to the left of the hyphen. Defaults to 2.
  • right - minimum number of characters to the right of the hyphen. Defaults to 2.

In addition, you can specify the string used to indicate hyphenation points with the hyphen parameter. The default is the UTF-8 soft-hyphen character (Unicode code U+00AD). Note that this is the UTF-8 character, not an entity.

You can update _config.yml to set these parameters. For example:

hyphenate_filter:
  language: en_uk
  left: 4
  right: 3
  hyphen: "­"

This configuration sets the language to UK English, with a minimum of 4 characters to the left of the hyphenation, minimum 3 characters to the right, and the HTML entity ­ to indicate hyphenation points.

Notes

HyphenateFilter builds upon the Jekyll::HyphenateFilter from Jekyll plugins by Aucor.

Two behavior differences between the Aucor Oy filter (as of 2013-09-20) and the one provided here:

  • This filter will descend into subelements (such as tags). Paragraphs containing tags is effectively skipped by the Aucor Oy filter.
  • The Aucor Oy filter rightly does not hyphenate the final word of a paragraph. However, all instances of that word in the paragraph will not be hyphenated. This filter does not special case the final word in the paragraph: all words are subject to the hyphenation rules.

Copyright

Copyright 2016 Michael Glaesemann. Released under the MIT License (see LICENSE for details).