zoukankan      html  css  js  c++  java
  • 基于centos6构建私有gitbook平台

    前言:

      开源gitbook工具可以让你方便有效的管理自己的文章笔记、发布产品文档等。这里为了学习,基于centos系统构建一个私有的gitbook项目。与公有云gitbook平台相比,这里是简单的展示页面,后面可以进行相关的学习再更新此文章。

    一、基础环境:参考链接:http://www.cnblogs.com/songqingbo/articles/5611532.html 

      nodejs 

      nginx

      python2.7

      npm  参考链接:快速切换npm源的开源工具--nrm

    二、部署GitBook及calibre组件

      1. 安装GitBook

    $ npm install gitbook -g
    $ npm install gitbook-cli -g
    

      2.安装calibre

    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
    '); exec(sys.stdin.read()); main('/usr/local')"
    

      命令的最后 main('/usr/local') 中/usr/local 为Calibre的安装目录,可根据需要修改。该步骤下载时间比较漫长,根据网络环境决定安装速度。

    三、初始化demo

    $ cd /var/www/html
    $ mkdir gitbook
    $ cd gitbook/
    $ mkdir demo
    $ cd demo/
    $ gitbook init
    

      执行最后一个命令之后会在 /var/www/html/gitbook/demo/ 下生成 README.md 和 SUMMARY.md 两个文件,可以将Gitbook-editer客户端编写的文档文件上传到该目录下面。

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

    1.生成完整的静态 HTML

    $ cd /var/www/html/gitbook/demo/
    $ gitbook build
    

      会在/var/www/html/gitbook/demo/ 目录下生成 _book 目录,即为完整的HTML静态网站。使用nginx配置路径到/var/www/html/gitbook/demo/_book,即可通过页面进行访问

    2.生成其他格式的文件 

      安装gitbook-pdf插件

    1.手动安装phantomjs,直接通过npm下载安装会失败
    淘宝镜像源下载地址:https://npm.taobao.org/dist/phantomjs/
    这里以phantomjs-1.9.7-linux-x86_64.tar.bz2为例:
    wget https://npm.taobao.org/mirrors/phantomjs/phantomjs-1.9.7-linux-x86_64.tar.bz2
    tar xf phantomjs-1.9.7-linux-x86_64.tar.bz2 -C /usr/local/
    #vim /etc/profile.d/phantomjs.sh
    export PATH=$PATH:/usr/local/phantomjs-1.9.7-linux-x86_64/bin
    
    source  /etc/profile
    
    2. npm install gitbook-pdf -g


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

    PDF: 在执行这个命令的时候会报错,主要gcc版本比较低造成的,升级gcc参考文档:https://blog.csdn.net/rbpicsdn/article/details/79565383 

    gitbook pdf ./demo ./demo.pdf

    ePub:

    gitbook epub ./demo ./demo.epub

    MOBI:

    gitbook mobi ./demo ./demo.mobi

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

      

  • 相关阅读:
    eclipse快速给表达式生成对应变量的快捷键
    java截取字符串中的最后几个字符
    javascript删除数组元素的7个方法
    java构建树形列表(带children属性)
    elementui树表修改子节点不能实时更新的解决办法
    css3的user-select属性设置文本内容能否被选择
    javascript中for-in和for-of的区别
    计算机等级考试改革
    SQL分组查询
    Windows 8 快捷键
  • 原文地址:https://www.cnblogs.com/songqingbo/p/5611653.html
Copyright © 2011-2022 走看看