之前在 这里 叙述了 用 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,做内网穿透,买域名.
需求
-
- 动态交互需求
当前的过程A 需要增加动态网页支持
当前的过程B 中的 http server 需要增加动态网页支持
-
- 手机访问需求
如果只是电脑访问局域网的话,没有必要自己建立http server
原来就建立了一个samba server , 那么我们可以通过 电脑网页浏览器基于file协议查看 html
此时手机不能查看,是因为 手机网页浏览器 因为安全问题 不支持 file 协议 .
如果手机想查看,必须 建立 http server,然后通过 http 协议查看.
-
- 版本管理需求
当前叙述的过程 A 本来就支持 版本管理1.支持离线编辑 2.网页源码基于文本文件