跳到主内容

用Gollum建立wiki

目的: 建立一个文献阅读笔记.

我想要一个看文献记录笔记的工具, 由于有http://sci-hub.tw 很方便找到全文, 而且我并不需要严格的引文管理/插入这样的操作, 所以只需要记录文献的标题和DOI即可. 在阅读中的笔记, 用blog不太合适, 因为还不完全是一个时间线的模式, 一篇文献可能从不同的角度, 在不同时间阅读的时候, 会产生不同的内容, 所以要动态更新. 文献中引用的知识或者信息, 可能还有交叉引用的可能. 于是我打算用wiki来做这件事情.

方法: 建立一个wiki

现在建立这类的工具, 必须有一份本地的, 有一份云端的. 单纯本地, 长时间不写, 就不知道丢到哪里去了; 单纯云端, 那天服务商倒闭/ 付费/ 降权/ 导入导出, 也是一堆麻烦.

所以, 必须有本地一份, 远端一份. 本blog也是如此.

我选择的本地应用是gollum, 远端是github.

  1. 按照gollum的官方安装说明进行操作, mac上按官方homebrew方式安装成功. (真是难得的开源软件, 居然一次成功)
  2. 有一个中文文件/目录名称的bug, 所以补充安装gem install gollum-rugged_adapter
  3. github上随便建一个github repository, 到wiki页面, 找到wiki的git地址, (与repo本身的地址是不同的), 然后git clone到本地
  4. 运行gollum --mathjax --adapter rugged, 启动本地服务
  5. 用浏览器打开 localhost:4567
  6. 用markdown语法直接写文档
  7. 如果对wiki不熟, 新建一个页面使用[[文件名]]的方式直接写出来就可以了. save以后双击就可以产生新的页面.
  8. 写好以后用git命令add,commit,push到远端

本地以markdown的.md文件形式保存, 使用git push 推到远端. 当使用gollum --mathjax启动时, 支持$$包裹的LaTeX数学公式. 远端github那边是否能够正常显示LaTeX我不在乎.(迟早吧, 要不太可耻了)

文献按照领域归类在不同的页面路径之下, 文献笔记的页面中记录文献的标题和DOI, 以及指向sci-hub的全文链接. 文献中的图片需要记录原始文献中的Figure编号, 如果有html全文, 则指向原始文献页面中的图片地址, 如果没有html全文, 则在PDF中截图, 并将截图存放在网上免费的公共图库中. 如果图片丢失, 可以从原文中查找.

结果:

整个过程还挺容易的.

讨论:

Gollum作为一个开源软件,

  • 居然按照原生说明一次安装成功,
  • 居然在国内运行良好不用换源,
  • 居然只遇到一个中文bug, 锅还是别人的.

怎么说呢, 实在是太不矜持了.

如果不想自己麻烦, 还有其他网友推荐的服务: