Contents

# Jekyll::AltUrls

Give your Jekyll posts and pages multiple URLs.

When importing your posts and pages from, say, Tumblr, it's annoying and
impractical to create new pages in the proper subdirectories so they, e.g. 
`/post/123456789/my-slug-that-is-often-incompl`, redirect to the new post URL.

Instead of dealing with maintaining those pages for redirection, let
`jekyll-alt-urls` handle it for you.

## Installation

Add this line to your application's Gemfile:

    gem 'jekyll-alt-urls'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install jekyll-alt-urls

Once it's installed into your evironment, add it to your `_config.yml`:

```yaml
gem:
  - jekyll-alt-urls
```

## Usage

The object of this gem is to allow an author to specify multiple URLs for a
page, such that the alternative URLs redirect to the new Jekyll URL. This is 

To use it, simply add the array to the YAML front-matter of your page or post:

```yaml
title: My amazing post
alt_urls:
  - /post/123456789
  - /post/123456789/my-amazing-post
```

This will generate the following pages in the destination:

```text
/post/123456789/index.html
/post/123456789/my-amazing-post/index.html
```

These pages will contain an HTTP-REFRESH meta tag which redirect to your URL.

## 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

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
jekyll-alt-urls-0.1.0	README.md