Outline 是什么？
初识 Outline 大约在今年（2024）的二月份，当时在探索自托管文档服务。最早使用玩客云小盒子安装了基于 NodeJS 的 Wiki.js。
在和好友 Twoer 交流中了解到 Outline 这样一款更"现代"的文档服务。
上面这个链接是 Outline 的官网，里面有 Outline 精美的"卖家秀"。让小剧用一句话来介绍就是：「支持自托管的团队协作文档服务」。
为什么一直没有使用 Outline？
小剧自从开始尝试自托管服务，大大小小的服务也折腾过不少。尤其是借助于 Docker 这样一个大杀器，安装维护服务也几乎是手到擒来。
然而 Outline 文档服务一直让我望而却步。
和其他我装过的服务比，Outline 最大的不同是登录方式很特别。它不支持传统的邮箱密码登录，只能用 Oauth 单点登录。例如 Slack、谷歌之类的，另外还支持其他符合标准 Oauth2.0 的认证服务。
直接可用的这几个认证服务要么需要公司注册，要么对网络要求很高，基本上个人裸的网络环境没办法直接用。而且最易操作的 Slack 也得配置一堆东西。
加上今年小剧的个人时间一直很紧张，能投入到折腾自托管服务的精力上更是少之又少。
因而小剧对 Outline 虽然"倾慕"已久，但始终没有动手尝试安装。
最近有时间折腾了？
其实也没时间折腾这些东西，完全是有了想法却不去实现，头脑会发痒，痒又挠不到的那种痒。
前段时间小剧入手了极摩客 G5 小主机，它出现在我们家，是因为小剧希望有一台独立的外部 Web 服务中转设备。
图一：极摩客 G5 小主机
虽然它的"招聘"流程很短，小剧对比了一天，思考半小时就下单了，然而漫长的"实习期"却让它闲置了很久。
半个月前交给它的第一个任务就是把 Immich 服务代理出去，处理 Immich 这种图片服务它的表现相当不错。
但一台 N97 四核 CPU、12G 内存的 Web 中转服务器，只转发一个 Immich 服务显然是大材小用了。
为了给它找点事干，就把 Outline 的服务安装提上了日程。
安装成功了么？
周五（2024/10/31）娃睡的比较早，哄完娃就开始研究 Outline 的安装了。
具体过程就不展开了，就是传统的 docker-compse 文件编写，漫长的 docker pull，以及配置 DNS。
折腾到凌晨，临时借助 Slack 完成了登陆流程，终于在 11 月的第一个小时把 Outline 安装好了。草草体验了十几分钟就被媳妇叫回去睡觉了。
三天后今天（2024/11/04）把 Keycloak 的私有化单点登录也搞好了。
不借助于外部服务的本地版 Outline 算是正式安装成功了。
目前还缺少关键数据的验证流程，数据库、文件的定时备份支持。
Outline 好用么？
前面提的这些都是作为运维身份的体验，自托管应用始终是为自己服务的，因此用户侧的体验才是我们所追求的。
客户端体验
短暂使用了半小时手机端，体验确实很好，比早些时间使用的 Wiki.js 强太多了。
Outline 是没有移动端 App 的，它用的是 PWA 版本简化 App。作为文档、笔记类的应用，Outline 的 PWA 版本体验能做到媲美原生 App 体验也是挺牛的。
当然实测下来 BUG 同样有一些，例如 Icon 选择器无法滚动、编辑模式光标聚焦到最底部工具条会被遮挡等小问题。
Outline 把最好的体验留给了桌面端，PC 浏览器和 PC 客户端几乎拥有一致的体验，因而小剧甚至更偏向于使用 Web 端而非客户端。
图二：分不清是 Web 端还是客户端的截图
文档组织逻辑
需要注意的是 Outline 的文档管理和我们常见的应用有轻微差异。
笔记类应用一般是单层目录结构，也就是【文件夹 > 笔记】的结构。
国内多数的文档产品是多级目录结构，每级目录下都可以存放文档。
我们常用的 Confluence Wiki 为文档嵌套结构，也就是每级目录都是一篇文档，每篇文档都可以再嵌套子文档。
图三：Outline 目录结构（红圈内为文档集，其余均是文档）
Outline 对文档的组织结构比较特殊，它是【Collection > 文档 > 文档】结构。和传统笔记类的产品一样，它只有只有一级文件夹。但是每一篇文档又可以再添加子文档，最多 6 层，嵌套逻辑又和 Wiki 很相似。
这种文档组织方式还没有深入使用，尚不好评价是优是劣，但给人耳目一新的感觉。
总体评价如何
Outline 给我整体的使用体验是：界面简洁、功能丰富、体验丝滑。
打算持续使用不？
早期部署的 Wiki.js 因为定位为 Wiki 站点发布而非团队知识库建设的平台，体验上较为繁琐。
相比之下 Outline 更为丝滑。
接下来几天，打算把原来 Wiki.js 里的内容全迁到这里后，就可以把玩客云小机器彻底下线了。
最后再把讯飞文档里的个人文档全部迁过来。
讯飞文档：iflydocs.com
对了，讯飞文档是小剧从头参与开发款一款文档类产品，如果你有多人协作的需求，又不想折腾私有化，更不想自行承担数据维护的成本以及内容丢失的风险，讯飞文档是众多可选项中还算不错的选择。
「跑题了，老东家记得打钱。」
小剧个人的文档经历了早早早早期的 Evernote，之后的有道云笔记、石墨文档、老东家的讯飞笔记、讯飞文档、硬盘存储 Markdown 等一堆零散的管理方式。
每个都挺好，都是小剧不同阶段个人知识库的缩影。但小剧的个人内容散落在个各个角落，终归需要有个集中管理的地方，Outline 目前看起来就是那个地方。
打算持续使用 Outline 不？
目前看起来还不错哦，先用用看吧～