@ -136,7 +136,7 @@ var dsqjs = new DisqusJS({
- DisqusJS 请求的 API Endpoint, 通常情况下你应该配置一个 Disqus API 的反代并填入反代的地址。你也可以直接使用 DISQUS 官方 API 的 Endpoint `https://disqus.com/api/` ,或是使用我搭建的 Disqus API 反代 Endpoint `https://disqus.skk.moe/disqus/` 。如有必要可以阅读关于搭建反代的 [相关内容 ](https://github.com/SukkaW/DisqusJS#%E8%B0%83%E8%AF%95%E8%BF%9B%E9%98%B6%E4%BD%BF%E7%94%A8--%E5%BC%80%E5%8F%91%E7%9B%B8%E5%85%B3 )
- ** 建议**,默认值为 `https://disqus.skk.moe/disqus/`
**apikey** `{string || { Array} }`
**apikey** `{string || Array}`
- DisqusJS 向 API 发起请求时使用的 API Key, 你应该在配置 Disqus Application 时获取了 API Key
- DisqusJS 支持填入一个 包含多个 API Key 的 Array, 在每次请求时会随机使用其中一个; 如果你只需要填入一个 API Key, 则可以填入 String 或 Array。
@ -160,9 +160,9 @@ var dsqjs = new DisqusJS({
- nesting 最大评论嵌套数(超过嵌套层数的评论会显示在同一层级下,目前该值采用 Disqus 官方 4 级嵌套且不可改变)
- nocomment 没有评论时的提示语(对应 Disqus Admin - Settings - Community - Comment Count Link - Zero comments)
~~- commentPolicyURL 站点评论政策 URL( 对应 对应 Disqus Admin - Settings - General - Comment Policy URL) ~~
~~- commentPolicyText 站点评论政策简介(对应 对应 Disqus Admin - Settings - General - Comment Policy Summary) ~~
~~- newcomment 是否允许添加新评论(目前增加评论功能尚未实现)~~
- ~~commentPolicyURL 站点评论政策 URL( 对应 对应 Disqus Admin - Settings - General - Comment Policy URL) ~~
- ~~commentPolicyText 站点评论政策简介(对应 对应 Disqus Admin - Settings - General - Comment Policy Summary) ~~
- ~~newcomment 是否允许添加新评论(目前增加评论功能尚未实现)~~
### PJAX 站点注意事项
@ -177,7 +177,7 @@ DisqusJS v1.0.0 及之后的版本使用了新的方法加载 DisqusJS, 并去
- Disqus API 不支持通过 AJAX 方式调用创建评论或者初始化页面,所以自动初始化页面和创建匿名评论在不搭配专门的后端程序的话不能实现。
- 所以如果 DisqusJS 检测到当前页面没有初始化、会提示是否切换到 Disqus 完整模式进行初始化。
- DisqusJS 仅在当前域名首次访问时检测 Disqus 可用性并选择模式,并把结果持久化在 localStorage 中,之后访问都会沿用之前的模式。
- 一个 Disqus Application 的 Rate Limit 是每小时 1000 次; DisqusJS 一次正常加载会产生 2 次请求。~~未来可能会开放填入多个 API Key, 支持调用多个 Application, 绕过 Rate Limit。~~ DisqusJS 已经 支持填入多个 API Key, 你可以创建多个 Disqus API Application 并分别获取 API Key。
- 一个 Disqus Application 的 Rate Limit 是每小时 1000 次; DisqusJS 一次正常加载会产生 2 次请求。DisqusJS 支持填入多个 API Key, 你可以创建多个 Disqus API Application 并分别获取 API Key。
- 我搭建了一个 Disqus API 反代的服务 `https://disqus.skk.moe/disqus/` 供没有能力搭建反代的用户使用,不保证 SLA、缓存 TTL 1 小时。
## 谁在使用 DisqusJS?
@ -197,7 +197,7 @@ DisqusJS v1.0.0 及之后的版本使用了新的方法加载 DisqusJS, 并去
- DisqusJS 在 localStorage 中持久化了 Disqus 连通性检查结果, key 为 `dsqjs_mode` , value 为 `disqus` 或者 `dsqjs` 。需要调整 DisqusJS 的模式时可以直接操作 localStorage。
- Disqus 自己的 config 保存在全局变量 `window.disqus_config` 中,你可能好奇为什么没有引入。实际上由于 `disqus_config` 和 DisqusJS 中有很多重复的配置,所以 DisqusJS 直接将相关配置项赋给了 `disqus_config` ,所以用户只需要配置 Disqus 即可。
- DisqusJS 并没有使用 Webpack 将 `disqusjs.css` 和 `disqus.js` 打包在一起,大家可以开发自己的 DisqusJS 主题。所有 DisqusJS 创建的 HTML 元素都在 `<div id="dsqjs"></div>` 之中、几乎所有的元素都有自己的类名并都以 `dsqjs-` 为前缀,防止污染。
- DisqusJS v1.2.0 版本实现了评论排序。Disqus 将评论排序方式持久化在 localStorage 中、key 为 `disqus.sort` , DisqusJS 沿用了这一位置。
- DisqusJS 从 v1.2.0 版本开始 实现了评论排序。Disqus 将评论排序方式持久化在 localStorage 中、key 为 `disqus.sort` , DisqusJS 沿用了这一位置。
## Todo List