最新消息:20210816 当前crifan.com域名已被污染,为防止失联,请关注(页面右下角的)公众号

【整理】Gitbook和Gitbook Editor使用心得

gitbook crifan 6436浏览 0评论

1.用其他编辑器如VSCode创建新章节,然后回到Gitbook中继续编辑内容

由于Gitbook中的新建章节New Article时

输入标题是输入的中文

而生成的新章节的md文件的文件名是中文的拼音,很不利于SEO,而在Gitbook中去rename该md时,应该是Gitbook的bug,又会导致rename后的md,常常会丢失,或者无法及时同步。

所以现在新建一个chapter的md时,都是:

去其他编辑器,比如VSCode,中去新建章节:

  • 编辑SUMMARY.md

  • 新建对应md文件

然后再去Gitbook中继续编辑

其会检测到外部文件的改动,提示是否同步,选择Sync同步:

然后就可以继续编辑了:

2.Editor(基于git)支持动态监测外部文件改动

如上,也可以看出来。

另外:

后来无意间发现了,Editor支持动态监测外部文件的修改

因为刚刚是直接在Finder中把chapter1.md删除了,其提示:

点击Sync即可。

2.md源码中列表用的是短横线-,结果保存后变成星号*了

Gitbook支持粘贴html,word等内容,自动转化为md格式,其中包括无序列表

然后对于无序列表,粘贴过来,默认都是*星号,然后自己一行行手动修改的,把星号都改为短横线-了

然后保存后,不知道何时,再去打开时,却变成了星号:

但是再去把部分星号改为短横线,结果好像又不会被改回星号。

所以没搞清楚Gitbook,何时会触发把我的列表的短横线变成星号。。。

3.刚刚发现,Gitbook中可以粘贴过来从其他地方如html中拷贝的图片

然后可以输出文件名和保存位置:

-》效果很帅啊:

-〉这样,Gitbook中,直接粘贴图片,就不用去其他地方找支持Gitbook的粘贴图片的插件了。

4.gitbook在Edit Markdown和预览模式之间切换时,内容如果太多,也会卡顿

估计内部是用JS实现的,在内容多的时候,在md源码和预览之间切换,也会卡顿

5.通过

disqus | GitBook Plugins

知道了顶部的配置,叫做:YAML frontmatter

6.gitbook安装插件方法

(1)所有的插件的安装方式都是:

配置好plugins后去:

gitbook install

(2)貌似也可以手动

npm install gitbook-plugin-xxx

比如:

npm install gitbook-plugin-disqus

7.大坑:在命令行操作gitbook的时候,一定要尽量避免同时打开Gitbook Editor

否则Gitbook Editor会过段时间(短则立刻,长则很多秒)后才能检测到文件改动,要点击Sync,才能同步更新,文件内容才是最新的。

详见:

【已解决】gitbook中book.json中的配置无效

转载请注明:在路上 » 【整理】Gitbook和Gitbook Editor使用心得

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
82 queries in 0.186 seconds, using 22.03MB memory