Prawn::Emoji

Prawn::Emoji is an extention that adds Emoji support to Prawn.

require 'prawn/emoji'

Prawn::Document.generate 'sushi.pdf' do
  font 'DejaVuSans.ttf'
  text '🐟 / 🔪 + 🍚 / 🍾 = 🍣'
end

For execute this code, you need DejaVuSans.ttf font.

• Emoji is provided by Twemoji
• Support Singleton/Combining/Modifier/Flag/ZWJ Sequence Emoji

See test/pdf/emoji_rendering/expect.pdf for details.

• RTL support
• Character spacing support
• Rotation support
• Alignment support
• Font size support

See test/pdf/prawn_integration/expect.pdf for details.

prawn-emoji/issues

14.0

2.4

3.0, 3.1, 3.2, 3.3

Add this line to your application's Gemfile:

gem 'prawn-emoji', require: false

And then execute:

$ bundle

Or install it yourself as:

$ gem install prawn-emoji

require 'prawn/emoji'

In order to draw Emoji, you must use a True Type Font.

Emoji Regex is a regular expression used to determine which emoji to draw.

Prawn::Emoji.config.regex # => ::Unicode::Emoji::REGEX_VALID by default

You can override it with unicode-emoji's Regex:

Prawn::Emoji.config.regex = ::Unicode::Emoji::REGEX_INCLUDE_TEXT

Bug reports and pull requests are welcome on GitHub at https://github.com/hidakatsuya/prawn-emoji.

Run all tests:

$ bundle exec rake test

Run unit tests:

$ bundle exec rake test:units

Run pdf tests:

$ bundle exec rake test:pdf

In order to run test:pdf, you need to install diff-pdf in your environment, or you can run test in the docker container as below.

You can use the docker container for development. This container contains the libraries required for testing, such as diff-pdf.

docker pull ghcr.io/hidakatsuya/ruby-with-diff-pdf:latest
docker run -v $PWD:/src -it ghcr.io/hidakatsuya/ruby-with-diff-pdf bash

> src#

You can run test:

> src# bundle install
> src# bundle exec rake test

Or, you can run test instantly like this:

$ docker run --rm -v $PWD:/src:cached -it ghcr.io/hidakatsuya/ruby-with-diff-pdf bash -c "bundle install && bundle exec rake test:pdf"

$ bundle exec rake emoji:update VERSION=<Twemoji version>

This task works the following:

1. Download emoji images from https://github.com/twitter/twemoji/
2. Save the emoji images in the emoji/images/
3. Write image list in emoji/images/ to emoji/index.yml
4. Update version in emoji/LICENSE

© 2015 Katsuya HIDAKA. See MIT-LICENSE for further details.

Twemoji Graphics licensed under CC-BY4.0. See emoji/LICENSE for futher details.

IPA Font License Agreement v1.0