Python static site generator

κάκτος

Kaktos is a python static site generator.

The idea is create a simple static site generator for people that don't need server-side languages.

Designers can use it too, since it don't need people that know a programming language.

Demo

https://kaktos.netlify.app/

Requirements

• Python 3.6+

Setup

Install python dependencies:

pip3 install -r requirements.txt

or

python3 -m pip install -r requirements.txt

Development

To work in development mode, you only need execute one command:

python3 kaktos.py

When you change any file locally, the server will process it again and auto-refresh on browser.

This command always force use development mode, with or without environment variable.

Production

To generate production files, you only need execute one command:

python3 kaktos.py build

All files will be generated in build folder.

If you set environment variable KAKTOS_DEBUG=True, kaktos will build all files for development mode, example:

KAKTOS_DEBUG=True python3 kaktos.py build

Deploy

Structure

• kaktos.py = main file that process your command
• requirements.txt = python dependency list
• templates/layouts = folder for all layouts that pages can inherit
• templates/pages = folder for pages that will be generated
• templates/shared = folder for parts of layouts that can be shared with other layouts
• modules = kaktos modules
• modules/config.py = configuration file
• files = folder that contains all assets and custom files

Templates

All templates (html files) are based on Jinja2 library. You can see it here:

https://jinja.palletsprojects.com/en/3.0.x/

Buy me a coffee

Images

All images for demo come get from:

https://unsplash.com/

License

MIT

Copyright (c) 2021, Paulo Coutinho