[转载] gitbook安装与使用

转载自http://blog.csdn.net/xiaocainiaoshangxiao/article/details/46882921

废话不说,直接主题:

gitbook安装

===========

1. 安装npm 
从网站 https://nodejs.org/#download 下载node.js源代码(点击绿色的INSTALL),
解压
./configure
make
make install 
成功执行后,npm就被安装好了。

2. gitbook 安装
npm install -g gitbook-cli

gitbook -V 
查看gitbook是否安装成功。

ref
===
1. wanqingwong.com/gitbook-zh/index.html

gitbook使用
===========
1. 根据目录生成图书结构

1.1 README.md 与 SUMMARY编写
README.md
这个文件相当于一本Gitbook的简介。
$ mkdir test_gitbook
$ touch README.md

SUMMARY.md
这个文件是一本书的目录结构,使用Markdown语法,
如我们这本书的SUMMARY.md:
$ touch SUMMARY.md
$ vim SUMMARY.md

输入

* [简介](README.md)
* [第一章](chapter1/README.md)
 - [第一节](chapter1/section1.md)
 - [第二节](chapter1/section2.md)
* [第二章](chapter2/README.md)
 - [第一节](chapter2/section1.md)
 - [第二节](chapter2/section2.md)
* [结束](end/README.md)

1.2 生成图书结构
当这个目录文件创建好之后,我们可以使用Gitbook
的命令行工具将这个目录结构生成相应的目录及文件:
$ gitbook init
$ tree . #查看建立的目录和文件
.
├── chapter1
│   ├── README.md
│   ├── section1.md
│   └── section2.md
├── chapter2
│   ├── README.md
│   ├── section1.md
│   └── section2.md
├── end
│   └── README.md
├── README.md
└── SUMMARY.md

我们可以看到,gitbook给我们生成了与SUMMARY.md所
对应的目录及文件。

每个目录中,都有一个README.md文件,相当于一章的说明。

2. 生成图书

2.1 输出为静态网站
你有两种方式输出一个静态网站:
2.1.1 本地预览时自动生成
当你在自己的电脑上编辑好图书之后,你可以使用Gitbook
的命令行进行本地预览:

$ gitbook serve .

然后浏览器中输入 http://localhost:4000 就可以预览生
成的以网页形式组织的书籍。
这里你会发现,你在你的图书项目的目录中多了一个名为
_book的文件目录,而这个目录中的文件,即是生成的静态
网站内容。
使用build参数生成到指定目录
与直接预览生成的静态网站文件不一样的是,使用这个命令,
你可以将内容输入到你所想要的目录中去:
$ mkdir /tmp/gitbook
$ gitbook build --output=/tmp/gitbook

2.2 输出PDF
输入为PDF文件,需要先使用NPM安装上gitbook pdf:
$ sudo npm install gitbook-pdf -g
我在执行上面这条命令的时候出现了下面的错误:
***************************************************
Downloading http://cdn.bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.7-linux-i686.tar.bz2
Saving to /usr/local/lib/node_modules/gitbook-pdf/node_modules/phantomjs/phantomjs/phantomjs-1.9.7-linux-i686.tar.bz2
Error: connect ETIMEDOUT
    at exports._errnoException (util.js:746:11)
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1010:19)
npm ERR! Linux 3.2.0-4-686-pae
npm ERR! argv "/usr/local/bin/node" "/usr/local/bin/npm" "install" "gitbook-pdf" "-g"
npm ERR! node v0.12.7
npm ERR! npm  v2.11.3
npm ERR! code ELIFECYCLE

npm ERR! [email protected] install: `node install.js`
npm ERR! Exit status 1
npm ERR! 
npm ERR! Failed at the [email protected] install script ‘node install.js‘.
npm ERR! This is most likely a problem with the phantomjs package,
npm ERR! not with npm itself.
npm ERR! Tell the author that this fails on your system:
npm ERR!     node install.js
npm ERR! You can get their info via:
npm ERR!     npm owner ls phantomjs
npm ERR! There is likely additional logging output above.

