V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
ntop
V2EX  ›  程序员

仿了一个类似 Gitbook 的 hugo 主题

  •  
  •   ntop · 2021-05-12 11:29:07 +08:00 · 2556 次点击
    这是一个创建于 1275 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前两天在折腾公司的文档系统,找来找去也没找到比较合适的文档平台(有的付费、有的不满意),后来发现好多公司都用 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 里面的配置)。

    6 条回复    2021-05-13 18:47:04 +08:00
    ntop
        2
    ntop  
    OP
       2021-05-12 15:06:24 +08:00
    @janxin 你找的这几个都不错,我找的时候竟然都没有看到。。
    Alastar
        3
    Alastar  
       2021-05-12 17:00:58 +08:00
    考虑模仿个新版 Gitbook 主题么🐶
    kevtyle
        4
    kevtyle  
       2021-05-13 08:29:44 +08:00
    hugo 插件多吗? 推荐 docsify
    ntop
        5
    ntop  
    OP
       2021-05-13 18:43:00 +08:00
    @Alastar 落伍了,新版 GitBook 很好看上档次。下次有机会可以改改,其实这个就是改点 CSS 没啥技术含量
    ntop
        6
    ntop  
    OP
       2021-05-13 18:47:04 +08:00
    @kevtyle 这个网站做的很漂亮,不过我不太喜欢基于 node 的项目,黑洞太重难以承受。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3008 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 13:26 · PVG 21:26 · LAX 05:26 · JFK 08:26
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.