Ubuntu安装Gitbook

安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash #安装NVM
source ~/.bashrc #读取bash
nvm #验证是否安装成功
安装Node
nvm install 10.24.1 #安装node指定版本
nvm use --delete-prefix v10.24.1 #删除不兼容
nvm alias default 10.24.1 # 设为默认版本
node -v #查看版本验证是否安装成功
npm -v #查看版本验证是否安装成功
安装Gitbook
npm install gitbook-cli -g #安装gitbook-cli
gitbook -V #安装gitbook
建立书本
新建文件夹如 myBook,命令行中使用 cd 命令进入到该文件夹下,在该文件夹下执行下面的命令进行初始化:
gitbook init #初始化

  会自动在目录中生成两个文件,
  修改 SUMMARY.md 和 README.md
新建文件夹。存放文章
  folder1,
    1.md
    2.md
  folder2,
修改summary.md, 如下:
* [介绍](README.md)
* [java](README.md)
    * [socket和Netty使用](java/socketAndNetty.md)
    * [stream.md使用](java/stream.md)
* [python](README.md)
    * [JSON格式转换](python/JSON.md)
    * [Excel处理](python/openpyxl.md)
    * [爬虫](python/spider.md)
网页发布
gitbook build #生成静态网页,
gitbook serve #运行,访问地址:http://ip:4000

### 如何将GitHub与GitBook进行同步 为了实现GitHub仓库中的文档能够自动更新到GitBook平台,可以采用几种不同的方法来完成这一目标。一种常见的做法是利用Webhooks以及CI/CD工具如Travis CI或GitHub Actions。 #### 使用GitHub Webhook触发构建 当提交被推送到特定分支时,可以通过配置GitHub上的Webhook,在每次推送代码后通知GitBook重新编译书籍[^1]。此过程涉及设置一个HTTP POST请求发送给GitBook API端点,告知其拉取最新的更改并部署新版本的内容。 #### 利用GitHub Actions自动化流程 另一种更现代的方式是在GitHub项目内定义工作流文件(位于`.github/workflows`目录下),通过调用GitBook CLI或其他命令行接口来进行发布操作。下面是一个简单的例子,展示了如何编写YAML脚本来执行这些任务: ```yaml name: Sync with GitBook on: push: branches: - main # 或者其他指定的分支名 jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Install Node.js and npm uses: actions/setup-node@v1 with: node-version: '14' - run: npm install gitbook-cli -g - run: gitbook install && gitbook build . - name: Deploy to GitBook env: GITBOOK_TOKEN: ${{ secrets.GITBOOK_TOKEN }} run: | curl -X PUT \ -H "Content-Type: application/json" \ -d '{"token": "$GITBOOK_TOKEN"}' \ https://api.gitbook.com/v1/spaces/{spaceId}/content ``` 这段脚本会在检测到有新的commit推送到main分支时启动一系列动作:检出最新代码、安装必要的依赖项、构建静态页面最后上传至GitBook服务器。 #### 配置GitBook空间API访问权限 值得注意的是,在上述示例中涉及到向GitBook API发出PUT请求的部分,这里需要提前获取有效的OAuth令牌用于身份验证,并将其存储为GitHub Secrets以便安全地传递参数值。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值