photish 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bf314194e23c79c0044bb7ae4a1e89d85a75c249
-  data.tar.gz: 058379e40ecc0ebc40575335c620b626ba496874
+  metadata.gz: 9b24062db6ffb294975d675025cf9948d2396584
+  data.tar.gz: d3694dd3929c89a3c236519d0787874c3763846f
 SHA512:
-  metadata.gz: 71d79a7276c266b57e06f21811f823a5315c6941ec2c17498c1bb35e39eb0a51a2b9c7213b175a949b60923557d0fa1df007ad96306dd733481b50a942218646
-  data.tar.gz: 2a43e23ad1bc0e6a5623a8213df6c6acd686e8f3fdd77f44bf0aec6bef54ceb221a424a4f8334c9d15e84adacfc5d021468d8cdf51ab27f63073e4eb6383151f
+  metadata.gz: bee41d8d3348cb8a944979d430fe61a0f8ab901408ac7d5c982ca5f636fdbc9eeb9df14b2099beb1ccd639acac9453e92b19f95e8c3982cc29a98a2aa5979166
+  data.tar.gz: 9a9921a7d9a0373c3c0089533b1d4c73c09b29cba11392e1e9ff38984102d8ccc165960adc2e87d060041c337eef2674f563e98250a4d3814accc8db1070a3c4

data/README.md

@@ -1,26 +1,367 @@
 # Photish
 
