From 4c01d790e551dc23e1e27da124ae76dc46f87e2b Mon Sep 17 00:00:00 2001 From: iMaeGoo Date: Wed, 10 Jul 2024 10:08:08 +0800 Subject: [PATCH 1/3] doc: add zstatic cdn url --- docs/frontend.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/frontend.md b/docs/frontend.md index 024106bf5..49ba80043 100644 --- a/docs/frontend.md +++ b/docs/frontend.md @@ -111,6 +111,7 @@ twikoo.init({ 如果遇到默认 CDN 加载速度缓慢，可更换其他 CDN 镜像。以下为可供选择的公共 CDN，其中一些 CDN 可能需要数天时间同步最新版本： +* `https://s4.zstatic.net/ajax/libs/twikoo/1.6.38/twikoo.all.min.js` * `https://lib.baomitu.com/twikoo/1.6.38/twikoo.all.min.js` * `https://cdn.jsdelivr.net/npm/twikoo@1.6.38/dist/twikoo.all.min.js` From d15342e2ff21da64cae1bf307c396d359bc65151 Mon Sep 17 00:00:00 2001 From: iMaeGoo Date: Tue, 16 Jul 2024 15:05:44 +0800 Subject: [PATCH 2/3] doc: update frontend.md --- docs/frontend.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/docs/frontend.md b/docs/frontend.md index 49ba80043..67535233a 100644 --- a/docs/frontend.md +++ b/docs/frontend.md @@ -88,12 +88,12 @@ twikoo: ## 通过 CDN 引入 ::: tip 提示 -如果您使用的博客主题不支持 Twikoo，并且您不知道如何引入 Twikoo，您可以[在 Github 提交适配请求](https://github.com/twikoojs/twikoo/issues/new) +如果您使用的博客主题不支持 Twikoo，并且您不知道如何引入 Twikoo，您可以向博客主题开发者提交适配请求 ::: ``` html
- + ``` -> 建议使用 CDN 引入 Twikoo 的用户在链接地址上锁定版本，以免将来 Twikoo 升级时受到非兼容性更新的影响。 - ### 更换 CDN 镜像 如果遇到默认 CDN 加载速度缓慢，可更换其他 CDN 镜像。以下为可供选择的公共 CDN，其中一些 CDN 可能需要数天时间同步最新版本： * `https://s4.zstatic.net/ajax/libs/twikoo/1.6.38/twikoo.all.min.js` +* `https://registry.npmmirror.com/twikoo/1.6.38/files/dist/twikoo.all.min.js` * `https://lib.baomitu.com/twikoo/1.6.38/twikoo.all.min.js` * `https://cdn.jsdelivr.net/npm/twikoo@1.6.38/dist/twikoo.all.min.js` -> 建议使用 CDN 引入 Twikoo 的用户参考上一段的示例在代码中加入 [SRI](https://developer.mozilla.org/zh-CN/docs/Web/Security/Subresource_Integrity) 属性以确保完整性。 +::: warning 注意 +建议使用 CDN 引入 Twikoo 的用户在链接地址上锁定版本，以免将来 Twikoo 升级时受到非兼容性更新的影响。 +::: + +::: warning 注意 +建议使用 CDN 引入 Twikoo 的用户在代码中加入 [SRI](https://developer.mozilla.org/zh-CN/docs/Web/Security/Subresource_Integrity) 以确保完整性，例： +```html + +``` +其中 `integrity` 的值可以在 [SRI Hash Generator](https://www.srihash.org/) 查询。 +::: ## 开启管理面板（腾讯云环境） From 209f02769e277875ef2e80b043a13c72b0775eff Mon Sep 17 00:00:00 2001 From: iMaeGoo Date: Tue, 16 Jul 2024 15:18:17 +0800 Subject: [PATCH 3/3] doc: update frontend.md --- docs/frontend.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/frontend.md b/docs/frontend.md index 67535233a..949d44c2b 100644 --- a/docs/frontend.md +++ b/docs/frontend.md @@ -105,6 +105,12 @@ twikoo.init({ ``` +### 不同版本之间的区别 + +* `twikoo.all.min.js`: 包含腾讯云云开发（tcb）的完整版本，如果您使用腾讯云云开发部署，请选择此版本 +* `twikoo.min.js`: 去除了腾讯云云开发（tcb）的精简版本，体积更小，适合所有非腾讯云云开发部署的用户 +* `twikoo.nocss.js`: 在完整版本的基础上剥离了样式，需要同时引入 `twikoo.css` 才能正常显示，适合想要魔改评论区样式的用户 + ### 更换 CDN 镜像 如果遇到默认 CDN 加载速度缓慢，可更换其他 CDN 镜像。以下为可供选择的公共 CDN，其中一些 CDN 可能需要数天时间同步最新版本：