gitbook经验总结
2016-09-30 本文已影响4481人
NicholasNC
程序员走起
----官网----
----官网插件地址----
----参考资料----
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账号
- 怎样安装、下载、注册gitbook账号就不多说了
-
打开之后选择右上角Gitbook.com可以看到服务器上面的书籍(当然提前创建好,另外这里我绑定了github所以有起icon,如果没有绑定github可能不会出现其icon)
-
点击其中一本书籍,就会出现下图,点击
Clone
按钮即可
-
然后就可以在本地看到书籍了
-
打开本地书籍,界面上有很多功能按钮,可以自己玩,如果想切换预览、书写模式,可以点击下图红框
-
编辑完,点击
SAVE
按钮
-
保存完点击下图红框中的按钮,就可以上次到服务器了
-
因为绑定了github账号,所以需要输入github的账号
----目录结构说明----
如上图所示,现在暂时分了三个部分,产品、设计、前端各自有一个文件夹,其中README.md
文件是对整个章节(即整个文件夹的一个简介,介绍这个章节有哪些内容),另外的product_standard.md
是对本章节的展开,也可以自己新建一个XXXXXX.md
文件