V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
594mantou
V2EX  ›  分享创造

Gem-book:文档网站生成器

  •  
  •   594mantou ·
    mantou132 · 2020-11-27 13:20:54 +08:00 · 1968 次点击
    这是一个创建于 1457 天前的主题,其中的信息可能已经有所发展或是发生改变。

    https://gem-book.js.org/

    截图

    对标的是 gitbook, dumi, docsify 类似的工具。

    如果你的 docs 目录放了 markdown 文档,那么下面的命令开始编辑和预览:

    gem-book docs
    

    gem-book 自身命令的完整例子:

    gem-book docs --title Gem-book --icon logo.png --i18n --home-mode --plugins raw --debug
    

    // 以前发过一次,但是是作为 <gem-book> 自定义元素介绍的,后来觉得那玩意只有我关心,就删掉文章了。后来 gem-book 从一个自定义元素变成了构建文档网站的工具(虽然也是使用 <gem-book> 来渲染的)

    2 条回复    2023-12-31 09:27:54 +08:00
    594mantou
        1
    594mantou  
    OP
       2020-11-27 13:45:27 +08:00
    加 `--build` 生成前端资源。

    如果要使用 ci 发布网站的话,就在输出目录(默认是指定的文档目录)中用 .gitignore 从 repo 中屏蔽掉这些文件。

    例如: https://github.com/mantou132/gem-book/blob/master/docs/.gitignore
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2608 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 11:01 · PVG 19:01 · LAX 03:01 · JFK 06:01
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.