pythoncamp0

1.注册 GitBook

可以用 GitHub 账号直接登陆。

tips:不要忘记验证你的邮箱。如何验证请看下面的具体步骤。

2.登陆

3.入门

GitBook 非常简单,新建一个 book 就可以进入第三个步骤了。

4.Gitbook 的命令行

下载并安装 Nodejs
 $ note -v
 显示"v0.12.0"表示已安装。 
GitBook命令
 $ gitbook -V     
 显示 "1.5.0",表示Gitbook也已经安装。

 $ gitbook build ./repository --output=./outputFolder
 显示“Starting build ...
      ENOENT, open 'repository/README.md'”
 但不会处理。

 $ gitbook build 
 显示“Starting build ...
     Cannot read property 'text' of undefined”

 $ gitbook init

显示如下错误

“TypeError: Cannot read property 'text' of undefined
at parseChapter (/usr/local/lib/node_modules/gitbook/lib/parse/summary.js:95:46)
at Array.map (native)
at Object.parseSummary [as summary] (/usr/local/lib/node_modules/gitbook/lib/parse/summary.js:134:6)
at /usr/local/lib/node_modules/gitbook/lib/generate/init.js:33:22
at _fulfilled (/usr/local/lib/node_modules/gitbook/node_modules/q/q.js:787:54)
at self.promiseDispatch.done (/usr/local/lib/node_modules/gitbook/node_modules/q/q.js:816:30)
at Promise.promise.promiseDispatch (/usr/local/lib/node_modules/gitbook/node_modules/q/q.js:749:13)
at /usr/local/lib/node_modules/gitbook/node_modules/q/q.js:557:44
at flush (/usr/local/lib/node_modules/gitbook/node_modules/q/q.js:108:17)
at process._tickCallback (node.js:355:11)”

我在谷歌搜索“TypeError: Cannot read property 'text' of undefined”,找到一个 issue 提了这个问题,给出的解决方法是在 Summary 中去掉了空行。我这并不奏效。

在这个过程中会发现 GitBook 的使用不知不觉已经会了,而这时候你发现你接着需要学习的是 Markdown,见后续章节。