写在前面
如何配置DISQUS插件?
解决过程: 从Gitbook官方教程的plungis一章找到plugins帮助文档那个,得知Install the Disqus plugin via NPM。如果要配置插件,就要先知道NPM是什么,如何获得。于是百度搜索“gitbook 插件 npm”,返回结果: 使用Gitbook制作电子书。从这篇文章得知从npm官方网站可以下载安装NPM。
反思:如果要下载npm以及获知npm的使用信息,可以直接找到npm的官网和查看documentation。节省无用信息筛选成本
下载安装node.js后,回到plugins帮助文档。 问题:npm是什么?怎么操作?
打开终端,按npm帮助文档的提示安装npm并检查安装版本: $ node -v #检查node.js版本 $ sudo npm install npm -g $ npm -v
回到plugins帮助文档,按操作安装disqus插件: $ sudo npm install gitbook-plugin-disqus -g
To use the Disqus plugin in your Gitbook project, add the disqus plugin to the book.json file, along with your shortname (you create a shortname for disqus by creating a new website on the disqus.com website) 问题:什么是book.json?怎么操作?
推测可能在gitbook的编辑器里,于是误打误撞通过右上角的设置添加了disqus插件:
这时文件树里多了book.json文件,恍然大悟,点击查看代码内容,按plugins帮助文档说明编写代码将disqus插件添加到book.json文件。
{
"plugins": ["disqus"],
"pluginsConfig": {
"disqus": {
"shortName": "notesforpython" #在disqus上创建的channel
}
}
}
大功告成? 在create your page点击read时发现:This book has not been published yet
回到gitbook官方教程,在build章得知: 为了build website,首先要使用git或gitbook editor push content 问题:如何使用gitbook editor push content?
尝试1:在设置中添加push插件。失败,无push插件 尝试2:在book.json中添加代码。为此,在百度中搜索“gitbook editor push content”,找到gitbook简明教程。在book.json中添加如下代码:
$ gitbook build ./repository --output=./outputFolder
成功!
成功? 现象:We were unable to load Disqus.
尝试1:问题旁边直接附有帮助文档。查看帮助文档,看不懂,暂且放弃,转换思路。
尝试2:重新研读plugins帮助文档 you create a shortname for disqus by creating a new website on the disqus.com website 我在disqus那边创建了一个channel,与这里的website是不是一个概念?这个问题的答案在disques的帮助文档里一定有,于是找到disques帮助文档,搜索“create website”,返回结果: Disqus Sites and Channels On Disqus, there are two different ways to facilitate Discussions and encourage conversation: Sites and Channe... A single embed code gives you access to both Engage and Reveal for your Site. 进入engage创建website,命名为notesforpythonjed 在book.json中将shortName修改为notesforpythonjed 刷新浏览器,disqus插件已添加到gitbook 大功告成!!
重要资源: