lightbox2 for Ruby on Rails

This ruby gem provides the latest version of lightbox2 for the Rails asset pipeline.

Installation

1. Adding the gem to your Rails app

Require this Ruby gem in your Ruby on Rails app by adding the following line to your Gemfile:

gem 'lightbox2'

Install the ruby gem by running bundle in your Rails app directory.

2. Activate the gem in your application.scss and application.js file

Rename your app/assets/stylesheets/application.css file to application.scss and put the following line at the end of this file:

@import 'lightbox2';

In case you renamed the file just right now, make sure that all of the pre-existing imports are using the same @import syntax as for lightbox2.

Open your app/assets/javascripts/application.js file and put the following lines at the end of your file:

//= require jquery
//= require lightbox2

Please make sure that jquery is always loaded before lightbox2!

NOTE: The Rails server needs to be restarted in order to make Rails aware of this new gem.

3. Have fun!

lightbox2 is now ready and can be used within your Rails application!

You can copy and paste the following line somewhere in a view to test the lightbox:

<%= link_to 'my picture', image_path('my_picture.jpg'), data: { lightbox: 'my-lightbox-name', title: 'title or caption for this image' } %>

Please refer to the lightbox2 author's documentation to see all available options.

License

This gem is licensed under the MIT license as the lightbox2 itself. Please visit the lightbox2 author's page in case the license has changed: https://lokeshdhakar.com/projects/lightbox2/#license

Credits

  • Lokesh Dhakar (creator of lightbox2)