Infoshop.io

This is the codebase that runs http://infoshop.io/. It is developed using nanoc and rsynced in static form to the server.

Installation

First, install the prerequisites and clone this codebase

# [Ruby Version Manager](http://rvm.io/) and [Ruby](http://ruby-lang.org/)

$ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
$ \curl -sSL https://get.rvm.io | bash -s stable
$ rvm install ruby-2.2.6

# [Homebrew](http://brew.sh/), Ghostscript, and ImageMagick

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew install gs
$ brew install imagemagick

# This generator codebase

$ git clone git@github.com/infoshop-io/generator
$ cd generator
$ git submodule init
$ git submodule update
$ gem install bundler
$ bundle install

Next, in two different terminal windows, run guard and nanoc view:

$ bundle exec guard
$ bundle exec nanoc view

Now load http://localhost:3000/ to see the preview server.

Maintenance

To add a resource to the infoshop, move the PDF file into content/media with a unique filename, then create a YAML file in parallel (it must differ from the PDF in extension only) with the following structure:

---
title: "TITLE_GOES_HERE"
summary: "ONE_SENTENCE_SUMMARY"
publisher: "PUBLISHER_OPTIONAL"
date: "DATE_OPTIONAL"
editors:
  - EDITORS_OPTIONAL
authors:
  - AUTHORS_OPTIONAL
languages: 
  - en
tags:
  - introduction
sources: 
  - SOURCE_URLS_OPTIONAL
---

Anything tagged with "introduction" will appear on the landing page. Check the entry in your browser to make sure it looks right--that's the step that generates the preview image.

Deployment

To deploy, make sure you can push to both this repository and the site repo, then run:

$ ./publish