Skip to content
A fill in the blank version of the Gettysburg Address
JavaScript CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
images
js
styles
.editorconfig
.gitignore
.jshintrc
Gruntfile.js
LICENSE.txt
README.md
bower.json
index-build.html
index-deploy.html
index.html
package.json

README.md

Minnpost Gettysburg Address

A fill in the blank version of the Gettysburg Address.

Lincoln at Gettysburg

Data

Gettysburg Address text taken from abrahamlincolnonline.org, cited source of Collected Works of Abraham Lincoln, edited by Roy P. Basler.

Data processing

No data processing was used in this project. There was manual choosing of words to use for blanks.

Development and running locally

Prerequisites

All commands are assumed to on the command line, often called the Terminal, unless otherwise noted. The following will install technologies needed for the other steps and will only needed to be run once on your computer so there is a good chance you already have these technologies on your computer.

  1. Install Git.
    • On a Mac, install Homebrew, then do: brew install git
  2. Install NodeJS.
    • On a Mac, do: brew install node
  3. Optionally, for development, install Grunt: npm install -g grunt-cli
  4. Install Bower: npm install -g bower
  5. Install Ruby, though it is probably already installed on your system.
  6. Install Bundler: gem install bundler
  7. Install Sass: gem install sass
    • On a Mac do: sudo gem install sass
  8. Install Compass: gem install compass
    • On a Mac do: sudo gem install compass

Get code and install packages

Get the code for this project and install the necessary dependency libraries and packages.

  1. Check out this code with Git: git clone https://github.com/MinnPost/minnpost-gettysburg-address.git
  2. Go into the template directory: cd minnpost-gettysburg-address
  3. Install NodeJS packages: npm install
  4. Install Bower components: bower install

Running

  1. Get pump primed with: grunt
  2. Run: grunt server
    • This will run a local webserver for development and you can view the application in your web browser at http://localhost:8814.
    • Utilize index.html for development, while index-deploy.html is used for the deployed version, and index-build.html is used to test the build before deployment.
    • The server runs grunt watch which will watch for linting JS files and compiling SASS. If you have your own webserver, feel free to use that with just this command.

Build

To build or compile all the assets together for easy and efficient deployment, do the following. It will create all the files in the dist/ folder.

  1. Run: grunt

Deploy

Deploying will push the relevant files up to Amazon's AWS S3 so that they can be easily referenced on the MinnPost site. This is specific to MinnPost, and your deployment might be different.

  1. Run: grunt deploy

Hacks

You can’t perform that action at this time.