imagesite 1.0.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 661a146b20c466fab9d7465057a75ceccf256a05
+  data.tar.gz: fb6c1ec0e6cc189288a0ca9d6bbe920d12720e07
+SHA512:
+  metadata.gz: f2a8865a3e34cf46384d88d56f83bca30310a6831ea497a949d2ab473c3efdc81a0c4e39b5d7d77e733e89f27f5d6a24621b43d395dda497d8be2ffffe990f16
+  data.tar.gz: 29e0ab6de03653d3fae7e0969c4e61402900ac929a5363e1beb175eeb8887a035f2dbed6e71831619e3738cd16fbfbcaeadb30e97a98e3872d82729ad776399e

data/Gemfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+source 'https://rubygems.org/'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    imagesite (1.0.0.pre)
+      erubis (>= 2.7.0)
+      exifr (>= 1.2.4)
+      image_science (>= 1.3.0)
+      xmp (>= 0.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    RubyInline (3.12.4)
+      ZenTest (~> 4.3)
+    ZenTest (4.11.1)
+    addressable (2.4.0)
+    capybara (2.7.1)
+      addressable
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    erubis (2.7.0)
+    exifr (1.2.4)
+    image_science (1.3.0)
+      RubyInline (~> 3.9)
+    json (1.8.3)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    nokogiri (1.5.11)
+    rack (1.5.5)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rake (0.9.6)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.2)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    simplecov (0.11.2)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    xmp (0.2.0)
+      nokogiri (~> 1.5.0)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.12.5)
+  capybara (>= 2.7.1)
+  imagesite!
+  rake (>= 0.9.6)
+  rspec (>= 3.5.0)
+  simplecov (>= 0.11.2)
+
+BUNDLED WITH
+   1.12.5

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Dave Schweisguth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,61 @@
+# imagesite
+
+OS X's iPhoto software had a feature that exported photos to a static web site.
+iPhoto was discontinued in 2015. Its replacement, Photos, does not have that
+feature. imagesite approximates that feature.
+
+imagesite HTML is similar, but not identical, to iPhoto's.
+imagesite's HTML is amateurishly styled, although somewhat less so than iPhoto's.
+On the bright side, imagesite's output includes an image's tags as well as 
+its title and description.
+
+## Requirements
+
+imagesite works with Ruby 2.0.0p648, which comes with OS X 10.11 (El Capitan), 
+and with later versions of Ruby.
+If your Mac has an older OS X, imagesite may or may not work with its built-in Ruby.
+If not, you may be able to install a newer Ruby on your Mac to use with imagesite.
+
+## Installation
+
+If you're using the Ruby that comes with OS X,
+
+    $ sudo gem install imagesite
+
+If you're using a Ruby that you installed yourself, `sudo` may or may not be appropriate.
+
+## Usage
+
+- Edit and annotate your images in Photos as usual.
+- Export your images from Photos (select them and choose
+  File ▶ Export ▶ Export Photos…, or type ⇧⌘E).
+- Run imagesite in Terminal:
+
+      $ imagesite -t 'Images' -o ~/Desktop/images ~/Desktop/images-export/*
+    
+  Replace `'Images'` with whatever you'd like the title of the image set to be,
+  `~/Desktop/images` with whatever you'd like the output directory to be, and
+  `~/Desktop/images-export` with the directory into which you exported your
+  images from Photos.
+  
+imagesite puts photos in its output in the order in which they're given to it
+on the command line. Unix, unlike Finder, sorts files whose names begin with
+numbers (such as those created by Photos' Sequential filename export option)
+in a way that requires leading zeros. You may, therefore, need to add
+leading zeros to your exported image filenames for `*` to list them in the order
+you want.
+
+### Customizing the output
+
+Run `imagesite -h` to see more options.
+  
+imagesite's HTML is largely determined by two template files. To change them,
+run the following command to see where they are
+
+    $ gem contents imagesite
+    
+and edit them to your liking.
+
+## License
+
+imagesite is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/imagesite

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require_relative '../lib/image_site/image_site'
+
+ImageSite::ImageSite.new.run

data/imagesite.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |spec|
+  spec.name          = 'imagesite'
+  spec.version       = '1.0.0.pre'
+  spec.author        = 'Dave Schweisguth'
+  spec.email         = 'dave@schweisguth.org'
+
+  spec.summary       = %q{iPhoto-style web export for Photos}
+  spec.description   = %q{OS X's iPhoto software had a feature that exported photos to a static web site. iPhoto was discontinued in 2015. Its replacement, Photos, does not have that feature. imagesite approximates that feature.}
+  spec.homepage      = 'https://github.com/dschweisguth/imagesite'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(.gitignore|.idea/|.rspec|spec/)}) }
+  spec.bindir	       = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+
+  spec.required_ruby_version = '~> 2.0'
+
+  spec.add_runtime_dependency 'exifr', '>= 1.2.4'
+  spec.add_runtime_dependency 'xmp', '>= 0.2.0'
+  spec.add_runtime_dependency 'image_science', '>= 1.3.0'
+  spec.add_runtime_dependency 'erubis', '>= 2.7.0'
+
+  spec.add_development_dependency 'bundler', '>= 1.12.5'
+  spec.add_development_dependency 'rake', '>= 0.9.6'
+  spec.add_development_dependency 'rspec', '>= 3.5.0'
+  spec.add_development_dependency 'capybara', '>= 2.7.1'
+  spec.add_development_dependency 'simplecov', '>= 0.11.2'
+
+end

data/lib/image_site/image.rb

@@ -0,0 +1,90 @@
+require 'fileutils'
+require 'image_science'
+require 'xmp'
+require 'exifr'
+require_relative 'model'
+
+module ImageSite
+  class Image < Model
+    def self.all(options)
+      images = options.files.map.with_index(1) do |file, i|
+        Image.new i, file, options
+      end
+      images.each.with_index do |image, i|
+        if i > 0
+          image.previous = images[i - 1]
+        end
+        if i < images.length - 1
+          image.next = images[i + 1]
+        end
+      end
+    end
+
+    def self.template_name
+      'Page.html.erb'
+    end
+    private_class_method :template_name
+
+    attr_accessor :next, :previous, :index
+
+    def initialize(number, file, options)
+      super number, options
+      @file = file
+    end
+
+    def write
+      write_scaled_image relative_image, 912
+      write_html image: self
+    end
+
+    def relative_image
+      "Images/#{@number}.jpeg"
+    end
+
+    def title
+      xmp && xmp.dc && xmp.dc.title && xmp.dc.title.first
+    end
+
+    NEWLINE = "\xE2\x80\xA8".force_encoding('ASCII-8BIT')
+
+    def description
+      exif && exif.image_description && exif.image_description.gsub(NEWLINE, "<br/>\n")
+    end
+
+    def tags
+      xmp && xmp.dc && xmp.dc.subject || []
+    end
+
+    def relative_html
+      "Pages/#{@number}.html"
+    end
+
+    def write_thumbnail
+      write_scaled_image relative_thumbnail, 240
+    end
+
+    def relative_thumbnail
+      "Thumbnails/#{@number}.jpeg"
+    end
+
+    private
+
+    def write_scaled_image(unqualified_name, size)
+      make_subdir File.dirname(unqualified_name)
+      ImageScience.with_image @file do |image|
+        image.thumbnail size do |thumbnail|
+          thumbnail.save "#{@options.output_dir}/#{unqualified_name}"
+        end
+      end
+    end
+
+    def xmp
+      @xmp ||= XMP.parse exif
+    end
+
+    def exif
+      @exif ||= EXIFR::JPEG.new @file
+    end
+
+  end
+end

data/lib/image_site/image_site.rb

@@ -0,0 +1,12 @@
+require_relative 'options'
+require_relative 'index'
+
+module ImageSite
+  class ImageSite
+    def run
+      options = Options.new
+      options.parse!
+      Index.write_all(options)
+    end
+  end
+end

data/lib/image_site/index.rb

@@ -0,0 +1,48 @@
+require_relative 'image'
+
+module ImageSite
+  class Index < Model
+    def self.write_all(options)
+      images = Image.all options
+      indexes = all images, options
+      images.each(&:write)
+      indexes.each(&:write)
+    end
+
+    def self.all(images, options)
+      indexes =
+        images.
+        each_slice(options.columns * options.rows).
+        with_index(1).
+        map { |images_for_index, i| Index.new(i, images_for_index, options) }
+      indexes.each do |index|
+        index.indexes = indexes
+        index.images.each { |image| image.index = index }
+      end
+    end
+    private_class_method :all
+
+    def self.template_name
+      'index.html.erb'
+    end
+    private_class_method :template_name
+
+    attr_reader :images
+    attr_accessor :indexes
+
+    def initialize(number, images, options)
+      super number, options
+      @images = images
+    end
+
+    def write
+      images.each(&:write_thumbnail)
+      write_html index: self
+    end
+
+    def relative_html
+      "index#{if @number > 1 then @number end}.html"
+    end
+
+  end
+end

data/lib/image_site/model.rb

@@ -0,0 +1,28 @@
+require 'erubis'
+
+module ImageSite
+  class Model
+    attr_reader :number
+
+    def self.template
+      @template ||= IO.read "template/#{template_name}"
+    end
+
+    def initialize(number, options)
+      @number = number
+      @options = options
+    end
+
+    def make_subdir(subdir)
+      FileUtils.mkdir_p "#{@options.output_dir}/#{subdir}"
+    end
+
+    def write_html(bindings)
+      make_subdir File.dirname(relative_html)
+      bindings = { options: @options }.merge bindings
+      page = Erubis::Eruby.new(self.class.template).result(bindings)
+      IO.write "#{@options.output_dir}/#{relative_html}", page
+    end
+
+  end
+end

data/lib/image_site/options.rb

@@ -0,0 +1,68 @@
+require 'optparse'
+
+module ImageSite
+  class Options
+    DEFAULT_COLUMNS = 4
+    DEFAULT_ROWS = 10
+
+    attr_reader :title, :columns, :rows, :parent_link_text, :output_dir, :files
+
+    def initialize
+      @title = nil
+      @columns = DEFAULT_COLUMNS
+      @rows = DEFAULT_ROWS
+      @parent_link_text = nil
+      @output_dir = nil
+    end
+
+    def parse!
+      parser = OptionParser.new do |op|
+        op.banner = "Usage: #{$0} -t TITLE -o OUTPUT_DIR [other options] file [...]"
+
+        op.on('-t TITLE', "Title of the set of images") do |title|
+          @title = title
+        end
+        op.on('-c COLUMNS', "The number of columns of thumbnails on each index page (default #{DEFAULT_COLUMNS})") do |columns|
+          @columns = columns.to_i
+        end
+        op.on('-r ROWS', "The number of rows of photos on each index page (default #{DEFAULT_ROWS})") do |rows|
+          @rows = rows.to_i
+        end
+        op.on('-p PARENT_LINK_TEXT', "The text of the link to ../ on the last index page") do |parent_link_text|
+          @parent_link_text = parent_link_text
+        end
+        op.on('-o OUTPUT_DIR', "Output directory") do |output_dir|
+          @output_dir = output_dir
+        end
+
+        # -h and --help work by default, but implement them explicitly so they're
+        # documented
+        op.on("-h", "--help", "Prints this help") do
+          warn op.to_s
+          exit
+        end
+
+      end
+      begin
+        parser.parse!
+      rescue OptionParser::ParseError
+        abort parser.to_s
+      end
+      if !@title
+        abort_with_help parser, "Please specify a title with -t."
+      end
+      if !@output_dir
+        abort_with_help parser, "Please specify an output directory with -o."
+      end
+      if ARGV.empty?
+        abort_with_help parser, "Please specify one or more image files."
+      end
+      @files = ARGV
+    end
+
+    def abort_with_help(parser, message)
+      abort "#{message}\n#{parser}"
+    end
+
+  end
+end

data/template/Page.html.erb

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title><%= image.title %></title>
+  <style>
+    body {
+      background-color: white;
+      color: black;
+    }
+  </style>
+</head>
+<body>
+  <p>
+    <% if image.previous %>
+    <a href="<%= image.previous.number %>.html">&lt;--Previous</a>
+    &nbsp;&nbsp;
+    <% end %>					      
+    <a href="../<%= image.index.relative_html %>">Up</a>
+    <% if image.next %>
+    &nbsp;&nbsp;
+    <a href="<%= image.next.number %>.html">Next--&gt;</a>
+    <% end %>					      
+  </p>
+  <p><img alt="<%= image.title %>" src="../<%= image.relative_image %>"/></p>
+  <% if image.title %>
+  <h1><%= image.title %></h1>
+  <% end %>
+  <% if image.description %>
+  <p><%= image.description %></p>
+  <% end %>
+  <% if image.tags.any? %>
+    <p>
+      <% image.tags.each do |tag| %>
+        <b><%= tag %></b>&nbsp;&nbsp;&nbsp;
+      <% end %>
+    </p>
+  <% end %>
+</body>
+</html>

data/template/index.html.erb

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title><%= options.title %></title>
+  <style>
+    body {
+      background-color: white;
+      color: black;
+    }
+
+    h1 {
+      text-align: center;
+    }
+
+    table {
+      width: 100%;
+      border-spacing: 2px;
+      border-collapse: separate;
+    }
+
+    td {
+      text-align: center;
+      width: <%= 100 / options.columns %>%;
+      padding: 2px;
+    }
+
+    img {
+      border: 0;
+      vertical-align: text-top;
+    }
+
+    .parent-link {
+      text-align: center;
+    }
+  </style>
+</head>
+<body>
+  <h1><%= options.title %></h1>
+  <% if index.indexes.length > 1 %>
+    <p>
+      <% index.indexes.each do |other_index| %>
+        <% if other_index == index %>
+          Page <%= other_index.number %>
+        <% else %>
+          <a href="<%= other_index.relative_html %>">Page <%= other_index.number %></a>
+        <% end %>
+        <% if other_index != index.indexes.last %>|<% end %>
+      <% end %>
+    </p>
+  <% end %>
+  <table>
+    <% index.images.each_slice options.columns do |row| %>
+      <tr>
+        <% row.each do |image| %>
+          <td>
+            <a href="<%= image.relative_html %>"><img alt="<%= image.title %>" src="<%= image.relative_thumbnail %>"></a><br/>
+            <%= image.title %>
+          </td>
+        <% end %>
+      </tr>
+    <% end %>
+  </table>
+  <% if index == index.indexes.last && options.parent_link_text %>
+    <p class="parent-link"><a href="../"><%= options.parent_link_text %></a></p>
+  <% end %>
+</body>
+</html>

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: imagesite
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre
+platform: ruby
+authors:
+- Dave Schweisguth
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: exifr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.4
+- !ruby/object:Gem::Dependency
+  name: xmp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: image_science
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: erubis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.12.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.12.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.6
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+description: OS X's iPhoto software had a feature that exported photos to a static
+  web site. iPhoto was discontinued in 2015. Its replacement, Photos, does not have
+  that feature. imagesite approximates that feature.
+email: dave@schweisguth.org
+executables:
+- imagesite
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/imagesite
+- imagesite.gemspec
+- lib/image_site/image.rb
+- lib/image_site/image_site.rb
+- lib/image_site/index.rb
+- lib/image_site/model.rb
+- lib/image_site/options.rb
+- template/Page.html.erb
+- template/index.html.erb
+homepage: https://github.com/dschweisguth/imagesite
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ~>
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14.1
+signing_key: 
+specification_version: 4
+summary: iPhoto-style web export for Photos
+test_files: []