auctor

Auctor is a simple Node.js based static site generator that uses Markdown or EJS JavaScript templates for content and EJS JavaScript templates for layout templates.

Pronunciation: awkTOHR

Release Notes

• Version 1.1.1 contains an update for EJS with breaking changes to includes: <% include file.ejs %> changes to <%- include('file.ejs'); %>
• Version 1.2.0 contains critical fixes and breaking changes to the serve module.

Roadmap

• [ ] Duplicate page detection (output to same file location).
• [ ] Create an index as content generated (could be used by duplicate page detection algorithm).
• [ ] Add automated sitemap generation for all generated pages.
• [ ] Add Robots.txt support, with integrated sitemap support.
• [ ] Add SASS support.
• [ ] Add minify support.
• [ ] Add Code of Conduct

Dependencies

• marked Markdown parser.
• ejs JavaScript template engine.
• front-matter for Jekyll-style front-matter YML parsing.
• fs-extra for filesystem access.
• glob for pattern matching.

Getting started

To keep it simple, Auctor expects the following structure:

• _includes
  • (Any EJS includes)
• _layout
  • default.ejs
  • (Any other EJS layout files)
• site
  • assets (CSS, JS, images)
  • content
    • (Any EJS, MD, or directories)

References

• Auctor Documentation
• Auctor Source Code
• Auctor NPM Package
• This project loosely follows Conventional Commits

This project was heavily influenced by the following:

• Build a static site generator in 40 lines with Node.js
• Building a simple static page generator with Node.js
• How to make a beautiful, tiny npm package and publish it