介绍我为 Hexo 编写的第二个主题 Wixo 。

自从我将博客的主题 Freemind 开源了之后,我收到了很多朋友的来信,希望我也能把博客里的 Wiki 部分也开源。

当初没有将 Wiki 的部分放进博客,主要是考虑到主题的简单性。原来的主题包含了很多我个人的特殊定制,虽然自己用着方便,但对别人就不见得适用了。比如,由于我的博客有 post 和 wiki 两套主要的 layout,为了创建草稿的时候有所区分,原来的 hexo new 就不适用了,于是我都是用自己写的工具来创建草稿。再比如,由于是自己用的东西,也就无所谓代码的模块化,有些 hard-code 的地方要做到灵活可定制又得折腾一顿功夫,而且太多定制项又会增加用户的学习负担。考虑再三,我决定将 Wiki 部分去除,尽可能保证主题整体的简单和模块化。本来我开源了 Freemind 主题后也不打算再写其他主题了,但因为来信询问 Wiki 主题的朋友实在太多,于是也给了我动力编写第二个主题 Wixo

Wixo 的含义就是 “A Wiki theme for Hexo”(虽然听起来像“猥琐”,2333)。对我而言,个人 Wiki 就是一个笔记库。笔记库的内容可以不像博客的文章那样精华,但必须系统化。所以,我将文章统一用 categories 分类,让每个分类更像是一个笔记本,并且为每个分类提供独立的 pagination 。设计这个主题的一个主要的理念就是保持简单,所以我将不需要的元素,比如导航栏、评论等模块都干掉了。这样的好处就是整个笔记库看起来很清爽纯粹。

特点

  • Simple - Wixo 是一个简单纯粹的 Wiki 主题;
  • Bootstrap - 基于 Boostrap 3.1.1;
  • Notebook - 一个分类就是一个笔记本;
  • Scrollspy - 文章左侧的 ToC 会自动监视你的滚动进度;
  • Tag plugins - 同 Freemind 主题一样可以搭配 hexo-tag-bootstrap 使用,以最大程度的发挥 Bootstrap 的威力。

安装

  1. 安装主题:
1
$ git clone https://github.com/wzpan/hexo-theme-wixo.git themes/wixo
  1. 安装 hexo-tag-bootstrap(可选,但推荐):
1
$ npm install hexo-tag-bootstrap --save

启用

修改 _config.yml 文件里的 theme 选项为 wixo 即可。

更新

1
2
$ cd themes/wixo
$ git pull

配置

Wixo 的配置文件非常简单:

1
2
3
4
5
rss: atom.xml
fancybox: true
favicon: favicon.png
fold: true
google_analytics:

其中:

  • rss - RSS 链接
  • fancybox - 是否启用 Fancybox
  • fold - 是否合并所有的笔记本
  • google_analytics - Google Analytics ID。

Front-Matter

  • toc - 生成 table of contents

示例:

1
2
3
4
5
title: Tag Plugins
date: 2014-03-16 10:17:16
categories: Docs
toc: true
---

Comments