一两个礼拜前,偶然看到了 MkDocs 生成的一个网站。
于是,去研究了下它。一看是 Python 的,亲切感油然而生。
由此萌生了用 MkDocs 替代 DokuWiki,重建个人网站的想法。
原来的 Dokuwiki 装了 Markdown 插件,部分早期的内容用的是 Dokuwiki 的语法,而后来的基本都是 Markdown 写的。
其实,老早就想着全部迁移到 Markdown 的,可惜一真没动手。
一来是没遇到心仪的工具,像 GitHub 的 jekyll,基于 Ruby,不喜。
二来是人懒散,毕竟工作量不小。
这次,终于,一心血来潮就开工了。
第一步是将原来的 WordPress 文章全部改成 Markdown,然后用 MkDocs 做了第一版,发现了有两个不满意的地方。
不能自动加载子目录下的全部文章,要一个个手工写进配置文件。
根目录下的文章,自动加载到导航菜单,隐藏要手工改配置。
翻文档,搜索引擎都没能解决,想来应该是不支持,也就只好转向其它工具了。
其实,早前也了解过 Hugo 。第一印象是太复杂,概念太多,而且默认不带主题,所以放弃了。
折腾 Hugo ,建议先把它的文档看一遍再动手。很多 Hugo 的主题没有更新支持一些新特性。
如何直接动手,极有可能找不到北。 主题魔改至 Hugo BootSwatch 。
查看官方文档,参考其它主题,进行了大量修改,最终折腾到满足需求。
_index.md
修改首页,否则生成列表。highlight.js
语法高亮。原 WordPress 内容迁移到了 Blog,原 Dokuwiki 内容迁移到了 Wiki 。
首页保留了原 Dokuwiki 的首页,新内容启用 Post 。
Ngigx
配置保留了原 Dokuwiki 的链接。
顺道,全站上了 https
,同时支持 http2
。
以上。