Skip to content

docpad/docpad-plugin-dateurls

Repository files navigation

docpad-plugin-dateurls

Travis CI Build Status NPM version NPM downloads Dependency Status Dev Dependency Status
GitHub Sponsors donate button Patreon donate button Flattr donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

DocPad plugin which adds the ability to use the date within posts to add url routes /YEAR/MONTH/DAY.

Install

Install this DocPad plugin by entering docpad install dateurls into your terminal.

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'

History

Discover the release history by heading on over to the history.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

Sponsors

No sponsors yet! Will you be the first?

GitHub Sponsors donate button Patreon donate button Flattr donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

and licensed under: