Distribusi is a content management system for the web that produces static pages based on the file system.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Luke Murphy cb9e19d1a2
Allow to append index.html files on menus
5 years ago
distribusi Allow to append index.html files on menus 5 years ago
scripts Package it up! Get it in shape for PyPi. 5 years ago
.gitignore Ignore new Pip related files 5 years ago
CHANGELOG.md Allow to append index.html files on menus 5 years ago
LICENSE Package it up! Get it in shape for PyPi. 5 years ago
Makefile Don't use pipenv for releases 5 years ago
README.md added info about exiftool 5 years ago
TODO.md Package it up! Get it in shape for PyPi. 5 years ago
pyproject.toml Add Black and Pip files config 5 years ago
setup.py Make new release 5 years ago

README.md

Distribusi CMS

PyPI version

distribusi is a content management system for the web that produces static index pages based on folders in the filesystem. It is inspired by the automatic index functions featured in several web servers. It works by traversing the file system and directory hierarchy to automatically list all the files in the directory and providing them with html classes and tags for easy styling.

Requirements

While a Pip install will pull in Python dependencies, you might need system dependencies. This package requires two underlying packages. Those are python-magic, and pillow. Here are the installation documentation for those packages:

Optional requirements

If you wish to use the --caption flag to add image captions read from EXIF comment metadata you will need a utility called exiftool.

You can install it via your package manager. For other options please consult the website: https://www.sno.phy.queensu.ca/~phil/exiftool/

Install It

$ export PATH=$PATH:$HOME/.local/bin
$ pip install --user distribusi

Upgrade It

If you already have it, you can upgrade with:

$ pip install -U distribusi

Use It

Get help with:

$ distribusi --help

Make a distribusi of your home folder:

$ distribusi -d ~/

You will find that you now have an index.html in every folder.

Create a quick gallery for the web:

$ distribusi -d /path/to/my/photos -t

This creates an index.html with base64 encoded thumbnails.

Generate verbose output:

$ distribusi -v

Make an index of the archive page:

$ distribusi -d /var/www/archive/my_event -t -v

Change It

You'll need to get a copy of the repository and then do an editable install:

$ git clone https://git.vvvvvvaria.org/varia/distribusi.git && cd distribusi
$ python3 -m venv .venv && source .venv/bin/activate
$ pip install -e .

You're then ready to make your changes and experiment with them.

Release It

You'll need a PyPi account and to be added as a maintainer.

Please ask around @ Varia for who has PyPi access.

$ pip install twine
$ make publish