Octopress的一些技巧

写在前面：换到Octopress还没几天，一步一步地配置，一步一步地学习，不得不承认，Octopress不愧是A blogging framework for hackers.，期间遇到了很多问题，很是让人头疼，而且可能还是比较小众吧，在搜索引擎中中文的帮助信息相当有限，所以也逼我看英文的文档跟手册，以往看到大段的英文总是头疼，现在也算是适应了吧。顺带提一句，Stack Overflow真的很好用，能够有效地获取帮助，IRC也是不错的选择，上面的技术牛人很nice的，获取帮助快速有效。还认识了几位靠谱的Geek，也给了我不少的帮助，谢谢啦～

Octopress is an obsessively designed framework for Jekyll blogging. It’s easy to configure and easy to deploy. Sweet huh?

Octopress目录结构

source/
  _includes/    # Main layout partials
    custom/     # <- Customize head, header, navigation, footer, and sidebar here
    asides/     # Theme sidebar partials
    post/       # post metadata, sharing & comment partials
  _layouts/     # layouts for pages, posts & category archives

Octopress相关

生成及发布：

rake generate   # Generates posts and pages into the public directory
rake watch      # Watches source/ and sass/ for changes and regenerates
rake preview    # Watches, and mounts a webserver at http://localhost:4000

更新Octopress：

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

Git相关

详见官网的帮助文档

Markdown语法

号称最简单易学的标记语言，在这儿可以查看到完整的说明文档，这儿是中文版的。然后还有这里是在线的Markdown编辑器。

个性化设置

在Octopress官网的Theming & Customization可以查看到详细说明。

在_config.yml（这个配置文件的语法是yaml，有兴趣的可以看看这篇简介）中，除了可以修改页面标题、描述之外，一些第三方服务也是支持的，诸如Twitter、Pinboard、Delicious……只需要填入相应的用户名或相关信息就可以在相应位置显示了（注意冒号后面应该留个空格），还可以在这里重新安排它们的位置，创建自定义的侧边栏。

在source目录下可以写一个404.html，这个就是404页面了。

编辑/source/_includes/custom/里的相应文件就可以修改header, footer, navigation了。

添加一个新页面：

rake new_page['About']

我这里添加了个about页面，这会在source目录下生成一个about/index.markdown，同样是markdown编写，跟文章一样。下面让它显示到导航条中。只要编辑source/_includes/custom/navigation.html就行了，编辑之后是这个样子的：

<ul class="main-navigation">
  <li><a href="/">Blog</a></li>
  <li><a href="/blog/archives">Archives</a></li>
  <li><a href="/about">About</a></li>
</ul>