文档编辑版本追踪的一些思考
文档编辑版本追踪的一些思考 最近帮老师整理一些文档,考虑到多人参与编辑,我决定将文档转换为在线云文档,选择使用飞书云文档。然而,在使用过程中遇到了一些问题。本文将讨论这些问题,并提出了一种解决方案,即使用Markdown进行版本管理。 飞书云文档可以追踪版本,每个变更都有对应的副本,类似于redis、rdb和Windows系统镜像,实现了完整回退的功能。然而,目前飞书云文档不支持变更说明,只能进行版本比对,无法为变更提供说明。这就导致了一个问题,当变更历史很多时,很难回溯到目标版本。我认为这个功能非常重要,可以大大提高文档的管理能力。目前飞书云文档的数据保存应该是富文本格式,不像Word那样有自己的文件格式和编码。如果飞书文档数据是二进制的,要进行变更内容的对比将变得复杂。如果是富文本,则比较容易实现,只需要解析不同文件格式,转换为飞书云文档支持的格式即可。 与Word、EPUB和PDF等文件不同,Markdown更适合文本编辑,尤其是对于只关注内容而不关注格式的情况。很多代码仓库都使用Markdown来进行仓库说明,也有很多文章使用Markdown进行创作。因此,我考虑使用Markdown管理文档内容,使用飞书云文档管理文档格式,同时使用飞书进行文档之间的沟通和消息交流。这样做有很多好处,比如只关注文档内容的改动而不关注格式,解决目录问题,低成本转换为网页展示内容,以及方便添加样式等。 预期行为: 我希望展示一本文档从原始的Word到多人协作的整个过程。首先,将Word文档去除格式,转换为Markdown格式存储到Git仓库中。然后将Markdown文件导入飞书云文档,大家可以针对文档提出意见和疑问,进行校订。这些校订内容以评论的形式进行,通过后进行内容更改,不通过则进行讨论。经过讨论后,与老师商议决定是否进行内容更改。每天将变更同步到Markdown仓库,并提交相关变更说明,完成细粒度变更的追踪。 如果想要生成两个目录,一个是初始讲习目录,一个是按照讲习内容制定的目录,可以基于主分支创建不同的分支,分别对应不同的目录,通过合并主分支的最新内容来更新目录。 如果想要将所有的文章发布到网站上,可以使用喜欢的UI框架,如Hexo、Hugo、VuePress或VitePress,将Markdown文件转换为网页并部署到服务器上进行展示。 如果群友想看到最...--GPT 4