npm ERR! Please include the following file with any support request:
npm ERR!     /home/wangxq/repository/phantomjs/npm-debug.log

***************************************************
由错误报告内容的第一行可以知道,发生错误的原因是下载
phantomjs发生了错误,因此我们需要手动下载和安装。

解决方法:[1]
$ git clone git://github.com/ariya/phantomjs.git
$ sudo apt-get install build-essential g++ flex bison gperf ruby perl \
  libsqlite3-dev libfontconfig1-dev libicu-dev libfreetype6 libssl-dev \
  libpng-dev libjpeg-dev python libx11-dev libxext-dev       #安装编译需要的工具和依赖
$ cd phantomjs
$ git checkout 1.9.7  #注意:这里的1.9.7是phantom的版本号,可以由错误报告的第一行找出 
$ ./build.sh --jobs 4
$ sudo cp bin/phantomjs /bin/
$ sudo npm install gitbook-pdf -g  #重新进行安装

然后,使用下面的命令,要PDF文件,首先安装依赖库:

$ sudo apt-get install calibre  
$ gitbook -v 2.1.0 pdf .
发生错误:
*****************************************************
info: start conversion to pdf ....ERROR

Error: Command failed: /bin/sh -c ebook-convert /tmp/tmp-29384ctltwbk/SUMMARY.html /tmp/tmp-29384ctltwbk/index.pdf --title="" --comments="这本书是gitbook的一个例子" --language="en" --book-producer="GitBook" --publisher="GitBook" --chapter="descendant-or-self::*[contains(concat(‘ ‘, normalize-space(@class), ‘ ‘), ‘ book-chapter ‘)]" --chapter-mark="pagebreak" --page-breaks-before="/" --level1-toc="descendant-or-self::*[contains(concat(‘ ‘, normalize-space(@class), ‘ ‘), ‘ book-chapter-1 ‘)]" --level2-toc="descendant-or-self::*[contains(concat(‘ ‘, normalize-space(@class), ‘ ‘), ‘ book-chapter-2 ‘)]" --level3-toc="descendant-or-self::*[contains(concat(‘ ‘, normalize-space(@class), ‘ ‘), ‘ book-chapter-3 ‘)]" --no-chapters-in-toc --max-levels="1" --breadth-first --margin-left="62" --margin-right="62" --margin-top="56" --margin-bottom="56" --pdf-default-font-size="12" --pdf-mono-font-size="12" --paper-size="a4" --pdf-header-template="<p class=‘header‘><span></span></p>" --pdf-footer-template="<p class=‘footer‘><span>_SECTION_</span> <span style=‘float:right;‘>_PAGENUM_</span></p>"
Usage: ebook-convert input_file output_file [options]

Convert an ebook from one format to another.

input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command.

The output ebook format is guessed from the file extension of output_file. output_file can also be of the special format .EXT where EXT is the output file extension. In this case, the name of the output file is derived the name of the input file. Note that the filenames must not start with a hyphen. Finally, if output_file has no extension, then it is treated as a directory and an "open ebook" (OEB) consisting of HTML files is written to that directory. These files are the files that would normally have been passed to the output plugin.

After specifying the input and output file you can customize the conversion by specifying various options. The available options depend on the input and output file types. To get help on them specify the input and output file and then use the -h option.

For full documentation of the conversion system see
http://manual.calibre-ebook.com/conversion.html

Whenever you pass arguments to ebook-convert that have spaces in them, enclose the arguments in quotation marks.

ebook-convert: error: no such option: --pdf-default-font-size

*****************************************************
解决方法[2]
$ sudo -v && wget -nv -O- https://raw.githubusercontent.com/kovidgoyal/calibre/master/setup/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write(‘Download failed\n‘); exec(sys.stdin.read()); main()"

$ gitbook -v 2.1.0 pdf .  # 重新执行命令生成pdf,目标文件为book.pdf

ref
===
1. http://phantomjs.org/build.html
2. http://calibre-ebook.com/download_linux

问题
===
1. 如果输入gitbook init命令,出现Installing version 2.1.0,
需要耐性等待安装。

