gresiblos

Home

License: BSD PyPI version test Downloads Downloads Coverage Status Documentation Status Dependecies

Donate

gresiblos - a simple private blogging system

Introduction

gresiblos is a simple blogging system written in Python. gresiblos generates static HTML pages from optionally annotated text, markdown, or HTML files. gresiblos is the acronym for greyrat's simple blog system.

gresiblos reads blog entries from files that may include some meta information and embeds the contents into a template. Optionally, in addition, it generates a json-file with meta information about the entries. gresiblos comes with a php-file that realises browsing, as well as with a php-file that generates rss and atom feeds.

Usage

Write your blog entries as text, markdown or HTML.

Then run gresiblos on them:

gresiblos ./blog/*.txt

… and it will convert them into complete HTML pages using a default template.

For 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 given meta information, as well as optional fields.

You may find further information at the gresiblos documentation pages.

Documentation

gresiblos is meant to be run on the command line. 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 sections.

Additional documentation includes a page with relevant links, the ChangeLog, as well as the license. gresiblos is licensed under the BSD license.

Background

I wanted to have a blog and I wanted it to use static pages. That's why I wrote it. gresiblos has some additional 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. The next steps to release 1.0 will involve some refactorings, including API changes.

Please let me know if you have any idea / feature request / question / whatever or contribute to gresiblos