「Note-taking, Wiki, Blog」- 笔记、维基、博客

  CREATED BY JENKINSBOT

问题描述

我们需要记录工作笔记,以及工作中遇到的问题。

该笔记将记录:笔记记录软件、博客发布系统,以及相关工具的使用方法。

解决方案

Zim(A Desktop Wiki Editor)
1)Zim – a desktop wiki
2)桌面维基编辑器。我们目前正在使用的笔记软件。

WordPress(Blog Tool, Publishing Platform, and CMS)
1)Blog Tool, Publishing Platform, and CMS
2)博客发布平台,博客系统,CMS 系统;

Hexo(A fast, simple & powerful blog framework, powered by Node.js.)
1)hexojs/hexo: A fast, simple & powerful blog framework, powered by Node.js.

Gollum — A git-based Wiki
1)gollum/gollum: A simple, Git-powered wiki with a sweet API and local frontend.
2)在 GitLab 中,默认的 Wiki 编辑工具。带有图形化界面,方便我们编辑 Markdown 文件。

Hugo
1)http://www.gohugo.org

蚂蚁笔记(Leanote)
1)访问GitHub仓库访问官方主页

Jekyll • Simple, blog-aware, static sites
1)Jekyll • Simple, blog-aware, static sites | Transform your plain text into static websites and blogs
2)博客软件,利用我们编写的 Markdown Liquid HTML CSS 来生成站点。

我们的博客发布方式

我们一直使用Zim进行日常笔记。后来,笔记渐渐有了博客般的内容形式,我们也打算将它发布出来。

02/14/2017 ZIM DESKTOP WIKI

最开始,我们发现Zim一个神奇的工具。它支持自定义模板,可以将博客根据模板页面导出到指定的格式。神一样的存在!!!我们的博客就是用Zim写的,然后导出HTML页面的,然后发布到线上。

07/26/2018 ZIM DESKTOP WIKI

导出HTML存在一些问题:
1)笔记较多,导出时间很长,消耗资源。
2)如果笔记发生了移动或重命名,之前导出的某些HTML页面就需要删除修改,所以每次更新都是发布整个笔记。

现在我们的博客已经不用导出HTML了。因为Zim中内置了一个轻量级的Web服务器,在服务端直接运行就好了,大致的流程如下:

  1. 在服务端运行Zim的以Web服务功能;使用Nginx进行反向代理;
  2. 本地修改笔记内容;
  3. 本地使用Git提交到仓库;
  4. Git仓库设置了Hook:在服务端检出笔记;更新Zim的索引(处理页面移动和重命名的问题);
  5. 至此,请求站点时,就可以看到Git提交的新页面。

需要注意的是,Zim的内置Web服务不是为了在服务端运行。如果将其运行在服务端,那运行Zim的用户的家目录必须存在,因为Zim要在用户的家目录里读取配置、创建索引、更新缓存等等,这也是说“Zim的内置Web服务不是为了在服务端运行”的原因。

12/08/2021 WORDPRESS

现在我们使用 WordPress 发布我们的博客及工作笔记。

参考文献

Best 6 Open source Note Taking Apps for Linux, Windows, and Mac OSX