记将github中Asciidoc文档格式项目导出pdf的一次实践

首先将github中的Asciidoc项目下载到电脑， 为保留博主操作时的项目源码，这里不要脸的拿出自己fork的一份git官方文档项目： https://github.com/yeqizhang/progit2-zh

下载好后解压，根路径下有个Gemfile的文件，这里需要使用ruby语言来进行操作。

github项目，必须要看的文件 README ,里边写道：

$ bundle install
$ asciidoctor-pdf-cjk-kai_gen_gothic-install
$ bundle exec rake book:build

只要使用这个三个命令，就可以将   HTML、Epub、Mobi、PDF 四种格式的文件导出来。

不过，过程却没这么简单顺畅。。。这也和博主第一次接触到ruby这语言有关系吧。

一、安装 ruby ，以及执行 bundle install 

首先博主考虑的是在window系统上操作，然后下载了Jruby，不过耗费了几个小时，中间gem插件包时各种错误，解决不了。罢了还是用linux吧，博主有个树莓派，就远程在里边弄，首先楼主傻傻地又装了Jruby，然后想起之前有用ruby脚本时安装过ruby的。于是切换到progit2-zh路径下，执行bundle install(没有bundle就 gem install bundle) ,中间似乎很顺利，到gem某个包时提示我的ruby版本太低了需要2.0后的版本，于是又安装rvm来管理ruby，  下载好高版本ruby后，由于我的树莓派cpu不行，中间编译了大半个小时吧。

接着继续bundle install （遇见错误，尝试处理后，继续执行这条命令），中间还是会有gem安装失败的情况，注意：

bundle是从Gemfile和Gemfile.lock找要gem的包自动去下载的，Gemfile.lock设置了要安装的插件以及版本， 如果安装失败 ，

可以先去https://rubygems.org/gems 搜这个插件，把Gemfile.lock中这个插件的版本设置的高一点，这里贴一份博主修改后的Gemfile.lock的内容：

GEM
  remote: https://rubygems.org/
  specs:
    Ascii85 (1.0.2)
    addressable (2.3.8)
    afm (0.2.2)
    asciidoctor (1.5.0)
    asciidoctor-epub3 (1.0.0.alpha.2)
      asciidoctor (>= 1.5.0, < 1.6.0)
      gepub (~> 0.6.9.2)
      thread_safe (~> 0.3.4)
    asciidoctor-pdf (1.5.0.alpha.8)
      asciidoctor (~> 1.5.0)
      prawn (>= 1.3.0, < 3.0.0)
      prawn-icon (= 0.6.4)
      prawn-svg (= 0.20.0)
      prawn-table (= 0.2.1)
      prawn-templates (= 0.0.3)
      safe_yaml (= 1.0.4)
      thread_safe (= 0.3.4)
      treetop (= 1.5.3)
    asciidoctor-pdf-cjk (0.1.2)
      asciidoctor-pdf (~> 1.5.0.alpha.8)
    asciidoctor-pdf-cjk-kai_gen_gothic (0.1.1)
      asciidoctor-pdf-cjk (~> 0.1.2)
    awesome_print (1.2.0)
    coderay (1.1.0)
    css_parser (1.3.7)
      addressable
    epubcheck (3.0.1)
    gepub (0.6.9.2)
      nokogiri (~> 1.6.1)
      rubyzip (>= 1.1.1)
    hashery (2.1.1)
    json (2.0.4)
    kindlegen (2.9.4)
    mini_portile (0.6.0)
    multi_json (1.12.1)
    nokogiri (1.6.3.1)
      mini_portile (= 0.6.0)
    pdf-core (0.6.0)
    pdf-reader (1.3.3)
      Ascii85 (~> 1.0.0)
      afm (~> 0.2.0)
      hashery (~> 2.0)
      ruby-rc4
      ttfunk
    polyglot (0.3.5)
    prawn (2.0.2)
      pdf-core (~> 0.6.0)
      ttfunk (~> 1.4.0)
    prawn-icon (0.6.4)
      prawn (>= 1.1.0, < 3.0.0)
    prawn-svg (0.20.0)
      css_parser (~> 1.3)
      prawn (>= 0.8.4, < 3)
    prawn-table (0.2.1)
    prawn-templates (0.0.3)
      pdf-reader (~> 1.3)
      prawn (>= 0.15.0)
    pygments.rb (1.1.2)
      multi_json (>= 1.0.0)
    rake (10.3.2)
    ruby-rc4 (0.1.5)
    rubyzip (1.1.6)
    safe_yaml (1.0.4)
    thread_safe (0.3.4)
    treetop (1.5.3)
      polyglot (~> 0.3)
    ttfunk (1.4.0)

PLATFORMS
  ruby

DEPENDENCIES
  asciidoctor (= 1.5.0)
  asciidoctor-epub3 (= 1.0.0.alpha.2)
  asciidoctor-pdf (= 1.5.0.alpha.8)
  asciidoctor-pdf-cjk-kai_gen_gothic (~> 0.1.1)
  awesome_print
  coderay
  epubcheck
  json
  kindlegen
  pygments.rb
  rake
  thread_safe

BUNDLED WITH
   1.15.3

下面是博主所有插件装好后再次执行 bundle install 的截图：

二、执行asciidoctor-pdf-cjk-kai_gen_gothic-install 下载语言字体包

这一步因为国内网络环境的问题尝试很多次都没有下载下来，后来找到这个插件的github项目，直接在发行版里找到了下载，地址为https://github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic/releases ，下载好以后放入 asciidoctor-pdf-cjk-kai_gen_gothic插件的子文件夹data/fonts文件夹里。

三、执行bundle exec rake book:build  ，大功告成。

附中英文下载链接：

英文： 我上传失败了。。网上很多的。

中文（需要积分，也可以私信我邮箱发给你）：http://download.csdn.net/download/yqztgc123/9937376