DocPad plugin which adds the ability to use the date within posts to add url routes /YEAR/MONTH/DAY.
Install this DocPad plugin by entering docpad install dateurls into your terminal.
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
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'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: trueWhen 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: trueIf 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'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'Discover the release history by heading on over to the history.md file.
Discover how you can contribute by heading on over to the CONTRIBUTING.md file.
These amazing people are maintaining this project:
No sponsors yet! Will you be the first?
These amazing people have contributed code to this project:
Discover how you can contribute by heading on over to the CONTRIBUTING.md file.
Unless stated otherwise all works are:
- Copyright © Mark Groves
and licensed under:
