ezrider / image-gallery

A Jekyll site with the main goal to show a set of albums with ease and a pleasant theme out of the box.

Azores Image Gallery

This project is a small Frankestein that was put together from other similar projects:
• Jekyll Gallery Generator
• Jekyll MiniMagick new
• urban-theme

Check this blog post if you want to know more about the creation of Azores Image Gallery 😀

Demo

If you want to see Azores Image Gallery in action check this demo: it's a small set of galleries put together in 1 minute.

Use case

The main goal is to show a given set of albums with ease leveraging the flexibility of Jekyll to provide a pleasant theme.

The following configuration options are applied by default if not specified:

gallery:
  root: false               # When true, it generates the main gallery index at root level.
  dir: photos               # Path to the gallery
  symlink: true             # false: copy images into _site. true: create symbolic links (saves disk space)
  title: "Photos"           # Title for gallery index page
  title_prefix: "Photos: "  # Title prefix for gallery pages. Gallery title = title_prefix + gallery_name
  auto_orient: false        # False by defeault. When activated it rotates the images based on the exifr.
  sort_field: "date_time"   # How to sort galleries on the index page.
                            # Possible values are: title, date_time, best_image
  thumbnail_size:
    x: 300                  # max width of thumbnails (in pixels)
    y: 300                  # max height of thumbnails (in pixels)

Check _config.yml for the full list of options.

Installation and Configuration

Configuration

• Clone the project and simply place all your albums in the gallery folder that by default is photos.
• The first time only run bundle install to download all the dependencies.
• Start Jekyll by typing jekyll serve. The firts time the build starts (either with jekyll build or jekyll serve) it will take some time to generate all the thumbnails.

DONE! When Jekyll is ready navigate to localhost:4000 to browse all your images, and mobile integration with swiping is supported too!

To further improve the experience you can modify, or remove some configuration options like

title: Your awesome title
email: [email protected]
description: >- # this means to ignore newlines until "baseurl:"
  Write an awesome description for your new site here. You can edit this
  line in _config.yml. It will appear in your document head meta (for
  Google search results) and in your feed.xml site description.
baseurl: "" # the subpath of your site, e.g. /blog
url: "" # the base hostname & protocol for your site, e.g. http://example.com
twitter_username: jekyllrb
github_username:  jekyll

To make your website available in your local network run jekyll serve --host 0.0.0.0 and all the devices connected to the same network can navigate the albums by typing <local_ip>:4000. The <local_ip> is the local IP of the machine serving the Jekyll site. On OSx the IP can be easily discovered by accessing the Network Preferences.

Installation

Azores Image Gallery is based on Jekyll and ImageMagick.

Jekyll

To install Jekyll please refer to the steps documented in the Installation section of the official Jekyll website.

ImageMagick

ImageMagick is a powerful tool for manipulating images. Depending on your system refer to the following steps:

Linux

Ubuntu

On Ubuntu, you can run:

sudo apt-get install libmagickwand-dev

Centos

On Centos, you can run:

sudo yum install gcc ImageMagick-devel make which

Arch Linux

On Arch Linux, you can run:

pacman -Syy pkg-config imagemagick

Alpine Linux

On Alpine Linux, you can run:

apk add pkgconfig imagemagick imagemagick-dev imagemagick-libs

macOS

On macOS, you can run:

brew install pkg-config imagemagick

Windows

1. Download the latest binary from Windows Binary Release (as of today is ImageMagick-7.0.10-30-Q16-HDRI-x64-dll.exe).
2. When installing ImageMagick you need to turn on checkboxes Add application directory to your system path and Install development headers and librarries for C and C++.

Other useful info

• Azores Image Gallery uses under the hood Minimagick to generate all the thumbnails. Minimagick is a clone of Rmagic but with a smaller memory footprint.

• The symlink option, that is enabled by default, will create symbolic links instead of copying every pictures in order to save disk space. If you are using this option on a Windows machine make sure to run jekyll serve from a terminal with administrator permissions or it will fail.

• auto_orient options is disabled by default. If set to true Azores Image Gallery will use an Exif Reader to determine the actual orientation of a picture.