docpad-plugin-st

2.1.3 • Public • Published

Express Caching Middleware Plugin for DocPad

NPM version

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

Readme

Keywords

none

Package Sidebar

Install

npm i docpad-plugin-st

Weekly Downloads

7

Version

2.1.3

License

MIT

Last publish

Collaborators

  • stongo