/artsy.github.io

The Artsy Engineering Open-Source Developers Blog

Primary LanguageCSS

Build Status

The Artsy OSS page and the blog run on top of a default jekyll install. If you'd like an overview of jekyll their website rocks.

Setup

  git clone git@github.com:artsy/artsy.github.io.git
  cd artsy.github.io
  rake bootstrap
  rake build

Running the OSS Site / Blog locally

Running rake serve will not generate category pages. They take a long time to generate. No one wants that when working on the site.

  rake serve

Categories are generated when the ENV var PRODUCTION = "YES".

Deploying

Travis CI will automatically deploy when new commits are pushed to the source branch, so you shouldn't need to deploy from your local computer. However, if you need to deploy locally, the rake deploy command is available.

Adding an Author

Authors are key-value stored, so you'll need to give yourself a key inside _config.yml - for example:

  joey:
    name: Joey Aghion
    github: joeyAghion
    twitter: joeyAghion
    site: http://joey.aghion.com

Everything but name is optional.

Authoring an Article

TLDR To generate a new post, create a new file in the _posts directory. Be sure to add your name as the author of the post and include a couple of categories to file the post under. Here's some sample header YAML:

---
layout: post
title: "Responsive Layouts with CSS3"
date: 2012-01-17 11:03
comments: true
author: Matt McNierney
github-url: https://www.github.com/mmcnierney14
twitter-url: http://twitter.com/mmcnierney
blog-url: http://mattmcnierney.wordpress.com
categories: [Design, CSS, HTML5]
---

More info can be found in the official docs.

When you have authored an article, git add and git commit it, then push to a named branch with git push origin [branch], and create a pull request to the source branch, it will be deployed to the site by travis when merged.