Metadata-Version: 2.0
Name: mikula
Version: 0.0.5
Summary: Static web gallery generator
Home-page: https://github.com/RomanKosobrodov/mikula
Author: Roman Kosobrodov
Author-email: mikula@kosobrodov.net
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: Jinja2 (==2.10.3)
Requires-Dist: Markdown (==3.1.1)
Requires-Dist: Pillow (==6.2.1)
Requires-Dist: PyYAML (==5.1.2)
Requires-Dist: boto3 (==1.10.26)

# 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](https://github.com/RomanKosobrodov/mikula-sample-gallery):

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

### Navigate to the gallery directory

```bash
cd mikula-sample-gallery
```

### Configure Mukula
```bash
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:
```bash
mikula build --output=<your-output-directory>
```

### View it
Run the development server and check the results
```bash
mikula serve
```
Click on the [link](http://localhost:5000) 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:
```bash
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
```

## Packaging
Run `setup.py` to build the package and `twine` to upload it to PyPI:
```bash
rm dist/*
rm -rf build/*
python3.7 setup.py sdist bdist_wheel
twine upload dist/* 
```


