Express Caching Middleware Plugin for DocPad

Add static caching for Express using the 'st' package

Install

docpad install st

Usage

Once installed, files will be served from a /static folder.

You can set your own custom st settings in the plugins config

plugins:
	st:
		path: "public_html/", # resolved against the process cwd
		url: "/", # defaults to '/'
		cache: # specify cache:false to turn off caching entirely
			fd:
				max: 1000, # number of fd's to hang on to
				maxAge: 1000*60*60, # amount of ms before fd's expire

			stat:
				max: 5000, # number of stat objects to hang on to
				maxAge: 1000 * 60, # number of ms that stats are good for

			content:
				max: 1024*1024*64, # how much memory to use on caching contents
				maxAge: 1000 * 60 * 10, # how long to cache contents for

			index:  # irrelevant if not using index:true
				max: 1024 * 8, # how many bytes of autoindex html to cache
				maxAge: 1000 * 60 * 10, # how long to store it for

			readdir:  # irrelevant if not using index:true
				max: 1000, # how many dir entries to cache
				maxAge: 1000 * 60 * 10, # how long to cache them for

		index: "index.html" # true for auto-index, the default, false returns 404's for directories

		dot: true # allow dot-files to be fetched normally, false return 403 for any url with a dot-file part

		passthrough: false # calls next/returns instead of returning a 404 error, false returns a 404 when a file or an index is not found

Deployment Notes

On Heroku, set cache to false. This will disable backend caching, which is unsupported on Heroku. Untested on other hosted platforms

History

Discover the change history by heading on over to the HISTORY.md file.

License

Licensed under the incredibly permissive MIT license