A simple static site generator for photoessays
X
Perl
Meet Expose, a rock-solid, simple-to-use static site generator perfect for those captivating photoessays you’ve always wanted to create. If you’ve got a penchant for photography and want to showcase your work in style, Expose is the no-fuss tool to make it happen, designed with the everyman in mind. Imagine this: folders packed with your beautiful images and videos, just sitting in your computer. Normally, turning these into an engaging photoessay would be a tedious job. But with Expose, a Bash script, you can transform these files into a stunning visual story effortlessly. It spits out a professional-grade photoessay similar to the ones seen on jack.ventures or jack.works—those sleek, visually-appealing personal blogs everyone loves to scroll through. Now, you might not be a big fan of that Jack flavor. No worries, because Expose comes with a snazzy Medium-style theme, too. Whether you’re running Windows with Cygwin, MacOS, or even Linux, you’re covered—this versatile little tool won’t let you down. Now that I have your attention, let’s talk installs. The only catch? You’ll need Imagemagick, and if you’re planning on throwing videos into the mix, FFmpeg as well. To get going, all you need to do is download the repo and sneak Expose into your alias stable: alias expose=/script/location/expose.sh Want it to stick around for good? Just add that line to your ~/.profiles or ~/.bashrc. Easy peasy. Using Expose is as straightforward as your morning coffee ritual. Shuffle into your folder of images, type ‘expose’ and hit enter. Bam! This script works its magic on your current working directory, chucking the output into a new ‘_site’ directory. And if you’re the tweaking kind, Expose has got custom configuration options for you to play with. Adjust the site title, theme, JPEG quality, and more, right in the script or via a `_config.sh` file. Need a quick peek before the final show? The `-d` flag lets you preview the essay in draft mode with low-res images. Whether you’re a meticulous planner or an on-the-fly creator, Expose respects your workflow—generated images and videos aren’t overwritten unless you clean out the existing ‘_site’ folder first. Each image comes with its own text note, gleaning text from files sharing the image’s filename. Alphabetical sorting keeps everything tidy, but if you like a bit of control, slap on numerical prefixes to order your images just right. Nest folders any way you like, they’ll render accurately in a nested HTML menu complete with custom ordering if numerically prefixed. For those who crave metadata, YAML support is included and fully integrated into the themes. And speaking of themes, there are two default options that come with Expose, with extensive custom properties to make it your own—from CSS classes to image-specific widths. And if you’re adventurous, create a whole new theme; the sky’s the limit. Video options? You betcha! With FFmpeg, apply cool filters and effects directly, getting that cinematographic touch just right. From simple cuts to complex LUT applications, Expose has configurations for it all. As for ImageMagick, it lets you apply incredible effects across your gallery—like adding a watermark or transforming images into striking black-and-white pieces, all through easily configurable options. Got a timelapse or stop-motion idea brewing? Fret not, for certain keywords trigger Expose to treat image sequences appropriately, encoding them at 24fps. In two clicks and a clap, Expose extensionally generates content using its templates. Remember, the goal here is fewer dependencies and more raw power—utilizing simple sed regex parse for fast, efficient metadata processing. So, ditch the over-complicated editors and come on over to Expose. It’s built for passionate photographers who want their work to speak volumes with minimal fuss. Get on with the program and check it out on GitHub. You won’t regret it.
Check out site