tiddlywiki服务器版本安装与配置

简介

总的来说，想试着配置一个wiki站点，然后，经过一番查找，选择了tiddlywiki，tiddlywiki支持单文件和服务器两种版本。

不过单文件版本有一个问题是，配置/文章/插件数量变多后，文件会变臃肿，变的很大。

所以这边打算配置nodejs版本，也就是服务器版本。

安装nodejs和npm

在arch系软件包中，想要安装nodejs，,可以通过pacman安装 nodejs 软件包。而npm也可以直接通过安装 npm 来得到。¹

1

pacman -Syu nodejs npm

不过由于这边装 nodejs 的时候发现 nodejs-lts-gallium (nodejs,16.X长期支持版本) 已经安装了，由于这两个软件包冲突，暂且不更换。

使用npm安装tiddiywiki

参考官网²的安装过程，npm安装完毕后就可以通过npm安装tiddlywiki

1

npm install -g tiddlywiki

使用 -g 选项会在全局路径安装，按照archwiki关于nodejs的介绍¹，在archlinux系统中，npm的默认全局路径位于 /usr/lib/node_modules/npm 所以 需要root权限 才能进行该操作。

不过，这边在安装过程中，发现，npm默认的源404(无法正常访问)，因此尝试设置国内镜像源。

1
2
3
4

npm config get registry     #查看当前软件源地址
#https://registry.npmjs.org/#此处返回的默认源
npm config set registry http://registry.npmmirror.com
#设置软件源为阿里巴巴的http://registry.npmmirror.com软件源，来自https://developer.aliyun.com/mirror/NPM

1

嗯，然后最终发现还是404,因为tiddlywiki错打成了tiddiywiki(

这边由于不打算全局安装，所以手动切换工作路径后，去掉了-g选项。去掉-g选项后，npm会把安装的插件保存在 ./node_modules 文件夹下。

建立wiki

在tiddly安装完成后，npm会在对应路径生成tiddlywiki命令，此处为 ./node_modules/.bin/tiddlywiki

1

如果安装在全局并或设置PATH变量路径的话，大概可以直接使用 ~tiddlywiki~ 命令调用，因此，以下部分大部分地方将直接使用tiddlywiki而略去路径前戳。

执行 tiddlywiki [wiki文件夹名] --init server 初始化wiki文件夹目录。

然后执行 tiddlywiki [wiki文件夹名] --listen 开始运行wiki服务。

默认情况下服务器将绑定在127.0.0.1:8080,可以传入 port 和 host 值来更改³。如 tiddlywiki wiki --listen "port=3002" "host=0.0.0.0" 这样就会绑定在3002端口，并对全地址开放。

现在，就能从http://127.0.0.1:3002访问到刚刚创建完成的wiki站点了。

插件安装

在nodejs版本的tiddlywiki和单文件版本，在插件安装上有一定区别。⁴，不能直接通过浏览器安装插件。

中文设置

停止wiki运行

使用文本编辑器打开wiki根目录下的tiddlywiki.info文件。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
      "plugins": [
  	      "tiddlywiki/codemirror"
      ],
      "themes": [
  	      "tiddlywiki/vanilla",
  	      "tiddlywiki/snowwhite"
      ],
    "languages": [
        "zh-Hans",
        "en-EN"
    ]
}

找到 languages 部分，然后在该部分中添加 zh-Hans 字段。如果没有找到languages字段则手动在合适位置添加。

1

该文件大体需要遵守json语法规则，除去结尾部分，每个部分都需要以逗号结尾。而最后一部分不允许以逗号结尾。不遵守会导致wiki无法正常工作。

1

另外，"zh-Hans"不能改成"zh-CN",虽然"zh-CN"在wiki的语言界面能改成“中文(中国)”，但是没有翻译效果，界面没有得到翻译。需要改成"zh-Hans" 才行。

然后，重新启动wiki后，就可以在wiki网页中，将语言设置为中文(简体)了。

末尾

大致上，tiddlywiki的nodejs版本就差不多安装完成了。不过，将wiki配置好，只是开始吧，也不太清楚会不会坚持下去……？

总之，试试吧。

脚注