Skip to content

Commit

Permalink
docs: add alfred workflow & fix typo in usage tracking (#5487)
Browse files Browse the repository at this point in the history
Signed-off-by: weiwei <[email protected]>
  • Loading branch information
zwwhdls authored Jan 2, 2025
1 parent 3319df5 commit fbe4e91
Show file tree
Hide file tree
Showing 9 changed files with 71 additions and 1 deletion.
35 changes: 35 additions & 0 deletions docs/en/community/integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,3 +24,38 @@ slug: /integrations
## DevOps

- [Terraform Provider for JuiceFS](https://github.com/toowoxx/terraform-provider-juicefs) by Toowoxx IT GmbH, an IT service company from Germany

## Alfred

JuiceFS documents offers an Alfred workflow to search documents of JuiceFS with instant results

![JuiceFS Alfred Workflow](../images/workflow-root.png)

Simply type your keyword into Alfred (default: jfs) and provide a query to see instant search results from JuiceFS documents.

### Install

Workflow of Alfred 5 version: [Latest Download](https://github.com/zwwhdls/juicefs-alfred-workflow/releases/download/v0.1.0/JuiceFS.Search.alfredworkflow)

### Usage

Search all documents of JuiceFS, including community, enterprise and CSI:

```
# JuiceFS community documents
jfs ce <search>
# JuiceFS enterprise documents
jfs ee <search>
# JuiceFS csi documents
jfs csi <search>
```

![JuiceFS Alfred Workflow demo](../images/workflow-demo.gif)

## Workflow Variables

- `API_KEY`: API key for algolia which JuiceFS documents uses. Default value is ok.
- `LANGUAGE`: Language of JuiceFS documents to search. Default is `en`.
- `HITS_PER_PAGE`: Hits of each search. Default is `10`.

![JuiceFS Alfred Workflow configuration](../images/configuration.png)
Binary file added docs/en/images/configuration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en/images/workflow-demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en/images/workflow-root.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 35 additions & 0 deletions docs/zh_cn/community/integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,38 @@ slug: /integrations
## DevOps

- [Terraform Provider for JuiceFS](https://github.com/toowoxx/terraform-provider-juicefs) 由 Toowoxx IT GmbH 贡献,他们是一家来自德国的 IT 服务公司。

## Alfred

JuiceFS 文档站集成了 Alfred,可以快速搜索 JuiceFS 文档。

![JuiceFS Alfred Workflow](../images/workflow-root.png)

只需在 Alfred 中输入关键字(默认:jfs)并提供查询即可查看 JuiceFS 文档的即时搜索结果。

### 安装

安装 Alfred 5 的 JuiceFS workflow: [下载最新版本](https://github.com/zwwhdls/juicefs-alfred-workflow/releases/download/v0.1.0/JuiceFS.Search.alfredworkflow)

### 使用

可以搜索 JuiceFS 的所有文档,包括社区、企业和 CSI:

```
# 查询 JuiceFS 社区版文档
jfs ce <search>
# 查询 JuiceFS 企业版文档
jfs ee <search>
# 查询 JuiceFS CSI 文档
jfs csi <search>
```

![JuiceFS Alfred Workflow demo](../images/workflow-demo.gif)

## Workflow 可配置的变量

- `API_KEY`:JuiceFS 文档使用的 algolia 的 API 密钥,使用默认值就可以。
- `LANGUAGE`:要搜索的 JuiceFS 文档的语言(en/zh),默认为 en。
- `HITS_PER_PAGE`:每次搜索的点击量,默认值为 10。

![JuiceFS Alfred Workflow configuration](../images/configuration.png)
2 changes: 1 addition & 1 deletion docs/zh_cn/community/usage_tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: 用量上报
sidebar_position: 4
---

JuiceFS 默认会收集并上报**「匿名」**的使用数据。这些数据仅仅包含核心指标(如版本号、文件系统大小),不会包含任何用户信息或者敏感数据。你可以查看[这里](https://github.com/juicedata/juicefs/blob/main/pkg/usage/usage.go)检查相关代码。
JuiceFS 默认会收集并上报 **「匿名」** 的使用数据。这些数据仅仅包含核心指标(如版本号、文件系统大小),不会包含任何用户信息或者敏感数据。你可以查看[这里](https://github.com/juicedata/juicefs/blob/main/pkg/usage/usage.go)检查相关代码。

这些数据帮助我们理解社区如何使用这个项目。你可以简单地通过 `--no-usage-report` 选项关闭用量上报:

Expand Down
Binary file added docs/zh_cn/images/configuration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/zh_cn/images/workflow-demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/zh_cn/images/workflow-root.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit fbe4e91

Please sign in to comment.