shellery/README.md

92 lines
1.6 KiB
Markdown

# Shellery
Simple SSG to create dynamic gallery one-pagers in your shell! Shell+Gallery
[Issue Tracker and Requests](https://git.uphillsecurity.com/cf7/shellery/issues)
- Status: Beta
- Instance/ Demo: [schief-117.com](https://schief-117.com/)
---
## Features
**Available**:
- Simple use without dependencies
- no Javascript
- Lightbox of image with anchor
- Order of images via filename
- Container available
- Simple to modify (Pictures and Templates)
**Ideas**:
- check file formats
- remove exif data
- conf file for options
- anonymize file names
- sections via file names
**Not planned**:
---
## Usage
### Docker / Podman
```bash
mkdir -p images output
podman run -v $(pwd)/images:/app/images -v $(pwd)/output:/app/output git.uphillsecurity.com/cf7/shellery:latest
```
### Local
- Clone
- Put images into `./images/`
- `./build.sh`
- Check `./output/`
Modify files accordingly.
### Docker Build
Build and run:
```bash
docker build -t localhost/shellery .
docker run -v $(pwd)/images:/app/images -v $(pwd)/output:/app/output localhost/shellery
```
The generated gallery will be in `./output/index.html`
---
## Notes
- [Github Mirror](https://github.com/CaffeineFueled1/shellery)
---
## Security
For security concerns or reports, please contact via `hello a t uphillsecurity d o t com` [gpg](https://uphillsecurity.com/gpg).
---
## License
**Apache License**
Version 2.0, January 2004
http://www.apache.org/licenses/
- ✅ Commercial use
- ✅ Modification
- ✅ Distribution
- ✅ Patent use
- ✅ Private use
- ✅ Limitations
- ❌Trademark use
- ❌Liability
- ❌Warranty