软文来源

学习来源

常规步骤

  1. 生成目录、简介文档（初始化一本书），在cmd命令行中执行

    1
    2
    mkdir mybook
    gitbook init

  2. 编辑目录(SUMMARY.md), 简介(README.md)

    SUMMARY.md是书的目录结构，后续生成指定的文件需要通过它，编辑如下图：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    * [介绍](README.md)
    * [基本安装](installation/README.md)
       * [Node.js安装](installation/nodejs-install.md)
       * [Gitbook安装](installation/gitbook-install.md)
       * [Gitbook命令行速览](installation/gitbook-cli.md)
    * [图书项目结构](book/README.md)
       * [README.md 与 SUMMARY编写](book/file.md)
       * [目录初始化](book/prjinit.md)
    * [图书输出](output/README.md)
       * [输出为静态网站](output/static.md)
       * [输出PDF](output/pdfandebook.md)
    * [发布](publish/README.md)
       * [发布到Github Pages](publish/gitpages.md)
       * [发布到公司文档服务器](publish/companyserver.md)
    * [结束](end/README.md)

    README.md是书的简介

  3. 生成书的框架

    1
    gitbook init

    windows下会报错

    1
    Error: ENOENT: no such file or directory, stat 'H:\MyBook\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'

    需修改gitbook的文件（路径：C:\Users\一夜万次郎.gitbook\versions\3.2.3\lib\output\website）,将copyPluginAssets.js的112行和67行注释掉（或者改为False）

  4. 编辑完毕后，执行以下命令进行预览，而后访问：http://localhost:4000

    1
    gitbook serve

    偶有报错发生，则需通过修改生成文本书中的theme.js, 其中 if(m)for(n.handler 替换成 if(false)for(n.handler

  5. 查看无误后，生成html文件，执行以下命令

    1
    gitbook build

电子书导出

  1. 安装环境(calibre)，需要将安装路径配置到环境变量中

    • windows安装：https://calibre-ebook.com/download_windows64

    • Linux安装，依次执行如下命令

      1
      2
      sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
      sudo ln -s /usr/bin/nodejs /usr/bin/node

  2. 生成对应格式的文件命令，需先进入对应的目录下

    1
    2
    3
    gitbook pdf
    gitbook mobi
    gitbook epub

IIS环境配置

  1. 添加IIS配置json格式

    • 打开IIS添加Mime项，关联拓展名：**.json**
    • 内容类型(MIME)：text/json

  2. IIS配置Video格式

    • 打开IIS添加Mime项，关联拓展名：**.MP4**

    • 内容类型(MIME)：video/mp4