gitbook windows下配置

Node.js安装

安装完成这后，你可以在终端模式(win下打开cmd即可)下检验一下：

C:\Users\lenovo> node -v

gitbook的安装

Gitbook是从NMP安装的，命令行(打开cmd，路径每个电脑不一)：

C:\Users\lenovo> npm install gitbook-cli -g

安装完之后，你可以检验下是否安装成功：

C:\Users\lenovo> gitbook -V
0.3.3

gitbook的使用

  • 本地书籍文件夹

    C:\Users\lenovo>mkdir 文件夹名称

  • 初始化目录（建立对应的目录和文件 README.md和 SUMMARY.md就是这么来的），切换到文件夹下初始化：

    C:\Users\lenovo>cd 文件夹名称 C:\Users\lenovo>文件夹名称>gitbook init

  • 给文件夹配置README.md和SUMMARY.md两个文件。

SUMMARY.md目录格式如下：

    # Summary

    * [Introduction](README.md)

    # Chapter1

    * [20170323+ASP.NET之webForms基本概念.md](/20170323+ASP.NET之webForms基本概念.md)
    * [20170402+sublime3之javascript运行配置.md](/20170402+sublime3之javascript运行配置.md)
    * [20170402+sublime3之openbrowser的配置.md](/20170402+sublime3之openbrowser的配置.md)

README.md文件可为空。

  • 本地预览

    C:\Users\lenovo> gitbook serve ./图书(文件夹)名称 或直接在图书目录下输入gitbook serve

会自动html文件，及输入localhost:4000在浏览器打开。

  • 输出一个静态网站

    C:\Users\lenovo> gitbook build 图书目录 输出目录

  • 查询：gitbook help

关联远程github

  • 配置.gitignore文件：

    • 在项目根目录下面创建gitignore.txt文件
    • 把你需要排除的文件名保存到gitignore.txt文件
    • 在项目根目录下面按住Shift键并右键然后选择“在此处打开命令窗口”
    • 执行命令 ren gitignore.txt .gitignore

文件内容如下：

# Node rules:
## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
.grunt

## Dependency directory
## Commenting this out is preferred by some people, see
## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git
node_modules/

# Book build output
_book/

# eBook build output
*.epub
*.mobi
*.pdf

  • 关联github

    git remote add origin Git_Repository_URL

  • Verify your URL

    git remote -v

  • git push origin master

gitbook本地转为pdf文件

由于直接在gitbook网页版中下载的个pdf格式文件格式太乱，于是该由本地生成。

  • Generating eBooks and PDFs

尝试以下方法不成功：

How to use it:

GitBook PDF can be installed from NPM using:

$ npm install gitbook-pdf -g

You can use it with the normal gitbook command:

$ gitbook pdf ./my_repository

  • 提示需要export-convert，查阅相关资料，提示需要安装Calibre，但没找到windows下的指令，只能下载.msi文件安装了。

  • 下载安装成功后，再使用上述方法，则可以生成格式更漂亮的pdf格式文件。

参考