GitBook + github高效写书

作者: 三也视界 | 来源:发表于2019-08-21 02:27 被阅读31次

    比较建议直接在github上部署你的框架,然后再导入gitbook。

    创建一个新的仓库

    image.png

    勾选创建一个readme文件,再点击红色框 create new file

    image.png

    创建一个新文件,名为SUMMARY.md,里面填入:

    # Summary
    * [前言](README.md)
    
    image.png

    提交更改


    image.png

    创建一本书

    首先进入gitbook的官网:https://www.gitbook.com/

    image.png

    点github登录

    登录之后,点左下角


    image.png

    进入下面的界面,可以创建和管理项目(书本)


    image.png

    点击左侧红框中的按钮,选择你需要导入的仓库,我们用刚才创建的# python3Scrapy
    ,耐心等待。

    image.png

    拉取列表,选择全部即可,进入线面页面,选择需要关联的项目。

    image.png image.png

    由于我们是在GitHub提交的文件,第一次应该是GitHub同步过来,于是选择第一个


    image.png image.png

    这个页面目前是在同步,等同步完毕后,就可以看到自己的书了。

    image.png

    可以发现里面就1页,就是我们刚才SUMMARY.md写的内容.

    接下来可以更改书本标题。

    image.png

    增加内容

    点击右下角红框进入编辑状态。


    image.png

    可以增加页面


    image.png

    也可以直接导入wiki等页面


    image.png

    这里需要特别注意的是,每次编写文字之后,需要手动你那个点击右下角的绿色勾,才会保存到gitbook


    image.png

    但是不会自动push到GitHub,需要手动点击一下merge


    image.png

    然后你会发现在github上也多了一个文件,这就关联起来了。


    image.png

    我们再看SUMMARY里面多了一个“第一章”的目录结构

    image.png

    我们双击一下,发现就是markdown的超链接,原来这就是gitbook的内容组织方式,通过超连接把内容和github上文件关联起来。

    我们修改一下名字,然后把他缩进一个tab,可以发现目录结构变了,然后名字也变了

    通过修改SUMMARY.md你可以轻松的组织你的书

    书的框架

    一般来说,你的书得有一个README.md和一个SUMMARY.md。
    其中SUMMARY.md是最重要的,它代表了整个书的框架,也是我们主要需要修改的地方。

    当你考虑好要写一本书,你可以先粗略的想好大概要分几部分,对这几部分弄一个文件夹。然后把对应的markdown文件放进去。

    然后push到github上,然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook关联

    关于地址的获取有个小诀窍,就是点击文件,邮件,有个重命名,这里可以看到文件的完整地址,复制就好。

    相关文章

      网友评论

        本文标题:GitBook + github高效写书

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