norite 0.1.0

A simple static website generator powered by Jinja2

Norite

Norite is a simple static website generator powered by Jinja2 as the templating engine.

Norite's main goal is to act as an easy to use rendering engine for people who like to design their own templates or want to have the option of building a custom structure for their websites. To achieve this goal norite exposes the entire content directory as a tree data-structure to the templates along with the rendered content, leaving it up to the template designer how to interpret and display this information.

Implemented Features:

• Markdown to HTML render
• Support for using toml or json files in place of markdown
• Jinja2 based HTML templates
• Support for embedding Jinja2 templates in markdown
• Support for nested folders in website content
• Support for custom templates for any subsection of the content folder
• Support for co-locating assets with content
• Syntax highlighting in code blocks
• Sass compilation (via libsass or dart-sass)
• In-built dev server with auto reload on file changes
• Support for building custom RSS/Atom feeds and robots.txt using templates
• Automatic sitemap.xml generation

Todo:

• Tests
• Nicer error messages
• Live reload in Javascript
• Incremental builds
• Link checker
• More examples

Installation

norite is in alpha, but if you like what you see and want to give it a try, you can install using:

pip install norite

It will install the following additional packages: jinja2, markdown, toml, pygments and watchdog.

Alternatively, if you want to install it globally as a shell tool within an isolated python environment, install via pipx:

pipx install 'norite'

Documentation

Checkout the documentation for norite here: documentation

Inspiration

Norite takes inspiration from Zola's features and its way of organizing content, borrows a few concepts from Hugo, and references Pelican's and Mkdocs's internal implementations for a few things. I would happily recommend using any of these excellent SSGs!

License

MIT License: Copyright (c) 2022 - 2022 Arsh
License.txt