gebrits/docpad-plugin-cleanurls

Adds support for clean urls to DocPad

Clean URLs Plugin for DocPad

Adds support for clean URLs to DocPad

Install

npm install --save docpad-plugin-cleanurls

Usage/Configure

For non-static environments we will set the document's url to it's clean url. This means that our document is still outputted to the same place on the file system as the clean url stuff is handled by the web server instead. This is the default.

For static environments we will set the document's outPath to that of a directory with a index.html file (e.g. pages/welcome.html will be outputted to pages/welcome/index.html). You can tell docpad to use the static environment by adding --env static to the end of your DocPad command, so to perform a one off generation for a static environment you'll run docpad generate --env static, to perform your usual generate, serve and watch it'll be docpad run --env static.

If you'd like to disable the static mode when working in the static environment you can add the following to your docpad configuration file.

environments:
	static:
		plugins:
			cleanurls:
				enabled: false

trailingSlashes

Enable to generate document.urls like '/beep/' instead of /beep. Defaults to false.

History

You can discover the history inside the History.md file

Contributing

You can discover the contributing instructions inside the Contributing.md file

License

Licensed under the incredibly permissive MIT License
Copyright © 2012+ Bevry Pty Ltd
Copyright © 2011 Benjamin Lupton