gitbook与github集成使用
创始人
2024-12-03 14:34:07

Reference

  • https://northbei.gitbooks.io/gitbook/content/engineer-only/install-gitbook-cli.html
  • https://tonydeng.github.io/gitbook-zh/gitbook-howtouse/howtouse/gitbookcli.html
  • https://www.chengweiyang.cn/gitbook/installation/README.html
  • https://www.youtube.com/watch?v=d4s0Ks0e-tA

1 安装node.js

2 Gitbook安装

  1. 打开cmd,运行以下命令
    npm install -g gitbook-cli 
    gitbook install 
    • 如果报错,解决方法参考:gitbook初探:TypeError: cb.apply is not a function

      TypeError: cb.apply is not a function 

      使用 nvm (Node Version Manager) 降低 node.js 版本:

      如果你还没有安装 nvm,参考以下链接进行安装 Node 版本管理器 NVM 安装指南

      安装所需的 Node.js 版本:

      nvm install 10.14.1 

      切换到该版本:

      nvm use 10.14.1 

3 新建书籍

  1. 新建一个文件,例如 gitbook_test,进入文件夹,打开cmd,运行以下命令

    gitbook init 
    • 这个命令创建了 readme.md 和 summary.md

4 修改书籍

5 打包静态网站

	gitbook serve 
  • 这个命令生成静态网站,点击输出的网址即可查看网址
  • 你会发现,在你编辑的gitbook项目的目录中会多一个 _book 目录,而这个目录中就是生成的本地预览的静态网站内容。
	gitbook build 
  • 这个命令打包静态网站到文件夹 _book

6 使用github部署静态网页

参考:

  • 使用Github部署静态域名网页
  • https://pages.github.com/
  1. 在github上面新建一个仓库

    • 建立的仓库命名规则为 <你的github用户名>.github.io
      在这里插入图片描述
  2. 进入 _book 文件夹, 打开 git bash ,运行以下命令

    git init 
    git remote add origin https://github.com/zp1008611/zp1008611.github.io.git 
    git branch -M main 
    git add . 
    git commit -m "Initial commit" 
    git push -u origin main 
  3. 进入 setting ,点击 page ,修改分支,点击 save
    在这里插入图片描述

  4. 打开网址 https://<你的github用户名>.github.io.

相关内容

热门资讯

托举天舟十号升空!长七火箭“美... 5月11日8时14分,天舟十号货运飞船载着总重近6.2吨的补给物资和实验载荷,在长征七号遥十一运载火...
“一人公司”社区落地贵阳高新区 5月7日,贵州科学城科技创新园与贵州星梦源科技有限公司正式签署合作协议,共同落地OPC(One Pe...
市、区科协联合开展科普大篷车进... 2026.5.11 近日,兰州市科协与城关区科协科普大篷车先后联合走进城关区拱星墩小学、文璟学校、甘...
科技保险从有保障迈向高质量 从人形机器人到人工智能大模型,从创新药到光电融合芯片……近年来,科技创新领域成果不断涌现。科技创新是...
天舟十号带货!太空光伏炸场,柔... 5 月 11 日,天舟十号货运飞船成功发射,除常规补给外,一件 “黑科技” 货物引爆市场 —— 我国...