[笔记]Github+Gitbook+Github Page+Typora搭建电子书-阿里云开发者社区

[笔记]Github+Gitbook+Github Page+Typora搭建电子书

2023-10-16 97

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： [笔记]Github+Gitbook+Github Page+Typora搭建电子书

前期

nodejs
npm
gitbook
github仓库
Typora MarkDown 编辑器

环境搭建

nodejs安装：NodeJS可在其官网（https://nodejs.org/zh-cn/）

npn安装gitbook：

npm install gitbook-cli -g

gitbook安装summer插件自动生成SUMMARY.md：

npm install -g gitbook-summary

开始gitbook搭建

创建文件夹

主要是创建以下目录：

docs：存放md文件
assert：是相关图片存放的目录（可选择创建）

以下目录是生成的：

创建book.json

以下为模板（包括插件，和配置信息）

{
  "plugins": [
    "collapsible-menu",
    "anchor-navigation-ex",
    "tbfed-pagefooter",
    "disqus",
    "summary", 
    "toggle-chapters", 
    "theme-comscore",
    "book-summary-scroll-position-saver",
    "expandable-chapters-small",
    "code",
    "copy-code-button"
  ],
  "title": "Shiver Book",
  "description": "Shiver Book",
  "author": "Shiver Book",
  "language": "zh-hans",
  "root": "./docs/",
  "links": {
    "sidebar": {
      "GitHub": "https://github.com/ShiverZm",
      "个人博客": "http://www.shiver.fun"
    }
  },
  "sharing": {
    "facebook": true,
    "twitter": true,
    "weibo": true,
    "qq": true,
    "all": [
      "douban",
      "google",
      "qzone",
      "linkedin"
    ]
  },
  "pluginsConfig": {
    "tbfed-pagefooter": {
      "copyright": "Copyright &copy ershouche-FE 2019",
      "modify_label": "文件修订时间：",
      "modify_format": "YYYY-MM-DD HH:mm:ss"
    },
    "disqus": {
      "shortName": "gitbookuse"
    }
  }
}

命令

初始化文件夹

生成README.md和SUMMARY.md

gitbook init

进入docs文件夹、根据目录生成SUMMARY.md

cd docs
sm book

安装book.json列出的插件

gitbook install

生成HTML

gitbook build

启动服务

gitbook serve

访问localhost:4000即可

开始github

创建仓库

上传book文件夹到主分支

目录上传到其他分支

设置github page

开始github action

创建.workflow/main.yml文件

创建环境变量token

常见问题

Gitbook错误"cb.apply is not a function"的解决办法

nodejs版本过高

改代码

https://zhuanlan.zhihu.com/p/367562636

https://blog.csdn.net/qq_43792900/article/details/131939070

一连串问题

不如卸载当前版本nodejs 安装nvm 来安装nodejs10.3

nvm install 10.3.0
nvm use 10.3.0