I’ve tried to keep configuring Octopress fairly simple and you’ll probably only ever change the
Rakefile and the
Here’s a list of files for configuring Octopress.
1 2 3 4
Configurations in the
Rakefile are mostly related to deployment and you probably won’t have to touch them unless you’re using rsync.
_config.yml there are three sections for configuring your Octopress Blog.
Spoiler: You must change
url, and you’ll probably change
author and enable some 3rd party services.
1 2 3 4 5 6 7 8 9 10 11
Note: If your site is a multi-author blog, you may want to set this config’s
author to the name of your
company or project, and add author metadata to posts and pages to give proper attribution for those works.
Jekyll & Plugins
These configurations are used by Jekyll and Plugins. If you’re not familiar with Jekyll, you should probably have a look at the configuration docs which lists more options that aren’t covered here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
If you want to change the way permalinks are written for your blog posts, see Jekyll’s permalink docs.
Note: Jekyll has a
baseurl config which offers mock subdirectory publishing support by adding a redirect to Jekyll’s WEBrick server. Please don’t use this.
If you want to publish your site to a subdirectory, (see Deploying Octopress to a Subdirectory).
3rd Party Settings
These third party integrations are already set up for you. Simply fill in the configurations and they’ll be added to your site.
- Github - List your github repositories in the sidebar
- Twitter - Setup a sidebar twitter feed, follow button, and tweet button (for sharing posts and pages).
- Google Plus One - Setup sharing for posts and pages on Google’s plus one network.
- Pinboard - Share your recent Pinboard bookmarks in the sidebar.
- Delicious - Share your recent Delicious bookmarks in the sidebar.
- Disqus Comments - Add your disqus short name to enable disqus comments on your site.
- Google Analytics - Add your tracking id to enable Google Analytics tracking for your site.
- Facebook - Add a Facebook like button