Skip to content

Latest commit

 

History

History
93 lines (70 loc) · 2.25 KB

README.md

File metadata and controls

93 lines (70 loc) · 2.25 KB

Playasophy Website

This repo contains an Octopress website for the Playasophy Burning Man camp.

Working With the Website

The website uses the rake command-line build tool. This is based on the Ruby programming language. The general invocation is rake <task>. Use rake -T for a list of available tasks to run.

Blog Posting

Open directory.

rake -T
rake new_post’[X]’
rake preview #will show preview of post in localhost:3003

Open post in source/_post and edit/add text.

git status   #Will show what is different.
git add source
git commit -m “commit message”
./aws-rake media:diff #Will show what is different in media
./aws-rake media:push #Will upload new media to S3
./aws-rake deploy #publishes

AWS Credentials

To interact with S3 and deploy the website, you'll need AWS credentials. The easiest way to use these is to create a script file which runs Rake with the credentials as environment variables:

#!/bin/bash

AWS_ACCESS_KEY_ID="<key id>" \
AWS_SECRET_ACCESS_KEY="<secret key>" \
rake "$@"

Media

Media for the site is served from a separate directory as the rest of the website files. Locally, this is the media/ directory. These files are published to s3://www.playasopy.org/media/ separately and not tracked in git.

To compare the local files to S3, use the media:diff task. This task shows media which matches as green, and missing or differing files as red with a status message.

% ./aws-rake media:diff
Listing media files in s3://www.playasophy.org/media/
Found 55 objects
Listing local files matching media/**/*
Found 55 files
camp/2012/camp_photo.jpg
camp/2013/layout/final-iso.png
...

To pull media down from S3, use media:pull. To push local media, use media:push. All of these tasks can be passed a prefix, which will restrict the task to files which start with the given prefix. For example, to only upload camp media for 2012, you could do:

% ./aws-rake 'media:diff[camp/2012/]'

Publishing

Deploying the website to S3 uses the s3_website gem. This can be done using the deploy:s3 task:

% ./aws-rake deploy:s3

Committing

git add X
git commit -m “commit message”
git push