免费文档模板素材网站,angularjs 做团购网站,wordpress 图片默认居中,网站源码上传对文档的编译#xff0c;目前的发布方案是越来越注重 MD 的编辑和发布。
针对其他 Wiki 的选择#xff0c;MD 文件的编辑通常会保留修改记录#xff0c;同时不依赖中央数据库和其他类型的 Web 应用服务。
随着各大云平台的支持#xff0c;包括 GitHub Page 和 Google 的 …对文档的编译目前的发布方案是越来越注重 MD 的编辑和发布。
针对其他 Wiki 的选择MD 文件的编辑通常会保留修改记录同时不依赖中央数据库和其他类型的 Web 应用服务。
随着各大云平台的支持包括 GitHub Page 和 Google 的 Firebase通常在免费的情况下就可以获得基于自己域名的文档服务。
对文档内容的修改也只需要修改 Md 文件就可以了。
Confluence
长期以来我们都使用 Confluence 来作为我们的 Wiki 系统并且提供内部和外部的使用的。
通常因为 Confluence 有更好的用户授权但是随着 Confluence 的生命周期的总结官方要求要不就使用他们的云服务要不就要自己部署一套云解决方案。
对我们来说这个没有意义所以我们需要为我们项目中已经公开的文档提供一个归档和方案。
这次我们决定使用 md 的文档格式所以我们考虑在 Docsify 和 Hugo 之间进行选型。
Docsify
Docsify 主打的就是一个简单。
对个人用户来说使用 Docsify 是非常好的选择这个能让个人只专注内容的而不需要考虑复杂的配置。 例如上面我们使用的文档工具对我们来说就暂时足够了但是在框架的配置上我们还是觉得过于简单了。
Hugo
Hugo 能够做出非常漂亮的文档。
例如 pulumi 的官方文档就是用 Hugo 做出来了。
可以说这个文档有非常高的水平了无论从配色还是其他方面来说都非常漂亮。 如果你是公司并且有足够的技术力量的话Hugo 通常是你非常好的选择。
部署
上面 2 个平台都能够使用无服务的方式进行部署。
我们用 pulumi 的文档测试编译后在 Google Firebase 上进行部署。
也能够实现一键部署能够让用户只专注代码和内容而不需要专注部署。
总结
如果是个人使用在前端和技术能力也不是非常强的情况下建议使用 Docsify 因为我们还是需要更多的关注内容。
如果有一定发展规模并且技术力量足够的情况下可以使用 Hugo因为 Hugo 能够提供更多的复杂功能但是又不会过多增加技术难度。 Docsify 和 Hugo 之间的选型 - 文档交付 - iSharkFly对文档的编译目前的发布方案是越来越注重 MD 的编辑和发布。 针对其他 Wiki 的选择MD 文件的编辑通常会保留修改记录同时不依赖中央数据库和其他类型的 Web 应用服务。 随着各大云平台的支持包括 GitHub Page 和 Google 的 Firebase通常在免费的情况下就可以获得基于自己域名的文档服务。 对文档内容的修改也只需要修改 Md 文件就可以了。 Confluence长期以来我们都使用 Con…https://www.isharkfly.com/t/docsify-hugo/15115
