发布

以上所说的都是在本地的操作，如何让别人也可以访问自己的书籍，除了自己买域名，还可以利用现有的互联网平台：gitbook.com、 github.com等

1. 在 gitbook.com 上发布和管理书籍

  • 需要先注册 gitbook 账号。可以单独注册，也可以使用 github 账号关联登录。

  • 然后就可以在线写书了～书籍的在线浏览地址为：https://yourorgnizationname.gitbook.io/yourspacename

2. 在 gitbhub上发布书籍源码

    1. 在GitBook项目目录，如gitbook中，执行如下命令，创建本地git仓库：

      git init

    1. 使用文本编辑器，创建名为.gitignore的文件，内容如下：

      *~
_book
.DS_Store

      通过.gitignore文件，本地仓库将忽略临时文件和_book文件夹，达到只保存书籍源码的目的。

    1. 现在可以将本地书籍源码添加到本地git仓库中了：

      git add .

    1. 添加更新说明

      git commit -m '更新说明文字'

    1. 建立本地仓库与远端仓库的对应关系

      git remote add origin https://远程仓库地址.git

    1. 将本地仓库内容同步到远端仓库：

      git push -u origin master

至此，就完成了将gitbook源码推送到远程仓库的任务，之后书籍内容修改后，执行如下操作即可：

git add .
git commit -m '更新说明文字'
git push -u origin master

3. 在 github上发布和管理书籍

需要在原有本地仓库新建一个分支，在这个分支中，只保留_book文件夹中的内容，然后将这些内容推送到远程仓库的pages分支，启用pages服务，最终达到免费发布电子书的目的。

    1. 新建分支

      git checkout -b gh-pages

      新建名为pages的分支，分支名称随意，但最好能反映出分支的用途。

    1. 删除不需要的文件

      切换到pages分支后，我们需要将_books目录之外的文件都清理掉：

      git rm --cached -r .
git clean -df
rm -rf *~

    1. 添加忽略文件

      使用文本编辑器，创建名为.gitignore的文件，内容如下：

      *~
_book
.DS_Store

      通过.gitignore文件，本地仓库将忽略临时文件和_book文件夹。

    1. 复制_book文件夹到分支根目录

      cp -r _book/* .

    1. 添加文件

      git add .

      添加更新说明

      git commit -m '更新说明'

      推送

      git push -u origin gh-pages

      现在开启git托管网站的pages服务即可。

      4. gitbook 与 github 关联同步

新版 gitbook.com 不支持本地版本管理了，但是对 github 的集成支持的不错。可以通过配置，实现在 github 项目里面提交内容，gitbook 平台会自动同步过去。

  • 在 gitbook 平台里，进入要设置的 space，也就是你的书。

  • 点左下角的配置按钮，进入配置，点击 Intergrations ，找到 github。

  • 点击 link you github repository 按钮，根据向导，登录 github ，选择 reposirory，选择分支，完成绑定和同步。(你还可以选择是 gitbook 同步 github ，还是 github 同步 gitbook)

    需要注意的是：绑定的 github 仓库分支里面要是 gitbook 的源码，也就是那些 md 文件。而不是 build 之后生成的 html 文件。

Previous插件安装

Last updated