Wixo - a wiki theme for Hexo

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

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

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

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

特点

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

安装

1. 安装主题:

$ git clone https://github.com/wzpan/hexo-theme-wixo.git themes/wixo

1. 安装 hexo-tag-bootstrap（可选，但推荐）:

$ npm install hexo-tag-bootstrap --save

启用

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

更新

$ cd themes/wixo$ git pull

配置

Wixo 的配置文件非常简单：

fancybox: truefavicon: favicon.pnggoogle_analytics:

其中：

• fancybox - 是否启用 Fancybox；
• google_analytics - Google Analytics ID。

Front-Matter

• toc - 生成 table of contents

示例:

title: Tag Plugins
date: 2014-03-16 10:17:16
categories: Docstoc: true
---

Todo

Wixo 还有一些值得改进的地方，欢迎关注本项目。

1. 让笔记本的图标和背景颜色可定制；
2. 允许用户选择和查看单一笔记本。