Skip to content

Commit 8309e84

Browse files
authored
refactor: migrate hugegraph website to TLP layout (#454)
* chore: migrate hugegraph docs to tlp layout - replace incubator URLs/repos with TLP paths across docs and metadata - update release validation/deploy scripts with --layout auto|tlp|incubator - align workflow and release guidelines to PMC-only voting after Jan 2026 graduation - keep historical incubating package compatibility with conditional DISCLAIMER checks * chore: simplify release flow to tlp only - remove incubator fallback logic from release validation and deploy scripts - enforce non-incubating package naming in script and CI checks - drop layout options and keep dist/download paths TLP-only - update dist README to match the simplified post-graduation workflow * docs(homepage): align graph-system copy and paths - update CN/EN homepage hero copy from graph database to graph system - add internal links for core components, query languages, and highlighted capabilities - switch homepage download CTA to docs download page and add toolchain entry - normalize introduction docs to section index pages (_index.md) - add aliases and update references to keep old introduction/readme links compatible
1 parent 7e7bbba commit 8309e84

File tree

58 files changed

+1412
-1304
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

58 files changed

+1412
-1304
lines changed

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
44
Some tips for you:
55
1. If this is your first time to submit PR, please read the
6-
[contributing guidelines](https://github.com/apache/incubator-hugegraph-doc/blob/master/contribution.md)
6+
[contributing guidelines](https://github.com/apache/hugegraph-doc/blob/master/contribution.md)
77
88
2. If a PR fix/close an issue, type the message "close xxx" below (Remember to update both EN & CN doc)
99
@@ -15,4 +15,3 @@
1515
- close #xxx <!-- or "fix #xxx", "link #xxx" -->
1616

1717
<!-- Better to paste the screenshot diff here, "xxx" is the ID-link of related issue, e.g: #1024 -->
18-

.github/workflows/validate-release.yml

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ jobs:
2525
runs-on: ${{ matrix.os }}
2626
env:
2727
SCRIPT_PATH: hugegraph-dist/scripts/
28-
URL_PREFIX: https://dist.apache.org/repos/dist/dev/incubator/hugegraph/
28+
URL_PREFIX: https://dist.apache.org/repos/dist/dev/hugegraph/
2929
USER: ${{ inputs.gpg_user }}
3030
# TODO: parse version from the running branch name & also adapt the input version
3131
RELEASE_VERSION: ''
@@ -70,6 +70,10 @@ jobs:
7070
if [[ ${{ matrix.os }} =~ "ubuntu" ]]; then
7171
sudo apt-get install -y subversion
7272
fi
73+
if ! svn ls "${URL_PREFIX}/${{ inputs.release_version }}/" >/dev/null 2>&1; then
74+
echo "Release path not found: ${URL_PREFIX}/${{ inputs.release_version }}/" && exit 1
75+
fi
76+
echo "Using SVN prefix: ${URL_PREFIX}"
7377
rm -rf dist/${{ inputs.release_version }}
7478
svn co ${URL_PREFIX}/${{ inputs.release_version }} dist/${{ inputs.release_version }}
7579
@@ -80,7 +84,7 @@ jobs:
8084
shasum --version 1>/dev/null || exit
8185
gpg --version 1>/dev/null || exit
8286
83-
wget https://downloads.apache.org/incubator/hugegraph/KEYS || exit
87+
wget https://downloads.apache.org/hugegraph/KEYS || exit
8488
echo "Import KEYS:" && gpg --import KEYS
8589
# TODO: how to trust all public keys in gpg list, currently only trust the first one
8690
echo -e "5\ny\n" | gpg --batch --command-fd 0 --edit-key $USER trust
@@ -110,25 +114,25 @@ jobs:
110114
for i in *src.tar.gz; do
111115
echo "$i"
112116
113-
# 4.1 check the directory name include "incubating"
114-
if [[ ! "$i" =~ "incubating" ]]; then
115-
echo "The package name $i should include incubating" && exit 1
117+
# 4.1 package naming should follow post-graduation TLP naming
118+
if [[ ! "$i" =~ ^apache-hugegraph ]]; then
119+
echo "The package name $i should start with apache-hugegraph" && exit 1
120+
fi
121+
if [[ "$i" =~ "incubating" ]]; then
122+
echo "The package name $i should not contain incubating in post-graduation releases" && exit 1
116123
fi
117124
118125
tar xzvf "$i" || exit
119126
pushd "$(basename "$i" .tar.gz)" || exit
120127
echo "Start to check the package content: $(basename "$i" .tar.gz)"
121128
122-
# 4.2 check the directory include "NOTICE" and "LICENSE" and "DISCLAIMER" file
129+
# 4.2 check the directory include "NOTICE" and "LICENSE" file
123130
if [[ ! -f "LICENSE" ]]; then
124131
echo "The package should include LICENSE file" && exit 1
125132
fi
126133
if [[ ! -f "NOTICE" ]]; then
127134
echo "The package should include NOTICE file" && exit 1
128135
fi
129-
if [[ ! -f "DISCLAIMER" ]]; then
130-
echo "The package should include DISCLAIMER file" && exit 1
131-
fi
132136
133137
# 4.3: ensure doesn't contains ASF CATEGORY X License dependencies in LICENSE and NOTICE files
134138
COUNT=$(grep -E "$CATEGORY_X" LICENSE NOTICE | wc -l)
@@ -191,7 +195,7 @@ jobs:
191195
cd dist/${{ inputs.release_version }} || exit
192196
193197
ls -lh
194-
pushd ./*hugegraph-incubating*src/hugegraph-server/*hugegraph*${{ inputs.release_version }} || exit
198+
pushd ./*hugegraph*${{ inputs.release_version }}*src/hugegraph-server/*hugegraph-server*${{ inputs.release_version }}* || exit
195199
bin/init-store.sh || exit
196200
sleep 3
197201
bin/start-hugegraph.sh || exit
@@ -233,7 +237,7 @@ jobs:
233237
popd || exit
234238
popd || exit
235239
# stop server
236-
pushd ./*hugegraph-incubating*src/hugegraph-server/*hugegraph*${{ inputs.release_version }} || exit
240+
pushd ./*hugegraph*${{ inputs.release_version }}*src/hugegraph-server/*hugegraph-server*${{ inputs.release_version }}* || exit
237241
bin/stop-hugegraph.sh || exit
238242
popd || exit
239243
@@ -253,26 +257,26 @@ jobs:
253257
254258
echo "$i"
255259
256-
# 7.1 check the directory name include "incubating"
257-
if [[ ! "$i" =~ "incubating" ]]; then
258-
echo "The package name $i should include incubating" && exit 1
260+
# 7.1 package naming should follow post-graduation TLP naming
261+
if [[ ! "$i" =~ ^apache-hugegraph ]]; then
262+
echo "The package name $i should start with apache-hugegraph" && exit 1
263+
fi
264+
if [[ "$i" =~ "incubating" ]]; then
265+
echo "The package name $i should not contain incubating in post-graduation releases" && exit 1
259266
fi
260267
261268
tar xzvf "$i" || exit
262269
pushd "$(basename "$i" .tar.gz)" || exit
263270
ls -lh
264271
echo "Start to check the package content: $(basename "$i" .tar.gz)"
265272
266-
# 7.2 check root dir include "NOTICE"/"LICENSE"/"DISCLAIMER" & "licenses" dir
273+
# 7.2 check root dir include "NOTICE"/"LICENSE" & "licenses" dir
267274
if [[ ! -f "LICENSE" ]]; then
268275
echo "The package should include LICENSE file" && exit 1
269276
fi
270277
if [[ ! -f "NOTICE" ]]; then
271278
echo "The package should include NOTICE file" && exit 1
272279
fi
273-
if [[ ! -f "DISCLAIMER" ]]; then
274-
echo "The package should include DISCLAIMER file" && exit 1
275-
fi
276280
if [[ ! -d "licenses" ]]; then
277281
echo "The package should include licenses dir" && exit 1
278282
fi
@@ -302,7 +306,7 @@ jobs:
302306
cd dist/${{ inputs.release_version }} || exit
303307
304308
# TODO: run pd & store
305-
pushd ./*hugegraph-incubating*${{ inputs.release_version }}/*hugegraph-server-incubating*${{ inputs.release_version }} || exit
309+
pushd ./*hugegraph*${{ inputs.release_version }}*/*hugegraph-server*${{ inputs.release_version }}* || exit
306310
bin/init-store.sh || exit
307311
sleep 3
308312
bin/start-hugegraph.sh || exit
@@ -341,7 +345,7 @@ jobs:
341345
342346
popd || exit
343347
# stop server
344-
pushd ./*hugegraph-incubating*${{ inputs.release_version }}/*hugegraph-server-incubating*${{ inputs.release_version }} || exit
348+
pushd ./*hugegraph*${{ inputs.release_version }}*/*hugegraph-server*${{ inputs.release_version }}* || exit
345349
bin/stop-hugegraph.sh || exit
346350
popd || exit
347351

NOTICE

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
Apache HugeGraph Documentation (incubating)
2-
Copyright 2022-2025 The Apache Software Foundation
1+
Apache HugeGraph Documentation
2+
Copyright 2022-2026 The Apache Software Foundation
33

44
This product includes software developed at
55
The Apache Software Foundation (http://www.apache.org/).

config.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ enable = false
235235
# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
236236
[[params.links.user]]
237237
name ="Introduction"
238-
url = "../docs/introduction/readme/"
238+
url = "../docs/introduction/"
239239
icon = "fa fa-book"
240240
desc = "Increase your understanding about the project"
241241
[[params.links.user]]

content/cn/_index.html

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,50 +15,50 @@ <h1 ><span style="font-size:50px;font-weight:bold">Apache</span>
1515
<a class="btn btn-lg btn-primary mr-3 mb-4" href="{{< relref "/docs" >}}">
1616
Learn More <i class="fas fa-arrow-alt-circle-right ml-2"></i>
1717
</a>
18-
<a class="btn btn-lg btn-secondary mr-3 mb-4" href="https://github.com/apache/hugegraph">
18+
<a class="btn btn-lg btn-secondary mr-3 mb-4" href="{{< relref "/docs/download/download" >}}">
1919
Download <i class="fab fa-github ml-2 "></i>
2020
</a>
21-
<p class="lead mt-5">HugeGraph 是一款全栈式图数据库系统</p>
22-
<p>支持从数据存储、实时查询到离线分析的完整图数据处理能力,同时支持 GremlinCypher 查询语言。</p>
21+
<p class="lead mt-5">HugeGraph 是一套全栈图系统,覆盖 <a href="{{< relref "/docs/quickstart/hugegraph/hugegraph-server" >}}">图数据库</a><a href="{{< relref "/docs/quickstart/computing/hugegraph-computer" >}}">图计算</a><a href="{{< relref "/docs/quickstart/hugegraph-ai" >}}">图 AI</a></p>
22+
<p>支持从数据存储、实时查询到离线分析的完整图数据处理能力,并支持 <a href="{{< relref "/docs/language/hugegraph-gremlin" >}}">Gremlin</a><a href="{{< relref "/docs/clients/restful-api/cypher" >}}">Cypher</a> 查询语言。</p>
2323
{{< blocks/link-down color="info" >}}
2424
</div>
2525
{{< /blocks/cover >}}
2626

2727

2828
{{% blocks/lead color="primary" %}}
29-
<p>HugeGraph 支持百亿级图数据高速导入与毫秒级实时查询,可与 Spark、Flink 等大数据平台深度集成。</p>
29+
<p>HugeGraph 最高支持千亿级图数据高速导入与毫秒级实时查询,可与 Spark、Flink 等大数据平台深度集成,并可通过 <a href="{{< relref "/docs/quickstart/toolchain" >}}">HugeGraph 工具链</a> 快速完成导入、可视化与运维</p>
3030
<p>在 AI 时代,通过与大语言模型 (LLM) 结合,为智能问答、推荐系统、风控反欺诈、知识图谱等场景提供强大的图计算能力。</p>
3131
{{% /blocks/lead %}}
3232

3333
{{< blocks/section color="dark" >}}
3434
{{% blocks/feature icon="fa-lightbulb" title="易用" %}}
35-
支持Gremlin图查询语言与RESTful API,并提供图检索常用接口,具备齐全的周边工具,支持分布式存储、数据多副本及横向扩容,内置多种后端存储引擎,轻松实现各种查询、分析。
35+
支持 Gremlin 图查询语言与 [**RESTful API**]({{< relref "/docs/clients/restful-api" >}}),并提供图检索常用接口,具备齐全的周边工具,支持分布式存储、数据多副本及横向扩容,内置多种后端存储引擎,轻松实现各种查询、分析。
3636

3737
{{% /blocks/feature %}}
3838

3939

4040
{{% blocks/feature icon="fa-shipping-fast" title="高效" %}}
41-
在图存储和图计算方面做了深度优化,提供支持多种数据源的批量导入工具,轻松完成百亿级数据快速导入,通过优化过的查询达到图检索的毫秒级响应,支持数千用户并发的在线实时操作。
41+
在图存储和图计算方面做了深度优化,提供 [**批量导入工具**]({{< relref "/docs/quickstart/toolchain/hugegraph-loader" >}}),轻松完成百亿级数据快速导入,通过优化过的查询达到图检索的毫秒级响应,支持数千用户并发的在线实时操作。
4242
{{% /blocks/feature %}}
4343

4444

4545
{{% blocks/feature icon="fa-exchange-alt" title="通用" %}}
46-
支持Apache Gremlin标准图查询语言和Property Graph标准图建模方法,支持基于图的OLTP和OLAP方案。集成Apache Hadoop及Apache Spark大数据平台,也可插件式轻松扩展后端存储引擎。
46+
支持 Apache Gremlin 标准图查询语言和 Property Graph 标准图建模方法,支持基于图的 OLTP 和 [**OLAP 图计算**]({{< relref "/docs/quickstart/computing/hugegraph-computer" >}}) 方案。集成 Apache Hadoop 及 Apache Spark 大数据平台,也可插件式轻松扩展后端存储引擎。
4747
{{% /blocks/feature %}}
4848

4949

5050
{{% blocks/feature icon="fa-brain" title="智能化" %}}
51-
集成LLM实现GraphRAG智能问答、自动化知识图谱构建,内置20+图机器学习算法,轻松构建AI驱动的图应用
51+
集成 LLM 实现 [**GraphRAG 能力**]({{< relref "/docs/quickstart/hugegraph-ai" >}})、自动化知识图谱构建,内置 20+ 图机器学习算法,轻松构建 AI 驱动的图应用
5252
{{% /blocks/feature %}}
5353

5454

5555
{{% blocks/feature icon="fa-expand-arrows-alt" title="可扩展" %}}
56-
支持水平扩容和分布式部署,从单机到PB级集群无缝迁移,提供多种存储引擎适配,满足不同规模和性能需求。
56+
支持水平扩容和分布式部署,从单机到 PB 级集群无缝迁移,提供 [**分布式存储引擎**]({{< relref "/docs/quickstart/hugegraph/hugegraph-hstore" >}}) 适配,满足不同规模和性能需求。
5757
{{% /blocks/feature %}}
5858

5959

6060
{{% blocks/feature icon="fa-puzzle-piece" title="开放生态" %}}
61-
遵循Apache TinkerPop标准,提供Java、Python、Go等多语言客户端,兼容主流大数据平台,社区活跃持续演进。
61+
遵循 Apache TinkerPop 标准,提供 [**多语言客户端**]({{< relref "/docs/quickstart/client/hugegraph-client" >}}),兼容主流大数据平台,社区活跃持续演进。
6262
{{% /blocks/feature %}}
6363

6464

content/cn/docs/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,4 +55,4 @@ Apache HugeGraph 是一套完整的图数据库生态系统,支持 OLTP 实时
5555
| **分布式** | 海量存储、存算分离 | < 1000TB |
5656
| **Docker** | 快速体验 | 任意 |
5757

58-
[📖 详细介绍](introduction/README)
58+
[📖 详细介绍](introduction/)

content/cn/docs/changelog/hugegraph-1.0.0-release-notes.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -166,8 +166,8 @@ weight: 9
166166

167167
更加详细的版本变更信息,可以查看各个子仓库的链接:
168168

169-
- [Server Release Notes](https://github.com/apache/incubator-hugegraph/releases/tag/1.0.0)
170-
- [Toolchain Release Notes](https://github.com/apache/incubator-hugegraph-toolchain/releases/tag/1.0.0)
171-
- [Computer Release Notes](https://github.com/apache/incubator-hugegraph-computer/releases/tag/1.0.0)
172-
- [Commons Release Notes](https://github.com/apache/incubator-hugegraph-commons/releases/tag/1.0.0)
169+
- [Server Release Notes](https://github.com/apache/hugegraph/releases/tag/1.0.0)
170+
- [Toolchain Release Notes](https://github.com/apache/hugegraph-toolchain/releases/tag/1.0.0)
171+
- [Computer Release Notes](https://github.com/apache/hugegraph-computer/releases/tag/1.0.0)
172+
- [Commons Release Notes](https://github.com/apache/hugegraph-commons/releases/tag/1.0.0)
173173

0 commit comments

Comments
 (0)