0.0
No commit activity in last 3 years
No release in over 3 years
Google Webfonts helper for Rails or Sinatra applications.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

< 2.0, >= 1.3.0
~> 5.3.3
>= 0
~> 1.3.2

Runtime

>= 3.0.0
 Project Readme

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

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Ensure what your code is well tested, and all the tests pass. (rspec spec)
  6. Create new Pull Request