Google::Webfonts
Provides a helper for using Google Webfonts in Rails or Sinatra.
Installation
Add this line to your application's Gemfile:
gem 'google-webfonts'
And then execute:
$ bundle
Or install it yourself as:
$ gem install google-webfonts
Usage
Syntax
google_webfonts_link_tag :font_name => [sizes], ...
Examples
Basic usage:
google_webfonts_link_tag :droid_sans => [400, 700],
:yanone_kaffeesatz => [300, 400]
The sizes are optional, and do not have to be in an Array if you are only including one size. For example:
google_webfonts_link_tag :droid_sans
# => generates a tag for Droid+Sans without specifying the font weight
google_webfonts_link_tag :droid_sans => 400
# => generates a tag for Droid+Sans with 400 weight
google_webfonts_link_tag :droid_sans => [400, 700]
# => generates a tag for Droid+Sans with 400 and 700 weights
You can also use a String instead of a Symbol if you'd prefer. For example:
google_webfonts_link_tag "Droid Sans", "Yanone Kaffeesatz" => 400
# includes Droid+Sans without a specified weight
# and Yanone+Kaffeesatz with weight 400
Using in Rails
No additional work required to use this gem in a Rails application. Just add it to your application's Gemfile, and it is automatically available in your views.
You will, however, need to include Google::Webfonts::Helper
if you want to use
it outside of a view.
Using in Sinatra
Here is a simple "Hello World" example for using Google::Webfonts in a Sinatra app:
# app.rb
require 'rubygems'
require 'sinatra'
require 'google-webfonts' # <= this must be required after 'sinatra'
get '/' do
erb :index
end
# views/index.erb
<html>
<head>
<%= google_webfonts_link_tag "Droid Sans" %>
</head>
<body>
<p style="font-family: 'Droid+Sans', sans-serif;">
Hello World!
</p>
</body>
</html>
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Ensure what your code is well tested, and all the tests pass. (
rspec spec
) - Create new Pull Request