AoboSir 博客

与15年前的我比，我现在是大人；与15年后的我比，我现在还是个婴儿

Octopress 搭建静态博客站点 --- 为站点侧边栏添加分类列表（Categories）

一共三步，很简单。跟着走就可以。

Step 1 . 增加 category_list 插件

在 octopress\plugins\ 文件夹里面，新建一个文件，取名为：category_list_tag.rb。并将下面的代码粘贴到里面。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

module Jekyll
  class CategoryListTag < Liquid::Tag
    def render(context)
      html = ""
      categories = context.registers[:site].categories.keys
      categories.sort.each do |category|
        posts_in_category = context.registers[:site].categories[category].size
        category_dir = context.registers[:site].config['category_dir']
        category_url = File.join(category_dir, category.gsub(/_|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase)
        html << "<li class='category'><a href='/#{category_url}/'>#{category} (#{posts_in_category})</a></li>\n"
      end
      html
    end
  end
end

Liquid::Template.register_tag('category_list', Jekyll::CategoryListTag)

这个插件会向liquid注册一个名为category_list的tag，该tag就是以li的形式将站点所有的category组织起来。如果要将category加入到侧边导航栏，需要增加一个aside。

Step 2 . 增加 aside

在 octopress\source\_includes\asides\ 文件夹里面，新建一个文件，取名为：category_list.html 。并粘贴下面的代码：

注意： 去掉 % 前面的 \。

1
2
3
4
5
6

<section>
  <h1>Categories</h1>
  <ul id="categories">
      {\% category_list \%}
  </ul>
</section>

Step 3 . 在 _config.yml 文件里面 ，修改 default_asides 项

打开 octopress\_config.yml 文件，修改里面的 default_asides 项，将 asides/category_list.html 添加进去。

1

default_asides: [asides/category_list.html, ......]

搞定

现在，我们执行 rake generate 命令来生成最新的博客站点。然后执行 rake preview 命令在本地预览博客站点。 看看修改后的效果。

Alt text

参考网站：

为octopress添加分类(category)列表 http://codemacro.com/2012/07/18/add-category-list-to-octopress/

Comments