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

Развёртывание облачной функции

Разместите Twikoo на хостинге или разверните самостоятельно на указанном сайте

Способ развёртывания	Рекомендация	Описание
Одно кликовое развёртывание Tencent Cloud	★☆☆☆☆	Хотя и удобно, но поддерживает только среды оплаты по факту использования — то есть для сред, развёрнутых в один клик, после исчерпания бесплатных ресурсов будут начисляться платежи. И среды оплаты по факту использования нельзя переключить на среды годовой/месячной подписки. Бесплатный лимит операций чтения базы данных составляет всего 500 раз в день, что не может поддерживать эксплуатационные требования Twikoo.
Ручное развёртывание Tencent Cloud	★★☆☆☆	Ручное развёртывание в среде CloudBase Tencent Cloud, более быстрая скорость доступа в материковом Китае. Требует платной покупки среды для развёртывания.
Развёртывание Tencent Cloud CLI	★☆☆☆☆	Только для разработчиков с опытом Node.js.
Развёртывание Vercel	★★★☆☆	Подходит для пользователей, желающих бесплатного развёртывания, более медленная или даже недоступная скорость доступа в материковом Китае, привязка собственного доменного имени может повысить скорость доступа.
Развёртывание Railway	★★☆☆☆	Имеет бесплатный лимит, но недостаточный для поддержки непрерывной работы в течение месяца, простое развёртывание, подходит для глобального доступа.
Развёртывание Zeabur	★☆☆☆☆	Требует привязки Alipay или кредитной карты, простое развёртывание, подходит для доступа из материкового Китая, среда бесплатного тарифа может быть удалена в любое время.
Развёртывание Netlify	★★★★☆	Имеет достаточный бесплатный лимит, хорошая скорость доступа в материковом Китае.
Развёртывание Hugging Face	★★★★☆	Бесплатно, хорошая скорость доступа в материковом Китае. Позволяет использовать пользовательские доменные имена через Cloudflare Tunnels.
Развёртывание AWS Lambda	★★★☆☆	Крупнейшая в мире облачная платформа, подходит для пользователей, которые уже используют полный набор сервисов AWS.
Развёртывание Cloudflare Workers	★★☆☆☆	Развёртывание требует командной строки, более короткое время холодного старта, некоторые функциональные ограничения.
Частное развёртывание	★★☆☆☆	Подходит для пользователей с серверами, нужно самостоятельно запрашивать HTTPS-сертификат.
Частное развёртывание (Docker)	★★★☆☆	Подходит для пользователей с серверами, нужно самостоятельно запрашивать HTTPS-сертификат.

Фронтенд развёртывание

👆Просто подключите адрес среды облачной функции выше

Использование в Hexo

Использование в теме Hexo Butterfly

Пожалуйста, обратитесь к Документу по установке Butterfly (4) Конфигурация темы-2 для настройки

Использование в теме Hexo Keep

Пожалуйста, обратитесь к hexo-theme-keep/_config.yml для настройки

Использование в теме Hexo Volantis

Пожалуйста, обратитесь к hexo-theme-volantis/_config.yml для настройки

Использование в теме Hexo Ayer

Пожалуйста, обратитесь к hexo-theme-ayer/_config.yml для настройки

Использование в теме Hexo NexT

Версии ниже NexT 8 пока не поддерживаются, сначала обновитесь до NexT 8. Затем выполните в корневом каталоге проекта Hexo

# Для версии NexT >= 8.0.0 && < 8.4.0
npm install hexo-next-twikoo@1.0.0
# Для версии NexT >= 8.4.0
npm install hexo-next-twikoo@1.0.3

Затем добавьте в конфигурацию

twikoo:
  enable: true
  visitor: true
  envId: xxxxxxxxxxxxxxx # Для среды Tencent Cloud заполните envId; для среды Vercel заполните адрес (https://xxx.vercel.app)
  # region: ap-guangzhou # Регион среды, по умолчанию ap-shanghai, для среды Tencent Cloud заполните ap-shanghai или ap-guangzhou; для среды Vercel не заполняйте

Использование в теме Hexo Matery

Пожалуйста, обратитесь к hexo-theme-matery/_config.yml для настройки

Использование в теме Hexo Icarus

