Octopress is a framework built on top of Jekyll. It’s a static site generator which means that it lacks advance feature which would normally require scripting and a back-end like Wordpress. If you want to know whether you should switch to Octopress or would like to know some tweaks, tips or adjustments then continue through this post.
Why To Migrate From Wordpress
- Wordpress is a great blogging and CMS platform, but it just had too many features for my personal blog.
- So far I have found Octopress easier to maintain than Wordpress. There is no need to maintain wp-super-cache which serves up static pages in the same ways as Octopress along with not needing to manage a local and external LAMP stack.
- WordPress blogs are a common target for hackers and spammers. To avoid this you need to keep your version of Wordpress constantly up to date.
- Octopress allow you to create pages using Markdown instead of or along with HTML. Markdown has a cleaner, simpler and more readable syntax.
- Octopress uses Jekyll to build pages. All pages of the pages are static and no server-side processing involved. This means that any requested page can deliver immediately by the server to the user.
- THEME ETC, READY FROM THE GET GO
Features You Might Miss
- You can’t edit online from anywhere. With Wordpress a mobile app was available so you did not need to be at your computer/laptop to publish new posts.
- Yay Markdown. Shame there is no solid way to manipulate images except by hand. I have currently worked around this by using Picasa to host my images which will cache my images and resize my images.
- Octopress does not feature drafts, previews or publishing. When you deploy your site, you deploy everything. And the publication date is the date it was started, not when it’s finished.
- Although it’s nice not having to use the web interface it’s also a feature which I also miss being able to post from anywhere, on almost any device.
- SLOW PREVIEW LARGE POST
- Octopress has less plugins and themes available than Wordpress, If you want more features you will need to wait for someone to write it or write it yourself.
- By default Octopress does not have a comment system. Although there is the option to use an external service for page comments such as Disqus. But using a service like this means that the comments are not hosted on your service and you lack the flexibility of the Wordpress commenting system.
Octopress is a great platform targeted at programmers who want to start blogging without having the hassle of customizing static page generators and caching on Wordpress. Personally I think that Octopress is ideal for my personal blog or a blog maintained by several developers which is where version control becomes essential. Although it is not practical for other user like a normal blogger who just wants to write content, a copy-editor or a business looking for more advance features such as LOREMIPSUM.
Tips, Tweaks & Adjustments
Faster Page Generation Using Isolation
If you have a lot post in
source/_posts then it could take a long time to compile your posts every time you update you blog.
If you are only working on 1 post at a time then it would make sense to only compile that page, to do this use
This will isolate the post your are working on then automatically move all other posts to
When you are ready to publish your site, use
rake integrate, which will move all posts from
source/_stash and move them back to
Custom 404 Page
config.ru from the root directory and update the sinatra
not_found route to the following:
1 2 3
This will redirect to
http://yourdomain.com/404/ where the page is found, but we still need to create a page.
To do this use
rake new_page. This will create a new file named
index.markdown in your
1 2 3 4 5 6 7 8 9 10
View my 404 page here.
There is a related post plugin already included in Jekyll, to use it open up the
_layouts/posts.html template and edit it
To enable this function open up
_config.yml and set
The lsi option will use a statistical analysis to calculate which pages are most relevant.
Now you need to install GSL using Ruby Gems.
After GSL is installed you can regenerated your blog.
Category List / Cloud Tree
Download the files from Github.
3. Append to default_asides in
This plugin was created by tokkonopapa.
Escaping Special Character In Markdown
- Open up your Gemfile and add this:
- Install it using Bundler:
- Run the installation command through Bundler:
bundle exec octopress-popular-posts install
The popular posts asides will now generate whenever you run:
- Open up
config.ymland add this line:
Append to default_asides in
Offloading Images to Picasa
At first I hosted all of my images using Octopress, then later switch to Picasa to host my images becuase of the following.
- Images will be delivered from CDN (free)
- Images will cache & resize on the fly.
- You can create custom image sizes.
- Optimize image by selecting image quality.