You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hugegraph.apache.org by ji...@apache.org on 2026/09/05 00:56:54 UTC
(hugegraph-doc) 03/20: feat(search): enrich bilingual entry metadata
This is an automated email from the ASF dual-hosted git repository.
imbajin pushed a commit to branch feat/oink-community-content
in repository https://gitbox.apache.org/repos/asf/hugegraph-doc.git
commit f6592d2f284788442f1a110e2f352e6aceadceb9
Author: dark <ji...@apache.org>
AuthorDate: Fri Sep 4 19:05:28 2026 +0800
feat(search): enrich bilingual entry metadata
- add focused keywords and boosts to 12 EN/CN entry groups\n- enable LLMSFULL only on latest bilingual docs roots\n- verify fixed metadata coverage and generated llms-full outputs
---
content/cn/docs/_index.md | 1 +
content/cn/docs/clients/_index.md | 2 ++
content/cn/docs/clients/restful-api/_index.md | 2 ++
content/cn/docs/config/config-authentication.md | 2 ++
content/cn/docs/config/config-guide.md | 2 ++
content/cn/docs/download/download.md | 2 ++
content/cn/docs/introduction/_index.md | 2 ++
.../quickstart/computing/hugegraph-computer.md | 2 ++
.../docs/quickstart/hugegraph/hugegraph-hstore.md | 6 ++---
.../cn/docs/quickstart/hugegraph/hugegraph-pd.md | 2 ++
.../docs/quickstart/hugegraph/hugegraph-server.md | 2 ++
.../docs/quickstart/toolchain/hugegraph-hubble.md | 2 ++
.../docs/quickstart/toolchain/hugegraph-loader.md | 2 ++
content/en/docs/_index.md | 1 +
content/en/docs/clients/_index.md | 2 ++
content/en/docs/clients/restful-api/_index.md | 2 ++
content/en/docs/config/config-authentication.md | 2 ++
content/en/docs/config/config-guide.md | 2 ++
content/en/docs/download/download.md | 2 ++
content/en/docs/introduction/_index.md | 2 ++
.../quickstart/computing/hugegraph-computer.md | 2 ++
.../docs/quickstart/hugegraph/hugegraph-hstore.md | 6 ++---
.../en/docs/quickstart/hugegraph/hugegraph-pd.md | 2 ++
.../docs/quickstart/hugegraph/hugegraph-server.md | 2 ++
.../docs/quickstart/toolchain/hugegraph-hubble.md | 2 ++
.../docs/quickstart/toolchain/hugegraph-loader.md | 2 ++
scripts/test_community_roster.py | 28 ++++++++++++++++++++++
27 files changed, 80 insertions(+), 6 deletions(-)
diff --git a/content/cn/docs/_index.md b/content/cn/docs/_index.md
index 2e3503418..e75800bb3 100755
--- a/content/cn/docs/_index.md
+++ b/content/cn/docs/_index.md
@@ -2,6 +2,7 @@
title: "Documentation"
linkTitle: "Documentation"
weight: 20
+outputs: [HTML, RSS, print, markdown, LLMSFULL]
---
## Apache HugeGraph 文档
diff --git a/content/cn/docs/clients/_index.md b/content/cn/docs/clients/_index.md
index b31bade12..26b2d129f 100644
--- a/content/cn/docs/clients/_index.md
+++ b/content/cn/docs/clients/_index.md
@@ -2,6 +2,8 @@
title: "客户端与 API"
linkTitle: "客户端与 API"
weight: 5
+search_keywords: [HugeGraph 客户端, Java 客户端, 客户端库]
+search_boost: 1.5
---
本节包含 REST API、Gremlin Console 和客户端说明。当前 Server REST API 使用图空间和图名称组成资源路径；具体路径以各 API 页面和 Server 的 OpenAPI 页面为准。
diff --git a/content/cn/docs/clients/restful-api/_index.md b/content/cn/docs/clients/restful-api/_index.md
index 6094321b2..ab79ed10b 100644
--- a/content/cn/docs/clients/restful-api/_index.md
+++ b/content/cn/docs/clients/restful-api/_index.md
@@ -2,6 +2,8 @@
title: "HugeGraph RESTful API"
linkTitle: "RESTful API"
weight: 1
+search_keywords: [HugeGraph REST API, RESTful API, OpenAPI]
+search_boost: 1.7
---
> ⚠️ **版本兼容性说明**
diff --git a/content/cn/docs/config/config-authentication.md b/content/cn/docs/config/config-authentication.md
index 5660a908c..673f42bbb 100644
--- a/content/cn/docs/config/config-authentication.md
+++ b/content/cn/docs/config/config-authentication.md
@@ -2,6 +2,8 @@
title: "HugeGraph 内置用户权限与扩展权限配置及使用"
linkTitle: "权限配置"
weight: 3
+search_keywords: [HugeGraph 认证, 权限配置, StandardAuthenticator]
+search_boost: 1.7
---
### 概述
diff --git a/content/cn/docs/config/config-guide.md b/content/cn/docs/config/config-guide.md
index a0f7d71dc..ab391be16 100644
--- a/content/cn/docs/config/config-guide.md
+++ b/content/cn/docs/config/config-guide.md
@@ -2,6 +2,8 @@
title: "Server 启动指南"
linkTitle: "Server 启动指南"
weight: 1
+search_keywords: [HugeGraph 配置, Server 配置, 配置指南]
+search_boost: 1.6
---
### 1 概述
diff --git a/content/cn/docs/download/download.md b/content/cn/docs/download/download.md
index 831c22faa..38c153ef5 100644
--- a/content/cn/docs/download/download.md
+++ b/content/cn/docs/download/download.md
@@ -2,6 +2,8 @@
title: "下载 Apache HugeGraph"
linkTitle: "Download"
weight: 2
+search_keywords: [HugeGraph 下载, 发布包, SHA512]
+search_boost: 1.7
---
> 指南:
diff --git a/content/cn/docs/introduction/_index.md b/content/cn/docs/introduction/_index.md
index cf0d2ce42..d85133ae5 100644
--- a/content/cn/docs/introduction/_index.md
+++ b/content/cn/docs/introduction/_index.md
@@ -2,6 +2,8 @@
title: "Apache HugeGraph 介绍"
linkTitle: "系统介绍"
weight: 1
+search_keywords: [HugeGraph 介绍, 图数据库简介, 系统架构]
+search_boost: 1.6
aliases:
# Hugo 0.165 prefixes aliases with the current language path.
- /docs/introduction/readme/
diff --git a/content/cn/docs/quickstart/computing/hugegraph-computer.md b/content/cn/docs/quickstart/computing/hugegraph-computer.md
index 8f1596d02..2f11558e3 100644
--- a/content/cn/docs/quickstart/computing/hugegraph-computer.md
+++ b/content/cn/docs/quickstart/computing/hugegraph-computer.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Computer Quick Start"
linkTitle: "使用 Computer 进行 OLAP 分析"
weight: 2
+search_keywords: [HugeGraph Computer, 图计算, OLAP]
+search_boost: 1.6
---
## 1 HugeGraph-Computer 概述
diff --git a/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md b/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
index 4d93a6533..479b07cd1 100644
--- a/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
+++ b/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
@@ -3,10 +3,10 @@ title: "HugeGraph-Store Quick Start"
linkTitle: "安装/构建 HugeGraph-Store"
weight: 3
search_keywords:
+ - HugeGraph HStore
+ - 分布式存储
- server.port
- - REST 端口
- - Store REST 端口
-search_boost: 1.5
+search_boost: 1.6
---
### 1 HugeGraph-Store 概述
diff --git a/content/cn/docs/quickstart/hugegraph/hugegraph-pd.md b/content/cn/docs/quickstart/hugegraph/hugegraph-pd.md
index 4e950f586..545df9673 100644
--- a/content/cn/docs/quickstart/hugegraph/hugegraph-pd.md
+++ b/content/cn/docs/quickstart/hugegraph/hugegraph-pd.md
@@ -2,6 +2,8 @@
title: "HugeGraph-PD Quick Start"
linkTitle: "安装/构建 HugeGraph-PD"
weight: 2
+search_keywords: [HugeGraph PD, 元数据管理, 集群调度]
+search_boost: 1.6
---
### 1 HugeGraph-PD 概述
diff --git a/content/cn/docs/quickstart/hugegraph/hugegraph-server.md b/content/cn/docs/quickstart/hugegraph/hugegraph-server.md
index ab6871dcf..588b90346 100644
--- a/content/cn/docs/quickstart/hugegraph/hugegraph-server.md
+++ b/content/cn/docs/quickstart/hugegraph/hugegraph-server.md
@@ -2,6 +2,8 @@
title: "HugeGraph Server 快速开始"
linkTitle: "安装/构建 HugeGraph Server"
weight: 1
+search_keywords: [HugeGraph Server, Server 快速开始, 图数据库服务]
+search_boost: 1.7
aliases:
- /docs/quickstart/hugegraph-server/
---
diff --git a/content/cn/docs/quickstart/toolchain/hugegraph-hubble.md b/content/cn/docs/quickstart/toolchain/hugegraph-hubble.md
index 1d0e38077..e19d140d2 100644
--- a/content/cn/docs/quickstart/toolchain/hugegraph-hubble.md
+++ b/content/cn/docs/quickstart/toolchain/hugegraph-hubble.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Hubble Quick Start"
linkTitle: "使用 Hubble 实现图可视化"
weight: 1
+search_keywords: [HugeGraph Hubble, 图可视化, Web 管理界面]
+search_boost: 1.6
---
### 1 HugeGraph-Hubble 概述
diff --git a/content/cn/docs/quickstart/toolchain/hugegraph-loader.md b/content/cn/docs/quickstart/toolchain/hugegraph-loader.md
index 6816fa781..159bb99a1 100644
--- a/content/cn/docs/quickstart/toolchain/hugegraph-loader.md
+++ b/content/cn/docs/quickstart/toolchain/hugegraph-loader.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Loader Quick Start"
linkTitle: "使用 Loader 实时/流式导入数据"
weight: 2
+search_keywords: [HugeGraph Loader, 批量导入, 数据导入]
+search_boost: 1.6
---
### 1 HugeGraph-Loader 概述
diff --git a/content/en/docs/_index.md b/content/en/docs/_index.md
index a9cd5fbca..7b1c7b8ee 100755
--- a/content/en/docs/_index.md
+++ b/content/en/docs/_index.md
@@ -2,6 +2,7 @@
title: "Documentation"
linkTitle: "Documentation"
weight: 20
+outputs: [HTML, RSS, print, markdown, LLMSFULL]
---
## Apache HugeGraph Documentation
diff --git a/content/en/docs/clients/_index.md b/content/en/docs/clients/_index.md
index 48a709f4f..76a9ddfb5 100644
--- a/content/en/docs/clients/_index.md
+++ b/content/en/docs/clients/_index.md
@@ -2,6 +2,8 @@
title: "Clients and APIs"
linkTitle: "Clients and APIs"
weight: 5
+search_keywords: [HugeGraph clients, Java client, client libraries]
+search_boost: 1.5
---
This section covers the REST API, Gremlin Console, and client libraries. The current Server REST API identifies graph resources with both a graph space and a graph name. Refer to each API page and the Server OpenAPI page for the exact paths.
diff --git a/content/en/docs/clients/restful-api/_index.md b/content/en/docs/clients/restful-api/_index.md
index 7c35ce9e3..3b651a5e8 100644
--- a/content/en/docs/clients/restful-api/_index.md
+++ b/content/en/docs/clients/restful-api/_index.md
@@ -2,6 +2,8 @@
title: "HugeGraph RESTful API"
linkTitle: "RESTful API"
weight: 1
+search_keywords: [HugeGraph REST API, RESTful API, OpenAPI]
+search_boost: 1.7
---
> ⚠️ **Version compatibility notes**
diff --git a/content/en/docs/config/config-authentication.md b/content/en/docs/config/config-authentication.md
index 1f646635f..bb58fa26d 100644
--- a/content/en/docs/config/config-authentication.md
+++ b/content/en/docs/config/config-authentication.md
@@ -2,6 +2,8 @@
title: "Built-in User Authentication and Authorization Configuration and Usage in HugeGraph"
linkTitle: "Config Authentication"
weight: 3
+search_keywords: [HugeGraph authentication, authorization, StandardAuthenticator]
+search_boost: 1.7
---
### Overview
diff --git a/content/en/docs/config/config-guide.md b/content/en/docs/config/config-guide.md
index 6798cd5fa..53bd6e587 100644
--- a/content/en/docs/config/config-guide.md
+++ b/content/en/docs/config/config-guide.md
@@ -2,6 +2,8 @@
title: "Server Startup Guide"
linkTitle: "Server Startup Guide"
weight: 1
+search_keywords: [HugeGraph configuration, server config, configuration guide]
+search_boost: 1.6
---
### 1 Overview
diff --git a/content/en/docs/download/download.md b/content/en/docs/download/download.md
index a23907c5c..2d0c84b92 100644
--- a/content/en/docs/download/download.md
+++ b/content/en/docs/download/download.md
@@ -2,6 +2,8 @@
title: "Download Apache HugeGraph"
linkTitle: "Download"
weight: 2
+search_keywords: [HugeGraph download, release artifacts, SHA512]
+search_boost: 1.7
---
diff --git a/content/en/docs/introduction/_index.md b/content/en/docs/introduction/_index.md
index 81ca606c8..83d8bb1f5 100644
--- a/content/en/docs/introduction/_index.md
+++ b/content/en/docs/introduction/_index.md
@@ -2,6 +2,8 @@
title: "Apache HugeGraph Introduction"
linkTitle: "System Introduction"
weight: 1
+search_keywords: [HugeGraph overview, graph database introduction, architecture]
+search_boost: 1.6
aliases:
# Hugo 0.165 prefixes aliases with the current language path.
- /docs/introduction/readme/
diff --git a/content/en/docs/quickstart/computing/hugegraph-computer.md b/content/en/docs/quickstart/computing/hugegraph-computer.md
index 92b84d454..5327259a3 100644
--- a/content/en/docs/quickstart/computing/hugegraph-computer.md
+++ b/content/en/docs/quickstart/computing/hugegraph-computer.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Computer Quick Start"
linkTitle: "Analysis with HugeGraph-Computer"
weight: 2
+search_keywords: [HugeGraph Computer, graph computing, OLAP]
+search_boost: 1.6
---
## 1 HugeGraph-Computer Overview
diff --git a/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md b/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
index 7e98b0e07..c14602b79 100644
--- a/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
+++ b/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
@@ -3,10 +3,10 @@ title: "HugeGraph-Store Quick Start"
linkTitle: "Install/Build HugeGraph-Store"
weight: 3
search_keywords:
+ - HugeGraph HStore
+ - distributed storage
- server.port
- - REST port
- - Store REST port
-search_boost: 1.5
+search_boost: 1.6
---
### 1 HugeGraph-Store Overview
diff --git a/content/en/docs/quickstart/hugegraph/hugegraph-pd.md b/content/en/docs/quickstart/hugegraph/hugegraph-pd.md
index 5dac8352d..7f6382962 100644
--- a/content/en/docs/quickstart/hugegraph/hugegraph-pd.md
+++ b/content/en/docs/quickstart/hugegraph/hugegraph-pd.md
@@ -2,6 +2,8 @@
title: "HugeGraph-PD Quick Start"
linkTitle: "Install/Build HugeGraph-PD"
weight: 2
+search_keywords: [HugeGraph PD, placement driver, cluster metadata]
+search_boost: 1.6
---
### 1 HugeGraph-PD Overview
diff --git a/content/en/docs/quickstart/hugegraph/hugegraph-server.md b/content/en/docs/quickstart/hugegraph/hugegraph-server.md
index ddc012aba..93bcb0608 100644
--- a/content/en/docs/quickstart/hugegraph/hugegraph-server.md
+++ b/content/en/docs/quickstart/hugegraph/hugegraph-server.md
@@ -2,6 +2,8 @@
title: "HugeGraph Server Quick Start"
linkTitle: "Install/Build HugeGraph Server"
weight: 1
+search_keywords: [HugeGraph Server, server quickstart, graph database]
+search_boost: 1.7
aliases:
- /docs/quickstart/hugegraph-server/
---
diff --git a/content/en/docs/quickstart/toolchain/hugegraph-hubble.md b/content/en/docs/quickstart/toolchain/hugegraph-hubble.md
index 2380518b5..9aed8e4f7 100644
--- a/content/en/docs/quickstart/toolchain/hugegraph-hubble.md
+++ b/content/en/docs/quickstart/toolchain/hugegraph-hubble.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Hubble Quick Start"
linkTitle: "Visual with HugeGraph-Hubble"
weight: 1
+search_keywords: [HugeGraph Hubble, graph visualization, web console]
+search_boost: 1.6
---
### 1 HugeGraph-Hubble Overview
diff --git a/content/en/docs/quickstart/toolchain/hugegraph-loader.md b/content/en/docs/quickstart/toolchain/hugegraph-loader.md
index 5630f0e97..3a297f986 100644
--- a/content/en/docs/quickstart/toolchain/hugegraph-loader.md
+++ b/content/en/docs/quickstart/toolchain/hugegraph-loader.md
@@ -2,6 +2,8 @@
title: "HugeGraph-Loader Quick Start"
linkTitle: "Load data with HugeGraph-Loader"
weight: 2
+search_keywords: [HugeGraph Loader, bulk import, data loading]
+search_boost: 1.6
---
### 1 HugeGraph-Loader Overview
diff --git a/scripts/test_community_roster.py b/scripts/test_community_roster.py
index e01c441b8..7f2b4bdcf 100644
--- a/scripts/test_community_roster.py
+++ b/scripts/test_community_roster.py
@@ -49,5 +49,33 @@ class CommunityRosterTests(unittest.TestCase):
self.assertEqual(original, roster.ROSTER_PATH.read_bytes())
+class CommunityContentContractTests(unittest.TestCase):
+ def test_search_metadata_covers_fixed_bilingual_entries(self):
+ entries = [
+ "docs/introduction/_index.md",
+ "docs/quickstart/hugegraph/hugegraph-server.md",
+ "docs/quickstart/hugegraph/hugegraph-hstore.md",
+ "docs/quickstart/hugegraph/hugegraph-pd.md",
+ "docs/quickstart/computing/hugegraph-computer.md",
+ "docs/quickstart/toolchain/hugegraph-loader.md",
+ "docs/quickstart/toolchain/hugegraph-hubble.md",
+ "docs/clients/_index.md",
+ "docs/clients/restful-api/_index.md",
+ "docs/config/config-guide.md",
+ "docs/config/config-authentication.md",
+ "docs/download/download.md",
+ ]
+ for language in ("en", "cn"):
+ for relative in entries:
+ text = (ROOT / "content" / language / relative).read_text(encoding="utf-8")
+ self.assertIn("search_keywords:", text, f"{language}/{relative}")
+ self.assertIn("search_boost:", text, f"{language}/{relative}")
+
+ def test_docs_roots_enable_llmsfull_only_in_front_matter(self):
+ for language in ("en", "cn"):
+ text = (ROOT / "content" / language / "docs/_index.md").read_text(encoding="utf-8")
+ self.assertIn("LLMSFULL", text.split("---", 2)[1])
+
+
if __name__ == "__main__":
unittest.main()