Сервис комментариев

Около 2 мин

vuepress-theme-hope реализует функцию комментариев со встроенным vuepress-plugin-comment2open in new window.

Инфо

vuepress-theme-hope передает plugins.comment в параметрах темы в качестве параметров плагина vuepress-plugin-comment2.

Включить Конфигурация страницы поддержки

// .vuepress/config.ts
import { defineUserConfig } from "vuepress";
import { hopeTheme } from "vuepress-theme-hope";

export default defineUserConfig({
  theme: hopeTheme({
    plugins: {
      comment: {
        provider: "Waline",

        // waline 模式下
        serverURL: "...", // your serverURL
      },
    },
  }),
});

// .vuepress/config.js
import { hopeTheme } from "vuepress-theme-hope";

export default {
  theme: hopeTheme({
    plugins: {
      comment: {
        provider: "Waline",

        // waline 模式下
        serverURL: "...", // your serverURL
      },
    },
  }),
};

Функция комментариев включена глобально по умолчанию и контролируется параметрами plugins.comment.comment.

Совет

Полный элемент конфигурации плагина смотрите в документации по плагинуopen in new window.

Поставщик комментариев

В настоящее время вы можете выбирать из Giscus, Waline, Twikoo и Artalk.

Выбор службы комментариев

Giscus рекомендуется, если ваш блог или документация в первую очередь ориентированы на программистов.
Если ваш блог или документация предназначены для широкой публики, рекомендуется Waline.

Giscus

Giscus — это система комментариев на основе GitHub Discussion, которую легко запустить.

Подготовка

Вам необходимо создать общедоступный репозиторий и открыть обсуждение как место для хранения комментариев.
Вам необходимо установить приложение Giscusopen in new window, чтобы иметь доступ к соответствующему репозиторию.

После выполнения вышеуказанных шагов перейдите на страницу Giscusopen in new window, чтобы получить настройки. Вам просто нужно заполнить категории репозитория и обсуждения, затем прокрутить до раздела "Enable giscus" внизу страницы и скопировать data-repo, data-repo-id, data-category и data-category-id четыре элемента по мере необходимости.

Конфиг

Пожалуйста, передайте data-repo, data-repo-id, data-category и data-category-id в качестве параметров плагина как repo, repoId, category categoryId.

Другие параметры смотрите в Конфиге Giscusopen in new window.

Waline

Получить APP_ID и APP_Key

Войтиopen in new window или зарегистрироватьсяopen in new window leancloud. Затем создайте новое приложение в Leancloud, и вы получите APP ID / APP Key / APP Master Key.

После этого создайте приложение Vercel с помощью кнопки ниже.

Затем введите имя нового репозитория GitHub и установите переменные среды LEAN_ID, LEAN_KEY и LEAN_MASTER_KEY в столбце "Environment Variables". APP ID — это значение LEAN_ID, а APP Key - это LEAN_KEY, Master Key - это LEAN_MASTER_KEY.

Нажмите кнопку Deploy, для деплоя. Это покажет, что вы успешно развернули через несколько минут. Затем настройте ссылку Vercel в настройках темы:

// .vuepress/config.ts
import { defineUserConfig } from "vuepress";
import { hopeTheme } from "vuepress-theme-hope";

export default defineUserConfig({
  theme: hopeTheme({
    plugins: {
      comment: {
        provider: "Waline",
        serverURL: "YOUR_SERVER_URL", // your server url
      },
    },
  }),
});

// .vuepress/config.js
import { hopeTheme } from "vuepress-theme-hope";

export default {
  theme: hopeTheme({
    plugins: {
      comment: {
        provider: "Waline",
        serverURL: "YOUR_SERVER_URL", // your server url
      },
    },
  }),
};

Совет

Конфигурация будет указана в Конфигурация плагинаopen in new window.

Для получения более подробной информации смотрите Документацию Waline Docsopen in new window。

Twikoo

Развертывание Vercel

Подать заявку на учетную запись MongoDBopen in new window
Создайте бесплатную базу данных MongoDB, рекомендуемый регион AWS / N. Virginia (us-east-1)
Нажмите ПОДКЛЮЧИТЬ на странице Кластеры, следуйте инструкциям, чтобы разрешить подключения со всех IP-адресов (Почему?open in new window), создайте пользователя базы данных и запишите строку подключения к базе данных, измените <password> в строке подключения на пароль базы данных
Зарегистрируйте учетную запись Vercelopen in new window
Нажмите кнопку ниже, чтобы развернуть Twikoo на Vercel одним щелчком мыши
open in new window
Vercel
Перейдите в Settings - Environment Variables, добавьте переменную среды MONGODB_URI, значением является строка подключения к базе данных на шаге 3.
Перейдите в Overview, щелкните ссылку в разделе Domains, если конфигурация среды верна, вы увидите сообщение "Twikoo cloud function is running normally"
Домены Vercel (с префиксом https://, например, https://xxx.vercel.app) – это идентификатор вашей среды

Artalk

Развертывание сервера Artalk

Смотрите документацию Artalkopen in new window для развертывания сервера artalk.

Конфигурация Artalk

Пожалуйста, установите provider: "Artalk" и передайте ссылку на ваш сервер на server в настройках плагина.

Другие элементы конфигурации см. в разделе Конфигурация Artalkopen in new window.

Заметка

Плагин сохраняет опцию el и вставляет сам Artalk на страницу. В то же время плагин автоматически установит для вас параметры pageTitle, pageKey и site в соответствии с информацией VuePress.

До того, как VuePress2 предоставит конфигурацию клиента, два параметра функции imgUploader и avatarURLBuilder не поддерживаются.