Пожалуйста, обратитесь к На основе Tencent Cloud, оснастите ваш блог Icarus системой комментариев Twikoo от 异次元de机智君💯

Использование в теме Hexo MengD

Пожалуйста, обратитесь к hexo-theme-MengD/_config.yml для настройки

Использование в теме hexo-theme-fluid

Пожалуйста, обратитесь к Руководство по конфигурации - Комментарии для настройки

Использование в теме hexo-theme-cards

Пожалуйста, обратитесь к hexo-theme-cards/_config.yml для настройки

Использование в теме maupassant-hexo

Пожалуйста, обратитесь к maupassant-hexo/_config.yml для настройки

Использование в теме hexo-theme-redefine

Пожалуйста, обратитесь к Официальной документации Redefine #comment для настройки

Использование в теме Hexo-Theme-Solitude

Пожалуйста, обратитесь к Документации Solitude для настройки

Использование в Hugo

Использование в теме hugo-theme-stack

Пожалуйста, обратитесь к Комментарии | Stack и hugo-theme-stack/config.yaml#L83 для настройки

Использование в теме FixIt

Пожалуйста, обратитесь к Введение - FixIt #Конфигурация темы и hugo-fixit/FixIt/config.toml#L613-L624 для настройки

Использование в VitePress

Пожалуйста, обратитесь к Эталонному решению интеграции twikoo в VitePress для настройки.

Подключение через CDN

Если тема блога, которую вы используете, не поддерживает Twikoo, и вы не знаете, как подключить Twikoo, вы можете отправить запрос на адаптацию разработчику темы блога

<div id="tcomment"></div>
<script src="https://cdn.jsdelivr.net/npm/twikoo@1.6.44/dist/twikoo.min.js"></script>
<script>
twikoo.init({
  envId: 'Ваш id среды', // Для среды Tencent Cloud заполните envId; для среды Vercel заполните адрес (https://xxx.vercel.app)
  el: '#tcomment', // Элемент контейнера
  // region: 'ap-guangzhou', // Регион среды, по умолчанию ap-shanghai, для среды Tencent Cloud заполните ap-shanghai или ap-guangzhou; для среды Vercel не заполняйте
  // path: location.pathname, // Пользовательский путь js для различения разных статей, если путь вашей статьи не является location.pathname, вам нужно передать этот параметр
  // lang: 'zh-CN', // Используется для ручной установки языка области комментариев, список поддерживаемых языков https://github.com/twikoojs/twikoo/blob/main/src/client/utils/i18n/index.js
})
</script>

Различия между разными версиями

twikoo.all.min.js: Полная версия, включающая CloudBase (tcb) Tencent Cloud, если вы развёртываете с использованием CloudBase Tencent Cloud, выберите эту версию
twikoo.min.js: Упрощённая версия с удалённым CloudBase (tcb) Tencent Cloud, меньший размер, подходит для всех пользователей, не развёртывающих с помощью CloudBase Tencent Cloud
twikoo.nocss.js: Версия с вынесенными стилями на основе полной версии, нужно одновременно подключить twikoo.css для нормального отображения, подходит для пользователей, желающих кастомизировать стили области комментариев

Замена CDN-зеркала

Если вы столкнулись с медленной скоростью загрузки CDN по умолчанию, вы можете заменить его на другое CDN-зеркало. Ниже приведены общедоступные CDN на выбор, некоторые из которых могут потребовать нескольких дней для синхронизации последней версии:

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

https://s4.zstatic.net/ajax/libs/twikoo/1.6.41/twikoo.min.js
https://lib.baomitu.com/twikoo/1.6.39/twikoo.min.js

Пользователям, подключающим Twikoo через CDN, рекомендуется зафиксировать версию в адресе ссылки, чтобы избежать влияния несовместимых обновлений при будущем обновлении Twikoo.

Пользователям, подключающим Twikoo через CDN, рекомендуется добавить SRI в код для обеспечения целостности, пример:

<script
  src="https://cdn.jsdelivr.net/npm/twikoo@1.6.36/dist/twikoo.all.min.js"
  integrity="sha384-4KfOjEinLSkv1i1J8TzlkC/RTnuiLoR1OLerVgjEKoH5djYtbf7mzEFsz9p3nfuA"
  crossorigin="anonymous">
</script>

Где значение integrity можно запросить в SRI Hash Generator.

菜单