文章目录
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 做版本管理
- 在 Github 创建好仓库
- 在 bookname 目录下执行
git init初始化本地仓库 -
git remote add origin [email protected]:path/repo-name.git关联远程仓库。 - 关联后,使用命令
git push -u origin master第一次推送master分支的所有内容。
关联 Gitbook
进入 Gitbook,用 Github 账号登录。
选择 Create a new space
点击 Intergrations
选择 Github
连接 Github 仓库
选择要同步的仓库
同步成功
复制地址即可供他人访问
也可在此修改域名
高阶 Gitbook 命令
生成 PDF gitbook pdf ./ ./mybook.pdf
生成 epub 格式的电子书 gitbook epub ./ ./mybook.epub
生成 mobi 格式的电子书 gitbook mobi ./ ./mybook.mobi