(as of 06.04.2026, 14:05:36)

gresiblos — a simple private blogging system.

Introduction

gresiblos is a radically simple static site generator / blogging system written in Python. It generates static HTML pages by embedding the contents of text, markdown, or HTML-snippet files into a template. It has no dependencies and no server backend is needed. gresiblos is the acronym for greyrat's simple blog system.

gresiblos reads blog entries from files that may include some meta information and embeds their contents into a template. It optionally generates: a) a JSON-file with meta information about the entries, b) lists of the entries sorted alphabetically or chronologically, c) RSS 2.0 and Atom feed files. gresiblos comes with a basic php-file that realizes browsing by topic and/or entries.

You may see it's results here: https://www.krajzewicz.de/blog/index.php.

Installation

The current version is 0.10.0. You may install the latest release using pip:

python -m pip install gresiblos

There is a page about installing gresiblos that lists further options.

Usage

gresiblos is started on the command line. Write your blog entries as text, markdown, or HTML.

Assuming they are stored in the ‘blog’ folder, run gresiblos on them like:

gresiblos ./blog/*.txt --to-html

and it will apply a basic conversion to HTML, embed them into the default template and store them into the folder ‘gresiblos_out’.

Of course, it makes sense to use markdown or even plain HTML snippets if you want to run a real blog…

For even more “complete” blogs — including authors, abstracts, release dates, etc. — the entries can be enriched by meta information. gresiblos templates support placeholders that are filled with the meta information given in an entry, as well as optional fields.

Documentation

The documentation consists of a user manual and a man-page like call documentation.

If you want to contribute, you may check the API documentation or visit gresiblos on github where besides the code you may find the gresiblos issue tracker or a discussions about gresiblos section.

Additional documentation includes a page with relevant links or the ChangeLog. You may find the complete documentation at the gresiblos readthedocs pages.

License

gresiblos is licensed under the GPL-3.0 license.

Background

I wanted to have a blog and I wanted it to use static pages. That's why I wrote gresiblos. It has some specific features — like the inclusion of custom JavaScript and CSS files — I needed for my own blog.

Status & Contributing

gresiblos works as intended for me, but lacks quite some features of enterprise systems.

Please let me know if you have any idea / feature request / question / whatever or contribute to gresiblos by adding an issue or by dropping me a mail.