From df6ed25a8e92542dff7eb62ad964f84c5ba80d6a Mon Sep 17 00:00:00 2001
From: Ryan Wang <i@ryanc.cc>
Date: Fri, 1 Dec 2023 16:32:10 +0800
Subject: [PATCH] docs: refine documentation of halo:comment tag (#281)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

从 Halo 2.9 开始，判断评论组件是否显示的条件不再只是单纯的判断评论插件是否安装。

see https://github.com/halo-dev/halo/pull/4271

/kind documentation


```release-note
None
```
---
 docs/developer-guide/theme/template-tag.md                     | 3 ++-
 .../version-2.10/developer-guide/theme/template-tag.md         | 3 ++-
 .../version-2.11/developer-guide/theme/template-tag.md         | 3 ++-
 .../version-2.9/developer-guide/theme/template-tag.md          | 3 ++-
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/developer-guide/theme/template-tag.md b/docs/developer-guide/theme/template-tag.md
index 1791921..2c0028d 100644
--- a/docs/developer-guide/theme/template-tag.md
+++ b/docs/developer-guide/theme/template-tag.md
@@ -14,7 +14,8 @@ Halo 为满足部分代码注入和模板扩展点的需求，提供了一些专
 ### 使用示例
 
 ```html title="/templates/post.html"
-<div th:if="${pluginFinder.available('PluginCommentWidget')}">
+<!-- 需要判断当前评论组件是否满足显示的条件，这个变量可能是是否安装评论插件、文章是否开启评论等条件的组合 -->
+<div th:if="${haloCommentEnabled}">
     <halo:comment
         group="content.halo.run"
         kind="Post"
diff --git a/versioned_docs/version-2.10/developer-guide/theme/template-tag.md b/versioned_docs/version-2.10/developer-guide/theme/template-tag.md
index 1791921..2c0028d 100644
--- a/versioned_docs/version-2.10/developer-guide/theme/template-tag.md
+++ b/versioned_docs/version-2.10/developer-guide/theme/template-tag.md
@@ -14,7 +14,8 @@ Halo 为满足部分代码注入和模板扩展点的需求，提供了一些专
 ### 使用示例
 
 ```html title="/templates/post.html"
-<div th:if="${pluginFinder.available('PluginCommentWidget')}">
+<!-- 需要判断当前评论组件是否满足显示的条件，这个变量可能是是否安装评论插件、文章是否开启评论等条件的组合 -->
+<div th:if="${haloCommentEnabled}">
     <halo:comment
         group="content.halo.run"
         kind="Post"
diff --git a/versioned_docs/version-2.11/developer-guide/theme/template-tag.md b/versioned_docs/version-2.11/developer-guide/theme/template-tag.md
index 1791921..2c0028d 100644
--- a/versioned_docs/version-2.11/developer-guide/theme/template-tag.md
+++ b/versioned_docs/version-2.11/developer-guide/theme/template-tag.md
@@ -14,7 +14,8 @@ Halo 为满足部分代码注入和模板扩展点的需求，提供了一些专
 ### 使用示例
 
 ```html title="/templates/post.html"
-<div th:if="${pluginFinder.available('PluginCommentWidget')}">
+<!-- 需要判断当前评论组件是否满足显示的条件，这个变量可能是是否安装评论插件、文章是否开启评论等条件的组合 -->
+<div th:if="${haloCommentEnabled}">
     <halo:comment
         group="content.halo.run"
         kind="Post"
diff --git a/versioned_docs/version-2.9/developer-guide/theme/template-tag.md b/versioned_docs/version-2.9/developer-guide/theme/template-tag.md
index 1791921..2c0028d 100644
--- a/versioned_docs/version-2.9/developer-guide/theme/template-tag.md
+++ b/versioned_docs/version-2.9/developer-guide/theme/template-tag.md
@@ -14,7 +14,8 @@ Halo 为满足部分代码注入和模板扩展点的需求，提供了一些专
 ### 使用示例
 
 ```html title="/templates/post.html"
-<div th:if="${pluginFinder.available('PluginCommentWidget')}">
+<!-- 需要判断当前评论组件是否满足显示的条件，这个变量可能是是否安装评论插件、文章是否开启评论等条件的组合 -->
+<div th:if="${haloCommentEnabled}">
     <halo:comment
         group="content.halo.run"
         kind="Post"