时间: 2024-10-04 03:59:45

[转载] gitbook安装与使用的相关文章

gitbook安装与使用

废话不说,直接主题: gitbook安装 =========== 1. 安装npm 从网站 https://nodejs.org/#download 下载node.js源代码(点击绿色的INSTALL), 解压 ./configure make make install 成功执行后,npm就被安装好了. 2. gitbook 安装 npm install -g gitbook-cli gitbook -V 查看gitbook是否安装成功. ref === 1. wanqingwong.com/g

Gitbook安装

Gitbook安装 Gitbook是从NMP安装的,命令行: $ npm install gitbook -g 安装完之后,你可以检验下是否安装成功: $ gitbook -V 0.4.2 如果你看到了与上面类似的版本信息,则表示你已成功完装上了Gitbook.

gitbook安装与使用之windows下搭建gitbook平台

安装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文件夹,

gitbook安装及初步使用

gitbook安装 https://www.jianshu.com/p/421cc442f06c https://blog.csdn.net/lu_embedded/article/details/81100704 结合插件typora设置:上传本地图片至github.初始设置 typora下载后安装很简单,选择一下安装位置及创建桌面快捷键就行 https://blog.csdn.net/qq_38056704/article/details/84765586 https://blog.csdn

转载maven安装,配置,入门

转载:http://www.cnblogs.com/dcba1112/archive/2011/05/01/2033805.html 本书代码下载 大家可以从我的网站下载本书的代码:http://www.juvenxu.com/mvn-in-action/,也可以通过我的网站与我取得联系,欢迎大家与我交流任何关于本书的问题和关于Maven的问题. 咖啡与工具 本书相当一部分的内容是在苏州十全街边的Solo咖啡馆完成的,老板Yin亲手烘焙咖啡豆.并能做出据说是苏州最好的咖啡,这小桥流水畔的温馨小

转载 eclipse 安装插件 jsp,html, js, css viewer

转载 http://www.cnblogs.com/mmmn/archive/2013/01/22/2870750.html 内容如下: 编辑一些页面文件,例如JSP,HTML,JS等,直接用内置的文本编辑器基本比较疯狂,自己选了一个顺手的编辑器,Eclipse HTML Editor! Eclipse HTML编辑器插件主要提供以下功能:- HTML/JSP/XML/CSS/DTD/JavaScript语法高亮- HTML/JSP预览- JSP/XML验证- HTML标签,基于DTD的XML,

转载:安装Ubuntu 15.10后要做的事

原文转载于:http://blog.csdn.net/skykingf/article/details/45267517 Ubuntu 15.10发布了,带来了很多新特性,同样也依然带着很多不习惯的东西,所以装完系统后还要进行一系列的优化. 1.删除libreoffice libreoffice虽然是开源的,但是Java写出来的office执行效率实在不敢恭维,装完系统后果断删掉 [html] view plain copy sudo apt-get remove libreoffice-com

转载 Python 安装setuptools和pip工具操作方法(必看)

本文章转载自 脚本之家 http://www.jb51.net  感谢! setuptools模块和pip模块是python进行第三方库扩展的极重要工具,例如我们在需要安装一些爬虫或者数据分析的包时就可以使用pip install命令来直接安装这些包了,因此pip工具一定要提前安装. 一.安装setuptools 在python交互界面执行如下命令,脚本我单独拿出来: ? 1 2 3 4 from urllib import urlopen data = urlopen('http://peak

(转载)Oracle12g安装图解与安装过程常见问题注意事项

首附转载地址:http://jingyan.baidu.com/article/f96699bbab21c0894e3c1bf8.html 首先,点击"setup",建议以管理员身份运行. 接下来如下图,检查监视器参数(此处依据机子配置等待时间不等,要耐心) 随后,如果符合安装要求,会出现安装程序界面 配置安全更新,如下图 电子邮件(可选) 我希望通过My Oracle Support接收安全更新(W)(可选) 一般情况下,这两项不必要勾选,如果你是DBA另说. 取消勾选"我