2022-11-19 05:33:46 +01:00
|
|
|
# fgg - free gallery generator
|
2022-11-18 21:45:03 +01:00
|
|
|
|
2022-11-27 16:05:28 +01:00
|
|
|
```
|
|
|
|
|
__
|
|
|
|
|
/ _| __ _ __ _
|
|
|
|
|
| |_ / _` |/ _` |
|
|
|
|
|
| _| (_| | (_| |
|
|
|
|
|
|_| \__, |\__, |
|
|
|
|
|
|___/ |___/
|
|
|
|
|
```
|
|
|
|
|
|
2022-11-19 04:04:50 +01:00
|
|
|
fgg is a free gallery generator for static site generators like Hugo, Jekyll, Nikola etc. using Flickr as data source.
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
|
|
|
|
More to come...
|
|
|
|
|
|
2022-12-24 14:34:55 +01:00
|
|
|
## Demo
|
|
|
|
|
|
|
|
|
|
A demo can be found at [https://hanez.org/photos/](https://hanez.org/photos), but this gallery is generated using
|
|
|
|
|
my old prototype script written in Ruby. But fgg will become a replacement for it.
|
|
|
|
|
|
2022-11-23 04:21:12 +01:00
|
|
|
## Requirements
|
2022-11-21 00:41:06 +01:00
|
|
|
|
|
|
|
|
- Python 3.* (I don't now the concrete version right now. I use only Python 3.10 at the moment. Could be that fgg is
|
|
|
|
|
running with an older version, but it could also be that required libs do not. Please report your Python version to
|
2022-11-23 19:09:14 +01:00
|
|
|
me if fgg works for you to help me to create a compatibility list.) - [https://python.org](https://python.org)
|
|
|
|
|
|
|
|
|
|
### Libraries
|
|
|
|
|
|
2022-11-21 01:30:59 +01:00
|
|
|
- crc32c 2.3 - [https://pypi.org/project/crc32c/](https://pypi.org/project/crc32c/)
|
|
|
|
|
- flickr-api 0.7.5 - [https://pypi.org/project/flickr-api/](https://pypi.org/project/flickr-api/)
|
2022-11-23 19:09:14 +01:00
|
|
|
- Jinja2 3.1.2 - [https://pypi.org/project/Jinja2/](https://pypi.org/project/Jinja2/)
|
2022-11-21 01:30:59 +01:00
|
|
|
- requests 2.28.1 - [https://pypi.org/project/requests/](https://pypi.org/project/requests/)
|
2022-11-21 00:41:06 +01:00
|
|
|
|
2022-11-23 04:21:12 +01:00
|
|
|
## To do
|
2022-11-19 04:04:50 +01:00
|
|
|
|
2022-11-21 00:52:08 +01:00
|
|
|
- Make it possible to recreate the gallery even when there are no photos at Flickr anymore!!!
|
2022-11-20 08:59:50 +01:00
|
|
|
- Error handling. Not done in any way so far... :|
|
2022-11-20 09:15:09 +01:00
|
|
|
- Make use of some CLI parameters to make it more comfortable to use fgg.
|
|
|
|
|
- Configure the Python logging stuff and add logging for easy debugging... ;)
|
2022-11-23 04:21:12 +01:00
|
|
|
- Set User-Agent for the requests module.
|
2022-11-20 08:59:50 +01:00
|
|
|
- ~~Save as most cached data as JSON files as possible. Object dumps are related to Ruby only at the moment.
|
2022-11-27 16:05:28 +01:00
|
|
|
So limit the use of Marshal to a minimum!~~ No marshal nor pickle is used anymore. All cache is JSON.
|
2022-11-20 08:59:50 +01:00
|
|
|
- ~~Rewrite fgg in Python. **Ruby is a weird language o_O!**~~ Python is the now the language of choice.
|
2022-11-19 04:04:50 +01:00
|
|
|
- Use a template engine for HTML output generation, but not before the rewrite in Python.
|
2022-11-19 05:33:46 +01:00
|
|
|
- Add more targets, not only Jekyll. Nikola preferred!
|
2022-11-20 08:59:50 +01:00
|
|
|
- Maybe add more photo sources, not only Flickr.
|
|
|
|
|
- ~~Define what is definitely needed in metadata to generate a gallery even when offline.~~ Should be done but maybe
|
|
|
|
|
needs more enhancements.
|
2022-11-19 05:33:46 +01:00
|
|
|
- Add API call to delete a photo in the source after downloading and creating metadata file.
|
2022-11-20 08:59:50 +01:00
|
|
|
- Tons of stuff... :)
|
