Wixo - a wiki theme for Hexo

2014/07/13 21:29
阅读数 5

介绍我为 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. 安装主题:


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
fancybox: truefavicon: favicon.pnggoogle_analytics:


其中:

  • fancybox - 是否启用 Fancybox;

  • 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: Docstoc: true
---


Todo

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

  1. 让笔记本的图标和背景颜色可定制;

  2. 允许用户选择和查看单一笔记本。


本文分享自微信公众号 - HaHack(gh_12d2fe363c80)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部