@saintic/vuepress-plugin-utterances v0.2.0
vuepress-plugin-utterances
A simple comments plugin for vuepress
English | 中文
Refer to utterances implemented by @Timi-design/vuepress-plugin-comments, also supports Beaudar
ps: The level is limited, there may be some bugs that cannot be solved, use it with caution~~
ps: Beaudar can be regarded as the Chinese version of Utterances
Install
With npm:
npm install --save @saintic/vuepress-plugin-utterancesWith yarn:
yarn add @saintic/vuepress-plugin-utterances -DWith cnpm:
cnpm i --save @saintic/vuepress-plugin-utterancesUsage
Name
As plugin:
@saintic/vuepress-plugin-utterancesAs component:
Comments(theme development using <- I did not test)
Options
Please learn about Utterances, a GitHub issue based review system.
| Option name | Required | Utterances configuration | Default value |
|---|---|---|---|
| repo | yes | GitHub Repository | \ |
| theme | no | Theme value | github-light |
| issueTerm | no | Blog Post ↔️ Issue Mapping | pathname |
| defaultShowComment | no | Show comments by default | true |
| service | no | Service provider: utterances/beaudar | utterances |
Page frontmatter
showComment {Boolean}: A single post page display comments
If the
defaultShowCommentis true (i.e. the default), all article details pages will display comments by default.Set this
showCommentto false to turn off comments on an article.If the
defaultShowCommentis false, all article details pages will not be displayed by default.Set this
showCommentto true, you can open comments on an article separately.
PS: by the way, comments are not allowed on the index page(/).
Examples
Please refer to how vuexpress uses plugins first
Babel Style
module.exports = { plugins: [ [ '@saintic/utterances', { repo: 'staugur/staugur.github.io', theme: 'github-light', issueTerm: 'pathname' } ] ] }Object Style
module.exports = { plugins: { '@saintic/utterances': { repo: 'staugur/staugur.github.io', defaultShowComment: false } } }