Linux Engineer and advocate for freedom and transparency
Getting Started With Octopress
This is my first post with Octopress.
I followed the installation instructions provided with Octopress,
and it was pretty easy on my 64-bit Fedora 15
laptop. In this post I describe:
Two issues I encountered during setup along with their solutions
Plugin configurations
Reordering plugins in the sidebar
Helpful references for Markdown
Issues
First, the version of rake required by Octopress did not match
what is installed by the gem bundle.
I fixed that by updating a single file in my git repo:
The second issue did not manifest itself until I tried to
add syntax highlighting to a code block. Luckily somebody else
had already identified the root cause and
posted a solution. On my machine, I ran cd ~/.rvm and then
modified the offending file like this:
Plugins were ridiculously easy to configure. For example,
enabling the Google Plus stuff was simply a matter of adding
my profile number:
Add Google Plus User ID
12345678910111213
diff --git a/_config.yml b/_config.ymlindex cdc7594..002b87b 100644--- a/_config.yml+++ b/_config.yml@@ -75,7 +75,7 @@ google_plus_one_size: medium # Google Plus Profile
# Hidden: No visible button, just add author information to search results
-googleplus_user:+googleplus_user: 114044653383272567071 googleplus_hidden: false
# Pinboard
For Disqus (comments), I signed up at disqus.com and registered
the URL http://jumanjiman.github.com
under the shortname jumanjiman.
Then I modified my config to be:
I decided I wanted the sidebar plugins to appear
slightly differently than default.
I changed the main config:
Reorder sidebar order
12345678910111213
diff --git a/_config.yml b/_config.ymlindex 024933b..fbcb630 100644--- a/_config.yml+++ b/_config.yml@@ -43,7 +43,7 @@ titlecase: true # Converts page and post titles to tilecase # list each of the sidebar modules you want to include, in the order you want them to appear.
# To add custom asides, create files in /source/_includes/custom/asides/ and add them to the list like 'custom/asides/custom_aside_name.html'
-default_asides: [asides/recent_posts.html, asides/github.html, asides/twitter.html, asides/delicious.html, asides/pinboard.html, asides/googleplus.html]+default_asides: [asides/recent_posts.html, asides/googleplus.html, asides/twitter.html, asides/github.html, asides/delicious.html, asides/pinboard.html] # Each layout uses the default asides, but they can have their own asides instead. Simply uncomment the lines below
# and add an array with the asides you want to use.
References
Here are some references that I found useful for
getting acquainted with Markdown: