Skip to content

kokkonisd/flores

Repository files navigation

Flores

CI codecov

Yet another static site generator.

Motivation

Why create another static site generator when there are so many out there?

Mainly for two reasons:

  1. For the learning and fun of it.
  2. Because most generators are very complex because they aim to be very powerful.

Flores is supposed to be as simple as possible, and yet be powerful enough to do what most static sites need. Its basic functionality is heavily inspired by Jekyll.

The idea is to be able to use it on a large number of platforms (Linux, macOS and Windows are supported!) without a ton of dependencies or custom plugins.

Features

For the moment, Flores supports the following features:

  • Markdown-based pages and posts
  • User-defined data and custom "data pages"
  • Out-of-the-box image optimization
  • Out-of-the-box Sass/SCSS support
  • A local testing/preview server
  • Cross-platform support (Linux, macOS, Windows)

Documentation

You can read the latest documentation for the main branch here, or you can build it yourself from source:

$ python -m pip install requirements-docs.txt
$ sphinx-build -b html docs/ docs/_build/