文档那么多，该怎么整理
做 开发其实会涉及到很多的文档的一些编写或整理，比如说，我们启动一个项目要怎么展望目标，然后如何规划一些细节，再然后到项目的分工，项目的产品文档，数据文档，账号平台等资料保存，API文档的说明，系统开发后的操作文档整理等等，对了，还有过程中参考用到的一些资料，学习到的内容的归档等，这些都需要大量的文档保存。
这 些所有呢，在最后可能都是通过文档的方式来保存下来才能更方便自己或者给到别人来阅读了解，如果按以前的方式都是通过word文档的方式来处理，那有个也有好也有坏，好处是我可以随时发给别人，但是坏处是有可能在大批量的内容统一做调整或者目录结构发生变化时候，不是很好的去做变更，这样导致内容维护起来没有溯源或者存在很多重复copy。
那有没有一个方式或工具能够满足我们对知识库的管理，这个文档库一直能保持是最新的一个状态，或者说我能随时的追溯到以往的一些记录，能够保证所有的信息都是在最新的，最有用的，而且又是最全面的。
可能很多人会想到或者已经用到例如 印象笔记、有道笔记、熊掌记、Notion 等，的确这些都是非常优秀的工具，但好像又缺了点什么。如果我想我的API文档能本地随时保存好，又能发布到类似这样的平台，又可以单独拿出来整理成API文档手册发布，并且这些操作的切换，其格式还能保存一致，这样对于别的工具来说可能就不一定那么便利了。
这里我介绍一套组合拳 Docsify + Gitee
markdown的语法： http://markdown.p2hp.com/basic-syntax/
https://docsify.js.org
http://gitee.com
这样的话，我们自己的知识库就可以开始搭建起来了。
去新建一个git库同步到本地后，新建docs 文件夹，
初始化为docsify的根目录，得到 _sidebar.md 和index.html 文件，分别为菜单目录文件和未来web访问的首页。
可以通过
来本地预览，对了，编辑的文件工具可以用vscode 或者其他可视化的markdown编写工具。这里边设计到如果要图片上传的话哦，本地保存，发布到线上去可能会导致图片丢失，最好的方式就是图片都是引用外部链接，保持本地和线上体验一致。 [todo]这个未来可以展开下图片怎么保存和获取访问地址。
这样我们可以保证内容文档随着开发的进度可以不断修改补充。
`
https://www.cnblogs.com/summerday152/p/14008463.html
`
博思aippt
2024-07-20 广告
