在自己的服务器上安装GitBook

无意间发现在这个开源的EBook制作软件GitBook,你可以在官网上配置相关信息来和自己的GitHub账号绑定来创建自己的EBook,并且支持生成PDF、ePub和MOBI 三种格式提供下载。

但是我想自己安装GitBook来生成HTML格式,那样就可以放在自己的网站里面了。

安装过程:

  • 安装基本环境

    • 安装Git
    • 安装NVM、Node.js和NPM
    • 升级Python版本到2.7.1以上
  • 安装GitBook及calibre组件
  • 初始化并生成Demo
  • 生成HTML以及其他格式的文件

安装基本环境

安装Git

CentOS安装Git的过程我写在自己的问答网站了,点击 CentOS安装Git

安装NVM、Node.js和NPM

快速搭建 Node.js / io.js 开发环境以及加速 npm

升级Python版本到2.7.1以上

由于GitBook生成多格式的文件需要用到calibre,calibre最新版要求python ≥ 2.7.1 not 3.x 。

查看Python版本:python ,看结果中Python的版本是否符合要求。

如果需要升级Python,请查看:centos系统升级python 2.7.3

安装GitBook及calibre组件

安装GitBook:

$ npm install gitbook-cli -g

安装calibre:

Calibre安装文档 For Linux

我找到的安装代码如下:

wget -nv -O- https://raw.githubusercontent.com/kovidgoyal/calibre/master/setup/linux-installer.py | python -c "import sys; main=lambda x:sys.stderr.write(‘Download failed\n‘); exec(sys.stdin.read()); main(‘/opt‘)"

命令的最后 main(‘/opt‘)/opt 为Calibre的安装目录,可根据需要修改。

初始化并生成Demo

$ cd /home/
$ mkdir gitbook
$ cd gitbook/
$ mkdir demo
$ cd demo/
$ gitbook init

执行最后一个命令之后会在 /home/gitbook/demo/ 下生成 README.mdSUMMARY.md 两个文件

生成HTML以及其他格式的文件

1.生成完整的静态 HTML:切换到书的目录后built 即可

$ cd /home/gitbook/demo/
$ gitbook build

会在/home/gitbook/demo/ 目录下生成 _book 目录,即为完整的HTML静态网站

2.生成其他格式的文件

先切换到项目的目录下:比如本机的/home/gitbook/

PDF:

gitbook pdf ./demo ./demo.pdf

ePub:

gitbook epub ./demo ./demo.epub

MOBI:

gitbook mobi ./demo ./demo.mobi

注:需要提前安装Calibre,Gitbook会使用其中的ebook-convert功能组件来完成书籍格式的转换。

我遇到的Bug

由于我未学习过node.js和Python,在 安装calibre 那一步出错了,导致在GitBook生成其他格式文件的时候出问题,生成pdf 和 mobi 会失败,但是 epub却成功了

安装calibre时的错误信息:

Failed to find directory to install bash completions, using default.
____________________ WARNING ____________________
Setting up completion failed with error:
__________________________________________________
    Traceback (most recent call last):
      File "site-packages/calibre/linux.py", line 748, in setup_completion
      File "site-packages/calibre/linux.py", line 505, in write_completion
      File "site-packages/calibre/gui2/__init__.py", line 8, in <module>
    ImportError: cannot import name QStyle

Setting up desktop integration...
____________________ WARNING ____________________
Setting up desktop integration failed with error:
__________________________________________________
    Traceback (most recent call last):
      File "site-packages/calibre/linux.py", line 781, in setup_desktop_integration
      File "site-packages/calibre/linux.py", line 1097, in render_img
    ImportError: cannot import name QImage

Creating un-installer: /usr/bin/calibre-uninstall

There were 2 warnings

* Setting up completion failed with error:

* Setting up desktop integration failed with error:

Run "calibre" to start calibre 

ImportError: cannot import name QStyleImportError: cannot import name QImage来看,估计是Python少了什么库,希望能解决这个问题的博友指点一下。

参考

http://faq.devwiki.cn/

https://github.com/GitbookIO/gitbook

http://www.calibre-ebook.com/download_linux

https://github.com/GitbookIO/gitbook

http://blog.liyibo.org/books-installation-authoring-tool-gitbook/

时间: 2024-10-12 23:45:33

在自己的服务器上安装GitBook的相关文章

Vmware vSphere 6.0之在一台服务器上安装Platform与vCenter Server

简介: vCenter Server 为数据中心提供单一控制点.它提供基本的数据中心服务,如访问控制.性能监控以及配置.它将各台计算服务器的资源统一在一起,使这些资源在整个数据中心中的虚拟机之间共享.其原理是:根据系统管理员设置的策略,管理虚拟机到计算服务器的分配,以及资源到给定计算服务器内虚拟机的分配. 在 vCenter Server 无法访问(例如,网络断开)的情况下(这种情况极少出现),计算服务器仍能继续工作.服务器可单独管理,并根据上次设置的资源分配继续运行分配给它们的虚拟机.恢复与

