snowdreams1006 / gitbook-plugin-mygitalk

Mygitalk is a gitbook comment plugin based on gitalk

gitbook-plugin-mygitalk

Mygitalk is a gitbook comment plugin based on gitalk.

If you want to know the story behind mygitalk, please visit gitbook-plugin-mygitalk.

Homepage

• Github : https://snowdreams1006.github.io/gitbook-plugin-mygitalk/
• Gitee : https://snowdreams1006.gitee.io/gitbook-plugin-mygitalk/
• Gitlab : https://snowdreams1006.gitlab.io/gitbook-plugin-mygitalk/

Feature

• Authentication with github account
• Serverless, all comments will be stored as github issues
• Both personal and organization github projects can be used to store comments
• Localization, support multiple languages [en, zh-CN, zh-TW, es-ES, fr, ru]
• Facebook-like distraction free mode (Can be enabled via the distractionFreeMode option)
• Hotkey submit comment (cmd|ctrl + enter)

Usage

• Install this plugin

Add mygitalk to plugins in book.json configuration file.

{
    "plugins" : ["mygitalk"]
}

Install mygitalk via npm or gitbook .

$ npm install gitbook-plugin-mygitalk

or

$ gitbook install

• Configure this plugin

Prepare a GitHub application , if you don't have one, Click here to register a new one.

Add it to your book.json with a basic configuration

{
  "pluginsConfig": {
    "mygitalk": {
        "clientID": "GitHub Application Client ID",
        "clientSecret": "GitHub Application Client Secret",
        "repo": "GitHub repo",
        "owner": "GitHub repo owner",
        "admin": ["GitHub repo owner and collaborators, only these guys can initialize github issues"],
        "distractionFreeMode": false
    }
  }
}

• Run gitbook locally

Run gitbook build or gitbook serve to verify this plugin is in effect and should not have been initialized yet.

• Release gitbook officially

Publish to the production environment to implement the comment function really.

• Star this plugin

If you feel this plugin is helpful, feel free to star gitbook-plugin-mygitalk.

Example

The gitbook-plugin-mygitalk project has been integrated with the plugin itself or you can refer to the sample project.

Feedback

I am very happy to help out with your books or any other questions you might have. see snowdreams1006

You can email me or new issue on github.

License

gitbook-plugin-mygitalk is licensed under Apache-2.0 License. See LICENSE for the full license text.

gitbook-plugin-mygitalk's Issues

document.title

location.href + header.meta[description]

Page not found · GitHub Pages

https://snowdreams1006.github.io/use/gitalk-info.html

undefined

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

what is gitalk · gitbook-plugin-mygitalk

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/gitalk-info.html

Page not found · GitHub Pages

https://snowdreams1006.github.io/use/mygitalk-story.html

undefined

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

story about mygitalk · gitbook-plugin-mygitalk

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-story.html

undefined

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

Page not found · GitHub Pages

https://snowdreams1006.github.io/use/

undefined

document.title

location.href + header.meta[description]

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

简介 · 雪之梦技术驿站

https://snowdreams1006.github.io/./

undefined

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

use/mygitalk-name.html

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

Page not found · GitHub Pages

https://snowdreams1006.github.io/use/mygitalk-name.html

undefined

Found a bug

I'm having a problem with this

Page not found · GitHub Pages

https://snowdreams1006.github.io/dev/

undefined

why name mygitalk · gitbook-plugin-mygitalk

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/use/mygitalk-name.html

undefined

403 Error

不知道大佬有没有发现在登录时会出现 403 错误，你自己的博客主页现在也会出现这种情况。

Found a bug

I'm having a problem with this

集成到gitbook.com，gitalk.js没有加载

在本地和集成到github，可以看到评论区。
在gitbook.com网站，没加载gitalk.js。

how to dev · gitbook-plugin-mygitalk

https://snowdreams1006.github.io/gitbook-plugin-mygitalk/dev/

undefined