Docmate - 一个可以自由部署的文档平台

2020-08-15 18:31:10 +08:00
 djyde

建议阅读本文的英文版: Announcing Docmate

对我来说,文档和代码同等重要,如果写出来的代码没有写文档,那么等于没写代码。互联网上有很多文档平台,但有些团队或公司会基于数据安全的考虑不能使用外部平台,只好通过自建的 Gitlab Wiki 或者其它一些开源的 wiki system 解决文档问题,或者用一些静态文档生成工具配合 Gitlab 生成文档。

我调研了一些开源的 wiki system, 发现国外开源的 wiki system 对中文内容并不友好,尤其是在内容组织上,基于 slug 来编排目录对于中文标题来说是非常困难的. 国内的开源 wiki system 相对比较少,所以这些天,作为一个 Side Project, 我尝试按照自己的思路做出来了 Docmate.

Docmate 可以做什么

1.编写 Markdown 文档,得到可以分享的 DocuteDocsify (暂不支持) 文档

2.建立团队,邀请团队成员,共同维护文档

3.文档可以设置为仅团队成员可见

如何获得 Docmate

Docmate 分为 Docmate Cloud 和自己部署的 Docmate, 两者功能目前完全相同。你可以按照官方文档部署自己的 Docmate, 也可以在 https://docmate.io 可以直接使用 Docmate Cloud. 所有功能暂时不收取费用。

谁应该使用 Docmate

1.对数据安全敏感、希望自己部署文档库的团队

2.工具开发者,需要给用户编写使用手册,可以直接使用 Docmate Cloud

Docmate 的计划

在团队合作中,编写文档是软件工程师很重要的素养,我希望 Docmate 能给需要文档库的团队多一个选择,让更多工程师愿意编写文档。

还有很多计划中的功能尚未完成,包括:

另外,在代码结构稳定后,我将开源全部代码。

2637 次点击
所在节点    分享创造
7 条回复
djyde
2020-08-15 18:31:54 +08:00
有没有设计师有兴趣 Redesign 一下?欢迎联系。
a132811
2020-08-15 18:38:27 +08:00
支持 math/latex 、表格、流程图 吗?
xcatliu
2020-08-15 18:40:42 +08:00
感觉不错,支持!
connection
2020-08-17 20:03:12 +08:00
touno
2020-08-18 10:07:15 +08:00
惯例先吐槽一下:因为对中文支持不友好~so~做了这个东西,然后这个东西全是英文...尴尬不~
yuanfnadi
2020-08-20 00:05:12 +08:00
个人倾向于 dumi
Terry05
2021-02-14 23:17:46 +08:00
这个项目已经没后续了么

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/698511

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX