vuepress-theme-reco

评论

2019/4/9

# 介绍

主题内置评论插件 @vuepress-reco/vuepress-plugin-comments，可以根据自己的喜好选择 Valine 或者 Vssue；

如果你想默认不加载评论，而只在某些页面显示评论功能，可以在 valineConfig 或 vssueConfig 中设置 showComment: false，并在需要展示评论的页面 设置 isShowComments: true。

如果仅是某篇文章不想设置开启评论功能，可以在 front-matter 设置 isShowComments: false。

浏览量

  1. 浏览量 仅在使用 Valine 时显示；
  2. 因为 浏览量 需要在页面加载时去调用相关接口，所以列表页的所有数据会一起加载下来，如果文章数量很多会影响加载速度，所以在 1.2.0 之后去掉文章列表的浏览量。

# Option API

# Valine

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

其他参数参考 Valine 官网 (opens new window)。

如果 valine 的获取评论的接口报 404 错误的话，不用担心，这是因为你还没有添加评论，只要存在1条评论，就不会报错了，这是 leanCloud 的请求处理操作而已；

# 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',
    }
  }  
}

其他参数参考 Vssue 官网 (opens new window)。

# 多语言配置

如果你需要支持不同语言，需要这么设置：

// config.js
module.exports = {
  locales: {
    '/': {
      lang: 'zh-CN'
    },
    '/en/': {
      lang: 'en-US'
    }
  }
  themeConfig: {
    locales: {
      '/': {
        valineConfig: {
          // ...
        }
      },
      '/en/': {
        valineConfig: {
          // ...
        }
      }
    }
  }
}

加密功能