概述
Wiki.js 由我们安装、更新和备份,运行在法国的机器上。一个现代而轻快的 wiki,配 Markdown 或可视化编辑器,权限可以细分,检索也是内置的。给一个协会或一支团队写文档非常合适。您什么都不用装,也不用配置服务器:下单后几分钟,这个应用就会以您的名义上线。
与它相配的是 应用 舒享版,每月 8.99 €(含税)—— 4 GB 内存。Wiki.js 是一个 Node.js 应用,后面接 PostgreSQL,内存主要用在三处:渲染链,把 Markdown 转成 HTML,还要给代码上语法高亮、画出图表;全文检索索引,每保存一次页面就要更新;以及 Git 同步,它会真的起 git 进程去读写仓库。几千页带图片的 wiki,在这个套餐里毫不吃力。
在这里被替换掉的是 Confluence、一个共享的 Notion 页面,或者一个谁都找不到东西的 Word 文件夹。Wiki.js 的特别之处,是它能在写进自己数据库的同时,把每一页也写进一个 Git 仓库:文档于是变成一棵带版本的 Markdown 文件树,可以脱离 wiki 单独阅读,也能搬到别处去用。这也是最稳妥的导入通道:把 Markdown 文件放进仓库,它们就会变成页面。至于登录,可以走公司的目录服务——LDAP 和 Active Directory、SAML、OpenID Connect——而不必再多记一个密码。
托管式主机改变了什么
Git 双向同步
每保存一个页面,内容就写进 Git 仓库;而往仓库里推的修改也会回到 wiki。于是文档和它所描述的代码住在同一个地方,带着提交历史,而且这份备份不依赖软件就能读。
同一个 wiki 里有四种编辑器
写得快的人用带实时预览的 Markdown,不喜欢的人用可视化编辑器,特殊情况用原始 HTML,技术文档用 AsciiDoc。这是一页一页选的,而且一个页面还可以换编辑器。
权限沿着目录树走
规则按路径来写:/public 下公开可读,/procedures 下只允许某个组写入,其他地方干脆看不见。于是一套安装里既能有对外开放的 wiki,也能有内部区域,不必再开第二个。
直接用现成的目录服务登录
LDAP 和 Active Directory、SAML、OpenID Connect,或者常见的那几家。目录里的组直接决定 wiki 里的权限:有人离职只要在一个地方处理,而谁也不必多记一个密码。
为什么交给我们,而不是自己装
一支想把文档放进 Git 的技术团队
运维手册和代码住在一起,在合并请求里被审阅,同时对不打开编辑器的人来说,浏览器里照样读得到。这正是选 Wiki.js 而不选别的 wiki 最常见的理由。
一个每两年换一届理事会的协会
活动怎么报批、场地钥匙放在哪、该打给哪家保险:这些知识每次换届都会丢一遍。写下来一次,就能随职务一起交接。
一家用 Active Directory 的公司
账号来自目录,组决定每个人能看到什么,员工离职就自动失去访问权,而 wiki 这边一动都不用动。管理员不必再维护两份名单。
一个多语言的 wiki
页面按语言归档,用户可以在语言之间切换。团队分布在两个国家,或者对外文档必须有英文版时,这一点就用得上。
一个对公众开放的知识库
帮助文章不用登录就能读,草稿和内部流程仍然锁着,而搜索结果里,匿名访客只会看到本来就给他看的内容。
托管在法国
在我们自建自营的新阿基坦大区基础设施。内部文档写的是您的访问方式、供应商和操作流程:它不出境。
常见问题
走 Git 仓库或文件存储,这是最稳妥的入口:放进目录树的每个 Markdown 文件都会变成一个页面,路径和标题都跟着来。Confluence 导出的是 HTML 或 XML,Notion 导出的是 Markdown;所以中间要转换,而这一步值得用专门的工具——HTML 用 pandoc,其余的用 Notion 自带的 Markdown 导出。图片和表格这两处最容易在导出中走形,请预留时间核对。
什么都行,因为一切都可以写成文件:只要开了 Git 同步或本地文件存储,您的页面就始终以 Markdown 文件的形式存在于一棵目录树里,并带着提交历史。这是一份持续进行的导出,而不是一次要手动触发的操作。单个页面也能在浏览器里打印成 PDF,而 PostgreSQL 数据库本身可以整份导出。
稳定版是第 2 版,它只提供一个主题:要改外观得注入 CSS,而不是用一个外观编辑器。第 3 版宣布了很久;做决定时请按第 2 版来考虑。评论功能很简略,它不是一个用来做审阅的工具。遇到复杂表格时,可视化编辑器仍然不如 Markdown 可控。另外它没有能离线用的手机应用。
应用 舒享版,每月 8.99 €(含税)。应用最低要求 1 GB 内存,而它提供 4 GB:这多出的余量是留给系统的,不是用来充门面的。日后可以更换套餐,无需重装。
什么都不用。您从目录里挑好应用,填上它要的几项——通常是一个邮箱地址和一个名称——它就上线了。访问方式会连同网址和登录信息一起用邮件发给您。