Gitbook 编写出白皮书关于gitbook使用 1.搜索了网上很多使用方法,很多都是需要在本地安装gitbook环
关于gitbook使用
1.搜索了网上很多使用方法,很多都是需要在本地安装gitbook环境,然后安装gitbook又需要安装node和npm,然后为了方便版本管理又需要去下载一个nvm管理node版本
2.在下载gitbook过程中总会遇到node版本过高过低导致bitbook下载失败 ,或者是gitbook init报错 ,init成功又需要下载一个Markdown工具去编辑,在gitbook serve过程中又会报错
3.一个node版本无法通关,总会报错然后去切换版本,你也不知道哪个版本在哪个步骤使用,就很烦
后来发现官网之后可以直接在官网里面编辑gitbook的内容,可以直接生成模板去写,可以说白走了两天弯路,下面是直接官网使用教程,无需以上1和2的操作,无需安装任何东西!,包括生成,编写,发布上线到工作所需的网址,或者官方会生成自己的一个网址供你上线
1.官网登录 www.gitbook.com/
用GitHub 登录gitbook 官网,选择使用Google账号或者Github账号去登录
2.创建新的一个空的模板
鼠标放在加号上,点击 New space 会生成一个叫 Untitled 的文件,点击它右边是展示它的内容,现在我们就已经创建了一个新的模板,让我们看看如何快速入手
3. 模板的使用,加页面以及加子页面 ,页面名字的编辑
可以看到系统已经给我们生成了一个默认的叫Page的章节,我们想要加更多的章节的话,把鼠标放在那个Page上面,会浮现出一个加号在上面(鼠标放在上半部分,加号出现在上面,放在下半部分出现在下面),点击下面的加号,会在Page页面下面生成一个叫Page1的章节
然后我们把鼠标放在Page上半部分,点击上面的的加号,又生成一个叫Page2的页面,如下图所示
Page2在上面,是不是看起来非常违和,所以接下来给他们改个名字
4, 修改模板名字,章节名字,加子页面以及修改子页面的名字
1.修改模板名字
也就是你这本书或者是什么的名字 ,再最上面那个叫Untitled的,直接鼠标点击就可以修改,修改完点击空白处可以看到右边的名字也跟着变了(奥利奥打钱!)
2.修改章节名字
鼠标放在Page在上面,右边出现的竖直的省略号,点击,再点击Rename
点击进去就是以下页面,红色框框(我自己框的,现实没有)里面的输入框就可以修改,修改完点击下方save按钮就可以修改成功
比如我修改成下图样子,直接用中文也行,
3.新建子页面,子页面修改名字和这个章节修改步骤一样,就不多赘述
子页面新建需要点击你选中的想要新建子页面的章节的竖直省略号,鼠标放在第一个选择insert subpage上,点击右边出现的page,就会新建一个子页面了,一般给你生成的都是叫page几的,生成玩可以像修改章节的名字一样修改成自己想要的名字
一下是生成的图片,可以多生成几个
5.编辑子页面,内容一般都是写在子页面里面的
点击想要编辑的子页面,在子页面空白处输入自己想要输入的内容即可,内容样式是按照markdown写法来的,可以试试了解一下,这边不多说
6.发布成在线地址浏览
点击右上角share按钮
点开之后显示为下图,再按照图中标记,也就是第二个选择点击后,右边有个开关,点击可以开启
点击开启之后,就生成了下图所示内容,里面那个链接就是我们刚刚编辑的内容的在线地址,可以直接浏览器打开查看 这里贴上我的地址 hulihuis-organization.gitbook.io/ao-li-ao/
以下是网站打开
7.再次编辑,需要点击右上角那个 Edit 按钮才能编辑
编辑完成你的内容,不要忘记再次点击右上角的按钮,此时已经换名字为 Merge ,点击之后,才会保存你刚刚编辑的内容,再次点击右上角share按钮,同步到网站地址,在你的网站地址点击刷新就能看到更新的内容了,更新内容可能没这么及时,需要多刷新几下
编辑不已,来个一键三连吧!
转载自:https://juejin.cn/post/7395866692771528744