GitBook的使用方法
---恢复内容开始---
由于近期工作中使用gitbook编写讲义,现把出现的问题总结下:
1 . gitbook的安装
Gitbook与word等办公软件类似,能够编写文档,Gitbook中编写文档时使用的Markdown格式,可以提交到gitHub上进行版本管理,我使用的组合是gitbook+Typora+git完成整个内容的编写工作。
Gitbook 是基于 Node.js,所以我们首先需要安装 Node.js(下载地址:https://nodejs.org/en/download/),找到对应平台的版本安装即可。
现在安装Node.js会默认安装npm(node包管理工具),所以不用单独安装 npm,打开命令行,执行以下命令安装 GitBook:
npm install -g gitbook-cli
安装后,就会有一个gitbook命令,就可以使用这个命令来创建书籍。
书籍内容的编辑使用的是Typora,在网上找到安装包后,安装即可使用。
git是版本管理工具,大家应该都很熟悉,就像托管代码一样,托管我们的书籍即可。
2 . 书籍的创建
在你要创建书籍的文件夹下打开终端窗口,比方说是firstbook,执行下述命令:
gitbook init
执行完以上代码后,会在文件夹中产生两个文件:readme.md和summary.md
readme文件中是书籍的介绍内容,这个根据您的需求编写。
summary中是书籍的目录结构,现在我们就是用Typora编辑这个文件,其中的内容为:
* [Introduction](README.md) * [1. 季节](季节/ReadMe.md)
* [1.1 春](季节/section0.md)
* [1.2 夏](季节/section1.md) * [2. 城市](城市/ReadMe.md)
* [1.1 北京](城市/section0.md)
* [1.2 上海](城市/section0.md)
然后,我们执行gitbook init来中心初始化这本书籍,这是我们看下结果:
文件夹中就生成了各个章节对应的文件,我们就可以在这些文件中写入相应的内容。
书籍写完之后使用
gitbook serve
生成html的文件即可,
也可使用:
gitbook build
来生成书籍。
3 生成书籍后遇到的问题:
1 ,点击目录,无法到达对应的位置:
找到gitbook目录下的thema.js文件:
找到其中的if(m)for(n.handler&&并将其中的m修改为false即可。
2. 目录无法折叠,无法改变其宽度,code无法复制等
在 summary.md目录中添加一个book.json,然后在其中添加以下内容:
{
"title": "opencv",
"output.name": "site",
"language": "zh-hans",
"gitbook": "3.2.3",
"root": ".",
"plugins": [
"code",
"splitter",
"chapter-fold"
],
"pluginsConfig": {
"code": {
"copyButtons": true
}
}
}
并运行gitbook install 即可。
---恢复内容结束---
最新文章
- [css 揭秘]-css coding tips
- 200行代码搞定炸金花游戏(PHP版)
- Git分支的前世今生
- R语言学习
- Java读取txt文件,计算2011年9月份的通话时间
- ListView(1)几个重要属性,关闭滚动到顶部,底部的动画,item之间的分割线,背景等
- Scala List的排序函数sortWith
- c#后台修改前台DOM的css属性
- 浪潮MegaCli
- dir()函数:罗列出参数所有的功能列表
- 辛格尔顿和Android
- JavaScript高级程序设计:第二章
- vimplugin破解
- 我的three.js学习记录(三)
- Java基础概念1
- freemarker报错之一
- Keepalived 的使用
- Unity协程实现伪加载页面
- c++ std 最小堆的使用 (用于实现top100之类的功能)
- NIO-新的io操作方式
热门文章
- 全网最全乌云drops文章下载(epub)
- 黑阀 adb 命令
- 0810NOIP模拟测试赛后总结
- poj 3682 King Arthur's Birthday Celebration (期望dp)
- JavaScript 数组(Array)方法(二)
- 数据库DSN是什么
- Windows进程创建的流程分析
- Android之RelativeLayout相对布局
- python用reduce和map把字符串转为数字的方法
- 2006-2007 ACM-ICPC | POJ3380 POJ3384 POJ3385 水题题解