From 1add3ef3dd0e8951edf60bcaa5ffcfbbeda47b59 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=9B=B0=E5=9B=B0=E9=B1=BC?=
 <89380218+chengzhongxue@users.noreply.github.com>
Date: Fri, 9 Aug 2024 21:06:40 +0800
Subject: [PATCH] docs: refine docs for postFinder.listByOwner (#391)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

补充根据创建者用户名和分页参数获取文章列表。

```release-note
None
```
---
 .../developer-guide/theme/finder-apis/post.md | 30 +++++++++++++++++++
 .../developer-guide/theme/finder-apis/post.md | 29 ++++++++++++++++++
 2 files changed, 59 insertions(+)

diff --git a/docs/developer-guide/theme/finder-apis/post.md b/docs/developer-guide/theme/finder-apis/post.md
index 10a75e1..0fa1734 100644
--- a/docs/developer-guide/theme/finder-apis/post.md
+++ b/docs/developer-guide/theme/finder-apis/post.md
@@ -216,6 +216,36 @@ postFinder.listByTag(page, size, tag);
 </ul>
 ```
 
+## listByOwner(page,size,owner)
+
+```js
+postFinder.listByOwner(page, size, owner);
+```
+
+### 描述
+
+根据创建者用户名和分页参数获取文章列表。
+
+### 参数
+
+1. `page:int` - 分页页码，从 1 开始
+2. `size:int` - 分页条数
+3. `owner:string` - 创建者用户名 `name`
+
+### 返回值
+
+[#ListResult<ListedPostVo\>](#listresultlistedpostvo)
+
+### 示例
+
+```html
+<ul th:with="posts = ${postFinder.listByOwner(1,10,'admin')}">
+  <li th:each="post : ${posts.items}">
+    <a th:href="@{${post.status.permalink}}" th:text="${post.spec.title}"></a>
+  </li>
+</ul>
+```
+
 ## archives(page,size)
 
 ```js
diff --git a/versioned_docs/version-2.18/developer-guide/theme/finder-apis/post.md b/versioned_docs/version-2.18/developer-guide/theme/finder-apis/post.md
index 10a75e1..e68fd23 100644
--- a/versioned_docs/version-2.18/developer-guide/theme/finder-apis/post.md
+++ b/versioned_docs/version-2.18/developer-guide/theme/finder-apis/post.md
@@ -215,6 +215,35 @@ postFinder.listByTag(page, size, tag);
   </li>
 </ul>
 ```
+## listByOwner(page,size,owner)
+
+```js
+postFinder.listByOwner(page, size, owner);
+```
+
+### 描述
+
+根据创建者用户名和分页参数获取文章列表。
+
+### 参数
+
+1. `page:int` - 分页页码，从 1 开始
+2. `size:int` - 分页条数
+3. `owner:string` - 创建者用户名 `name`
+
+### 返回值
+
+[#ListResult<ListedPostVo\>](#listresultlistedpostvo)
+
+### 示例
+
+```html
+<ul th:with="posts = ${postFinder.listByOwner(1,10,'admin')}">
+  <li th:each="post : ${posts.items}">
+    <a th:href="@{${post.status.permalink}}" th:text="${post.spec.title}"></a>
+  </li>
+</ul>
+```
 
 ## archives(page,size)