Project

rubypants

0.56
Low commit activity in last 3 years
A long-lived project that still receives updates
The original "SmartyPants" is a free web publishing plug-in for Movable Type, Blosxom, and BBEdit that easily translates plain ASCII punctuation characters into "smart" typographic punctuation HTML entities.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
 Project Readme

RubyPants: SmartyPants for Ruby¶ ↑

Gem Travis CodeCov

Synopsis¶ ↑

RubyPants is a Ruby port of the smart-quotes library SmartyPants.

The original “SmartyPants” is a free web publishing plug-in for Movable Type, Blosxom, and BBEdit that easily translates plain ASCII punctuation characters into “smart” typographic punctuation HTML entities.

Description¶ ↑

RubyPants can perform the following transformations:

  • Straight quotes (" and ') into “curly” quote HTML entities

  • Backticks-style quotes (``like this'') into “curly” quote HTML entities

  • Dashes (-- and ---) into en- and em-dash entities

  • Three consecutive dots (... or . . .) into an ellipsis entity

This means you can write, edit, and save your posts using plain old ASCII straight quotes, plain dashes, and plain dots, but your published posts (and final HTML output) will appear with smart quotes, em-dashes, and proper ellipses.

RubyPants does not modify characters within <pre>, <code>, <kbd>, <math>, <style> or <script> tag blocks. Typically, these tags are used to display text where smart quotes and other “smart punctuation” would not be appropriate, such as source code or example markup.

Installation¶ ↑

gem install rubypants

Or, in your application's Gemfile:

gem 'rubypants'

Example of Usage¶ ↑

RubyPants.new("String with 'dumb' quotes.").to_html

For additional options, consult the documention in lib/rubypants/core.rb.

Backslash Escapes¶ ↑

If you need to use literal straight quotes (or plain hyphens and periods), RubyPants accepts the following backslash escape sequences to force non-smart punctuation. It does so by transforming the escape sequence into a decimal-encoded HTML entity:

\\    \"    \'    \.    \-    \`

This is useful, for example, when you want to use straight quotes as foot and inch marks: 6'2“ tall; a 17” iMac. (Use 6\'2\" resp. 17\".)

Algorithmic Shortcomings¶ ↑

One situation in which quotes will get curled the wrong way is when apostrophes are used at the start of leading contractions. For example:

'Twas the night before Christmas.

In the case above, RubyPants will turn the apostrophe into an opening single-quote, when in fact it should be a closing one. I don't think this problem can be solved in the general case–every word processor I've tried gets this wrong as well. In such cases, it's best to use the proper HTML entity for closing single-quotes (“&#8217;”) by hand.

Bugs¶ ↑

To file bug reports or feature requests, please create an issue in this gem's GitHub repository.

If the bug involves quotes being curled the wrong way, please send example text to illustrate.

Authors¶ ↑

John Gruber did all of the hard work of writing this software in Perl for Movable Type and almost all of this useful documentation. Chad Miller ported it to Python to use with Pyblosxom.

Christian Neukirchen provided the Ruby port, as a general-purpose library that follows the *Cloth API.

Jeremy McNevin posted this code to GitHub ages ago, but has recently been trying to improve it where possible.

Aron Griffis made jekyll-pants which depends on RubyPants, and consequently jumped in to help out with issues and pull requests.

John Gruber

daringfireball.net

SmartyPants

daringfireball.net/projects/smartypants

Chad Miller

web.chad.org

Christian Neukirchen

kronavita.de/chris

Aron Griffis

arongriffis.com