+Photish is a simple, convention based (but configurable) static photo site
+generator. Photish allows you to group your photo collections by folder.
+Metadata can be written alongside the photo in a [YAML](http://yaml.org/) file
+with the same name as the photo.
+
+Photish will crawl through your directory of photos and metadata, and render
+the information in your website templates. Photish supports all template
+engines implemented by [Tilt](https://github.com/rtomayko/tilt) (currently over
+30 formats). It will also read your configuration and automatically convert
+your images to your configured size, dimensions, colourscheme, etc using
+[ImageMagick](http://www.imagemagick.org/script/index.php). Using this
+information, Photish creates a complete static website that can be hosted on an
+[NGINX](http://nginx.org/), [Apache HTTP Server](https://httpd.apache.org/), or
+even on [Github Pages](https://pages.github.com/).
+
+## Overview
+
+Photish turns this:
+
+    ./my_new_photo_site
+    ├── config.yml
+    ├── photos
+    │   ├── Big Dogs
+    │   │   ├── Tired Dogs.jpg
+    │   │   └── Winking Dog.jpg
+    │   └── Small Dogs
+    │       ├── Fluffy Dogs
+    │       │   ├── Exhausted Dogs.jpg
+    │       │   ├── Exhausted Dogs.yml
+    │       │   ├── Many Dogs.jpg
+    │       │   └── Many Dogs.yml
+    │       ├── Sleepy Dog.jpg
+    │       ├── Sleepy Dog.yml
+    │       └── Squishy Dogs
+    │           └── Big Ear Dog.jpg
+    └── site
+        ├── _templates
+        │   ├── album.slim
+        │   ├── collection.slim
+        │   ├── layout.slim
+        │   └── photo.slim
+        ├── custom.html
+        └── styles
+            └── basic.css
+
+Into this:
+
+    ./my_new_photo_site
+    └── output
+        ├── big-dogs
+        │   ├── index.html
+        │   ├── tired-dogs
+        │   │   ├── images
+        │   │   │   ├── tired-dogs-low.jpg
+        │   │   │   └── tired-dogs-original.jpg
+        │   │   └── index.html
+        │   └── winking-dog
+        │       ├── images
+        │       │   ├── winking-dog-low.jpg
+        │       │   └── winking-dog-original.jpg
+        │       └── index.html
+        ├── custom.html
+        ├── index.html
+        ├── small-dogs
+        │   ├── fluffy-dogs
+        │   │   ├── exhausted-dogs
+        │   │   │   ├── images
+        │   │   │   │   ├── exhausted-dogs-low.jpg
+        │   │   │   │   └── exhausted-dogs-original.jpg
+        │   │   │   └── index.html
+        │   │   ├── index.html
+        │   │   └── many-dogs
+        │   │       ├── images
+        │   │       │   ├── many-dogs-low.jpg
+        │   │       │   └── many-dogs-original.jpg
+        │   │       └── index.html
+        │   ├── index.html
+        │   ├── sleepy-dog
+        │   │   ├── images
+        │   │   │   ├── sleepy-dog-low.jpg
+        │   │   │   └── sleepy-dog-original.jpg
+        │   │   └── index.html
+        │   └── squishy-dogs
+        │       ├── big-ear-dog
+        │       │   ├── images
+        │       │   │   ├── big-ear-dog-low.jpg
+        │       │   │   └── big-ear-dog-original.jpg
+        │       │   └── index.html
+        │       └── index.html
+        └── styles
+            └── basic.css
+
+A breakdown of the before and after is as follows:
+
+1. For the **Collection** of photos in "Photos" an _index.html_ was created
+1. For each **Album** (that is a folder in the "Photos" collection), an
+   _index.html_ was created in a slugified sub folder
+1. For each **Photo** (an image file in the album), another _index.html_ was
+   created in a slugified sub folder named after the original photo
+1. For each of these Photos, a version of the **Image** was made in both "low"
+   and "original" quality in a sub folder called _images_
+
+The number of Images and the quality of each is completely configurable. Using
+the templating language of your choice you can easily generate a Photo
+collection driven website with all of your photos available in various
+qualities and formats.
+
 ## Installation
 
 Install the gem locally by running:
 
     $ gem install photish
 
+Alternatively, use [Bundler](http://bundler.io/). Create a folder for your
+photo site so you can track the version of Photish you are building with:
+
+    $ mkdir my_new_photo_site
+    $ cd my_new_photo_site
+    $ bundle init
+    $ echo 'gem "photish"' >> Gemfile
+    $ bundle install
+
 ## Usage
 
-TODO: Write usage instructions here
+Once you have photish installed. Get started with the following commands:
+
+### Initialize
+
+A skeleton site can be created by running the below command inside the
+`my_new_photo_site` folder:
+
+    $ photish init
+
+#### Basic Photish Structure
+
+Inside your `my_new_photo_site` folder, you will have a:
+
+File or Folder                    | Purpose
+--------------------------------- | -------
+`photos`                          | folder, for your photo collection and metadata
+`site`                            | folder for your templates, assets and static pages
+`site/_templates`                 | folder for your templates
+`site/_templates/layout.slim`     | file for the basic layout for all pages
+`site/_templates/collection.slim` | template file for your collection page
+`site/_templates/album.slim`      | template file for your album page(s)
+`site/_templates/photo.slim`      | template file for your photo page(s)
+`config.yml`                      | file to store all configuration in YAML format
+
+#### Template Engines
+
+By default Photish uses [Slim](http://slim-lang.com/) as the template language.
+The templates can be in any format supported by
+[Tilt](https://github.com/rtomayko/tilt). To use a different template language:
+
+1. Create a `layout`, `collection`, `album` and `photo` file with
+the file extension of the template engine you prefer
+1. Update `config.yml` to reference your newly created template files
+1. Re write the basic template code in your chosen language
+
+#### Site Assets, CSS, Images, JavaScript
+
+Any content not starting with an `_` (underscore) in the `site` folder will be
+copied to the `output` folder.
+
+In the example in the Overview section. There are 2 static asset files. These
+are:
+
+1. `site/styles/basic.css`
+1. `site/custom.html`
+
+Both of these files were copied by Photish to the output folder, respecting
+their folder/file hierarchy:
+
+1. `output/styles/basic.css`
+1. `site/custom.html`
+
+As documented in the Generate section, assets are copied before the site
+content is generated. If an asset has a conflicting name and path with a
+generated file, the generated file will clobber the asset.
+
+#### Config File Options
+
+Below is a basic `config.yml` file:
+
+```yaml
+port: 9876
+qualities:
+  - name: Original
+    params: []
+  - name: Low
+    params: ['-resize', '200x200']
+templates:
+  layout: layout.slim
+  collection: collection.slim
+  album: album.slim
+  photo: photo.slim
+```
+
+The meanings and purpose of each field is defined below:
+
+Field                  | Purpose
+---------------------- | -------
+`port`                 | the port number that the `photish host` command will bind to
+`qualities`            | an array of `name` and `params` fields for **Images**
+`qualities[]/name`     | the name of the **Image** quality
+`qualities[]/params`   | the parameters to be provided to the ImageMagick `convert` utility  for the **Image** file quality
+`templates`            | a listing of the various template files
+`templates/layout`     | the layout template file in the `site/_templates` folder
+`templates/collection` | the collection template file in the `site/_templates` folder
+`templates/album`      | the album template file in the `site/_templates` folder
+`templates/photo`      | the photo template file in the `site/_templates` folder
+
+#### Customizing Templates
+
+Below is the documentation for the various data available inside
+each of the templates.
+
+**Note:** `{type}` is a place holder depending on your chosen template engine
+the file extension will change. By default the template engine is
+[Slim](http://slim-lang.com/), so templates will end with the _slim_ extension.
+
+##### Layout Template
+
+`site/_templates/layout.{type}`
+
+The layout template is the base layout for all the other templates. The
+`collection`, `album` and `photo` templates will be rendered inside this
+layout. The layout template **must** include the `yield` statement to bind the
+sub template inside it. Below is an example [Slim](http://slim-lang.com/)
+template, the other templates will be bound where the `yield` statement is:
+
+```slim
+doctype html
+html
+  head
+    title Master Layout
+  body
+    == yield
+```
+
+##### Collection Template
+
+`site/_templates/collection.{type}`
+
+The collection template becomes the `index.html` for the root of the website.
+
+This template is passed the
+[Collection](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/collection.rb)
+model when rendered.
+
+Attribute or Method | Description
+------------------- | -----------
+url                 | the URL of this page
+metadata            | an object with methods for the attributes in the `photos.yml` file
+all_albums          | an array of all child [Albums](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/album.rb)
+all_photos          | an array of all child [Photos](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/photo.rb)
+all_images          | an array of all child [Images](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/image.rb)
+
+##### Album Template
+
+`site/_templates/album.{type}`
+
+For each folder in the `photos` directory, a slugified album folder is created
+with an `index.html` in it.
+
+This template is passed the
+[Album](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/album.rb)
+model when rendered.
+
+Attribute or Method | Description
+------------------- | -----------
+name                | the name of the folder, i.e. `photos/My album/` will become `My album`
+url                 | the URL of this page
+metadata            | an object with methods for the attributes in the `{album_name}.yml` file stored at the same level as the album
+all_albums          | an array of all child [Albums](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/album.rb)
+all_photos          | an array of all child [Photos](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/photo.rb)
+all_images          | an array of all child [Images](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/image.rb)
+
+##### Photo Template
+
+`site/_templates/photo.{type}`
+
+For each image in an Albums directory, a slugified photo folder is created
+with an `index.html` in it.
+
+This template is passed the
+[Photo](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/photo.rb)
+model when rendered.
+
+Attribute or Method | Description
+------------------- | -----------
+name                | the name of the photo, i.e. `photos/My album/My dog.jpg` will become `My dog`
+url                 | the URL of this page
+metadata            | an object with methods for the attributes in the `{photo_name}.yml` file stored at the same level as the photo
+exif                | an object with methods for the exif data of the original photo file
+images              | an array of all the [Images](https://github.com/henrylawson/photish/blob/master/lib/photish/gallery/image.rb) for this photo, an Image will be a version of the photo in the quality configured in `config.yml`
+
+### Generate
+
+The static HTML can be generated by running the below command inside the
+`my_new_photo_site` folder:
+
+    $ photish generate
+
+All generated content will be written to the `output` folder by default.
+
+#### Execution Order
+
+The Generate command does the following:
+
+1. Crawls the `photos` directory for photos and metadata
+1. Creates a site structure of Collection, Album(s), Photo(s) and Image(s)
+1. Copies all files in the `site` folder **not** beginning with an `_`
+   (underscore) to the `output` folder as these are viewed as "static" assets.
+   That is, folders like `_templates` are ignored
+1. Renders the HTML _index_ file(s) for the Collection, Album(s), Photo(s) and
+   Image(s) to the `output` folder
+1. Converts all Photo(s) to the configured quality versions, writing various
+   images to the `output` folder
+
+### Host
+
+To test and view your changes locally, the host command can be used to run a
+local
+[WEBrick](http://ruby-doc.org/stdlib-1.9.3/libdoc/webrick/rdoc/WEBrick.html)
+server to serve the HTML files:
+
+    $ photish host
+
+The local version of your website will be visible at [http://localhost:9876/](http://localhost:9876/)
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+If you would like to contribute to Photish by creating a new feature or fixing
+bugs, you are more then welcome!
+
+To develop:
+
+    $ git clone git@github.com:henrylawson/photish.git
+    $ cd photish
+    $ ./bin/setup     # installs dependencies
+    $ rake            # runs the tests
+    $ vim             # open up the project and begin contributing
+    $ ./bin/console   # for an interactive prompt
+
+To release:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+    $ git add -p                      # add in changed files
+    $ git commit -m 'Final commit'    # finish up changes
+    $ rake                            # ensure all tests pass
+    $ vim lib/photish/version.rb      # update version
+    $ rake release                    # release to rubygems
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/henrylawson/photish. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/henrylawson/photish. This project is intended to be a safe,
+welcoming space for collaboration, and contributors are expected to adhere to
+the [Contributor Covenant](contributor-covenant.org) code of conduct.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT
+License](http://opensource.org/licenses/MIT).
 

data/TODO.md

@@ -2,17 +2,17 @@
 
 ## Must Have
 
+1. `init` command to get started
 
 ## Might Have
 
-1. `init` command to get started
 1. `deploy` to deploy to github pages
-1. Better README.md
-1. Actual website, using photish
+1. Exception and error handling to have clearer errors
 1. Startup bash script should install image magick, libmagic, exiftool
+1. README table of contents
 
 ## Potential Features
 
-1. A sitemap feature
-1. A breadcrumb feature
+1. A sitemap helper
+1. A breadcrumb helper
 1. Relative/absolute with/without hostname URLs (for different host envs) with view helper

data/lib/photish/assets/config.yml

@@ -0,0 +1,12 @@
+---
+port: 9876
+qualities:
+  - name: Original
+    params: []
+  - name: Low
+    params: ['-resize', '200x200']
+templates:
+  layout: layout.slim
+  collection: collection.slim
+  album: album.slim
+  photo: photo.slim

data/lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Exhausted Dogs.yml

@@ -0,0 +1,2 @@
+---
+description: Soft fluffy doggy!

data/lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Many Dogs.yml

@@ -0,0 +1,2 @@
+---
+description: Many doggies!!

data/lib/photish/assets/photos/Small Dogs/Sleepy Dog.yml

@@ -0,0 +1,2 @@
+---
+description: A sleepy doggy!

data/lib/photish/assets/site/_templates/album.slim

@@ -0,0 +1,31 @@
+h1 Album "#{name}"
+h2 Sub Albums
+ul
+  - albums.each do |album|
+    li
+      a href=album.url
+        | #{album.name}
+  - if albums.empty?
+    li
+      | Empty
+h2 Photos
+ul
+  - photos.each do |photo|
+    li
+      a href=photo.url
+        | #{photo.name}
+  - if photos.empty?
+    li
+      | Empty
+h2 Photos
+ul
+  - all_photos.each do |photo|
+    li
+      a href=photo.url
+        | #{photo.name}
+h2 Images
+ul
+  - all_images.each do |image|
+    li
+      a href=image.url
+        | #{image.name}

data/lib/photish/assets/site/_templates/collection.slim

@@ -0,0 +1,19 @@
+h1 Collection "My Photo Site"
+h2 Albums
+ul
+  - albums.each do |album|
+    li
+      a href=album.url
+        | #{album.name}
+h2 Photos
+ul
+  - all_photos.each do |photo|
+    li
+      a href=photo.url
+        | #{photo.name}
+h2 Images
+ul
+  - all_images.each do |image|
+    li
+      a href=image.url
+        | #{image.name}

data/lib/photish/assets/site/_templates/layout.slim

@@ -0,0 +1,16 @@
+doctype html
+html
+  head
+    title Master Template
+    link href="/styles/basic.css" media="screen" rel="stylesheet" type="text/css"
+  body
+    == yield
+
+    h2 Asset Links
+    ul
+      li
+        a href="/custom.html"
+          | My Custom Page
+      li
+        a href="/styles/basic.css"
+          | CSS Download

data/lib/photish/assets/site/_templates/photo.slim

@@ -0,0 +1,10 @@
+h1 Photo "#{name}"
+h2 Images
+- if metadata.try(:description)
+  p #{metadata.try(:description)}
+ul
+  - images.each do |image|
+    li
+      a href=image.url
+        | #{image.name}
+        img src=image.url

data/lib/photish/assets/site/custom.html

@@ -0,0 +1,8 @@
+<html>
+  <head>
+  </head>
+  <body>
+    <h1>Custom Page</h1>
+    <p>Custom content</p>
+  </body>
+</html>

data/lib/photish/assets/site/styles/basic.css

@@ -0,0 +1,3 @@
+body {
+  font-family:arial;
+}

data/lib/photish/cli.rb

@@ -1,38 +1,26 @@
 require 'thor'
 require 'photish/generation'
 require 'photish/host'
+require 'photish/init'
 
 module Photish
   class CLI < Thor
     package_name "Photish"
 
     desc "generate", "Generates the gallery static site"
-    method_option :photo_dir,
-                  aliases: "-p",
-                  desc: "The directory where the photos live"
-    method_option :site_dir,
-                  aliases: "-s",
-                  desc: "The location of the site config and template files"
-    method_option :output_dir,
-                  aliases: "-o",
-                  desc: "The output directory where the generated site should go"
     def generate
       Photish::Generation.new(options).execute
     end
 
-    desc "host", "Generates the gallery static site"
-    method_option :photo_dir,
-                  aliases: "-p",
-                  desc: "The directory where the photos live"
-    method_option :site_dir,
-                  aliases: "-s",
-                  desc: "The location of the site config and template files"
-    method_option :output_dir,
-                  aliases: "-o",
-                  desc: "The output directory where the generated site should go"
+    desc "host", "Serves the HTML on a HTTP server at http://localhost:9876/"
     def host
       Photish::Host.new(options).execute
     end
+
+    desc "init", "Creates a basic Photish site sctructure"
+    def init
+      Photish::Init.new(options).execute
+    end
   end
 end
 

data/lib/photish/init.rb

@@ -0,0 +1,36 @@
+module Photish
+  class Init
+    include Photish::Log
+
+    def initialize(runtime_config)
+      @runtime_config = runtime_config
+    end
+
+    def execute
+      FileUtils.cp_r(config_file, Dir.pwd)
+      FileUtils.cp_r(photos_dir, Dir.pwd)
+      FileUtils.cp_r(site_dir, Dir.pwd)
+      log "Photish site initiated successfully"
+    end
+
+    private
+
+    attr_reader :runtime_config
+
+    def config_file
+      asset_path('config.yml')
+    end
+
+    def photos_dir
+      asset_path('photos')
+    end
+
+    def site_dir
+      asset_path('site')
+    end
+
+    def asset_path(*path)
+      File.join(File.dirname(__FILE__), 'assets', path)
+    end
+  end
+end

data/lib/photish/version.rb

@@ -1,3 +1,3 @@
 module Photish
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/photish.gemspec

@@ -10,7 +10,10 @@ Gem::Specification.new do |spec|
   spec.email         = ["henry.lawson@foinq.com"]
 
   spec.summary       = %q{A static photo site generator}
-  spec.description   = %q{Using a collection of photos grouped by folder, photish will generate a the website content using templates that you provide.}
+  spec.description   = %q{Photish is a simple, convention based (but
+  configurable) static photo site generator. Photish allows you to group your
+  photo collections by folder.  Metadata can be written alongside the photo in
+  a [YAML](http://yaml.org/) file with the same name as the photo.}
   spec.homepage      = "https://github.com/henrylawson/photish"
   spec.license       = "MIT"
 
@@ -19,15 +22,17 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "thor"
-  spec.add_dependency "activesupport"
-  spec.add_dependency "slim"
-  spec.add_dependency "tilt"
-  spec.add_dependency "mini_magick"
-  spec.add_dependency "ruby-filemagic"
-  spec.add_dependency "anemone"
-  spec.add_dependency "mini_exiftool"
-  spec.add_dependency "recursive-open-struct"
+  spec.required_ruby_version = '>= 1.8.6'
+
+  spec.add_dependency "thor", "~> 0.1"
+  spec.add_dependency "activesupport", "~> 4.2"
+  spec.add_dependency "slim", "~> 3.0"
+  spec.add_dependency "tilt", "~> 2.0"
+  spec.add_dependency "mini_magick", "~> 4.3"
+  spec.add_dependency "ruby-filemagic", "~> 0.7"
+  spec.add_dependency "anemone", "~> 0.7"
+  spec.add_dependency "mini_exiftool", "~> 2.5"
+  spec.add_dependency "recursive-open-struct", "~> 0.6"
 
   spec.add_development_dependency "bundler", "~> 1.10"
   spec.add_development_dependency "rake", "~> 10.0"

metadata

@@ -1,141 +1,141 @@
 --- !ruby/object:Gem::Specification
 name: photish
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Henry Lawson
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-22 00:00:00.000000000 Z
+date: 2015-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: slim
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: mini_magick
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: ruby-filemagic
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: anemone
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: mini_exiftool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: recursive-open-struct
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -234,8 +234,11 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Using a collection of photos grouped by folder, photish will generate
-  a the website content using templates that you provide.
+description: |-
+  Photish is a simple, convention based (but
+    configurable) static photo site generator. Photish allows you to group your
+    photo collections by folder.  Metadata can be written alongside the photo in
+    a [YAML](http://yaml.org/) file with the same name as the photo.
 email:
 - henry.lawson@foinq.com
 executables:
@@ -256,6 +259,22 @@ files:
 - bin/setup
 - exe/photish
 - lib/photish.rb
+- lib/photish/assets/config.yml
+- lib/photish/assets/photos/Big Dogs/Tired Dogs.jpg
+- lib/photish/assets/photos/Big Dogs/Winking Dog.jpg
+- lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Exhausted Dogs.jpg
+- lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Exhausted Dogs.yml
+- lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Many Dogs.jpg
+- lib/photish/assets/photos/Small Dogs/Fluffy Dogs/Many Dogs.yml
+- lib/photish/assets/photos/Small Dogs/Sleepy Dog.jpg
+- lib/photish/assets/photos/Small Dogs/Sleepy Dog.yml
+- lib/photish/assets/photos/Small Dogs/Squishy Dogs/Big Ear Dog.jpg
+- lib/photish/assets/site/_templates/album.slim
+- lib/photish/assets/site/_templates/collection.slim
+- lib/photish/assets/site/_templates/layout.slim
+- lib/photish/assets/site/_templates/photo.slim
+- lib/photish/assets/site/custom.html
+- lib/photish/assets/site/styles/basic.css
 - lib/photish/cli.rb
 - lib/photish/config/app_settings.rb
 - lib/photish/config/default_config.rb
@@ -271,6 +290,7 @@ files:
 - lib/photish/gallery/traits/urlable.rb
 - lib/photish/generation.rb
 - lib/photish/host.rb
+- lib/photish/init.rb
 - lib/photish/log.rb
 - lib/photish/render/image_conversion.rb
 - lib/photish/render/page.rb
@@ -289,7 +309,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.8.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="