Gitbook 超详细入门!

Gitbook效果预览

安装

安装 node.js

安装 gitbook

安装了 Node.js 会默认安装 npm(node 包管理工具)

npm install -g gitbook-cli

输入 gitbook -V 查看是否安装成功

安装 Typora

安装 Git

使用方法

创建放置文档的仓库

在电脑中创建一个 Gitbook 文件夹,用于放置自己的 Gitbook 文件。

再在 Gitbook 文件夹中创建新的文件夹,以 bookname 命名。

初始化

到 bookname 文件夹中打开 powershell 窗口,执行gitbook init命令。

坑:在此系统禁止运行脚本

此处若失败并出现提示信息“因为在此系统禁止运行脚本”,需要以管理员身份打开power shell,输入set-ExecutionPolicy RemoteSigned,选择“是”。

编辑

接下来打开 Typora,文件 - 打开文件夹 - 选择 bookname 文件夹,编辑 SUMMARY.md 文件以修改大纲。

修改后,打开 power shell,输入 gitbook init,bookname 文件夹内就会生成对应的 md 文件。

预览

执行 gitbook serve 来预览这本书籍。

坑:Error: ENOENT: no such file or directory

用户目录下找到文件 .gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js,将所有的 confirm: true 语句改为 confirm: false

之后打开 http://localhost:4000 预览。

生成静态网站

执行 gitbook build 命令,默认将生成的静态网站输出到 _book 目录。

用 Git 做版本管理

  1. 在 Github 创建好仓库
  2. 在 bookname 目录下执行 git init初始化本地仓库
  3. git remote add origin [email protected]:path/repo-name.git关联远程仓库。
  4. 关联后,使用命令git push -u origin master第一次推送master分支的所有内容。

关联 Gitbook

进入 Gitbook,用 Github 账号登录。

Gitbook 超详细入门教程!电子书从入门到发布

选择 Create a new space

Gitbook 超详细入门教程!电子书从入门到发布

点击 Intergrations

Gitbook 超详细入门教程!电子书从入门到发布

选择 Github

Gitbook 超详细入门教程!电子书从入门到发布

连接 Github 仓库

Gitbook 超详细入门教程!电子书从入门到发布

选择要同步的仓库

Gitbook 超详细入门教程!电子书从入门到发布

同步成功

Gitbook 超详细入门教程!电子书从入门到发布

复制地址即可供他人访问

也可在此修改域名

高阶 Gitbook 命令

生成 PDF gitbook pdf ./ ./mybook.pdf

生成 epub 格式的电子书 gitbook epub ./ ./mybook.epub

生成 mobi 格式的电子书 gitbook mobi ./ ./mybook.mobi

相关文章:

  • 2022-12-23
  • 2022-12-23
  • 2022-12-23
  • 2021-09-11
  • 2021-11-25
  • 2021-12-01
  • 2021-06-26
猜你喜欢
  • 2022-01-06
  • 2022-12-23
  • 2021-08-23
  • 2022-12-23
  • 2022-12-23
  • 2021-08-29
相关资源
相似解决方案