未分類
4 2 月 2021

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

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

資深大佬 : demomacro 13

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

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

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

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

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

大佬有話說 (14)

  • 資深大佬 : lostberryzz

    mkdocs

  • 資深大佬 : steamEra

    我的个人网站在用 Publii，看到你的问题感觉正合适。

    我没打广告，只是因为我很喜欢这个产品，

    https://marketplace.getpublii.com/product/prodocs/

    https://marketplace.getpublii.com/product/documentation/

    这俩主题很适合你，而且 Publii 官方支持 Github 和 Gitlab 还有 Netlify 之类的，更合适。建议看看。

  • 資深大佬 : bearcat001

    MWeb 生成站点 + Github 私有库 + S3 + CloudFont

  • 資深大佬 : ETiV

    http://docs.raneto.com/

    这个的样式非常平淡，但可以自己改一改

    我拿它魔改了一个我们自己内部用的，支持多 Markdown repo + WebHook 自动更新、支持中文搜索和目录排序的文档站

  • 資深大佬 : xyjtou

    微文档 https://weishu.vip/p/27182824

    界面类似 Docsify，

  • 資深大佬 : xyjtou

    比 Docsify 更轻量，单文件形式

  • 資深大佬 : renmu123

    直接向官方提 pr 要求 i18n 支持，如果嫌访问慢可以做个反向代理

  • 資深大佬 : missdeer

    这需求不是应该找个合适的 jekyll，gohugo 的 theme 就行吗

  • 資深大佬 : fenglangjuxu

    hexo hugo 就可以吧

  • 資深大佬 : metrue

    我给自己写了一个小 app ( https://giki.app)， 不知道适不适合，对我自己而言基本满足需求, 写写 Markdown 文字，自动发布到网站，备份到云服务，感觉还行.

  • 資深大佬 : lostexile

    mweb 推荐一下

  • 資深大佬 : Minamion

    mkdocs

  • 資深大佬 : muyunyun

    案例下我开发的 create-react-doc 。( https://github.com/MuYunyun/create-react-doc)。它支持自定义展示目录, 天然适合搭建 monorepo 类型的文档等站点。应该满足博主提到的文档相对路径显示的痛点, 如果有不满足的点可以提需求给我 ღ( ´･ᴗ･` )比心

  • 資深大佬 : muyunyun

    @muyunyun 发现连接跳转有问题再发下链接, https://github.com/MuYunyun/create-react-doc