mikula 0.0.2

Static web gallery generator

Mikula

Static image gallery generator inspired by Jekyll and JAlbum. Mikula is written in Python and supports uploads to AWS S3.

Motivation

I used JAlbum some time ago while it was free. With enough tweaking to the themes it produced acceptable results but I always wanted more flexibility in designing my albums. Jekyll inspired me to create my own gallery generator in Python, so here it is, welcome Mikula.

Name

Mikula is a Ukrainian version of name Nicholas.

Installation

Use pip

Getting Started with Mikula

Once you installed Mikula, clone a sample gallery from GitHub:

git clone https://github.com/RomanKosobrodov/mikula-sample-gallery

Navigate to the gallery directory

cd mikula-sample-gallery

Configure Mukula

mikula configure

If you have a AWS S3 account you can provide your access key id, access key and region. Otherwise, skip these settings.

Build sample gallery

Choose the output directory and run:

mikula build --output=<your-output-directory>

View it

Run the development server and check the results

mikula serve

Click on the link to open the gallery in your browser. To exit the server press Ctrl + C (or Command + C on Mac).

Deploy it

If you configured your AWS S3 credentials you can deploy your gallery to AWS S3. Choose a name for the bucket which is unique for AWS and run:

mikula deploy --bucket <your-bucket-name>

Check that everything is working as expected by opening your website. The url has the following format:

<your-bucket-name>.s3-website-<your-AWS-region>.amazonaws.com