0.3.本地化

    《逐陆记》最开始使用Gitbook Editor书写,所以可以按照在电脑上形成电子版,并且是Gitbook的格式,下边是本地化流程:

1. 下载代码

git clone https://github.com/silentbalanceyh/vertx-chaser.git

2. 编译成书

确保您的环境中已经安装了docker工具,生成过程使用了docker容器化的gitbook。

~ >> cd vertx-chaser
~/vertx-chaser >> ./book-build.sh

3. 启动

确保您的电脑中安装了node, serve,则可直接运行根目录中命令启动。

~/vertx-chaser >> ./book-server.sh

   ┌───────────────────────────────────────────────┐
                                                  
      Serving!                                    
                                                  
      - Local:            http://localhost:1231   
      - On Your Network:  http://10.0.0.6:1231    
                                                  
      Copied local address to clipboard!          
                                                  
   └───────────────────────────────────────────────┘

启动过后,就可以在浏览器中打开查看了,之所以用1231做端口号,是因为12月31日是老婆的生日。

4. 问题

在使用gitbook工具的过程中,也许您会随机遇到下边问题:

Error: ENOENT: no such file or directory, stat ‘/nfs/home/alf/gitbook/foobar/_book/gitbook/gitbook-plugin-lunr/lunr.min.js’
Error: ENOENT: no such file or directory, stat ‘/home/aparra/Documentos/zoi-api/book/_book/gitbook/gitbook-plugin-livereload/plugin.js’
Error: ENOENT: no such file or directory, stat ‘…_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js’

解决办法:确认您的目录中包含了gitbook, gitbook-cli,然后按照下边教程处理:

~ >> cd ~/.gitbook/versions/3.2.3/lib/output/website
~/.gitbook/versions/3.2.3/lib/output/website » vim copyPluginAssets.js

修改copyPluginAssets.js文件中的片段(修改112行),将confirm的值修改成false

    return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            confirm: false // Fix Random Issue
        }
    );

附加:如果您在gitbook安装目录中执行下边命令:

~/.gitbook/versions » ll                                      
total 0
drwxr-xr-x 22 lang staff 704 Jun 22 14:51 2.6.9
drwxr-xr-x 22 lang staff 704 Jun 22 14:54 3.2.3

上述工具中,2.6.9gitbook-cli的版本,3.2.3则是gitbook的版本。

最后更新于