写在前面

如何配置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 大功告成!!

重要资源:

Gitbook官方教程