美文网首页文章笔记程序员blog
用 GitHub + GitBook 发布一本新书

用 GitHub + GitBook 发布一本新书

作者: ixiaoyi | 来源:发表于2018-08-14 13:34 被阅读176次

    如果你熟用 Markdown 和 GitHub ,那么利用 GitBook 搭建一本属于自己的在线书籍对于你来说就易如反掌。完成后的效果是这个样子的。

    image

    本教程里面暂不涉及本地文件与github连接的问题,有兴趣的可以自行搜索。本篇文章需要具备的基础:

    1. markdown语法。一点基础都没有,只要你搜到教程,边看边实践,你也可以在30分钟内快速上手
    2. github 账号。如果没有请提前注册,网址:https://github.com/
    3. 多点耐心。

    第一步:在github上创建一个新的仓库(repository)

    image image

    第二步:创建 summary.md 文档

    image

    SUMMARY.md的重要性体现在gitbook通过这个文件来生成整本书的目录。大家可以借鉴下图的代码生成自己的目录。直接全部复制到 SUMMARY.md 里面即可。

      # Summary
    
      * [Introduction](README.md)
      * [预备周:基于认知科学的信息训练法](ch0/preface.md)
          * [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch0/RepTaskBasic.md)_
          * [进阶任务](ch0/RepTaskAdvanced.md)
          * [个人教程](ch0/handbook.md)
      * [第一讲:从现实问题到学科信息](ch1/README.md)
          * [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch1/RepTaskBasic.md)
          * [进阶任务](ch1/RepTaskAdvanced.md)
          * [个人教程](ch1/handbook.md)
      * [第二讲:快速获取专业领域关键信息](ch2/README.md)
          * [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch2/RepTaskBasic.md)
          * [进阶任务](ch2/RepTaskAdvanced.md)
          * [个人教程](ch2/handbook.md)
      * [第三讲:改变世界经济格局的财团](ch3/README.md)
          * [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch3/RepTaskBasic.md)
          * [进阶任务](ch3/RepTaskAdvanced.md)
          * [个人教程](ch3/handbook.md)
      * [第四讲:获取公司信息、预测前景](ch4/README.md)
          *  [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch4/RepTaskBasic.md)
          * [进阶任务](ch4/RepTaskAdvanced.md)
          * [个人教程](ch4/handbook.md)
      * [第五讲:获取职业信息、预测前景](ch5/README.md)
          * [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch5/RepTaskBasic.md)
          * [进阶任务](ch5/RepTaskAdvanced.md)
          * [个人教程](ch5/handbook.md)
      * [第六讲:人际关系与反信息分析](ch6/README.md)
          *  [检索实操](ch0/RepSearchPractice.md)
          * [基础任务](ch6/RepTaskBasic.md)
          * [进阶任务](ch6/RepTaskAdvanced.md)
          * [个人教程](ch6/handbook.md)
      * [结业大作业](ch8/README.md)
          * [个人教程](ch8/handbook.md)
      * [备注](ps/handbooks.md)
      * [参考文献](ps/ref.md)
      * [致谢](ps/thanks.md)
      * [后记](no_end/postscript.md)  
    
    image

    第三步:登录gitbook,选择用 github账号登录

    网址:www.gitbook.com

    image

    授权登录后是这个鬼样子:

    image

    先说明一下:第一步是建立 organization,然后在 organization 之下再建立 space 。

    我的理解是:整个 gitbook 就好像是一个大书库,一个 organization 就是一个主题,而space 就是某一列别里面的单本书。 当然你只要知道 gitbook 可以包含多个 organization ,一个organization 又可以包含多个 space就可以了。

    image

    一直点击 “Next”,到达下面的页面

    image image image

    第四步: 连接github和 gitbook

    image image image image image image image image

    第五步:大功告成

    image image

    这是网址: https://ixiaoyi.gitbook.io/gitbook-tutorial/

    当然现在还没有内容在里面,需要你自己在github里面进行添加。如果你对github稍加研究就知道怎么做了。如果不知道欢迎Google后提问!

    接下来要正常发文章的话,你需要知道如何在github网站建立文件夹,并指导如何建立 markdown文档。

    相关文章

      网友评论

      本文标题:用 GitHub + GitBook 发布一本新书

      本文链接:https://www.haomeiwen.com/subject/vetvbftx.html