docker安装gitbook

docker安装gitbook,第1张

/srv/gitbook 是gitbook工作目录,用来存放源文件,映射到了本地的/data/gitbook/gitbook

/srv/html 是构建后的html文件,可在WEB服务中查看,映射到了本地的/data/gitbook/html

请确保本地的gitbook目录中包含至少README.md和SUMMARY.md两个文件

每次改动md源文件后,都要重新构建,命令:

爬取gitbook自动保存为md格式。

Gitbook可以将md文件自动做成类似电子书的形式,自动生成目录、风格简约,使用方便,建议写文档的同学都可以学习一下,书写方面同样是支持markdown和html语法的。

安装NodeJS(推荐v4.0.0及以上版本)

npm install gitbook-cli -g,gitbook-cli是一个在同一系统上安装和使用多个版本的GitBook的实用程序。它将自动安装所需版本的GitBook来构建一本书。

初始化书籍目录(有点类似git初始化仓库,执行一次即可,会生成README.md和SUMMARY.md文件,少一个都不行QAQ):gitbook init。

插件地址: gitbook-plugin-summary

插件说明:

summary: 自动生成SUMMARY.md文件

toggle-chapters: 菜单可以折叠

theme-comscore: 主题插件, 修改标题和表格颜色

在根目录下新增目录, 如取名 "菜单1", 在菜单1目录中新增0-README.md文件, 并在该文件中加入标题

该标题对应gitbook中该菜单名称.

子菜单添加规则一致, 需要在目录中加入README.md文件, 并指定文件中的标题为菜单名称

在菜单中加入 用户指南 MARKDOWN文件, 并修改该文件的标题为


欢迎分享,转载请注明来源:内存溢出

原文地址: http://outofmemory.cn/tougao/12023139.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2023-05-20
下一篇 2023-05-20

发表评论

登录后才能评论

评论列表(0条)

保存