Theme Development in Octopress

Question

Octopress is a great blogging engine; however, I seem to have a lot of trouble finding how to create a new theme in Octopress.

The official guide I found (http://octopress.org/docs/theme/) only limits to how to modify the official theme, and doesn't really detail the syntax such as

{% assign index = true %}
{% for post in paginator.posts %}
{% assign content = post.content %}

nor the directory structures. Other theme creators (http://billpatrianakos.me/blog/2012/10/31/the-making-of-an-octopress-theme/) have simply done this by looking at the default theme, which is the path I might take.

But before I embark on this strenuous process, I want to know if there is some kind of guide to creating Octopress themes that I might have missed.

Thank you,

I has the same issue as you, and after I learned more I wrote [a short guide](http://chymeric.eu/blog/2013/12/30/octopress-theme/) to octopress theming. It is by no means exhaustive, but it teaches you a bit about the octopress structure and that you can always use ```grep``` to find out more about your individual use case. — TheChymera, Jun 25 '14 at 02:29
thanks! I ended up writing my own theme also by looking at another theme as an example: https://github.com/rickypai/octopai — rickypai, Jun 26 '14 at 18:49

score 15 · Accepted Answer · edited Aug 20 '13 at 23:09

15

Octopress themes are in reality just Jekyll templates (Octopress is a wrapper around Jekyll that provides nice extras) which use the Liquid templating engine.

You can learn more about Jekyll (including the directory structure) from the documentation. You can learn more about Liquid tags on their GitHub wiki.

edited Aug 20 '13 at 23:09

Praveen Gowda I V

8,920
4
39
49

answered Jul 08 '13 at 00:22

Sam Whited

4,954
1
26
35

1

Thanks Sam, this is hugely helpful. Being unfamiliar with Jekyll (but familiar with Octopress) I was under the impression that Octopress had invented that directory structure and methods of naming. No longer! :) – Rob S. Aug 21 '13 at 21:35

score 2 · Answer 2 · answered Apr 30 '13 at 19:24

2

You could look at other people theme code on github: https://github.com/imathis/octopress/wiki/3rd-Party-Octopress-Themes

answered Apr 30 '13 at 19:24

tomordonez

321
2
11

Theme Development in Octopress

2 Answers2