mio 2a081b0a2d | ||
---|---|---|
image | ||
template | ||
util | ||
.gitignore | ||
cli.go | ||
config.go | ||
go.mod | ||
go.sum | ||
main.go | ||
readme.md |
readme.md
Lamium
A simple HTML album generator.
Features:
- Generate rectangular or square image thumbnails
- Default plain theme with CSS lightbox
- Supported image types: .jpg, .png
- Supported image caption files: .txt, .html
This is currently a preview release and may contain issues.
Build
-
Download the source or
git clone
the repo. -
Install Go, then build:
go build -o lm .
Usage
-
Make a new album directory and change into it:
mkdir [album] && cd [album]
-
Add a folder of images (a "set") to the directory, including any image captions as .txt files.
-
Generate a new sample config and theme:
lm new
-
Edit the settings in the
.json
config file. -
Customise the default theme templates as desired.
-
Generate the album:
lm make
By default the make
option will output a public_html
folder inside the album source directory with the generated HTML files, images and thumbnails. The HTML album can then be uploaded to a web server directory using rsync or another file transfer application.
Example album structure:
album/
|- set1/
| |- image1.jpg
| |- image1.txt
| |- image2.jpg
| |- image2.txt
| |- index.txt
|- themes/
| |- [theme]/
| |- index.txt
|- lamium.json