Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/appfoundry/jekyll-lightbox

Simple Jekyll tag for Lightbox
https://github.com/appfoundry/jekyll-lightbox

Last synced: 8 days ago
JSON representation

Simple Jekyll tag for Lightbox

Awesome Lists containing this project

README

        

# Jekyll Lightbox Plugin

A very simple Jekyll tag for including lightbox images in your jekyll powered website.

## Installation

* Install Lightbox as instructed on [their website](http://lokeshdhakar.com/projects/lightbox2/)
* Copy the `lightbox.rb` file to your Jekyll `_plugins` folder

## Usage

Use this plugin as a Jekyll tag in any of your pages as follows:

```
{% lightbox images/appfoundry.png --thumb="images/appfoundry-thumb.png" --data="appfoundry_image_set" --title="The AppFoundry Logo" --alt="This is our logo" --img-style="max-width:80%;" --class="yourclass" %}
```

This will ouput:

```html

This is our logo

```

The options explained:

* **--thumb**: (optional) corresponds to Lightbox undocumented thumbnail feature
* **--data**: corresponds to the Lightbox `data-lightbox` attribute
* **--title**: corresponds to the Lightbox `data-title` attribute
* **--alt**: (optional) image `alt` value. If ommitted, the value of `title` is used
* **--img-style**: (optional) any inline `CSS` you would like to apply to your image
* **--class**: (optional) any class you would like to apply to your image

## Versioning

* Current version: **1.0**

## Contact
Feel free to email [email protected] with questions or comments.

## License
This project is licensed under the terms of the MIT license.