gitbook经验总结

作者: NicholasNC | 来源:发表于2016-09-30 21:00 被阅读4481次

    程序员走起

    ----官网----

    gitbook

    ----官网插件地址----

    gitbook-plugins

    ----参考资料----

    GitBook 简明教程
    Gitbook 入门教程
    GitBook的安装配置
    【Gitbook】实用配置及插件介绍

    ----对于gitbook项目大概的目录/文件说明----

    ├── _book                     // gitbook serve自动生成的文件夹,不用理
    ├── designer                  // 各章节目录
    │   ├── README.md             // 各章节的简介
    │   ├── images                // 存放各章节的图片
    │   └── designer_standard.md  // 各章节内容的具体展开
    ├── node_modules              // npm包的安装目录
    ├── product                   // 各章节目录
    │   ├── README.md             // 各章节的简介
    │   ├── images                // 存放各章节的图片
    │   └── product_standard.md   // 各章节内容的具体展开
    ├── web                       // 各章节目录
    │   ├── README.md             // 各章节的简介
    │   ├── images                // 存放各章节的图片
    │   └── web_standard.md       // 各章节内容的具体展开
    ├── .gitignore                // git 的忽略文件
    ├── book.json                 // 整个gitbook的配置文件
    ├── README.md                 // 整本书的简介
    └── SUMMARY.md                // 整本书的目录索引
    

    ----SUMMARY.md----



    从上述两张图可以看出,SUMMARY.md文件是整本书的目录索引,与服务器上的左侧导航栏相对应。

    程序小白也能玩

    ----小白工具----

    gitbook-editor

    ----gitbook-editor小说明----

    1. 下载、安装好之后,登录你的gitbook账号
    • 怎样安装、下载、注册gitbook账号就不多说了
    1. 打开之后选择右上角Gitbook.com可以看到服务器上面的书籍(当然提前创建好,另外这里我绑定了github所以有起icon,如果没有绑定github可能不会出现其icon)


    2. 点击其中一本书籍,就会出现下图,点击Clone按钮即可

    3. 然后就可以在本地看到书籍了


    4. 打开本地书籍,界面上有很多功能按钮,可以自己玩,如果想切换预览、书写模式,可以点击下图红框


    5. 编辑完,点击SAVE按钮

    6. 保存完点击下图红框中的按钮,就可以上次到服务器了


    7. 因为绑定了github账号,所以需要输入github的账号

    ----目录结构说明----


    如上图所示,现在暂时分了三个部分,产品、设计、前端各自有一个文件夹,其中README.md文件是对整个章节(即整个文件夹的一个简介,介绍这个章节有哪些内容),另外的product_standard.md是对本章节的展开,也可以自己新建一个XXXXXX.md文件

    相关文章

      网友评论

      • a5be7c4950b1:为什么我的gitbook editor界面跟你的不一样。
        NicholasNC:是否跟版本有关?

        版本号,Mac/Win 等也会有区别吧

      本文标题:gitbook经验总结

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