{"id":13858612,"url":"https://github.com/ggreer/jekyll-gallery-generator","last_synced_at":"2025-05-16T05:00:19.577Z","repository":{"id":3551760,"uuid":"4612491","full_name":"ggreer/jekyll-gallery-generator","owner":"ggreer","description":"A Jekyll plugin that generates photo galleries from directories full of images.","archived":false,"fork":false,"pushed_at":"2024-01-14T13:39:13.000Z","size":72,"stargazers_count":363,"open_issues_count":7,"forks_count":67,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-12T14:01:44.987Z","etag":null,"topics":["image-processing","imagemagick","jekyll","jekyll-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ggreer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-06-10T03:36:59.000Z","updated_at":"2025-05-02T21:42:47.000Z","dependencies_parsed_at":"2022-07-12T15:00:40.601Z","dependency_job_id":null,"html_url":"https://github.com/ggreer/jekyll-gallery-generator","commit_stats":{"total_commits":105,"total_committers":14,"mean_commits":7.5,"dds":"0.18095238095238098","last_synced_commit":"a567838d7cebd18726fd5cf6df83d9a627ce385b"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggreer%2Fjekyll-gallery-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggreer%2Fjekyll-gallery-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggreer%2Fjekyll-gallery-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggreer%2Fjekyll-gallery-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ggreer","download_url":"https://codeload.github.com/ggreer/jekyll-gallery-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471028,"owners_count":22076582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-processing","imagemagick","jekyll","jekyll-plugin"],"created_at":"2024-08-05T03:02:15.001Z","updated_at":"2025-05-16T05:00:17.337Z","avatar_url":"https://github.com/ggreer.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# Gallery Generator\n\nThis is a [Jekyll plugin](http://jekyllrb.com/docs/plugins/) that generates galleries from directories full of images. It uses [RMagick](http://rmagick.rubyforge.org/) to create thumbnails.\n\nThis plugin is quite minimalist. It generates galleries with no pagination, no sub-galleries, and no descriptions. [See my gallery](http://geoff.greer.fm/photos/) for an example of what it looks like.\n\n[![Gem Version](https://img.shields.io/gem/v/jekyll-gallery-generator.svg)](https://rubygems.org/gems/jekyll-gallery-generator)\n\n[![Build Status](https://travis-ci.org/ggreer/jekyll-gallery-generator.svg?branch=master)](https://travis-ci.org/ggreer/jekyll-gallery-generator)\n\n[![Floobits Status](https://floobits.com/ggreer/jekyll-gallery-generator.svg)](https://floobits.com/ggreer/jekyll-gallery-generator/redirect)\n\n\n## Usage\n\n1. Install the `jekyll-gallery-generator` gem, either by running `gem install jekyll-gallery-generator` or by adding `gem 'jekyll-gallery-generator'` to your `Gemfile` and running `bundle`.\n\n2. Add `jekyll-gallery-generator` to the plugins list in your `_config.yml`:\n\n```yaml\nplugins:\n  - jekyll-gallery-generator\n```\n\n3. Copy your image directories into `jekyll-site/photos/`. Here's what my directory structure looks like:\n\n```bash\n$ ls jekyll-site/photos\nbest/          chile_trip/  japan_trip/\n$ ls jekyll-site/photos/chile_trip\nIMG_1039.JPG  IMG_1046.JPG  IMG_1057.JPG\n```\n\n4. Run `jekyll build` and be patient. It can take a while to generate all the thumbnails on the first run. After that, you should have pretty pictures.\n\n\n## Dependencies\n\n* [ImageMagick](http://www.imagemagick.org/)\n* [RMagick](https://github.com/rmagick/rmagick)\n* [exifr](https://github.com/remvee/exifr/)\n* [Ruby](https://www.ruby-lang.org) \u003e= 2.1\n\n### Install dependencies on OS X\n\n```bash\nbrew install imagemagick rbenv\nrbenv install 2.4.0\nrbenv global 2.4.0\ngem install rmagick exifr\n```\n\n### Install dependencies on Ubuntu\n\n```bash\napt install libmagick++-dev\ngem install rmagick exifr\n```\n\n## Configuration\n\nThis plugin reads several config options from `_config.yml`. The following options are supported (default settings are shown):\n\n```yaml\ngallery:\n  dir: photos               # Path to the gallery\n  symlink: false            # false: copy images into _site. true: create symbolic links (saves disk space)\n  title: \"Photos\"           # Title for gallery index page\n  title_prefix: \"Photos: \"  # Title prefix for gallery pages. Gallery title = title_prefix + gallery_name\n  sort_field: \"date_time\"   # How to sort galleries on the index page.\n                            # Possible values are: title, date_time, best_image\n  thumbnail_size:\n    x: 400                  # max width of thumbnails (in pixels)\n    y: 400                  # max height of thumbnails (in pixels)\n  # The following options are for individual galleries.\n  galleries:\n    chile_trip:\n      best_image: IMG_1068.JPG  # The image to show on the gallery index page. Defaults to the last image.\n    japan_trip:\n      best_image: IMG_0690.JPG\n      name: \"日本の旅\"       # Defaults to directory name, replacing _ with spaces \u0026 capitalizing words.\n    awesome_stuff:\n      best_image: snaileo_gonzales.jpg\n      sort_reverse: true    # Reverse sort images in gallery.\n    secret_stuff:\n      hidden: true          # Don't show this gallery on the index page. People must guess the URL.\n    with_info:\n      info:\n        desc: \"Gallery Description\" # Info fields can be used in custom templates.\n```\n\n\n## Overriding layouts\n\nIf you want to customize the templates used by this generator, copy `gallery_index.html` and `gallery_page.html` to your Jekyll site's `_layouts`:\n\n    cp lib/gallery_index.html jekyll-site/_layouts/\n    cp lib/gallery_page.html jekyll-site/_layouts/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggreer%2Fjekyll-gallery-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fggreer%2Fjekyll-gallery-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggreer%2Fjekyll-gallery-generator/lists"}