No description, website, or topics provided.
CoffeeScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
test
.gitignore
.npmignore
Cakefile
history.md
license.md
package.json
readme.md

readme.md

Date URLs Plugin for DocPad

Adds support for date based URLs to DocPad

Install

npm install --save docpad-plugin-dateurls

Usage

The purpose of this plugin is to enable date based url paths based on the a date metadata field within a post.

Add a date yaml header to posts you would like to have a date based url

For /documents/posts/2012-10-21-my-blog-post.html.md

---
name: my blog post
date: 2012-10-21
---

results:

http://yoursite.com/2012/10/21/my-blog-post.html

Document Paths

By default dateurls will pickup documents within /documents/posts if you would like to process a different folder under documents add:

  plugins:
    dateurls:
      documentPath: 'yourpath'

Clean Urls

By default the files paths will have the file extension:

http://yoursite.com/2012/10/21/my-blog-post.html

If you would like to have clean urls such as:

http://yoursite.com/2012/10/21/my-blog-post

Pass true to the cleanurl configuration property

  plugins:
    dateurls:
      cleanurl: true

Trailing Slashes

When using clean urls a route will be added with the forms

http://yoursite.com/2012/10/21/my-blog-post
http://yoursite.com/2012/10/21/my-blog-post/

If you wish to have links to the post use a trailing slash pass true to the trailingSlashes configuration property

  plugins:
    dateurls:
      trailingSlashes: true

Collection Name

If you would like dateurls to process documents in a collection you defined yourself (instead of documents in a specific document path), you can tell the plugin which collection to use explicitly:

  plugins:
    dateurls:
      collectionName: 'myCollection'

Date Format

If you wish to format the date portion of the generated URL differently, you can tell the plugin which date format to use with moment explicitly:

  plugins:
    dateurls:
      dateFormat: '/YYYY/MM'

License

See license.md file