0.02
No commit activity in last 3 years
No release in over 3 years
easily make assets available under a consistent public name
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 1.5
< 11.0
~> 2.14.0

Runtime

>= 4, < 7
 Project Readme

AssetSymlink

Build Status

Rails 4 and above only generate digested assets. From within your app this is a huge win, but it complicates things if you need to know the location of an asset from elsewhere.

This gem automates symlinking your digested assets to their public names. You can rely on the latest version of the asset being available at a predictable location and these assets will continue to be served by your web servers without hitting your rails instances.

Example use cases:

  • images/css referenced from static html pages (eg 500.html)
  • javascript you make available to 3rd parties

Installation

You only need to include this gem in the environment(s) that precompile your assets

Usage

After installing the gem you need to configure which digested assets are mapped to their public names and how. For example

config.asset_symlink = ['widgets.js']

would symlink widgets.js to widgets-<digest>.js

you can also specify an alternative public name, for example

config.asset_symlink = {'widgets.js' => 'v1/foo.js'}

would symlink v1/foo.js to widgets-<digest>.js

Lastly you can mix and match these, for example

config.asset_symlink = ['widgets.js', {'partner.js' => 'v1/partner.js'}]

symlinks widgets.js to widgets-<digest>.js and v1/partner.js to partner-<digest>.js

Contributing

  1. Fork it ( http://github.com/fcheung/asset_symlink/fork )
  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