README

@vuepress-reco/vuepress-plugin-comments

Introduce

Comments plugin for vuepress-theme-reco or other vuepress theme.

Name

As plugin: @vuepress-reco/vuepress-plugin-comments
As component: Comments (评论) / AccessNumber (使用 Valine 时的访问量)（主题开发时使用）

Option API

组件会在 $themeConfig 注入一个参数 commentsSolution，如果使用 Valine，其值为 valine，如果使用 Vssue，其值为 vssue，可以使用这个参数来主题中做差异化处理，比如是否显示阅读数量。

Valine

module.exports = {
  theme: 'reco',
  themeConfig: {
    valineConfig: {
      appId: '...',// your appId
      appKey: '...', // your appKey
    }
  }  
}

或者：

module.exports = {
  theme: 'reco',
  plugins: [['@vuepress-reco/comments', {
    solution: 'valine',
    options: {
      appId: '...',// your appId
      appKey: '...', // your appKey
    }
  }]] 
}

Vssue

module.exports = {
  theme: 'reco',
  themeConfig: {
    vssueConfig: {
      platform: 'github',
      owner: 'OWNER_OF_REPO',
      repo: 'NAME_OF_REPO',
      clientId: 'YOUR_CLIENT_ID',
      clientSecret: 'YOUR_CLIENT_SECRET',
    }
  }  
}

或者：

module.exports = {
  theme: 'reco',
  plugins: [['@vuepress-reco/comments', {
    solution: 'vuess',
    options: {
      platform: 'github',
      owner: 'OWNER_OF_REPO',
      repo: 'NAME_OF_REPO',
      clientId: 'YOUR_CLIENT_ID',
      clientSecret: 'YOUR_CLIENT_SECRET',
    }
  }]] 
}

options 详解：

platform: 支持的代码托管平台
owner: 对应 repository 的拥有者帐号或者团队
repo: 用来存储评论的 repository
clientId: OAuth App 的 client id
clientSecret: OAuth App 的 client secret（只有在使用某些平台时需要）

platform 详解（点击查看支持的代码托管平台）：

github: @vssue/api-github-v3
github-v4: @vssue/api-github-v4
gitlab: @vssue/api-gitlab-v4
bitbucket: @vssue/api-bitbucket-v2
gitee: @vssue/api-gitee-v5

AccessNumber

仅在使用 Valine 时才有效。

idVal

description: valine 记录浏览数的 id 值
type: String

numStyle

description: 浏览量的数字样式（用于调整不同位置的显示风格）
type: Object

flagTitle

description: 文章标题
type: String

Usage no npm install needed!