1.0.2 • Published 8 years ago
folderise v1.0.2
Folderise
Folderise is a express middleware to create static (or semi-static) websites from a folder of markdown files.
Folderise was developed for Frontyard Project's website as a simple way for multiple authors to easily modify the organisations website. We used a shared dropbox folder, so that any changes to the files/folders immediately caused the website to update.
Guide:
- Every folder becomes a page. The title of the folder is the name of the page.
- Any .md file included in a folder will be parsed as Markdown and rendered in alphabetic order.
- After .md files, if there are other files they will rendered as download links.
- Any image will be served as an image at the bottom of the page.
- Any folders, files, or images that begin with a . or an _ will not be rendered.
- Listings will be alphabetical.
- The sites pages are cached in _tmp.html files inside each folder.
- Folderise uses ckokidar to listen for any changes to the website folder and automatically rerenders any changes.
- template.html is used as the base folder
Folderise is a based on the python static website generator Folders.
Still to do:
- enable template to be overriden in settings.
- include .css or .less
Install:
npm install folderise
Folderise requires a settings.json file with the following options:
{
"port": /* port for server to listen on */,
"title": /* title of your site */,
"folder": /* path/to/folder */,
"plugins": [ /* list of plugins */ ]
}
Check out the example provided for how to intergate Folderise into your express application.
var express = require('express');
var helmet = require('helmet');
var bodyParser = require('body-parser');
var errorHandler = require('errorhandler');
var options = require('./settings.json');
var folderise = require("folderise")(options);
var port = options.port;
var app = express();
app.use(helmet());
app.use(helmet.noCache());
app.use(bodyParser.urlencoded({extended: true}));
app.use(bodyParser.json());
app.use(errorHandler());
app.use('/', express.static(options.folder));
app.use(folderise.middleman() );
app.get('*', folderise.serve() );
app.listen(port, function() {
console.log('Express server listening on port ' + port);
});
Note: If not using any folderise plugins you can increase performance by using Nginx to serve static content.