Skip to content

Commit

Permalink
add icons in search in market page (#132)
Browse files Browse the repository at this point in the history
  • Loading branch information
MaikoTan authored Dec 8, 2023
1 parent 19f0170 commit 8bbfed3
Showing 1 changed file with 59 additions and 24 deletions.
83 changes: 59 additions & 24 deletions zh-CN/manual/recipe/search.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,37 +14,50 @@ Koishi 有着丰富的插件生态。为了让用户更方便地搜索插件,

我们提供了四种插件标识,它们本身也是过滤条件。包括:

- `is:verified`:官方认证 (对钩)
- `is:insecure`:不安全 (叹号)
- `is:preview`:开发中 (扳手)
- `created:>date`:近期新增 (树苗)
<div class="plugin-flags-list">

- <market-icon name="verified" style="color: var(--k-color-success)" />`is:verified`:官方认证
- <market-icon name="insecure" style="color: var(--k-color-danger)" />`is:insecure`:不安全
- <market-icon name="preview" style="color: var(--k-color-warning)" />`is:preview`:开发中
- <market-icon name="newborn" style="color: var(--k-color-success)" />`created:>date`:近期新增

</div>

此外,还有一些不带标识的过滤条件:

- `is:installed`:已安装
- `is:portable`:快速体验
- `updated:>date`:近期更新
<div class="plugin-flags-list">

- <market-icon name="download" />`is:installed`:已安装
- <market-icon name="portable" />`is:portable`:快速体验
- <market-icon name="tag" />`updated:>date`:近期更新

</div>

上述的过滤条件也可以反向选择,例如 `not:insecure``created:<date`。在侧边栏中,你可以点击标识名称进行选择,点击第二次反向选择,点击第三次则会取消选择。

## 插件分类

我们目前提供了 14 个基础分类。它们分别是:

- `category:core`:核心功能
- `category:adapter`:适配器
- `category:storage`:存储服务
- `category:extension`:扩展功能
- `category:console`:控制台
- `category:manage`:管理工具
- `category:preset`:行为预设
- `category:image`:图片服务
- `category:media`:资讯服务
- `category:tool`:实用工具
- `category:ai`:人工智能
- `category:meme`:趣味交互
- `category:game`:娱乐玩法
- `category:gametool`:游戏辅助

<div class="plugin-flags-list">

- <market-icon name="solid:core" />`category:core`:核心功能
- <market-icon name="solid:adapter" />`category:adapter`:适配器
- <market-icon name="solid:storage" />`category:storage`:存储服务
- <market-icon name="solid:extension" />`category:extension`:扩展功能
- <market-icon name="solid:console" />`category:console`:控制台
- <market-icon name="solid:manage" />`category:manage`:管理工具
- <market-icon name="solid:preset" />`category:preset`:行为预设
- <market-icon name="solid:image" />`category:image`:图片服务
- <market-icon name="solid:media" />`category:media`:资讯服务
- <market-icon name="solid:tool" />`category:tool`:实用工具
- <market-icon name="solid:ai" />`category:ai`:人工智能
- <market-icon name="solid:meme" />`category:meme`:趣味交互
- <market-icon name="solid:game" />`category:game`:娱乐玩法
- <market-icon name="solid:gametool" />`category:gametool`:游戏辅助

</div>

插件的分类由 Koishi 团队成员负责维护,通常在插件发布后的一周内完成。极少数插件不会属于任何类别。如果你认为你的插件没有被正确分类,可以提交议题进行反馈。

Expand All @@ -59,9 +72,13 @@ Koishi 有着丰富的插件生态。为了让用户更方便地搜索插件,

除了按照评分排序,你还可以选择其他的排序方式:

- `sort:download`:按下载量排序
- `sort:created`:按创建时间排序
- `sort:updated`:按更新时间排序
<div class="plugin-flags-list">

- <market-icon name="download" />`sort:download`:按下载量排序
- <market-icon name="heart-pulse" />`sort:created`:按创建时间排序
- <market-icon name="tag" />`sort:updated`:按更新时间排序

</div>

如果要反向排序,可以在后面加上 `-asc`,例如 `sort:created-asc`。在侧边栏中,你可以点击排序方式进行排序,点击第二次反向排序,点击第三次则会取消排序。

Expand All @@ -72,3 +89,21 @@ Koishi 有着丰富的插件生态。为了让用户更方便地搜索插件,
:::

[Koishi Online (k-on!)](https://koishi.online) 是一个在线的 Koishi 运行时。你可以在其中快速体验插件的功能,而无需在本地安装 Koishi。适配了 k-on! 的插件会显示一个闪电按钮,点击即可快速创建一个 k-on! 实例。如果你是插件开发者,可以参考 [这篇文章](../../cookbook/practice/online.md) 来将你的插件部署到 k-on!。

<script lang="ts" setup>
import { MarketIcon } from '@koishijs/market'
</script>

<style>
.plugin-flags-list ul {
list-style-type: none;
padding-left: 0.5rem;
}
.plugin-flags-list svg {
transform: translateX(-0.5rem);
width: 16px;
height: 16px;
display: inline-block;
vertical-align: middle;
}
</style>

0 comments on commit 8bbfed3

Please sign in to comment.