为了账号安全，请及时绑定邮箱和手机
点击这里，将文章分享到自己的动态
GitBook使用入门
GitBook是什么？GitGit可能是目前全球最通用软件编程、软件开发项目的管理工具，帮助开发人员对项目文件和开发进度进行管理，支持版本历史管理和多人协作管理等必须功能。GitHubGitHub是Git在线化，就是有人把自家的git服务向所有人公开了，每个开发者都能使用它来在线管理自家的项目。目前它已经是全球最大的开源软件项目集散地地，很多知名的项目比如Nodejs，Tensorflow等等都是发布在GitHub上面的开源项目。开源意味着你可以随时把整个项目的源代码拷贝到你的计算机上，和项目的开发人员同步看到项目的代码内容，看到项目的发展过程；也意味着你可以提出自己对项目代码的改进意见，并提及给项目管理人员，如果你的建议足够好或者你修改进的代码足够精彩，那么它会出现在项目的下一个版本中向全世界人发布。GitBookGitHub是基于Git技术的，是面向做软件开发的程序员的。GitBook同样是基于Git技术的，但它最初定位是面向软件说明文档的编写者的，但它同样适合任何类型的文字编辑工作者。GitBook是使用软件项目的先进管理经验打造的在线文档书籍撰写工具。 & / &
/ & / &GitBook工具链/可以在线协作一起写书，并且直接发布到这个网站，方便分享和公众阅读。这是一个机遇Node.js的本机服务软件，他可以在断网状态下载浏览器内展示你的书籍。离线的编辑器，支持Windows和MacOS、Linux，类似office word那种，但更简单写出书也更漂亮。GitBook Editor编辑器书籍管理如果您没有梯子，可以在一开始选择Do that later暂不登录延迟登录从菜单GitbookEditor设置书籍存储目录Change Library Path，接下来书籍所有文件都会放到这里设置目录然后可以随便创建一个新书+new book，名称任意如MyFirstBook。点左上角铅笔图标可以返回书籍列表。文章管理撰写界面左侧列出了文章的内容列表TOC(Table of content)，就是书的目录了。FILES文件模式是这个项目的实际使用的文件，先不用管。已经有两篇文章introduction本书说明和First Chapter第一章。点击可以在右侧主区域打开并编辑。新建、重命名、删除、上下拖拽调整顺序，这些不再多说。本地预览请参照下一段GitBook本地服务GitBook本地服务安装使用命令行安装GitBook本地服务。npm&install&gitbook-cli&-g启动服务然后cd进入你的书籍目录，比如xx/import/mybookname，然后执行命令启动服务gitbook&serve如果你遇到问题，那么可能需要初始化一下。初始化项目gitbook&init其实可以使用任意的编辑器来修改md文档，不仅仅限于Editor。发布到legacy.gitbook.com创建GitHub仓库首先需要登录注册登录并创建一个项目start a project（仓库reposi'tory)。创建项目任意项目名称，其他默认，你将会得到一个GitHub仓库地址类似https://github.com/zhyuzh3d/mytestbook.git上传到Github(自备梯子)然后在编辑器book菜单sync,这会弹出提示需要输入上面的.git地址，然后要输入GitHub用户名和密码，稍后本地的书籍文件就上传到GitHub仓库了。关联GitHub和GitBook(自备梯子)回到legacy.gitbook.com，使用GitHub账号登录，然后从右上角头像Account Setting账号设置进入，左侧选GitHub，右侧Integration整合，install，这将让你选择把哪个repository仓库同步过来，可以选全部。从GitHub仓库创建书籍创建一本新书，然后从SETTINGS进入，再点左侧GitHub，然后输入你的GitHub仓库名，这样就把GitHub仓库变成GitBook书籍的形式展示了。在GitBook里面点read阅读这个书籍，和本机serve的效果是一样的，而且当我们本机Editor修改之后，只要sync一下就能自动同步刷新了。这个书籍的链接可分享或者发给朋友，当然确保你的朋友自备梯子...其他同步到GitHub的方法使用命令行或者界面化的Git工具，比如SourceTree，将import下的mytestbook文件夹推送到GitHub目录。在线编写（自备梯子）也可以完全使用legacy的在线编写工具撰写书籍。MardDown语法GitBook都是基于markdown语法的，其实就是一些特殊的符号表示文字样式，比如一个#加空格代表这是一行大标题，两个##加空格代表这是二号标题，一个*加空格代表这是一个列表，&加空格代表后面的文字是注释，等等。很多编辑器和网站都支持markdown语法，比如你现在看的这个简书文章就是markdown语法撰写的。你可以在网上搜索markdown找到很多教程。结语依赖于GitHub社区，GitBook很可能成为新的通用工具。但由于被墙也就并不推荐普通用户使用。如果需要的话可以优先考虑国内的.作者：zhyuzh3d链接：https://www.jianshu.com/p/b0a11b9b8725來源：简书著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
若觉得本文不错，就分享一下吧！
评论加载中...
看过此文的用户，还看了以下文章
正在加载中
作者相关文章想制作自己的电子书？Gitbook使用介绍想制作自己的电子书？Gitbook使用介绍昌乐安百家号gitbook是制作电子书的利器，下面介绍在Windows上如何安装gitbook。1. 官网下载Node.js - https://nodejs.org/zh-cn/，选择推荐版本安装。2. 修改默认的镜像地址为国内地址$ npm config set registry http://registry.npm.taobao.org或者修改~/.npmrc文件，添加行registry=http://registry.npm.taobao.org3. 全局安装gitbook$ npm install gitbook-cli -g安装过程，需要下载安装包，等待一段时间，具体多长取决于你的网速和硬件配置。安装完成后运行命令$ gitbook init4. gitbook常用命令$ gitbook --help //输出gitbook-cli的帮助信息$ gitbook build //生成静态网页$ gitbook serve //生成静态网页并运行服务器，默认端口4000$ gitbook build --gitbook=3.2.3 //生成时指定的gitbook版本，本地没有会先下载$ gitbook ls //列出本地所有gitbook版本$ gitbook update //更新到最新的gitbook版本$ gitbook uninstall 2.0.1 //卸载对应的gitbook版本$ gitbook build --log=debug //指定log的级别$ gitbook build --debug //输出错误信息5. 文本编辑 - typora下载地址：https://typora.io/#windows注意：引用图片时，一定要是相对路径，否则无法显示图片。本文由百家号作者上传并发布，百家号仅提供信息发布平台。文章仅代表作者个人观点，不代表百度立场。未经作者许可，不得转载。昌乐安百家号最近更新：简介:好的书籍是最贵重的珍宝。作者最新文章相关文章30.5k 人阅读
标签：至少1个，最多5个
GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书。GitBook支持输出以下几种文档格式
静态站点：GitBook默认输出该种格式
PDF：需要安装gitbook-pdf依赖
eBook：需要安装ebook-convert
在使用GitBook 之前, 我们需要先安装一些必须的工具，Node.js、GitBook、GitBook Editor、Git版本控制器。
Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台， 用来方便地搭建快速的， 易于扩展的网络应用· Node.js 借助事件驱动， 非阻塞 I/O 模型变得轻量和高效， 非常适合 run across distributed devices 的 data-intensive 的实时应用。
1、win下安装Node.js
直接到nodejs官网下载，简单安装即可，此处不再细述。
2、检测是否安装成功
//显示v4.1.1
GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书。通过Node.js命令安装GitBook
1、NMP安装Gitbook
npm install gitbook -g
2、安装gitbook CLI
想在系统上的任何地方的gitbook命令，需要安装“gitbook CLI”，执行以下命令
//安装命令npm install -g gitbook-cli//卸载命令npm uninstall -g gitbook
3、检验下是否安装成功
gitbook -V
//显示0.4.2
Git是一款免费、开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目。基本安装请点击安装教程。如果不需要从GitHub更新书到本地再编译，则可以不安装Git。
GitBookEditor
GitBook官方客户端编辑器，支持Win、Linux、Mac系统。请点击下载GitBookEditor。使用该编辑器可以快速的创建、编辑GitBook。安装具有以下步骤：
解压下载包 gitbook-editor-4.2.1-windows-ia32.zip
运行GitBook Editor Setup.exe进行默认安装
GitBook 大致分为两种使用方式，即离线和在线。最简单的使用方式是使用GitBook Editor编辑GitBook ，然后使用相关命令编译成功HTML。当然还有以下几种方式
使用命令创建基本GitBook
使用网页在线编辑器创建、编辑GitBook。
使用itBookEditor客户端创建、编辑GitBook。
gitBookEditor
使用客户端方式，支持在线和本地两种方式创建、编辑GitBook，再执行相关命令编译成HTML，这种方式比较方便，推荐使用。以本地创建书籍为例
1、gitBookEditor客户端基本使用
2、使用命令对已经创建的Book进行编译
找到需要编译的书籍所在目录，执行gitbook serve 命令,在本电脑的默认路径为C:UsersQGYGitBookLibraryImportgitbooksimpletutorial，如图所示
掌握了“基本使用”，但有时候想要gitBook更美观，或者更符合我们自己的需求，则通过book.json配置进行自定义、以及安装一些常用的插件等。
Book.json配置
GitBook 在编译书籍的时候会读取书籍源码顶层目录中的 book.js 或者 book.json，这里以 book.json 为例，参考 GitBook 文档 可以知道，book.json 支持如下配置
//样式风格配置格式
"styles": {
"website": "styles/website.css",
"ebook": "styles/ebook.css",
"pdf": "styles/pdf.css",
"mobi": "styles/mobi.css",
"epub": "styles/epub.css"
//插件安装配置格式
"plugins": ["myplugin"],
"pluginsConfig": {
"myPlugin": {
"message": "Hello World"
自定义插件扩展
插件是扩展GitBook功能最好的方法。使得GitBook功能更加强大，例如，把数学公式显示支持，跟踪回访使用谷歌解析，…以toggle-chapters插件为例toggle-chapters 插件的效果是默认只在目录导航中显示章的标题，而不会显示小节的标题，点击每一章或者每一节会显示当前章或节的子目录，如果有的话，但是同时会收起其它之前展开的章节。所以，个人认为不是非常实用，因为这样子用户不能快速跳转到没有展开的章节！
一、搜索、安装插件方式
1、编辑器方式（没成功）
2、通过GitHub方式
www.plugins.gitbook.com
3、node.js命令方式
默认安装在以下路径
C:\Users\QGY\AppData\Roaming\npm\node_modules
把插件文件夹复制到
npm install gitbook-plugin-toggle-chapters --save-dev
二、通过Book.json配置插件
"plugins": ["toggle-chapters"],
"pluginsConfig": {
"myPlugin": {
"message": "Hello World"
13 收藏&&|&&72
你可能感兴趣的文章
你可能感兴趣的文章
分享到微博？
我要该，理由是：
在 SegmentFault，学习技能、解决问题
每个月，我们帮助 1000 万的开发者解决各种各样的技术问题。并助力他们在技术能力、职业生涯、影响力上获得提升。新人专享好礼凡未购买过小册的用户，均可领取三张 5 折新人专享券，购买小册时自动使用专享券，最高可节省 45 元。小册新人 5 折券最高可省 15 元小册新人 5 折券最高可省 15 元小册新人 5 折券最高可省 15 元注：专享券的使用期限在领券的七天内。一键领取购买小册时自动使用专享券前往小册首页本活动仅适用于小册新用户知道了GitBook 使用教程首先先献上 ，可以在我的
导航栏处找到，下面进行相关的介绍。
由于之前都把零散的知识都写在
上，要查找的时候不是很系统化，所以打算挪到
上来统一管理，而且
写完编译后可以生成静态页面发布到博客上，逼格满满的样子。
GitBook 是一个基于 Node.js 的命令行工具，下载安装 ，安装完成之后，你可以使用下面的命令来检验是否安装成功。
输入下面的命令来安装 GitBook。
$ npm install gitbook-cli -g
安装完成之后，你可以使用下面的命令来检验是否安装成功。
$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
更多详情请参照
来安装 GitBook。
下载 GitBook 编辑器；如果是 Mac 用户且安装过 brew cask 的话可以使用 brew cask install gitbook-editor 命令行来安装 GitBook 编辑器。
GitBook 准备工作做好之后，我们进入一个你要写书的目录，输入如下命令。
$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished
可以看到他会创建 README.md 和 SUMMARY.md 这两个文件，README.md 应该不陌生，就是说明文档，而 SUMMARY.md 其实就是书的章节目录，其默认内容如下所示：
* [Introduction](README.md)
接下来，我们输入 $ gitbook serve 命令，然后在浏览器地址栏中输入 http://localhost:4000 便可预览书籍。
效果如下所示：
运行该命令后会在书籍的文件夹中生成一个 _book 文件夹, 里面的内容即为生成的 html 文件，我们可以使用下面命令来生成网页而不开启服务器。
gitbook build
下面我们来详细介绍下 GitBook 目录结构及相关文件。
GitBook 基本的目录结构如下所示：
├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
├── README.md
└── something.md
└── chapter-2/
├── README.md
└── something.md
下面我们主要来讲讲 book.json 和 SUMMARY.md 文件。
该文件主要用来存放配置信息，我先放出我的配置文件。
"title": "Blankj's Glory",
"author": "Blankj",
"description": "select * from learn",
"language": "zh-hans",
"gitbook": "3.2.3",
"styles": {
"website": "./styles/website.css"
"structure": {
"readme": "README.md"
"links": {
"sidebar": {
"我的狗窝": "https://blankj.com"
"plugins": [
"-sharing",
"splitter",
"expandable-chapters-small",
"anchors",
"github-buttons",
"sharing-plus",
"anchor-navigation-ex",
"pluginsConfig": {
"github": {
"url": "https://github.com/Blankj"
"github-buttons": {
"buttons": [{
"user": "Blankj",
"repo": "glory",
"type": "star",
"size": "small",
"count": true
"donate": {
"alipay": "./source/images/donate.png",
"title": "",
"button": "赞赏",
"alipayText": " "
"sharing": {
"douban": false,
"facebook": false,
"google": false,
"hatenaBookmark": false,
"instapaper": false,
"line": false,
"linkedin": false,
"messenger": false,
"pocket": false,
"qq": false,
"qzone": false,
"stumbleupon": false,
"twitter": false,
"viber": false,
"vk": false,
"weibo": false,
"whatsapp": false,
"google", "facebook", "weibo", "twitter",
"qq", "qzone", "linkedin", "pocket"
"anchor-navigation-ex": {
"showLevel": false
"favicon":{
"shortcut": "./source/images/favicon.jpg",
"bookmark": "./source/images/favicon.jpg",
"appleTouch": "./source/images/apple-touch-icon.jpg",
"appleTouchMore": {
"120x120": "./source/images/apple-touch-icon.jpg",
"180x180": "./source/images/apple-touch-icon.jpg"
相信很多节点自己也能猜到是什么意思，我还是简单介绍下吧。
本书语言，中文设置 "zh-hans" 即可
指定使用的 GitBook 版本
自定义页面样式
指定 Readme、Summary、Glossary 和 Languages 对应的文件名
在左侧导航栏添加链接信息
配置使用的插件
配置插件的属性
这个文件主要决定 GitBook 的章节目录，它通过 Markdown 中的列表语法来表示文件的父子关系，下面是一个简单的示例：
* [Introduction](README.md)
* [Part I](part1/README.md)
* [Writing is nice](part1/writing.md)
* [GitBook is nice](part1/gitbook.md)
* [Part II](part2/README.md)
* [We love feedback](part2/feedback_please.md)
* [Better tools for authors](part2/better_tools.md)
这个配置对应的目录结构如下所示:
我们通过使用 标题 或者 水平分割线 将 GitBook 分为几个不同的部分，如下所示：
* [Introduction](README.md)
* [Writing is nice](part1/writing.md)
* [GitBook is nice](part1/gitbook.md)
* [We love feedback](part2/feedback_please.md)
* [Better tools for authors](part2/better_tools.md)
* [Last part without title](part3/title.md)
这个配置对应的目录结构如下所示:
GitBook 有 ，默认带有 5 个插件，highlight、search、sharing、font-settings、livereload，如果要去除自带的插件， 可以在插件名称前面加 -，比如：
"plugins": [
如果要配置使用的插件可以在 book.json 文件中加入即可，比如我们添加 ，我们在 book.json 中加入配置如下即可：
"plugins": [ "github" ],
"pluginsConfig": {
"github": {
"url": "https://github.com/your/repo"
然后在终端输入 gitbook install ./ 即可。
如果要指定插件的版本可以使用 plugin@0.3.1，因为一些插件可能不会随着 GitBook 版本的升级而升级。
这是我对 GitBook 使用的总结，希望能帮到今后需要的小伙伴。
加入掘金和开发者一起成长。发送简历到 hr@xitu.io，期待你的加入！分享gitbook安装与使用之windows下搭建gitbook平台
时间： 12:44:17
&&&& 阅读：280
&&&& 评论：
&&&& 收藏：0
标签：&&&&&&&&&&&&&&&&&&&&&&&&&&&
安装nodejs
http://nodejs.cn/download/
cnpm安装gitbook
解压书籍文件，并cd到书籍文件目录
gitbook serve
浏览器访问localhost:4000
先在windows 下安装nodejs
官网：https://nodejs.org/en/
下载后直接安装即可
然后通过cmd调出DOS命令窗口测试下是否安装完成
输入命令：node
输入：console.log("Hello,World!");测试一下
在D盘下建立一个app文件夹，app文件夹里面写一个test.js。
代码如下：
var&http = require("http");
http.createServer(function(req, res) {
&&res.writeHead( 200 , {"Content-Type":"text/html"});
&&res.write("&h1&Node.js&/h1&");
&&res.write("&p&Hello World&/p&");
&&res.end("&p&beyondweb.cn&/p&")
}).listen(3000);
console.log("HTTP server is listening at port 3000.");
编辑好文件后
再从DOS窗口进入你的app的文件夹，在命令窗口执行【node test.js】。这样就可以在网页上访问你的js了。访问网址http://127.0.0.1:3000。如果你正常访问了，那么就安装成功了。
Nodejs安装成功。
搭建gitbook平台
输入命令，全局安装gitbook。
npm install gitbook-cli -g
由于安装过程默认使用国外镜像，可以考虑切换国内镜像。
在CMD窗口中输入
&& mkdir&& mybook&&&&&&&&&&&&&&&&&&&&&&&&&&& 创建文件夹
切换到目录下.
切换文件夹后在当前文件目录下的在窗口中输入如下命令
&gitbook init&&&&& //初始化目录文件
初始化之后
gitbook安装好之后
解压书籍文件，并cd到书籍文件目录
gitbook serve
然后就可以输入http://127.0.0.1:4000/ 访问了
1、需要安装node.js。去官网下载对应的版本就可以了https://nodejs.org/en/2、安装cnpm，其实安装npm也可以的。。npm install cnpm -g --registry=https://registry.npm.taobao.org3、cnpm
-g gitbook-cli4、cd
到要查看的文件目录5、gitbook
serve6、http://127.0.0.1:4000/
浏览器查看电子书
&标签：&&&&&&&&&&&&&&&&&&&&&&&&&&&原文地址：http://www.cnblogs.com/bell1991/p/7016806.html
&&国之画&&&& &&&&chrome插件
版权所有 京ICP备号-2
迷上了代码！}