热门标签 | HotTags
当前位置:  开发笔记 > 后端 > 正文

求一个合适的管理多份文档(Markdown)的静态站点生成器

由于饱受某些国外开发文档没有官方中文文档以及因为站点部署在海外而有时无法正常浏览的的困扰,于是决定根据官方文档自行翻译,并且在国内搭建相关站点。目前翻译文档正在进展中,但需要一个合适的静态站点生

由于饱受某些国外开发文档没有官方中文文档以及因为站点部署在海外而有时无法正常浏览的的困扰,于是决定根据官方文档自行翻译,并且在国内搭建相关站点。目前翻译文档正在进展中,但需要一个合适的静态站点生成器以建立站点。



之前尝试过 Gitbook, Docsify, VuePress,效果都不是很理想

Gitbook 的设计风格我其实很满意,但是 Gitbook 似乎无法按照次级目录正常处理多份文档
Docsify 其实基本满足我的要求,但是它对于相对路径的处理不理想
VuePress 不能独立配置单独某份文档



我希望的静态站点生成器是具有类似于 Gitbook 和 Docsify 的目录结构,同时能根据目录结构设置多站点的静态站点生成器,以便优化浏览,并且使翻译文档能单独上传到 Git 存储库保存

求助各位万能的网友提供一个好的想法

第 1 条附言  ·  79 天前

看到了大家的回复,其中 mkdoc 还不错,但是 mkdocs 在目录结构上不太适合 monorepo 或者 multirepo 的多存储库协作,构建工具还是希望能够应用到 Git 存储库上,以纯代码实现自动化流程,方便后续社区维护工作。

因为文档比较多,每份文档数十页,多份文档上百页,不能维护在同一个目录下,所以需要在独立的存储库里存放各自的目录,并最后通过自动化的方式进行统一部署……这就很令人困扰,需要的是一种文档中心的解决方案。

Gitbook 和 docsify 的目录结构其实是很合适的,但是 Gitbook 如今已经不再维护,对于多站点的实现也不太合理; docsify 的相对路径和搜索功能又有问题。能解决以上两个问题或许也是一种解决方案。

大家可以推荐一些适用于多站点部署的插件

感谢大家的回复,如果还有更多好的建议希望多多提出!

mkdocs


   



推荐阅读
author-avatar
手机用户2602903715
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有