Updating Octopress With Bug Fixes and Enhancments

For each Octopress project you have created (ie. for each blog / website you created with Octopress) you need to pull some code from Github remote (octopress master) and run a few rake tasks.

Before you start with an update, check you Octopress projects files have been added to the Git repository or Stashed out of the way - as Octopress will try and overwrite them (although as its using git it will fail and warn you about a merge conflict).

git pull octopress master     # Get the latest Octopress
bundle install                # Keep gems updated
rake update_source            # update the template's source
rake update_style             # update the template's style


Thank you

This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License, including custom images & stylesheets. Permissions beyond the scope of this license may be available at @jr0cket
Creative Commons License

Creating Content in Markdown for Your Octopress Blog

Octopress enables the creation of great looking blog post using simple markdown text. This gives you a no-fuss way of writing your blogs without getting distracted. Here I will cover how to add formatting to you text and embedding code and other useful media into your blog posts.

In my previous blog on Octopress I covered the blogging workflow and the handful of rake commands that help you create and deploy your blog posts consistently.

Read More

Customise Octopress Themes for Fun and Your Profit

Octopress themes are stored in the the root folder of your project in a folder called .themes. If you installed one of the custom themes for Octopress [link], the .themes folder is where the instructions tell you to clone the theme git repository.

Themes can also be installed by passing a parameter to the rake install command. the default theme being “classic”.

Using the .theme folder for your themes helps ensure that your customisations do not get over-written by Octopress updates .

Read More

Creating Blog Posts With Octopress

Octopress provides an easy way to create blog posts by proving a task that will automatically place and name your markdown file. This helps manage your blog posts in a sensible structure and avoids conflicts.

To create a new post, use the following command inside your Octopress project folder:

rake new_post["Title of your blog post"]

This will create a markdown file including frontmatter to apply the blog post style. The task creates the file under the _source folder and included the date at the start of the filename.

Read More

First Blog Post Ever - Awesome

This is the first blog post of many in my adventures in learning how to publish a blog using Octopress.

As a developer I want a lightweight tool to create and easily publish content interesting to other developers in the community. Although I can write HTML, CSS and JavaScript for webapps, I dont want to be slowed down writing these things when I am doing creative writing.

Using Octopress, which is a blogging framework on top of Jekyll, I can write my content using Markdown. As Markdown is just simple text with a few characters and indents used for formating, I can focus on the writing and make it as appealing as I can. I dont get distracted by the visual layout of the content and a standard design for the blog is consistently applied.

Read More