You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by li...@apache.org on 2022/04/26 03:32:34 UTC
[dubbo-website] branch refactor/docs updated: update facade doc structure (#1075)
This is an automated email from the ASF dual-hosted git repository.
liujun pushed a commit to branch refactor/docs
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/refactor/docs by this push:
new 1d03e89398 update facade doc structure (#1075)
1d03e89398 is described below
commit 1d03e89398dfa2a4167a72c314370b9eba9ea270
Author: ken.lj <ke...@gmail.com>
AuthorDate: Tue Apr 26 11:32:30 2022 +0800
update facade doc structure (#1075)
---
.github/workflows/build_and_deploy.yml | 2 +-
assets/scss/_styles_project.scss | 4 +++
content/cn/facade-docs/_index.md | 1 +
content/cn/facade-docs/mannual/Golang.md | 2 ++
content/cn/facade-docs/mannual/Java.md | 11 -------
content/cn/facade-docs/mannual/_index.md | 13 ++++----
content/cn/facade-docs/quickstart/_index.md | 4 +--
content/cn/facade-docs/what/_index.md | 12 +++++++-
content/cn/facade-docs/what/core-concepts.md | 7 -----
content/cn/facade-docs/what/ecosystem.md | 6 ++--
content/cn/facade-docs/what/overview.md | 16 ++++++++--
content/cn/facade-docs/what/usecases.md | 11 +++++++
content/cn/facade-docs/whatsnew/_index.md | 2 ++
content/cn/java-sdk/_index.md | 24 +++++++++++++--
.../advanced-features-and-usage/_index.md | 2 +-
.../{v3.x => }/concepts-and-architecture/_index.md | 2 +-
.../users.md | 2 +-
.../cn/java-sdk/{v2.x => }/contributing/_index.md | 2 +-
.../cn/java-sdk/{v3.x => }/introduction/_index.md | 2 +-
.../users.md | 2 +-
.../cn/java-sdk/{v2.x => }/quick-start/_index.md | 2 +-
.../java-sdk/{v2.x => }/reference-manual/_index.md | 2 +-
.../upgrades-and-compatibility/_index.md | 2 +-
content/cn/java-sdk/v2.x/_index.md | 8 -----
.../v2.x/advanced-features-and-usage/_index.md | 8 -----
.../v2.x/concepts-and-architecture/_index.md | 8 -----
.../v2.x/concepts-and-architecture/users.md | 6 ----
content/cn/java-sdk/v2.x/introduction/_index.md | 8 -----
.../cn/java-sdk/v2.x/quick-start/quick-start.md | 8 -----
.../v2.x/upgrades-and-compatibility/_index.md | 8 -----
content/cn/java-sdk/v3.x/_index.md | 8 -----
content/cn/java-sdk/v3.x/contributing/_index.md | 8 -----
content/cn/java-sdk/v3.x/introduction/users.md | 6 ----
content/cn/java-sdk/v3.x/quick-start/_index.md | 8 -----
.../cn/java-sdk/v3.x/reference-manual/_index.md | 8 -----
layouts/partials/docs/prog-lang-home.html | 35 ++++++++++++++++++++++
layouts/partials/docs/toc-inline.html | 14 +++++++++
layouts/shortcodes/docs/content_box.md | 27 +++++++++++++++++
38 files changed, 163 insertions(+), 138 deletions(-)
diff --git a/.github/workflows/build_and_deploy.yml b/.github/workflows/build_and_deploy.yml
index ea465f11be..09dfd5e9cf 100644
--- a/.github/workflows/build_and_deploy.yml
+++ b/.github/workflows/build_and_deploy.yml
@@ -37,7 +37,7 @@ jobs:
run: cp .htaccess ./public
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
- if: github.ref == 'refs/heads/master'
+ if: github.ref == 'refs/heads/refactor/docs'
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_branch: asf-site
diff --git a/assets/scss/_styles_project.scss b/assets/scss/_styles_project.scss
index a6fb42e0f4..d4d505426b 100644
--- a/assets/scss/_styles_project.scss
+++ b/assets/scss/_styles_project.scss
@@ -42,3 +42,7 @@ assets/scss/_styles_project.scss
}
}
}
+
+.card-bottom {
+ margin-bottom: 20px;
+}
diff --git a/content/cn/facade-docs/_index.md b/content/cn/facade-docs/_index.md
index 2cc92d08ef..1a14e81fcb 100755
--- a/content/cn/facade-docs/_index.md
+++ b/content/cn/facade-docs/_index.md
@@ -4,6 +4,7 @@ type: docs
title: "文档"
linkTitle: "文档"
no_list: true
+hide_summary: true
menu:
main:
weight: 10
diff --git a/content/cn/facade-docs/mannual/Golang.md b/content/cn/facade-docs/mannual/Golang.md
index cbd0b12e05..81e212e25e 100755
--- a/content/cn/facade-docs/mannual/Golang.md
+++ b/content/cn/facade-docs/mannual/Golang.md
@@ -5,6 +5,8 @@ title: "Golang SDK"
linkTitle: "golang"
description: ""
weight: 2
+manualLinkTarget: _blank
+_build: { render: link }
---
diff --git a/content/cn/facade-docs/mannual/Java.md b/content/cn/facade-docs/mannual/Java.md
deleted file mode 100755
index f222bed0e3..0000000000
--- a/content/cn/facade-docs/mannual/Java.md
+++ /dev/null
@@ -1,11 +0,0 @@
-
----
-type: docs
-title: "Java SDK"
-linkTitle: "java"
-description: ""
-weight: 1
----
-
-
-
diff --git a/content/cn/facade-docs/mannual/_index.md b/content/cn/facade-docs/mannual/_index.md
index e5eee941a3..8197f914cc 100755
--- a/content/cn/facade-docs/mannual/_index.md
+++ b/content/cn/facade-docs/mannual/_index.md
@@ -5,13 +5,10 @@ title: "用户手册"
linkTitle: "用户手册"
weight: 5
no_list: true
-nav_children: section
-notoc: true
-simple_list: true
---
-{{< blocks/section color="white" height="auto">}}
+{{< blocks/section color="white" height="auto" >}}
<div class="td-content list-page">
<div class="lead"></div><header class="article-meta">
</header><div class="row">
@@ -19,9 +16,9 @@ simple_list: true
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href="https://dubbo.apache.org/cn/java-sdk/v3.x/quick-start">参考手册</a>
+ <a target="_blank" href='{{< relref "../../java-sdk" >}}'>Java SDK</a>
</h4>
- <p>Dubbo Java SDK</p>
+ <p>Java SDK</p>
</div>
</div>
</div>
@@ -29,9 +26,9 @@ simple_list: true
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href="https://dubbo.apache.org/cn/golang-sdk/quick-start/">参考手册</a>
+ <a target="_blank" href='{{< relref "../../golang-sdk" >}}'>Golang SDK</a>
</h4>
- <p>Dubbo Golang SDK</p>
+ <p>Golang SDK</p>
</div>
</div>
</div>
diff --git a/content/cn/facade-docs/quickstart/_index.md b/content/cn/facade-docs/quickstart/_index.md
index c9e47ef2d1..f152a6e737 100755
--- a/content/cn/facade-docs/quickstart/_index.md
+++ b/content/cn/facade-docs/quickstart/_index.md
@@ -14,7 +14,7 @@ weight: 2
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href="https://dubbo.apache.org/cn/java-sdk/v3.x/quick-start">Quick start</a>
+ <a target="_blank" href='{{< relref "../../java-sdk/quick-start" >}}'>Quick start</a>
</h4>
<p>Dubbo Java SDK</p>
</div>
@@ -24,7 +24,7 @@ weight: 2
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href="https://dubbo.apache.org/cn/golang-sdk/quick-start/">Quick start</a>
+ <a target="_blank" href='{{< relref "../../golang-sdk" >}}'>Quick start</a>
</h4>
<p>Dubbo Golang SDK</p>
</div>
diff --git a/content/cn/facade-docs/what/_index.md b/content/cn/facade-docs/what/_index.md
index 55a409a6a6..0b96c4f682 100644
--- a/content/cn/facade-docs/what/_index.md
+++ b/content/cn/facade-docs/what/_index.md
@@ -4,4 +4,14 @@ title: "什么是 Dubbo"
linkTitle: "什么是 Dubbo"
weight: 1
description: ""
----
\ No newline at end of file
+---
+
+Apache Dubbo 是一款 RPC 微服务框架，提供了包括 Java、Golang 等在内的多种语言 SDK 实现，如果你是，
+* 第一次接触 Dubbo，请继续阅读本章了解 Dubbo 提供的丰富功能及核心概念；
+* 想快速体验 Dubbo，请参考 [快速开始](../quickstart)
+* 高级用法请参考 [多语言 SDK 文档](../mannual)
+* 关注 Dubbo3
+ * [3.0 设计理念与核心功能](../whatsnew)
+ * [如何迁移到 Dubbo3](../../java-sdk/upgrades-and-compatibility)
+
+
diff --git a/content/cn/facade-docs/what/core-concepts.md b/content/cn/facade-docs/what/core-concepts.md
deleted file mode 100644
index 0244943d65..0000000000
--- a/content/cn/facade-docs/what/core-concepts.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-type: docs
-title: "核心概念"
-linkTitle: "核心概念"
-weight: 2
-description: ""
----
\ No newline at end of file
diff --git a/content/cn/facade-docs/what/ecosystem.md b/content/cn/facade-docs/what/ecosystem.md
index 0a57e72b33..22526a8d9d 100644
--- a/content/cn/facade-docs/what/ecosystem.md
+++ b/content/cn/facade-docs/what/ecosystem.md
@@ -1,7 +1,9 @@
---
type: docs
title: "Dubbo 生态"
-linkTitle: "生态"
+linkTitle: "生态系统"
weight: 3
description: ""
----
\ No newline at end of file
+---
+
+https://istio.io/latest/about/ecosystem/
diff --git a/content/cn/facade-docs/what/overview.md b/content/cn/facade-docs/what/overview.md
index 0a137edadb..e4586462de 100644
--- a/content/cn/facade-docs/what/overview.md
+++ b/content/cn/facade-docs/what/overview.md
@@ -1,7 +1,19 @@
---
type: docs
title: "Dubbo 简介"
-linkTitle: "简介"
+linkTitle: "了解 Dubbo"
weight: 1
description: ""
----
\ No newline at end of file
+---
+
+Dubbo 的一句话定义与总结。
+
+> Dubbo 总体工作原理图，可涵盖服务发现、RPC、多语言、Mesh 等。
+
+## Dubbo 是什么
+
+
+## Dubbo 如何工作
+
+## Dubbo 核心特性
+https://istio.io/latest/about/service-mesh/
\ No newline at end of file
diff --git a/content/cn/facade-docs/what/usecases.md b/content/cn/facade-docs/what/usecases.md
new file mode 100644
index 0000000000..86cf022c31
--- /dev/null
+++ b/content/cn/facade-docs/what/usecases.md
@@ -0,0 +1,11 @@
+---
+type: docs
+title: "用户案例"
+linkTitle: "用户案例"
+weight: 2
+description: ""
+---
+
+概括 Dubbo 被广泛使用。
+
+前期放用户案例列表，可以把用户的故事写出来，链接过去。
\ No newline at end of file
diff --git a/content/cn/facade-docs/whatsnew/_index.md b/content/cn/facade-docs/whatsnew/_index.md
index 70b36d033d..940c5cfea6 100755
--- a/content/cn/facade-docs/whatsnew/_index.md
+++ b/content/cn/facade-docs/whatsnew/_index.md
@@ -5,3 +5,5 @@ title: "3.0 速览"
linkTitle: "3.0 速览"
weight: 3
---
+
+此页面需要完整的描述 3.0 背后的核心设计理念与思考，以及 3.0 当前的状态与实践情况。
\ No newline at end of file
diff --git a/content/cn/java-sdk/_index.md b/content/cn/java-sdk/_index.md
index 9d5fefd9e4..6d2726c564 100755
--- a/content/cn/java-sdk/_index.md
+++ b/content/cn/java-sdk/_index.md
@@ -1,8 +1,26 @@
---
-type: advanced-docs
-title: "Dubbo Java SDK"
-linkTitle: "Dubbo Java SDK"
+type: docs
+title: "Java"
weight: 3
+#no_list: true
+#hide_summary: true
+content:
+ - 快速开始:
+ - "[快速开始](quick-start/)"
+ - 概念与架构:
+ - "[概念与架构](concepts-and-architecture/)"
+ - 高级特性:
+ - "[高级特性](advanced-features-and-usage/)"
+ - 参考手册:
+ - "[参考手册1](reference-manual/)"
+ - 升级与兼容性:
+ - "[tasks1](upgrades-and-compatibility/)"
---
+{{% docs/content_box %}}
+
+### Useful Links
+* aa
+* bb
+* cc
diff --git a/content/cn/java-sdk/v3.x/advanced-features-and-usage/_index.md b/content/cn/java-sdk/advanced-features-and-usage/_index.md
similarity index 81%
rename from content/cn/java-sdk/v3.x/advanced-features-and-usage/_index.md
rename to content/cn/java-sdk/advanced-features-and-usage/_index.md
index d4ff413206..1a8ace15f0 100755
--- a/content/cn/java-sdk/v3.x/advanced-features-and-usage/_index.md
+++ b/content/cn/java-sdk/advanced-features-and-usage/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "高级特性和用法"
linkTitle: "高级特性和用法"
weight: 4
diff --git a/content/cn/java-sdk/v3.x/concepts-and-architecture/_index.md b/content/cn/java-sdk/concepts-and-architecture/_index.md
similarity index 78%
rename from content/cn/java-sdk/v3.x/concepts-and-architecture/_index.md
rename to content/cn/java-sdk/concepts-and-architecture/_index.md
index de300c6b23..25376686d7 100755
--- a/content/cn/java-sdk/v3.x/concepts-and-architecture/_index.md
+++ b/content/cn/java-sdk/concepts-and-architecture/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "概念和架构"
linkTitle: "概念和架构"
weight: 3
diff --git a/content/cn/java-sdk/v2.x/introduction/users.md b/content/cn/java-sdk/concepts-and-architecture/users.md
similarity index 76%
rename from content/cn/java-sdk/v2.x/introduction/users.md
rename to content/cn/java-sdk/concepts-and-architecture/users.md
index c9af84c04d..ca3ac70b29 100644
--- a/content/cn/java-sdk/v2.x/introduction/users.md
+++ b/content/cn/java-sdk/concepts-and-architecture/users.md
@@ -1,5 +1,5 @@
---
-type: advanced-docs
+type: docs
title: "用户列表"
linkTitle: "用户列表"
weight: 3
diff --git a/content/cn/java-sdk/v2.x/contributing/_index.md b/content/cn/java-sdk/contributing/_index.md
similarity index 77%
rename from content/cn/java-sdk/v2.x/contributing/_index.md
rename to content/cn/java-sdk/contributing/_index.md
index 99c6534771..24ba359409 100755
--- a/content/cn/java-sdk/v2.x/contributing/_index.md
+++ b/content/cn/java-sdk/contributing/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "参与贡献"
linkTitle: "参与贡献"
weight: 7
diff --git a/content/cn/java-sdk/v3.x/introduction/_index.md b/content/cn/java-sdk/introduction/_index.md
similarity index 73%
rename from content/cn/java-sdk/v3.x/introduction/_index.md
rename to content/cn/java-sdk/introduction/_index.md
index b05b677d43..5e967f0e09 100755
--- a/content/cn/java-sdk/v3.x/introduction/_index.md
+++ b/content/cn/java-sdk/introduction/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "简介"
linkTitle: "简介"
weight: 1
diff --git a/content/cn/java-sdk/v3.x/concepts-and-architecture/users.md b/content/cn/java-sdk/introduction/users.md
similarity index 76%
rename from content/cn/java-sdk/v3.x/concepts-and-architecture/users.md
rename to content/cn/java-sdk/introduction/users.md
index c9af84c04d..ca3ac70b29 100644
--- a/content/cn/java-sdk/v3.x/concepts-and-architecture/users.md
+++ b/content/cn/java-sdk/introduction/users.md
@@ -1,5 +1,5 @@
---
-type: advanced-docs
+type: docs
title: "用户列表"
linkTitle: "用户列表"
weight: 3
diff --git a/content/cn/java-sdk/v2.x/quick-start/_index.md b/content/cn/java-sdk/quick-start/_index.md
similarity index 77%
rename from content/cn/java-sdk/v2.x/quick-start/_index.md
rename to content/cn/java-sdk/quick-start/_index.md
index 9b7b2492a1..d4895cc73e 100755
--- a/content/cn/java-sdk/v2.x/quick-start/_index.md
+++ b/content/cn/java-sdk/quick-start/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "快速入门"
linkTitle: "快速入门"
weight: 2
diff --git a/content/cn/java-sdk/v2.x/reference-manual/_index.md b/content/cn/java-sdk/reference-manual/_index.md
similarity index 77%
rename from content/cn/java-sdk/v2.x/reference-manual/_index.md
rename to content/cn/java-sdk/reference-manual/_index.md
index 3c009b7dad..aabb129624 100755
--- a/content/cn/java-sdk/v2.x/reference-manual/_index.md
+++ b/content/cn/java-sdk/reference-manual/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "参考手册"
linkTitle: "参考手册"
weight: 5
diff --git a/content/cn/java-sdk/v3.x/upgrades-and-compatibility/_index.md b/content/cn/java-sdk/upgrades-and-compatibility/_index.md
similarity index 80%
rename from content/cn/java-sdk/v3.x/upgrades-and-compatibility/_index.md
rename to content/cn/java-sdk/upgrades-and-compatibility/_index.md
index 7d92813b4d..9598f4b441 100755
--- a/content/cn/java-sdk/v3.x/upgrades-and-compatibility/_index.md
+++ b/content/cn/java-sdk/upgrades-and-compatibility/_index.md
@@ -1,6 +1,6 @@
---
-type: advanced-docs
+type: docs
title: "升级和兼容性"
linkTitle: "升级和兼容性"
weight: 6
diff --git a/content/cn/java-sdk/v2.x/_index.md b/content/cn/java-sdk/v2.x/_index.md
deleted file mode 100755
index 1935db7ac1..0000000000
--- a/content/cn/java-sdk/v2.x/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "v2.x"
-linkTitle: "v2.x"
-weight: 1
----
-
diff --git a/content/cn/java-sdk/v2.x/advanced-features-and-usage/_index.md b/content/cn/java-sdk/v2.x/advanced-features-and-usage/_index.md
deleted file mode 100755
index d4ff413206..0000000000
--- a/content/cn/java-sdk/v2.x/advanced-features-and-usage/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "高级特性和用法"
-linkTitle: "高级特性和用法"
-weight: 4
----
-
diff --git a/content/cn/java-sdk/v2.x/concepts-and-architecture/_index.md b/content/cn/java-sdk/v2.x/concepts-and-architecture/_index.md
deleted file mode 100755
index de300c6b23..0000000000
--- a/content/cn/java-sdk/v2.x/concepts-and-architecture/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "概念和架构"
-linkTitle: "概念和架构"
-weight: 3
----
-
diff --git a/content/cn/java-sdk/v2.x/concepts-and-architecture/users.md b/content/cn/java-sdk/v2.x/concepts-and-architecture/users.md
deleted file mode 100644
index c9af84c04d..0000000000
--- a/content/cn/java-sdk/v2.x/concepts-and-architecture/users.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-type: advanced-docs
-title: "用户列表"
-linkTitle: "用户列表"
-weight: 3
----
diff --git a/content/cn/java-sdk/v2.x/introduction/_index.md b/content/cn/java-sdk/v2.x/introduction/_index.md
deleted file mode 100755
index b05b677d43..0000000000
--- a/content/cn/java-sdk/v2.x/introduction/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "简介"
-linkTitle: "简介"
-weight: 1
----
-
diff --git a/content/cn/java-sdk/v2.x/quick-start/quick-start.md b/content/cn/java-sdk/v2.x/quick-start/quick-start.md
deleted file mode 100644
index 219b19de5a..0000000000
--- a/content/cn/java-sdk/v2.x/quick-start/quick-start.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-type: advanced-docs
-title: "快速开始2"
-linkTitle: "快速开始2"
-weight: 3
----
-
-链接到各个生态的quick-start
\ No newline at end of file
diff --git a/content/cn/java-sdk/v2.x/upgrades-and-compatibility/_index.md b/content/cn/java-sdk/v2.x/upgrades-and-compatibility/_index.md
deleted file mode 100755
index 7d92813b4d..0000000000
--- a/content/cn/java-sdk/v2.x/upgrades-and-compatibility/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "升级和兼容性"
-linkTitle: "升级和兼容性"
-weight: 6
----
-
diff --git a/content/cn/java-sdk/v3.x/_index.md b/content/cn/java-sdk/v3.x/_index.md
deleted file mode 100755
index fcb85345b1..0000000000
--- a/content/cn/java-sdk/v3.x/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "v3.x"
-linkTitle: "v3.x"
-weight: 2
----
-
diff --git a/content/cn/java-sdk/v3.x/contributing/_index.md b/content/cn/java-sdk/v3.x/contributing/_index.md
deleted file mode 100755
index 99c6534771..0000000000
--- a/content/cn/java-sdk/v3.x/contributing/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "参与贡献"
-linkTitle: "参与贡献"
-weight: 7
----
-
diff --git a/content/cn/java-sdk/v3.x/introduction/users.md b/content/cn/java-sdk/v3.x/introduction/users.md
deleted file mode 100644
index c9af84c04d..0000000000
--- a/content/cn/java-sdk/v3.x/introduction/users.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-type: advanced-docs
-title: "用户列表"
-linkTitle: "用户列表"
-weight: 3
----
diff --git a/content/cn/java-sdk/v3.x/quick-start/_index.md b/content/cn/java-sdk/v3.x/quick-start/_index.md
deleted file mode 100755
index 9b7b2492a1..0000000000
--- a/content/cn/java-sdk/v3.x/quick-start/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "快速入门"
-linkTitle: "快速入门"
-weight: 2
----
-
diff --git a/content/cn/java-sdk/v3.x/reference-manual/_index.md b/content/cn/java-sdk/v3.x/reference-manual/_index.md
deleted file mode 100755
index 3c009b7dad..0000000000
--- a/content/cn/java-sdk/v3.x/reference-manual/_index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-
----
-type: advanced-docs
-title: "参考手册"
-linkTitle: "参考手册"
-weight: 5
----
-
diff --git a/layouts/partials/docs/prog-lang-home.html b/layouts/partials/docs/prog-lang-home.html
new file mode 100644
index 0000000000..211934832c
--- /dev/null
+++ b/layouts/partials/docs/prog-lang-home.html
@@ -0,0 +1,35 @@
+{{ $Lang := .Params.title | default .Params.language }}
+
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="h-100 card shadow" href="#">
+ <div class="card-body">
+ <h4 class="card-title">
+ <a class="" href="quickstart/">Quick start</a>
+ </h4>
+ <p>
+ Run your first {{ replace $Lang " " "-" }} gRPC app in minutes!
+ </p>
+ </div>
+ </div>
+ </div>
+
+ {{ if .GetPage "basics" }}
+ <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="h-100 card shadow">
+ <div class="card-body">
+ <h4 class="card-title">
+ <a class="" href="basics/">Basics tutorial</a>
+ </h4>
+ <p>
+ Learn about {{ replace $Lang " " "-" }} gRPC basics.
+ </p>
+ </div>
+ </div>
+ </div>
+ {{ end }}
+ </div>
+ {{ with .Content }}
+ <hr/>
+ {{ . }}
+ {{ end }}
\ No newline at end of file
diff --git a/layouts/partials/docs/toc-inline.html b/layouts/partials/docs/toc-inline.html
new file mode 100644
index 0000000000..0e2bd3833b
--- /dev/null
+++ b/layouts/partials/docs/toc-inline.html
@@ -0,0 +1,14 @@
+{{ if not .Params.notoc }}
+ {{ with .TableOfContents }}
+ {{ if ge (len .) 200 }}
+ <a id="td-content__toc-link" href="#td-content__toc" data-toggle="collapse" aria-controls="td-docs-toc" aria-expanded="false" aria-label="Toggle toc navigation">
+ <span class="lead">Contents<i class="fas fa-chevron-right ml-2"></i></span>
+ </a>
+ <div id="td-content__toc" class="collapse">
+ {{ . }}
+ </div>
+ <button id="td-content__toc-link-expanded" href="#td-content__toc" class="btn btn-small ml-1 my-2 py-0 px-3" data-toggle="collapse" aria-controls="td-docs-toc" aria-expanded="true" aria-label="Toggle toc navigation">
+ </button>
+ {{ end }}
+ {{ end }}
+{{ end }}
diff --git a/layouts/shortcodes/docs/content_box.md b/layouts/shortcodes/docs/content_box.md
new file mode 100644
index 0000000000..85fd54a2f4
--- /dev/null
+++ b/layouts/shortcodes/docs/content_box.md
@@ -0,0 +1,27 @@
+{{ $lang := lower ($.Page.Params.language | default $.Page.Params.title) -}}
+{{ $src_repo_url := $.Page.Params.src_repo | default (printf "https://github.com/apache/dubbo-%s" $lang) -}}
+{{ $src_repo_link := printf "[dubbo-%s repo](%s)" $lang $src_repo_url -}}
+
+{{ with .Page.Params.content -}}
+<div class="row">
+{{ range $list_entry := . }}
+{{ range $heading, $items := $list_entry }}
+{{ $hd := printf "### %s" (humanize $heading) -}}
+
+{{ range $items }}
+<div class="col-sm col-md-6 mb-4">
+ <div class="h-100 card shadow" href="#">
+ <div class="card-body">
+ {{ $item := replace . "$src_repo_url" $src_repo_url }}
+ {{ $item = replace $item "$src_repo_link" $src_repo_link }}
+ <h4 class="card-title">
+ {{ $item | $.Page.RenderString }}
+ </h4>
+ </div>
+ </div>
+</div>
+{{ end }}
+{{ end }}
+{{ end }}
+</div>
+{{ end -}}