Sha256: 5b38e01a3fca9ecf0a5385b54f5a4b14499e74cc0662329091e2630dbd171c75

Contents?: true

Size: 1.71 KB

Versions: 4

Compression:

Stored size: 1.71 KB

Contents

# Sinatra AssetsLinker Helper

[![Gem Version](https://badge.fury.io/rb/sinatra-assets_linker.svg)](http://badge.fury.io/rb/sinatra-assets_linker)


Provided methods:
* `css_uri(file_name, add_script_name = true)`
* `js_uri(file_name, add_script_name = true)`
* `img_uri(file_name, add_script_name = true)`

They extend the [`uri`][uri] method from the Sinatra. 
Always returns relative paths, unless you set `:cdn_url`.

## Installation

Add this line to your application's Gemfile:

    gem 'sinatra-assets_linker'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install sinatra-assets_linker

## Usage

```ruby
require 'sinatra/base'
require 'sinatra/assets_linker'

class MyApp < Sinatra::Base
  helpers Sinatra::AssetsLinker

  configure do
    # define assets dirs
    set :css_dir, 'css_dir'
    set :js_dir, 'js_dir'
    set :img_dir, 'img_dir'

    # optionally
    set :cdn_url, 'http://cdn.net'
  end

end
```

and when you call:

```ruby
css_uri('file.css')       # -> /css_dir/file.css
js_uri('file.js')         # -> /js_dir/file.js
img_uri('file.jpg')       # -> /img_dir/file.jpg
```

if you set `:cdn_url` before, you get:

```ruby
css_uri('file.css')       # -> http://cdn.net/css_dir/file.css
js_uri('file.js')         # -> http://cdn.net/js_dir/file.js
img_uri('file.jpg')       # -> http://cdn.net/img_dir/file.jpg
```
## Versioning

See [semver.org][semver]


## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

[uri]: https://github.com/sinatra/sinatra/blob/master/lib/sinatra/base.rb#L265
[semver]: http://semver.org/

Version data entries

4 entries across 4 versions & 1 rubygems

Version Path
sinatra-assets_linker-1.0.5 README.md
sinatra-assets_linker-1.0.4 README.md
sinatra-assets_linker-1.0.3 README.md
sinatra-assets_linker-1.0.2 README.md