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”（虽然听起来像“猥琐”，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

▲