Linux下Gitbook生成pdf及中文问题的解决

Linux下Gitbook生成pdf

• 安装 Calibre

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"

• 配置book.json

{
    "title": "Cloudroom SDK Refference",
    "description": "云屋视频SDK参考文档",
    "author": "HeDonghai",
    "language": "zh-hans",
    "styles": {
        "website": "style.css"
    },
    "plugins": [
        "-lunr",
        "-search",
        "-livereload",
        "-sharing",
        "book-summary-scroll-position-saver",
        "expandable-chapters",
        "search-plus",
        "splitter",
        "tbfed-pagefooter",
        "back-to-top-button",
        "yahei",
        "katex",
        "theme-api",
        "theme-comscore"
    ],
    "pluginsConfig": {
        "expandable-chapters": {},
        "theme-api": { "theme": "light" },
        "tbfed-pagefooter": {
            "copyright": "© HeDonghai",
            "modify_label": "文件修订时间：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        },
        "fontSettings": {
            "theme": "white",
            "family": "msyh",
            "size": 2
          }
    },
    "pdf": {
        "toc": true,
        "pageNumbers": true,
        "fontSize": 18,
        "paperSize": "a3",
        "margin": {
          "right": 30,
          "left": 30,
          "top": 30,
          "bottom": 50
        }
      }
}
//pdf 配置下的toc貌似没有生效

• 安装Gitbook插件

cd 进入存放book.json的Linux目录下，然后执行命令

gitbook install

• 生成pdf
  在markdown文件目录下执行下面的命令会自动book.pdf文件

gitbook pdf

• pdf文档内中文不显示或中文乱码

原因是中文字体未支持，可手动配置支持，操作如下：
1. 在插件配置中使用”yahei”(雅黑字体)并配置fontSettings
2. 手动从windows系统的Fonts目录下复制msyh.ttc文件或msyh.ttf文件上传到Linux的/usr/share/fonts/truetype目录下
3. 重新生成pdf即可