docs: update postCount field in category vo and tag vo (#477)

统一分类和标签的文章数量字段。 See https://github.com/halo-dev/halo/issues/7095 ```release-note None ```
2025-10-18 08:14:42 +00:00 · 2024-12-04 17:39:10 +08:00
parent d0373d3db5
commit ec9331cbcc
24 changed files with 30 additions and 78 deletions
--- a/docs/developer-guide/plugin/extension-points/ui/interface/ListedPost.md
+++ b/docs/developer-guide/plugin/extension-points/ui/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/docs/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/docs/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/docs/developer-guide/theme/vo/_CategoryVo.md
+++ b/docs/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/docs/developer-guide/theme/vo/_TagVo.md
+++ b/docs/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.16/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
+++ b/versioned_docs/version-2.16/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/versioned_docs/version-2.16/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/versioned_docs/version-2.16/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.16/developer-guide/theme/vo/_CategoryVo.md
+++ b/versioned_docs/version-2.16/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.16/developer-guide/theme/vo/_TagVo.md
+++ b/versioned_docs/version-2.16/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.17/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
+++ b/versioned_docs/version-2.17/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/versioned_docs/version-2.17/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/versioned_docs/version-2.17/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.17/developer-guide/theme/vo/_CategoryVo.md
+++ b/versioned_docs/version-2.17/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.17/developer-guide/theme/vo/_TagVo.md
+++ b/versioned_docs/version-2.17/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.18/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
+++ b/versioned_docs/version-2.18/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/versioned_docs/version-2.18/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/versioned_docs/version-2.18/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.18/developer-guide/theme/vo/_CategoryVo.md
+++ b/versioned_docs/version-2.18/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.18/developer-guide/theme/vo/_TagVo.md
+++ b/versioned_docs/version-2.18/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.19/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
+++ b/versioned_docs/version-2.19/developer-guide/plugin/api-reference/ui/extension-points/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/versioned_docs/version-2.19/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/versioned_docs/version-2.19/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.19/developer-guide/theme/vo/_CategoryVo.md
+++ b/versioned_docs/version-2.19/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.19/developer-guide/theme/vo/_TagVo.md
+++ b/versioned_docs/version-2.19/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.20/developer-guide/plugin/extension-points/ui/interface/ListedPost.md
+++ b/versioned_docs/version-2.20/developer-guide/plugin/extension-points/ui/interface/ListedPost.md
@@ -21,9 +21,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 分类的永久链接
-      postCount: number;                          // 分类下的文章总数
-      visiblePostCount: number;                   // 分类下可见的文章总数
    };
+    postCount: number;                            // 分类下的文章总数
  }>;
  contributors: Array<{                           // 文章的贡献者集合
    avatar: string;                               // 贡献者头像
@@ -110,9 +109,8 @@ export interface ListedPost {
    };
    status: {
      permalink: string;                          // 标签的永久链接
-      postCount: number;                          // 标签下的文章总数
-      visiblePostCount: number;                   // 标签下可见的文章总数
    };
+    postCount: number;                            // 标签下的文章总数
  }>;
 }

--- a/versioned_docs/version-2.20/developer-guide/theme/vo/_CategoryTreeVo.md
+++ b/versioned_docs/version-2.20/developer-guide/theme/vo/_CategoryTreeVo.md
@@ -23,11 +23,9 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
  "children": "List<#CategoryTreeVo>",                  // 下级分类，CategoryTreeVo 的集合
  "parentName": "string",
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.20/developer-guide/theme/vo/_CategoryVo.md
+++ b/versioned_docs/version-2.20/developer-guide/theme/vo/_CategoryVo.md
@@ -23,9 +23,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "postCount": 0,                                     // 文章数
-    "visiblePostCount": 0                               // 已发布文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```
--- a/versioned_docs/version-2.20/developer-guide/theme/vo/_TagVo.md
+++ b/versioned_docs/version-2.20/developer-guide/theme/vo/_TagVo.md
@@ -18,9 +18,7 @@
  },
  "status": {
    "permalink": "string",                              // 固定链接
-    "visiblePostCount": 0,                              // 已发布文章数
-    "postCount": 0                                      // 文章数
  },
-  "postCount": 0
+  "postCount": 0                                        // 文章数量
 }
 ```