显示目录

GitBook 使用 Coding.net 的 Pages 访问

GitBook 生成的静态网页文件在 _book 目录中,下面介绍怎么把它发布到 coding.net 的 Pages 服务中,这样就能够通过网络访问了。

  1. https://coding.net 创建一个账号 xtuer(下面请换为自己的账号)
  2. 创建仓库 2 个仓库 fox 和 fox-doc (仓库名字随意取):
    • fox-doc: GitBook 源文件
    • fox: GitBook 生成的静态文件
  3. 克隆这 2 个仓库到本地的同一个文件夹下
    • git clone git@git.coding.net:xtuer/fox.git
    • git clone git@git.coding.net:xtuer/fox-doc.git
  4. 命令行进入 fox-doc 目录: cd ${fox-doc-path}

    1. 增加 .gitignore 文件:

      1
      2
      3
      4
      _book/
      node_modules/
      Thumbs.db
      .DS_Store
    2. 在 fox-doc 中增加 GitBook 的文件 (可参考 http://qtdebug.com/gitbook),主要是:

      • book.json
      • README.md
      • SUMMARY.md
    3. gitbook install
    4. gitbook build 生成静态网页到目录 _book
  5. 命令行进入 fox 目录: cd ../fox

    1. 复制 fox-doc/_book 中的文件到 fox 目录下: cp -r ../fox-doc/_book/* .
    2. git add -A
    3. git commit -m "O_O"
    4. git push
    5. 访问 https://coding.net 中的仓库 fox,点击 Pages 服务部署来源 选择 master 分支
    6. 访问 http://xtuer.coding.me/fox 就可以看到我们使用 GitBook 写的内容了

      格式为: {user_name}.coding.me/{project_name},具体请参考 https://coding.net/help/doc/pages/creating-pages.html

脚本自动化

每次编辑和发布都要机械的重复上面的步骤,枯燥无味还容易出错,可以借助脚本自动化执行:

  • 类 Unix 可以使用 shell 脚本 fox-doc/deploy.sh 进行自动化处理:

    1
    2
    3
    4
    5
    6
    7
    gitbook build
    cd ../fox
    rm -rf *
    cp -r ../fox-doc/_book/* .
    git add -A
    git commit -m "O_O"
    git push

    在 fox-doc 目录中执行 sh deploy.sh 就可以把 GitBook 生成的网页发布到网上了

  • Windows 可以使用 Bat 脚本 fox-doc/deploy.bat 进行自动化处理:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    call gitbook build
    cd ..\fox
    del /Q *
    rd /S /Q gitbook
    xcopy /E ..\fox-doc\_book\* .
    git add -A
    git commit -m "O_O"
    git push
    cd ..\fox-doc

    在 fox-doc 目录中执行 deploy.bat 就可以把 GitBook 生成的网页发布到网上了

    del /Q * 删除 目录下的所有文件

    rd /S /Q gitbook 删除 gitbook 目录及其所有子目录和文件

    call cmd 在当前窗口运行第三方程序,运行完后继续往下执行

    start cmd 会打开新窗口运行第三方程序


提示:为了方便管理,可以把 fox 目录放到 fox-doc 下面,不过需要在 fox-doc 的 .gitignore 中加上规则 fox/,deploy.sh 对应的修改为

1
2
3
4
5
6
7
gitbook build
cd fox
rm -rf *
cp -r ../_book/* .
git add -A
git commit -m "O_O"
git push

还有一种办法是只使用一个仓库,master 分支管理 GitBook 的源文件,coding-pages 分支管理 GitBook 生成的网站文件并提供 Pages 服务,不过文件看上去比较乱,不如 2 个仓库的清晰。