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

2021-01-15 01:01:28 +08:00
 demomacro

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

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

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

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

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

3033 次点击
所在节点    奇思妙想
14 条回复
lostberryzz
2021-01-15 01:21:15 +08:00
mkdocs
steamEra
2021-01-15 02:02:30 +08:00
我的个人网站在用 Publii,看到你的问题感觉正合适。

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

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

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

这俩主题很适合你,而且 Publii 官方支持 Github 和 Gitlab 还有 Netlify 之类的,更合适。建议看看。
bearcat001
2021-01-15 03:12:18 +08:00
MWeb 生成站点 + Github 私有库 + S3 + CloudFont
ETiV
2021-01-15 04:42:19 +08:00
http://docs.raneto.com/

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

我拿它魔改了一个我们自己内部用的,支持多 Markdown repo + WebHook 自动更新、支持中文搜索和目录排序的文档站
xyjtou
2021-01-15 04:46:46 +08:00
微文档 https://weishu.vip/p/27182824

界面类似 Docsify,
xyjtou
2021-01-15 04:48:17 +08:00
比 Docsify 更轻量,单文件形式
renmu123
2021-01-15 08:54:13 +08:00
直接向官方提 pr 要求 i18n 支持,如果嫌访问慢可以做个反向代理
missdeer
2021-01-15 09:31:23 +08:00
这需求不是应该找个合适的 jekyll,gohugo 的 theme 就行吗
fenglangjuxu
2021-01-15 10:17:15 +08:00
hexo hugo 就可以吧
metrue
2021-01-15 10:20:15 +08:00
我给自己写了一个小 app ( https://giki.app), 不知道适不适合,对我自己而言基本满足需求, 写写 Markdown 文字,自动发布到网站,备份到云服务,感觉还行.
lostexile
2021-01-15 10:43:38 +08:00
mweb 推荐一下
Minamion
2021-01-15 13:15:12 +08:00
mkdocs
muyunyun
2021-01-16 22:01:02 +08:00
案例下我开发的 create-react-doc 。( https://github.com/MuYunyun/create-react-doc)。它支持自定义展示目录, 天然适合搭建 monorepo 类型的文档等站点。应该满足博主提到的文档相对路径显示的痛点, 如果有不满足的点可以提需求给我 ღ( ´・ᴗ・` )比心
muyunyun
2021-01-16 22:01:52 +08:00
@muyunyun 发现连接跳转有问题再发下链接, https://github.com/MuYunyun/create-react-doc

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/745077

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX