无须任何git技术也可入门,所以下面的教学都为操作步骤当然如果会git技术就可以更加轻鬆上版先讲为何来说这技术的目的可以增加技术的交流对于任一技术有更佳的结构化认识能更有效的学习更有可能因此可以写书!?
如果没有 github 跟 gitbook帐号可以去申请一下~
github : https://github.com/gitbook : https://www.gitbook.com/join所以我们开始来写书噜 ~
在本机建立一个专案资料夹进入此资料夹并创立 README.md SUMMARY.md.gitbook.yaml 放在你可以抓到的档案位置README.md 为首页SUMMARY.md为目录.gitbook.yaml 为 gitbook设定档README.md 範例 :## 我的首页#### 看起来还不错
SUMMARY.md 範例 :# Summary* [我的首页](README.md) * [我的首页分页](my.md)* [更多内容](content.md)
.gitbook.yaml 範例 :# Root directory to locate the content# Default is the root directory of the repository.root: ./你的专案资料夹名称/# Files to use as SUMMARY/README.# (Relative to <root> directory)structure: readme: README.md summary: SUMMARY.md# Redirect urls to specific files (relative to the <root> directory)#redirects: #previous/page: new-folder/page.md
将所有内容都创建完后(包括 其他 md 档案),就可以做书了!
github 步骤
请先在 github 创立一个专案若不太会git建议起初创立README.md,之后可透过 upload files 直接上传先将 .gitbook.yaml 设定档上传以后,再将专案资料夹上传即可原本github创建的 README.md 可以用来介绍此专案的目的
gitbook 步骤
当创建完帐号,一定会创立一个组织名字都可以随意(因为都可以更改头像与名字)在组织里创建一个 space(电子书)space 的名字也可自取~最重要的是 与 github 连结(方便上版到gitbook)点选左下方的 蓝色方块按钮 找到 integrations 可以看到 github点选以后,与当初在github的专案连结起来即可有没有很简单!一本电子书就此诞生了!?
当然 node 也可製作 gitbook 本机离线版 (在下面留言 介绍使用)
我自己製作的 bootstrap gitbook,小小範例(如果可以随手帮加颗星星~3q)
我的gitbook製作