在windows服务器上安装subversion

windows安装: 1.下载subversion  各个版本的说明: CollabNet: 功能最强大的,因为svn的创始者就是CollabNet,不过这个版本因为功能最多,所以整个软件包也是最臃肿的,安装包就有100多M,而且因为是运行在java平台上的,要占用很大的内存资源 SlikSVN和Win32Svn: 这两个基本是一样的,都只有svn的内核,没有界面,也就是使用的时候只能用命令行操作.这两者稍微有些区别,比如Win32Svn提供了和apache的库文件,而SlikSVN没有.不存在

我为什么很烦在DB服务器上安装杀毒软件

常见的数据库连接问题无外乎是在数据库服务器本地可以连接SQL Server,但通过其他服务器就不可以连接.但这次我却碰到了相反的情况,在服务器本地无法通过IP/实例名连接,但从其他服务器却可以.而且每次重启后问题短暂消失,不多久后,又重现.我还是第一次碰到这样的问题.通过深究后找到了根本原因:竟然是某杀毒软件惹的祸..... 报错截图 下面分享下我的排错过程: 一.本地使用IP/实例名无法访问服务器,但通过机器名可以: 我们知道,使用IP/实例名访问SQL Server时所采用的协议与使用机器名

阿里云服务器上安装mysql的心路历程(博友们进来看看哦)

在阿里云花了100买了一台云服务器,配置如下: CPU: 1核 内存: 512MB 数据盘: 0G 带宽: 1Mbps 阿里云服务器安装mysql搞得我想吐血,搞了一个多星期,现在才搞好,而且,还有许多问号存在我的脑海里.... 说说我在阿里云服务器上安装mysql的心路历程吧,刚开始安装好java8和tomcat8,安装非常的顺利,但是我接下来要安装mysql了,在网上看到一篇帖子(是rpm包安装的,也在本机上的centos6.5安装过没有问题),所以我就按照这个安装mysql,可是失败了,报

如何在Lunix云服务器上安装Mysql进行远程连接

说说这个服务器上安装mysql真是一个大坑啊 ! 我也不知道自己怎么心血来潮就买一个百度云服务器,然后就想着吧自己做的一些小项目都跑上去.嘿嘿...其实就是想显摆下,写点小应用给不是编程的朋友们使用 ,以满足我自己的小心思,哎呀跑题了,一下没有刹住就给跑偏了,继续说安装的事. 网上百度了许多的教程 ,那叫一个坑啊 !刚开始装JDK 和 Tomcat的时候一切都是顺利.直到开始装Mysql时我不知道是我的服务器不一样还是 我的操作失误!反正就是各种不行 ,那叫一个郁闷.各种方法什么解压tar.gz

在阿里云Linux服务器上安装MySQL

申请阿里云Linux服务器 昨天在阿里云申请了一个免费试用5天的Linux云服务器. 操作系统:Red Hat Enterprise Linux Server 5.4 64位. CPU:1核 内存:512M 硬盘空间:20G 带宽:1Mbps. 今天在这台云服务器上安装了基本环境(JDK.Tomcat和MySQL).本文主要在阿里云Linux云服务器安装MySQL全过程,以及对安装时遇到的问题进行记录. 下载MySQL服务器和客户端 访问MySQL的官网,进入其下载页面(http://dev.m

Dell Omsa在Linux服务器上安装部署

前言 本页详述了在一台Linux(RHEL6.4 x86_64)服务器上部署安装OMSA的通用做法,包括OMSA软件的获取方法和安装步骤. 演示环境: PowerEdge R620, RHEL 6.4 x86_64 OMSA所必须的关联安装包的安装 安装OMSA之前,我们必须确保OMSA安装所需的一些先决安装包已经安装,它们包括: libcmpiCppImpl0libwsman1sblim-sfcbsblim-sfccopenwsman-clientopenwsman-server 其中sbli

如何在一台服务器上安装两个mysql或者更多

如何在一台服务器上安装两个mysql 1       前言 上篇写了在一台机器上源码编译安装一个mysql,那么如何在一台机器上源码编译安装两个mysql或者更多呢? 2       环境 mysql软件包: mysql-5.6.31.tar mysql-5.5.32.tar 操作系统环境: CentOS release 6.8 (Final) 3       系统规模 /mysqlsoft 用来存放mysql的各个程序 /mysqlsoft/mysql1 用来存放mysql-5.5.32.ta

在阿里云服务器上安装redis流程及常见错误

在阿里云服务器上部署redis,首先需要登陆远程登陆自己购买的阿里云服务器,购买及认证的过程就不说了,当时也是一个新手,啥都不懂,也不懂服务器,一步步按照说明才完成的,现在需要在阿里云服务器上安装redis,具体过程如下: 1,找到redis官网https://redis.io/的下载页面 复制链接地址,这里我下载的是最新的稳定版,然后进入服务器,在你想要放文件的目录下,使用wget命令进行下载 wget http://download.redis.io/releases/redis-4.0.9