gresiblos 0.4.0

A simple private blogging system

gresiblos

Introduction

gresiblos is the acronym for greyrat's simple blog system. It is a simple blogging system written in Python that generates static HTML pages from blog content definitions.

In the current stage (v0.4.0), gresiblos reads a file with blog entry contents and meta information and embeds it into a template. It generates a json-file with meta information about the entries for generating lists of topics, entries, or entries with a named topic. gresiblos comes with a php-file that realises browsing entries and topics, and a php-file that generates rss and atom feeds.

Background

I wanted to have a blog and I wanted it to use static pages. That's why I wrote it. There are some features — like the inclusion of custon JavaScript and CSS files — I needed for my own blog.

Usage

Write your blog entries as HTML contents/snippets (may be extended to .md etc. in the future) with some additional meta information, e.g. ‘entry1.txt’:

state:release
title:My first blog entry
filename:my-first-blog-entry
author:Daniel Krajzewicz
date:26.12.2024 19:25
topics:blog,example
abstract:A very first introduction into blogging
content:
<b>Hello there!</b><br/>
This is my very first blog post!
===

All information starts with a key that is separated from the value by a ‘:’. Multi-line values start with a blank line after the key and are closed with ‘===’. More information about the format of the entries is given on the 'Entry Definition' page.

Then run gresiblos on it:

python src\gresiblos.py entry1.txt

… and it will convert it into a complete HTML page using the default template stored in ./data/. The command line options and the usage is described on the 'Running on the Command Line' page.

License

gresiblos is licensed under the GPLv3 license.

Installing gresiblos

The current version is gresiblos-0.4.0.

You may install gresiblos using

python -m pip install gresiblos

You may download a copy or fork the code at gresiblos's github page.

Besides, you may download the current release here:

• gresiblos-0.4.0.zip
• gresiblos-0.4.0.tar.gz

Further Documentation

• A complete documentation is located at https://gresiblos.readthedocs.io/en/latest/
• Discussions are open at https://github.com/dkrajzew/gresiblos/discussions
• The github repository is located at: https://github.com/dkrajzew/gresiblos
• The issue tracker is located at: https://github.com/dkrajzew/gresiblos/issues
• The PyPI page is located at: https://pypi.org/project/gresiblos/

Status

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

I may extend it in the future, but that mainly depends on my motivation and your interaction with me.

ChangeLog

gresiblos-0.4.0 (to come)

• support for entry index (using json and php)
  • generates a json-file with entries
  • added a php-file which lists entries or topics

gresiblos-0.2.0 (27.12.2024)

• Initial version
  • processes entries and saves them