重生记

Thu, Dec 21, 2017 in using tags

迁移到 Hugo

一两个礼拜前,偶然看到了 MkDocs 生成的一个网站。

于是,去研究了下它。一看是 Python 的,亲切感油然而生。

由此萌生了用 MkDocs 替代 DokuWiki,重建个人网站的想法。

原来的 Dokuwiki 装了 Markdown 插件,部分早期的内容用的是 Dokuwiki 的语法,而后来的基本都是 Markdown 写的。

其实,老早就想着全部迁移到 Markdown 的,可惜一真没动手。

一来是没遇到心仪的工具,像 GitHub 的 jekyll,基于 Ruby,不喜。

二来是人懒散,毕竟工作量不小。

这次,终于,一心血来潮就开工了。

第一步是将原来的 WordPress 文章全部改成 Markdown,然后用 MkDocs 做了第一版,发现了有两个不满意的地方。

  1. 不能自动加载子目录下的全部文章,要一个个手工写进配置文件。

  2. 根目录下的文章,自动加载到导航菜单,隐藏要手工改配置。

翻文档,搜索引擎都没能解决,想来应该是不支持,也就只好转向其它工具了。

其实,早前也了解过 Hugo 。第一印象是太复杂,概念太多,而且默认不带主题,所以放弃了。

折腾 Hugo ,建议先把它的文档看一遍再动手。很多 Hugo 的主题没有更新支持一些新特性。

如何直接动手,极有可能找不到北。 主题魔改至 Hugo BootSwatch

查看官方文档,参考其它主题,进行了大量修改,最终折腾到满足需求。

  1. 新增 _index.md 修改首页,否则生成列表。
  2. 新增 highlight.js 语法高亮。
  3. 列表加入分页功能。
  4. 其它许多增删修正。

原 WordPress 内容迁移到了 Blog,原 Dokuwiki 内容迁移到了 Wiki

首页保留了原 Dokuwiki 的首页,新内容启用 Post

Ngigx 配置保留了原 Dokuwiki 的链接。

顺道,全站上了 https,同时支持 http2

以上。