docs: refine documentation of halo:comment tag (#281)

从 Halo 2.9 开始，判断评论组件是否显示的条件不再只是单纯的判断评论插件是否安装。 see halo-dev/halo#4271 /kind documentation ```release-note None ```
halo-dev · Dec 1, 2023 · df6ed25 · df6ed25 · vercel · Dec 1, 2023
1 parent 7e8a8ec
commit df6ed25
Show file tree

Hide file tree

Showing 4 changed files with 8 additions and 4 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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"