Artsy.github.io

Overview:

The Artsy OSS page and the blog run on top of a default Jekyll install. This article provides an overview of Jekyll and explains how to set up and run the site locally. It also covers how to add authors, write articles, and enable comments on the blog.

Features:

• Jekyll: The site runs on a default Jekyll installation.
• Installation: Provides instructions for installing the necessary dependencies, such as Ruby and v8.
• Local Development: Explains how to run the site locally using the rake serve command and mentions the need to set the PRODUCTION environment variable for generating category pages.
• Deployment: Describes how the site is automatically deployed to GitHub Pages using Circle and provides a rake command to trigger a local deployment.
• Adding an Author: Explains how to add an author by assigning a key in the _config.yml file.
• Authoring an Article: Provides instructions for creating a new post in the _posts directory, including a sample YAML header and information on adding categories. Mentions using post templates for getting started.
• Enabling Comments: Explains that comments for articles are managed using GitHub issues and provides instructions for creating an issue and attaching it to the article. Also mentions adding a comment_id attribute to the post's YAML front matter.
• Deploying an Article: Mentions the need for a snappy tweet for each article and provides options for getting it done.