Embedding Discourse сomments with GitBook

AI-generated summary

The discussion revolves around integrating Discourse comments with GitBook. lev.kavelin is seeking help with this integration, having tried two plugins that do not work. erlend_sh suggests contacting the authors of the deprecated plugins for assistance.

yhsiang shares their success with the g0v/gitbook-plugin-discourse plugin, which syncs topics from Gitbook to Discourse, and then uses the Discourse JSON API to customize their page with comments.

jerdog clarifies that the plugins can take comments from Gitbook and create a topic in a chosen Discourse category.

Mindey provides an example of a well-working integration, where GitBook exposes comments and links to discussions on a separate forum using a custom discuss.js script and HTML divs in Markdown files.

Good day!

It is necessary to integrate the Discourse comments with GitBook. For each new page\post should be created theme in the Discourse. In essence this is the same as the plug comments to a blog that is described here - Embed Discourse comments on another website via Javascript

But I’m not so good at JS to do it now on their own.

In the catalog Gitbook there are two plug-ins for integration with platform comments discourse. But both the plugin does not work.

Can anyone help with this? I would be grateful for any advice.

Well your best bet would be to try get in touch with the authors of those deprecated plugins:

Ask them to create a topic for their plugin in our Customization > Extras category so we can stay in touch with them!

1개의 좋아요

Hi,

g0v/gitbook-plugin-discourse still works, but it design for creating the same topic on discourse.

We use it on our project vtaiwant.tw

First, we create a gitbook, and use this plugin to sync topics to discourse.
Then we use discourse json api to custom our page with discourse comments.

1개의 좋아요

So if I understand this correctly, these plugins listed above take any questions/comments people make about whatever is posted on Gitbook and puts them in as a topic in the chosen Category, correct?

Has anyone had any good success with doing this? Which one did you choose?

Hm, I’ve seen a well working integration at, e.g.: here, where GitBook exposes the comments, and reply link leads to discussion on their https://discuss.gluon.ai/ . That GitBook uses divs inside MD files, like so

Discuss on our Forum

And then, it uses this discuss.js:
https://github.com/diveintodeeplearning/d2l-en/blob/master/build/_static/discuss.js

Or even with QR code to scan-in to discussions:
https://github.com/diveintodeeplearning/d2l-zh/blob/master/build/_static/discuss.js

2개의 좋아요