Fast Ruby Blog

Blog for the Fast Ruby using Jekyll as the blog-engine.

Installation

To get the blog up and running in a local environment, follow the steps below:

1. Clone the repository: git clone git@github.com:fastruby/blog.git
2. Setup .ruby-version if you're using RVM.
3. Run bundle install to install Jekyll and other dependencies.
4. Start the blog by running bundle exec jekyll serve.

You can then access the blog at localhost:4000 (default port).

By default, the auto-regeneration is enabled, so any changes on HTML, CSS or posts will be auto-regenerated/compiled and viewable by refreshing the browser.

Creating a new post

$ bundle exec post:create

After saving the new file to /_posts/, you will see the post generated as HTML under /_site/ and published to your local blog if it's running.

To edit the post, first change the YAML variables post, date and categories. You can also change layout to use one of the layouts under /_layouts/ (only post and page exist for now).

Then, you can begin writing your post by replacing the existing copy beneath. NOTE: It should be written using Markdown syntax.

After you're done, simply save the file, and (optionally) run the blog locally if it's not already running to preview it.

Publishing a post

In order to publish your newly created post, simply create a branch and make a Pull Request. When the branch is merged and deployed, the post will be displayed in the blog.

Editing a post

To edit a post, simply edit the content for one of the markdown files and the HTML for the post will regenerate.

Deleting a post

To delete a post, you can unpublish it by setting a published flag under the post's YAML variables, see: http://jekyllrb.com/docs/frontmatter/