Download and Installation

gresiblos is a Python script. To run it, you must have Python installed. If you have not installed Python, yet, please read instructions on installing Python first (see below).

Installing gresiblos

The current version is gresiblos-0.10.0.

You have different options for installing gresiblos.

Installing from PyPi

You may install gresiblos from PyPi using

python -m pip install gresiblos

This will install gresiblos as a script that may be directly called on the command line as well as the Python module which you may import using import gresiblos. The PyPi version only includes the (executable) source code and files needed to run it.

Before installing gresiblos, you may consider building a virtual environment, first.

After installing, you may run gresiblos using

gresiblos

Cloning the repository

You may clone the repository which is available at gresiblos's github page.

git clone https://github.com/dkrajzew/gresiblos.git
cd gresiblos

You may then run gresiblos using

python gresiblos/gresiblos.py

Please note that the current repository version may contain an in-between version with new, undescribed, or even buggy behavior. You should rather use a recent release version.

Download the latest release

Besides, you may download the current release here:

• gresiblos-0.10.0.zip
• gresiblos-0.10.0.tar.gz

You will get the complete copy of the repository which you have to decompress. A folder named gresiblos-0.10.0 will be generated. gresiblos.py is stored in the gresiblos folder.

After changing into the generated folder, you may run gresiblos using

python gresiblos/gresiblos.py

Installing add-ons

gresiblos currently supports two add-ons that are not part of the standard installation: markdown, and degrotesque.

Installing markdown

markdown is a text markup language for generating HTML, see https://python-markdown.github.io/. Install markdown using:

python -m pip install markdown

Installing degrotesque

degrotesque is a text processor which replaces basic characters by some nicer, typographic, counterparts, see https://degrotesque.readthedocs.io/en/latest/. Install degrotesque using:

python -m pip install degrotesque

Installing Python

Python is an interpreted programming language. For running gresiblos and other scripts written in Python you have to install Python itself, first.

For installing Python, use an installer for your system from https://www.python.org.

You should as well install pip, a package manager for Python. After installing Python, you should be able to install pip using:

python get-pip.py

You may upgrade pip using:

pip install --upgrade pip