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/18 18:28:09 UTC
(hugegraph-doc) branch staging/oink-reviewed updated (659f94dd3 -> 3a2276af0)
This is an automated email from the ASF dual-hosted git repository.
imbajin pushed a change to branch staging/oink-reviewed
in repository https://gitbox.apache.org/repos/asf/hugegraph-doc.git
from 659f94dd3 fix(docs): preserve oink table rendering
add f3d12c883 fix(community): refine github member cards
add bebd7fe4b docs(community): refresh roster screenshots
add 2d30ffa40 fix(community): apply member title styling
add 6da3dc1d5 fix(community): expose public names to assistive tech
add 5b35f58fb docs(community): refresh accessible roster screenshots
add 00495a9aa fix(community): keep member names readable on mobile
add 19bb2c2ce docs(community): focus pr visual evidence
add 2afe924b8 docs(download): add focused desktop evidence
add bfafe24d1 fix(community): refine roster labels and card surfaces
add 7eb368b40 fix(community): fill unified member surfaces
add 267bce602 docs(community): refresh roster comparison evidence
add c590963c2 fix(community): keep only explicit name overrides
add 6c6817c0c fix(ci): stabilize rerun artifacts
add 225537d14 fix(community): update member display names
add d25c82d75 fix(site): resolve review follow-ups
add b983f2bed fix(search): surface Ask AI tail
add 097d799bb feat(search): offer AI for empty results
add 127dd19a8 docs(community): connect contributor pathways
new 3a2276af0 fix(docs): open primary sidebar groups
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../oink-evidence/cn-community-mobile-dark.webp | Bin 118690 -> 126654 bytes
.../en-ask-ai-consent-desktop-light.webp | Bin 0 -> 54872 bytes
.../en-ask-ai-search-tail-desktop-light.webp | Bin 0 -> 47008 bytes
.../en-community-after-desktop-light.webp | Bin 0 -> 46910 bytes
.../en-community-before-desktop-light.webp | Bin 0 -> 32624 bytes
.../oink-evidence/en-community-desktop-light.webp | Bin 163648 -> 46910 bytes
.../oink-evidence/en-community-mobile-light.webp | Bin 0 -> 25012 bytes
.../oink-evidence/en-download-desktop-light.webp | Bin 0 -> 85128 bytes
.github/workflows/hugo.yml | 23 +-
assets/js/hugegraph-shell.js | 34 ++-
assets/js/kapa-adapter.js | 15 ++
assets/scss/_styles_project.scss | 18 ++
assets/scss/community-members.scss | 71 ++++--
content/cn/docs/_nav/operate.md | 4 +-
content/cn/docs/clients/restful-api/vertex.md | 106 ++++-----
content/en/docs/clients/restful-api/vertex.md | 94 ++++----
data/community/github-map.json | 90 +++++++-
data/community/roster.json | 249 ++++++++++++++-------
data/landing/community/cn.yaml | 12 +-
data/landing/community/en.yaml | 12 +-
dist/validate-site-output.py | 2 +-
hugo.yaml | 2 +-
i18n/en.yaml | 3 +-
i18n/zh-CN.yaml | 3 +-
layouts/_partials/community/members.html | 18 +-
layouts/_partials/community/members.md | 13 +-
layouts/_partials/hooks/body-end.html | 1 +
scripts/community_roster.py | 59 ++++-
scripts/test_community_roster.py | 47 +++-
scripts/versioning.py | 2 +-
...c0bfd0064d012d3de1d57dec883c3e3fa6901d3f85.webp | Bin 0 -> 1170 bytes
...9ee51aee806047a84fecaed5829893494dbd35736b.webp | Bin 0 -> 1104 bytes
...808268a96e04b8acb73f1e9dc8a4c1cd9053ce65b0.webp | Bin 0 -> 3224 bytes
...64df2ef2131eaf935f9e8abf69e468cbeb1474ac75.webp | Bin 0 -> 2002 bytes
...316117bfb1d1bbee78ea050d920047f3e9874f81f1.webp | Bin 0 -> 3880 bytes
...dadfc559f0002ef1b63a2a517fda0cd5a09f4a820d.webp | Bin 0 -> 3654 bytes
...26876ae28f5f44d874454d197fd5f7a08595f8d7a3.webp | Bin 0 -> 376 bytes
...ab4eab361172ebb3dae217a71f79b7531a7637abdc.webp | Bin 0 -> 3274 bytes
...812c769f481b73cf9d8f1d6d985e865d87e633e36a.webp | Bin 0 -> 1326 bytes
...40aada61a514377c349d8fed86f091792b303e76e0.webp | Bin 0 -> 1406 bytes
...9de0439a8cedd7c8ab613b49be5e75991f98c78dac.webp | Bin 0 -> 3602 bytes
...ea1b7782a18a74ed0957ca02c1ac16e1bfa58c899f.webp | Bin 0 -> 2910 bytes
...26030f37ae54cdc12eac678debcd8989b12f64ee59.webp | Bin 0 -> 2858 bytes
...c2e555b619058c665b2cc67eadac43df2e454b68e6.webp | Bin 0 -> 2662 bytes
...76c1767bc21d05f4a7ed018bc232cdc0c83cbf2346.webp | Bin 0 -> 5264 bytes
...32f5d00c5701e4384bb4414126ccfccb9dadacfe1a.webp | Bin 0 -> 1408 bytes
...cd6b6df651b1459206d2973b8bbb5bd302015d1a14.webp | Bin 0 -> 2412 bytes
...ee2aa2baadb2b03b284dfb3b6159e792fb9a44e31d.webp | Bin 0 -> 2966 bytes
...793429fe405a8846fb2994d700d079b9215786aa17.webp | Bin 0 -> 3952 bytes
tests/e2e/artifact-test.js | 22 +-
tests/e2e/platform.spec.js | 42 +++-
tests/e2e/workflow-contract.test.cjs | 10 +
52 files changed, 687 insertions(+), 265 deletions(-)
create mode 100644 .github/oink-evidence/en-ask-ai-consent-desktop-light.webp
create mode 100644 .github/oink-evidence/en-ask-ai-search-tail-desktop-light.webp
create mode 100644 .github/oink-evidence/en-community-after-desktop-light.webp
create mode 100644 .github/oink-evidence/en-community-before-desktop-light.webp
create mode 100644 .github/oink-evidence/en-community-mobile-light.webp
create mode 100644 .github/oink-evidence/en-download-desktop-light.webp
create mode 100644 static/img/community/avatars/045e2234792e0baba143f9c0bfd0064d012d3de1d57dec883c3e3fa6901d3f85.webp
create mode 100644 static/img/community/avatars/08f13d01a0fc2048ef26199ee51aee806047a84fecaed5829893494dbd35736b.webp
create mode 100644 static/img/community/avatars/266c764e5bf245a1e02fbb808268a96e04b8acb73f1e9dc8a4c1cd9053ce65b0.webp
create mode 100644 static/img/community/avatars/2b8f6cf3f85038d5a0668a64df2ef2131eaf935f9e8abf69e468cbeb1474ac75.webp
create mode 100644 static/img/community/avatars/3953b178d91c3cfec7f994316117bfb1d1bbee78ea050d920047f3e9874f81f1.webp
create mode 100644 static/img/community/avatars/55d7d9385e8d21e38d7cfcdadfc559f0002ef1b63a2a517fda0cd5a09f4a820d.webp
create mode 100644 static/img/community/avatars/62e0171bfb271e4938963a26876ae28f5f44d874454d197fd5f7a08595f8d7a3.webp
create mode 100644 static/img/community/avatars/657d7c6a76e43a96d9da26ab4eab361172ebb3dae217a71f79b7531a7637abdc.webp
create mode 100644 static/img/community/avatars/695bd7904d7f4cfab98b7d812c769f481b73cf9d8f1d6d985e865d87e633e36a.webp
create mode 100644 static/img/community/avatars/6962957beb238414dd798740aada61a514377c349d8fed86f091792b303e76e0.webp
create mode 100644 static/img/community/avatars/7590d40579ad10dacf0a2f9de0439a8cedd7c8ab613b49be5e75991f98c78dac.webp
create mode 100644 static/img/community/avatars/87ba3c0066e31c0f584706ea1b7782a18a74ed0957ca02c1ac16e1bfa58c899f.webp
create mode 100644 static/img/community/avatars/ab585341e46cfbf10b3fe426030f37ae54cdc12eac678debcd8989b12f64ee59.webp
create mode 100644 static/img/community/avatars/af583d1e4ffed9bc08ef7ec2e555b619058c665b2cc67eadac43df2e454b68e6.webp
create mode 100644 static/img/community/avatars/c936571abaf109fd7049f976c1767bc21d05f4a7ed018bc232cdc0c83cbf2346.webp
create mode 100644 static/img/community/avatars/ce12f31198b55a4acaf56732f5d00c5701e4384bb4414126ccfccb9dadacfe1a.webp
create mode 100644 static/img/community/avatars/d3ecd2b51f116bece9a9c4cd6b6df651b1459206d2973b8bbb5bd302015d1a14.webp
create mode 100644 static/img/community/avatars/d959beeff7a37e2528ca79ee2aa2baadb2b03b284dfb3b6159e792fb9a44e31d.webp
create mode 100644 static/img/community/avatars/df8a3cbc33555abcdef083793429fe405a8846fb2994d700d079b9215786aa17.webp
(hugegraph-doc) 01/01: fix(docs): open primary sidebar groups
Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
imbajin pushed a commit to branch staging/oink-reviewed
in repository https://gitbox.apache.org/repos/asf/hugegraph-doc.git
commit 3a2276af034d2c8e1a9f8414eb6b0442223c3e31
Author: dark <ji...@apache.org>
AuthorDate: Sat Sep 19 02:27:53 2026 +0800
fix(docs): open primary sidebar groups
- expand Start and Components on docs home
- preserve explicit sidebar choices across reloads
- rename Operations to Configuration in Chinese navigation
- keep Community Markdown copy aligned with HTML
---
assets/js/hugegraph-shell.js | 34 +++++++++++++++++++++++++++-------
content/cn/docs/_nav/operate.md | 4 ++--
dist/validate-site-output.py | 2 +-
hugo.yaml | 2 +-
layouts/_partials/community/members.md | 4 ++--
scripts/versioning.py | 2 +-
tests/e2e/platform.spec.js | 28 +++++++++++++++++++++++++++-
7 files changed, 61 insertions(+), 15 deletions(-)
diff --git a/assets/js/hugegraph-shell.js b/assets/js/hugegraph-shell.js
index d6c371bb9..c7c45b5af 100644
--- a/assets/js/hugegraph-shell.js
+++ b/assets/js/hugegraph-shell.js
@@ -52,7 +52,7 @@
if (!buttons.length) return;
var storage = safeStorage(windowObject);
var key =
- 'oink.sidebar.v1.' +
+ 'oink.sidebar.v2.' +
String(config.version || 'latest') +
'.' +
String(config.locale || 'en');
@@ -62,9 +62,12 @@
}),
);
var saved = [];
+ var hasSavedState = false;
if (storage) {
try {
- var parsed = JSON.parse(storage.getItem(key) || '[]');
+ var stored = storage.getItem(key);
+ hasSavedState = stored !== null;
+ var parsed = JSON.parse(stored || '[]');
if (Array.isArray(parsed)) {
saved = parsed.filter(function (id) {
return typeof id === 'string' && valid.has(id);
@@ -75,13 +78,19 @@
}
}
var remembered = new Set(saved);
+ var docsRoot = /\/(?:cn\/)?docs\/?$/.test(windowObject.location.pathname);
buttons.forEach(function (button) {
var item = button.closest('li');
var activePath = item && item.classList.contains('td-active-path');
+ var control = button.getAttribute('aria-controls') || '';
+ var defaultOpen =
+ !hasSavedState &&
+ docsRoot &&
+ /_nav(?:start|components)-children$/.test(control);
setTreeExpanded(
button,
- Boolean(activePath || remembered.has(button.getAttribute('aria-controls'))),
+ Boolean(activePath || remembered.has(control) || defaultOpen),
documentObject,
);
button.addEventListener('click', function () {
@@ -108,11 +117,22 @@
});
});
- // Rewriting the filtered set removes stale node IDs after navigation
- // changes without retaining a second schema/version marker.
- if (storage) {
+ // Seed the new persistence schema once so the docs-home defaults survive
+ // reloads; later clicks replace this set with the user's choices.
+ if (storage && !hasSavedState) {
try {
- storage.setItem(key, JSON.stringify(saved));
+ var initial = buttons
+ .filter(function (button) {
+ var item = button.closest('li');
+ return (
+ button.getAttribute('aria-expanded') === 'true' &&
+ !(item && item.classList.contains('td-active-path'))
+ );
+ })
+ .map(function (button) {
+ return button.getAttribute('aria-controls');
+ });
+ storage.setItem(key, JSON.stringify(initial));
} catch (_) {
/* Ignore storage becoming unavailable after the probe. */
}
diff --git a/content/cn/docs/_nav/operate.md b/content/cn/docs/_nav/operate.md
index 5516b6ab7..99b13577a 100644
--- a/content/cn/docs/_nav/operate.md
+++ b/content/cn/docs/_nav/operate.md
@@ -1,6 +1,6 @@
---
-title: "运维"
-linkTitle: "运维"
+title: "配置"
+linkTitle: "配置"
description: "从配置开始,再查看安全、备份和性能调优指南。"
manual_link: /cn/docs/config/
search_exclude: true
diff --git a/dist/validate-site-output.py b/dist/validate-site-output.py
index 28a5b82e1..4b9894037 100644
--- a/dist/validate-site-output.py
+++ b/dist/validate-site-output.py
@@ -74,7 +74,7 @@ ERROR_DOCUMENT_PATHS = {
}
DOCS_NAV_GROUP_TITLES = {
"en": ("Get Started", "Components", "Develop", "Operate", "Reference"),
- "cn": ("开始", "组件", "开发", "运维", "参考"),
+ "cn": ("开始", "组件", "开发", "配置", "参考"),
}
EXTERNAL_ACTIVE_RESOURCE_ATTRIBUTES = {
("script", "src"),
diff --git a/hugo.yaml b/hugo.yaml
index d276b93c5..93a313c00 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -45,7 +45,7 @@ languages:
- { identifier: docs-start, parent: docs, name: 开始, pageRef: /docs/quickstart, weight: 11, params: { icon: 'fa-solid fa-rocket' } }
- { identifier: docs-components, parent: docs, name: 组件, pageRef: /docs/quickstart/hugegraph, weight: 12, params: { icon: 'fa-solid fa-cubes' } }
- { identifier: docs-develop, parent: docs, name: 开发, pageRef: /docs/clients, weight: 13, params: { icon: 'fa-solid fa-code' } }
- - { identifier: docs-operate, parent: docs, name: 运维, pageRef: /docs/config, weight: 14, params: { icon: 'fa-solid fa-screwdriver-wrench' } }
+ - { identifier: docs-operate, parent: docs, name: 配置, pageRef: /docs/config, weight: 14, params: { icon: 'fa-solid fa-screwdriver-wrench' } }
- { identifier: docs-reference, parent: docs, name: 参考, pageRef: /docs/changelog, weight: 15, params: { icon: 'fa-solid fa-book-open' } }
- { identifier: download, name: 下载, pageRef: /docs/download/download, weight: 20 }
- { identifier: blog, name: 博客, pageRef: /blog, weight: 30 }
diff --git a/layouts/_partials/community/members.md b/layouts/_partials/community/members.md
index 6be6414a3..36622e13f 100644
--- a/layouts/_partials/community/members.md
+++ b/layouts/_partials/community/members.md
@@ -1,8 +1,8 @@
{{- $page := .page -}}
{{- $data := hugo.Data.community.roster -}}
{{- $labels := dict
- "en" (dict "title" "Project members" "lead" "Current Apache HugeGraph PMC members and Committers, sourced from public ASF records." "chair" "Chair")
- "cn" (dict "title" "项目成员" "lead" "Apache HugeGraph 当前的 PMC 成员与 Committers,数据来自 ASF 公开记录。" "chair" "主席")
+ "en" (dict "title" "Project members" "lead" "Current Apache HugeGraph PMC members and Committers, sourced from ASF records." "chair" "Chair")
+ "cn" (dict "title" "项目成员" "lead" "Apache HugeGraph 当前的 PMC 成员与 Committers,数据来自 ASF 记录。" "chair" "主席")
-}}
{{- $copy := index $labels $page.Language.Lang | default (index $labels "en") -}}
## {{ $copy.title }}
diff --git a/scripts/versioning.py b/scripts/versioning.py
index 1b30f3beb..84d9a2d5f 100644
--- a/scripts/versioning.py
+++ b/scripts/versioning.py
@@ -123,7 +123,7 @@ LANGUAGE_OPTION_TITLES = {"en-US": "English", "zh-CN": "简体中文"}
DOCS_NAV_GROUP_IDS = ("start", "components", "develop", "operate", "reference")
DOCS_NAV_GROUP_TITLES = {
"en": ("Get Started", "Components", "Develop", "Operate", "Reference"),
- "cn": ("开始", "组件", "开发", "运维", "参考"),
+ "cn": ("开始", "组件", "开发", "配置", "参考"),
}
DOCS_NAV_EXPECTED_STATS = {
"latest": {
diff --git a/tests/e2e/platform.spec.js b/tests/e2e/platform.spec.js
index ebed648b7..98f47386a 100644
--- a/tests/e2e/platform.spec.js
+++ b/tests/e2e/platform.spec.js
@@ -4,7 +4,7 @@ for (const locale of ["en", "cn"]) {
const prefix = locale === "cn" ? "/cn" : "";
test(`latest ${locale} sidebar persists and isolates collapse`, async ({ page }) => {
await page.goto(`${prefix}/docs/introduction/`);
- const key = `oink.sidebar.v1.latest.${locale}`;
+ const key = `oink.sidebar.v2.latest.${locale}`;
await expect.poll(() => page.evaluate((name) => localStorage.getItem(name), key))
.not.toBeNull();
const toggle = page
@@ -57,6 +57,32 @@ for (const locale of ["en", "cn"]) {
});
}
+for (const locale of ["en", "cn"]) {
+ const prefix = locale === "cn" ? "/cn" : "";
+ test(`latest ${locale} docs home opens start and components by default`, async ({ page }) => {
+ const key = `oink.sidebar.v2.latest.${locale}`;
+ await page.goto(`${prefix}/docs/`);
+ await page.evaluate((name) => localStorage.removeItem(name), key);
+ await page.reload();
+ const start = page.locator(
+ '#td-shell-sidebar [data-td-shell-tree-toggle][aria-controls$="_navstart-children"]',
+ );
+ const components = page.locator(
+ '#td-shell-sidebar [data-td-shell-tree-toggle][aria-controls$="_navcomponents-children"]',
+ );
+ const develop = page.locator(
+ '#td-shell-sidebar [data-td-shell-tree-toggle][aria-controls$="_navdevelop-children"]',
+ );
+ await expect(start).toHaveAttribute("aria-expanded", "true");
+ await expect(components).toHaveAttribute("aria-expanded", "true");
+ await expect(develop).toHaveAttribute("aria-expanded", "false");
+ await start.click();
+ await page.reload();
+ await expect(page.locator(`[aria-controls="${await start.getAttribute("aria-controls")}"]`))
+ .toHaveAttribute("aria-expanded", "false");
+ });
+}
+
test("disabled AI emits no UI or Kapa request", async ({ page }) => {
const kapaRequests = [];
page.on("request", (request) => {