仿了一个类似 Gitbook 的 hugo 主题

2021-05-12 11:29:07 +08:00
 ntop

前两天在折腾公司的文档系统,找来找去也没找到比较合适的文档平台(有的付费、有的不满意),后来发现好多公司都用 GitBook 来搭建文档。于是我又去研究了下 Gitbook,结果发现这个东西真是年久失修,而且关于 GitBook 的好多网页链接都 404 了(指向了 GitBook.com ),我把 GitBook 最后的发布版本弄到本地总算跑起来了,但是我先老是有各种小错误出现,而且主题不知道怎么修改。。。折腾的特别郁闷,主要是我心里在想即使我自己重复造轮子,也就是解析一下 Markdown 渲染一个网页的事情结果搞了一整个下午,于是痛定思痛决定自己山寨一个 GitBook,山寨 GitBook 最核心的还是解析 Markdown 文档,后来我一想 hugo 其实不就是一个现成的 Markdown 解析器吗。。。于是打开 hugo 的官网,找了最接近我需求的主题,改了下 CSS 不到 30 分钟,一个 90%山寨版的 GitBook 主题就诞生了。用 hugo 主题的好处是我可以方面添加我要的、删除我不想要的页面元素。

这个主题我已经传到了 Github 上 : https://github.com/ntop001/hugo-gitbook-theme

大概效果可以看我们公司的文档: http://qingjucrm.com/docs

不过这个主题现在是不支持移动端的(没做适配)。切记,如果使用的话要配置:

[params]
    # Documentation Menu section
    # Menu style settings
    menu_style = "open-menu" # "open-menu" or "slide-menu" or "" blank is as no sidebar

不然左侧的目录会不显示(更多可以参考 example 里面的配置)。

2381 次点击
所在节点    程序员
6 条回复
janxin
2021-05-12 11:47:47 +08:00
ntop
2021-05-12 15:06:24 +08:00
@janxin 你找的这几个都不错,我找的时候竟然都没有看到。。
Alastar
2021-05-12 17:00:58 +08:00
考虑模仿个新版 Gitbook 主题么🐶
kevtyle
2021-05-13 08:29:44 +08:00
hugo 插件多吗? 推荐 docsify
ntop
2021-05-13 18:43:00 +08:00
@Alastar 落伍了,新版 GitBook 很好看上档次。下次有机会可以改改,其实这个就是改点 CSS 没啥技术含量
ntop
2021-05-13 18:47:04 +08:00
@kevtyle 这个网站做的很漂亮,不过我不太喜欢基于 node 的项目,黑洞太重难以承受。

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

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

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

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

© 2021 V2EX