gitbook是一个好用的发布电子书的项目;使用gitbook 可以在本地写好文档再远程推送到库;也可以在gitbook提供的在线平台上制作电子书;要想在自己的服务器上使用gitbook 发布一个网站;则需要相应的运行环境。本文是通过gitbook editor 软件写好电子书的项目;然后通过WinSCP上传到服务器;再通过gitbook serve 解析MarkDown文档,监听本地4000端口实现的。
1、运行环境:
LINUX; CentOS平台 ; nodejs;npm;
2、安装配置:
配置很简单;安装nodejs:
yum install nodejs
npm 是nodejs自带的包管理工具;使用yum安装 nodejs 默认安装npm;
3、安装gitbook:
使用命令 (全局安装)
npm install -g gitbook-cli
4、初始化:
gitbook init
会在默认安装gitbook的文件夹初始化一个项目;包含一个README.md 和 SUMMARY.md 两个文件。 默认情况下在这个目录新建文档即可;也可以将写好的整个项目上传到服务器;最后使用gitbok解析即可;我们选择后者;
5、解析新项目:
新项目上传到服务器后;找到项目路径:
cd /usr/share/nginx/gitbook
新项目的名称位于gitbook文件夹下;名称为javascript;
gitbook serve javascript
运行结果:
默认 监听本地的4000端口;可以使用服务器的ip(公网ip)访问这个项目;gitboo会解析Markdown文档;并返回html页面。
因为http默认协议使用的是80端口;使用默认的url链接是无法访问的;必须要在后面加上端口号;类似于 http://localhost:4000/; 非常不好看; 但是我们可以通过web服务器Nginx、 Apache;开启端口转发。将80端口的请求转发到4000端口。