使⽤gitee+gitbook搭建个⼈在线电⼦书
GitBook是⼀个简单的个⼈在线书籍⽹站,在这⾥可以把⾃⼰的⽂档整理成书籍发布出来,便于阅读,现在使⽤gitee+gitbook搭建个⼈在线电⼦书!
搭建环境
git node.js gitbook Gitee Pages
搭建步骤
1. 配置好本地Git环境
2. 安装node.js,可在cmd输⼊node查看是否安装成功
3. 使⽤码云(与Github类似),新建仓库,开启Gitee Pages服务,master分⽀放HTML⽂件,新建book分⽀放源码
4. gitbook 环境搭建
1.安装gitbook
npm install -g gitbook-cli
gitbook -V
2.创建⽬录
mkdir gitbook
cd gitbook
gitbook init
3.启动gitbook服务,可以在浏览器查看
gitbook serve
4.⽣成项⽬静态⽹页,"_book"⽬录
gitbook build
5.安装gitbook插件
gitbook install
6.成 PDF 格式的电⼦书
gitbook pdf ./ ./mybook.pdf
使⽤报错
gitbook -V安装报错
C:\Users\Admin\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287 if(cb) cb.apply(this, arguments)
^
TypeError: cb.apply is not a function
解决⽅案
注释C:\Users\Admin\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js
// fs.stat = statFix(fs.stat)
// fs.fstat = statFix(fs.fstat)
// fs.lstat = statFix(fs.lstat)
Gitbook结构介绍
# gitbook init后⽣成⽂件树
├── node_modules
├── book.json (配置数据(optional))
├── README.md (电⼦书的前⾔或简介(required))
├── SUMMARY.md (电⼦书⽬录(optional))
├── GLOSSARY.md (词汇/注释术语列表(optional))
优化Gitbook
在gitbook中有很多有⽤的插件,可以进⾏美化页⾯,但是使⽤起来会有⼀点⿇烦,这⾥仅讲解如何使⽤,gitbook的插件⼤部分都在npm 上,可以访问npm官⽹⾃⾏查看并搜索插件。
演⽰安装gitbook-plugin-summary的⽅法
插件:gitbook-plugin-summary (⾃动⽣成⽬录)
安装步骤:
1.打开gitbook根⽂件夹下的book.json⽂件,若没有就创建此⽂件
2.将以下代码复制进去
{网站源码在线
"plugins":["summary"]
}
3.打开命令⾏,在这个⽂件夹中执⾏命令`gitbook install`安装插件,执⾏命令`gitbook serve`,
然后在查看的时候就会发现,之前明明没有写⽬录,现在却有了⽬录

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。