自身文档管理规范

之前在 这里 叙述了 用 sphinx 生成静态网站， 并利用 静态网络托管服务 readthedocs
现在我们有了新的需求，想知道这些东西到底是什么。

过程

过程A ： markdown/rst -> html

mkdocs
sphinx

相关：
pandoc(不能生成整个网站的html文件，而是生成单个md/rst对应的html文件)
	应用场合： 例如 sphinx 支持 markdown 不力 ，可以将 md格式转为rst格式
gitbook(更像是团队文档管理方案，包括过程A&B)
	应用场合：团队开发。
	应用限制：只能线上编辑。

过程B ： 将过程A生成的 静态网站源码，发布到静态网站

//网站托管服务：
github pages
netlify
vercel
gitlab pages
readthedocs
//自己弄：
自己建立http server,做内网穿透,买域名.

需求

• 1. 动态交互需求

当前的过程A 需要增加动态网页支持
当前的过程B 中的 http server 需要增加动态网页支持

• 2. 手机访问需求

如果只是电脑访问局域网的话，没有必要自己建立http server
原来就建立了一个samba server ， 那么我们可以通过 电脑网页浏览器基于file协议查看 html
此时手机不能查看,是因为 手机网页浏览器 因为安全问题 不支持 file 协议 .
如果手机想查看,必须 建立 http server,然后通过 http 协议查看.

• 3. 版本管理需求

当前叙述的过程 A 本来就支持 版本管理
	1.支持离线编辑 
	2.网页源码基于文本文件