This is an automated email from the ASF dual-hosted git repository.
zhongxjian pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new 2242efde119 Optimize document layout and font size (#3167)
2242efde119 is described below
commit 2242efde1190232ca138d2d4b9082ff7b0905047
Author: mfordjody <[email protected]>
AuthorDate: Sat Dec 13 04:34:36 2025 +0800
Optimize document layout and font size (#3167)
---
assets/scss/_base.scss | 3 +-
assets/scss/_custom.scss | 370 ++++++++++++++++++++-
content/en/overview/home/_index.md | 2 +-
.../mannual/java-sdk/tasks/extensibility/_index.md | 46 ++-
.../java-sdk/tasks/traffic-management/_index.md | 64 ++--
content/en/overview/mesh/concepts/_index.md | 44 +++
.../en/overview/reference/pixiu/deploy/_index.md | 17 +
.../mannual/java-sdk/tasks/extensibility/_index.md | 46 ++-
.../tasks/mesh/bookinfo-proxyless/_index.md | 8 +-
.../mesh/bookinfo-proxyless/traffic/_index.md | 28 +-
.../java-sdk/tasks/mesh/bookinfo-sidecar/_index.md | 8 +-
.../tasks/mesh/bookinfo-sidecar/traffic/_index.md | 28 +-
.../java-sdk/tasks/traffic-management/_index.md | 83 ++---
13 files changed, 547 insertions(+), 200 deletions(-)
diff --git a/assets/scss/_base.scss b/assets/scss/_base.scss
index bf146fbf548..a88dcd249d4 100755
--- a/assets/scss/_base.scss
+++ b/assets/scss/_base.scss
@@ -62,8 +62,9 @@ footer {
}
p {
- font-size: 14px;
+ font-size: 16px;
font-weight: 400;
+ line-height: 1.7;
}
.button {
diff --git a/assets/scss/_custom.scss b/assets/scss/_custom.scss
index 90846f40327..44fa4f2cb55 100755
--- a/assets/scss/_custom.scss
+++ b/assets/scss/_custom.scss
@@ -48,6 +48,9 @@ section {
}
body {
+ font-size: 16px;
+ line-height: 1.7;
+
header + .td-outer {
min-height: 50vh;
height: auto;
@@ -353,10 +356,6 @@ footer {
height: calc(100vh - 10rem);
overflow-y: auto;
}
-
- #TableOfContents {
- padding-top: 1rem;
- }
}
main {
@@ -458,6 +457,8 @@ body.td-home .deprecation-warning, body.td-blog
.deprecation-warning, body.td-do
.td-documentation .td-content > .highlight {
max-width: initial;
width: 100%;
+ margin-top: 0.1rem !important;
+ margin-bottom: 1rem !important;
}
body.td-home #deprecation-warning {
@@ -545,12 +546,12 @@ body.cid-community > #deprecation-warning >
.deprecation-warning > * {
padding-top: .5rem;
padding-left: 1.5rem;
}
-
+
ul ul,
.td-sidebar-nav__section ul ul {
padding-left: 0.1rem !important;
}
-
+
ul ul ul,
.td-sidebar-nav__section ul ul ul {
padding-left: 0.1rem !important;
@@ -563,16 +564,16 @@ nav.foldable-nav .with-child,
nav.foldable-nav .without-child {
position: relative;
padding-left: 0.8em !important;
-
+
input[type="checkbox"] {
position: absolute !important;
left: -0.3em !important;
margin-left: 0 !important;
}
-
+
label {
padding-left: 0.3em !important;
-
+
&::before {
left: -0.3em !important;
margin-left: 0 !important;
@@ -783,10 +784,36 @@ body.td-documentation #announcement + .header-hero {
padding-left: 12px;
}
-body.td-documentation .td-main {
- padding-top: 62px;
- @media (min-width: 768px) {
- padding-top: 78px;
+body.td-documentation {
+ font-size: 16px;
+ line-height: 1.7;
+
+ .td-main {
+ padding-top: 62px;
+ @media (min-width: 768px) {
+ padding-top: 78px;
+ }
+
+ > .row > main {
+ padding-left: 2rem !important;
+ padding-right: 2rem !important;
+
+ @media (min-width: 768px) {
+ padding-left: 2.5rem !important;
+ padding-right: 2.5rem !important;
+ }
+
+ @media (min-width: 992px) {
+ padding-left: 2rem !important;
+ padding-right: 2rem !important;
+ }
+
+ @media (min-width: 1200px) {
+ padding-left: 2.5rem !important;
+ padding-right: 2.5rem !important;
+ }
+
+ }
}
}
@@ -798,7 +825,11 @@ body.td-documentation .td-main {
}
.td-documentation .td-main > .row > main {
flex: 1 1 auto;
- max-width: calc(100% - 280px);
+ max-width: calc(100% - 560px);
+ }
+ .td-documentation .td-toc {
+ flex: 0 0 280px;
+ max-width: 280px;
}
}
@@ -878,6 +909,139 @@ figure.release-logo {
}
.td-content {
+ font-size: 16px;
+ line-height: 1.7;
+}
+
+.td-content .row,
+main .td-content .row,
+.td-documentation main .row,
+.td-documentation .td-content .row,
+body.td-documentation main .td-content .row,
+body.td-documentation .td-main > .row > main .td-content .row {
+ margin-left: 0 !important;
+ margin-right: 0 !important;
+ --bs-gutter-x: 0 !important;
+ --bs-gutter-y: 0 !important;
+ padding-left: 0 !important;
+ padding-right: 0 !important;
+ justify-content: flex-start !important;
+ width: 100% !important;
+ max-width: 100% !important;
+
+ & > .col-sm,
+ & > .col-md-6,
+ & > .col-lg-4,
+ & > .col-9,
+ & > [class*="col-"] {
+ padding-left: 0 !important;
+ padding-right: 1rem !important;
+ margin-left: 0 !important;
+ margin-right: 0 !important;
+ flex: 0 0 auto !important;
+
+ @media (min-width: 768px) {
+ padding-left: 0 !important;
+ padding-right: 1.5rem !important;
+ margin-left: 0 !important;
+ margin-right: 0 !important;
+ }
+ }
+}
+
+.td-content .row > *,
+main .td-content .row > *,
+.td-documentation main .row > *,
+.td-documentation .td-content .row > *,
+body.td-documentation main .td-content .row > *,
+body.td-documentation .td-main > .row > main .td-content .row > * {
+ padding-left: 0 !important;
+ margin-left: 0 !important;
+}
+
+.td-content .card,
+main .td-content .card,
+.td-documentation main .card,
+.td-documentation .td-content .card,
+body.td-documentation main .td-content .card,
+body.td-documentation .td-main > .row > main .td-content .card {
+ width: 100%;
+ margin-left: 0 !important;
+ margin-right: 0 !important;
+
+ .card-body {
+ padding-top: 1.5rem !important;
+ padding-bottom: 1.5rem;
+ padding-left: 1.5rem;
+ padding-right: 1.5rem;
+ }
+
+ .card-title,
+ h4.card-title,
+ .h4.card-title {
+ margin-top: 0 !important;
+ margin-bottom: 0.75rem;
+ }
+}
+
+.td-content {
+ p {
+ font-size: 16px;
+ line-height: 1.7;
+ margin-bottom: 1.25rem;
+ }
+
+
+ h1 {
+ font-size: 2rem;
+ line-height: 1.3;
+ margin-top: 2rem;
+ margin-bottom: 1.5rem;
+ }
+
+ h2 {
+ font-size: 1.625rem;
+ line-height: 1.4;
+ margin-top: 2rem;
+ margin-bottom: 1.25rem;
+ }
+
+ h3 {
+ font-size: 1.375rem;
+ line-height: 1.4;
+ margin-top: 1.75rem;
+ margin-bottom: 1rem;
+ }
+
+ h4 {
+ font-size: 1.125rem;
+ line-height: 1.4;
+ margin-top: 1.5rem;
+ margin-bottom: 0.875rem;
+ }
+
+ ul, ol {
+ font-size: 16px;
+ line-height: 1.7;
+ margin-bottom: 1.25rem;
+ padding-left: 2rem;
+
+ li {
+ margin-bottom: 0.5rem;
+ line-height: 1.7;
+ }
+ }
+
+ code {
+ font-size: 0.9em;
+ padding: 0.2em 0.4em;
+ }
+
+ pre {
+ font-size: 0.9em;
+ line-height: 1.6;
+ }
+
table code {
background-color: inherit !important;
color: inherit !important;
@@ -888,6 +1052,160 @@ figure.release-logo {
max-width: 100% !important;
}
+.highlight {
+ position: relative;
+
+ .btn-copy,
+ button[data-clipboard-target],
+ .copy-button,
+ [class*="copy"] {
+ position: absolute;
+ top: 1rem;
+ right: 0.75rem;
+ z-index: 10;
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ width: 24px;
+ height: 24px;
+ padding: 0;
+ font-size: 0;
+ color: #9ca3af;
+ background-color: rgba(31, 41, 55, 0.6);
+ border: 1px solid rgba(255, 255, 255, 0.1);
+ border-radius: 0.25rem;
+ cursor: pointer;
+ transition: all 0.2s ease-in-out;
+ backdrop-filter: blur(8px);
+ -webkit-backdrop-filter: blur(8px);
+ box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.2);
+ opacity: 0;
+ transform: translateY(-4px);
+
+ &::after {
+ content: '';
+ display: block;
+ width: 14px;
+ height: 14px;
+ background-image: url("data:image/svg+xml,%3Csvg
xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24'
stroke='%239ca3af' stroke-width='2'%3E%3Crect x='9' y='9' width='13'
height='13' rx='2' ry='2'/%3E%3Cpath d='M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2
2 0 012 2v1'/%3E%3C/svg%3E");
+ background-size: contain;
+ background-repeat: no-repeat;
+ background-position: center;
+ transition: all 0.2s;
+ }
+ }
+
+ &:hover .btn-copy,
+ &:hover button[data-clipboard-target],
+ &:hover .copy-button,
+ &:hover [class*="copy"] {
+ opacity: 1;
+ transform: translateY(0);
+ }
+
+ .btn-copy:hover,
+ button[data-clipboard-target]:hover,
+ .copy-button:hover,
+ [class*="copy"]:hover {
+ background-color: rgba(31, 41, 55, 0.8);
+ border-color: rgba(255, 255, 255, 0.2);
+ box-shadow: 0 2px 4px 0 rgba(0, 0, 0, 0.3);
+ transform: translateY(-1px);
+
+ &::after {
+ background-image: url("data:image/svg+xml,%3Csvg
xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24'
stroke='%23d1d5db' stroke-width='2'%3E%3Crect x='9' y='9' width='13'
height='13' rx='2' ry='2'/%3E%3Cpath d='M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2
2 0 012 2v1'/%3E%3C/svg%3E");
+ }
+ }
+
+ .btn-copy:active,
+ button[data-clipboard-target]:active,
+ .copy-button:active,
+ [class*="copy"]:active {
+ transform: translateY(0);
+ box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+ }
+
+ .btn-copy.copied,
+ button[data-clipboard-target].copied,
+ .copy-button.copied,
+ [class*="copy"].copied {
+ background-color: rgba(16, 185, 129, 0.8);
+ border-color: #10b981;
+
+ &::after {
+ background-image: url("data:image/svg+xml,%3Csvg
xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24'
stroke='%23ffffff' stroke-width='2.5'%3E%3Cpath stroke-linecap='round'
stroke-linejoin='round' d='M5 13l4 4L19 7' /%3E%3C/svg%3E");
+ }
+ }
+
+ &[data-theme="dark"],
+ &.dark,
+ pre[data-theme="dark"] & {
+ .btn-copy,
+ button[data-clipboard-target],
+ .copy-button,
+ [class*="copy"] {
+ background-color: rgba(31, 41, 55, 0.9);
+ border-color: rgba(255, 255, 255, 0.1);
+
+ &::after {
+ background-image: url("data:image/svg+xml,%3Csvg
xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24'
stroke='%23d1d5db' stroke-width='2'%3E%3Crect x='9' y='9' width='13'
height='13' rx='2' ry='2'/%3E%3Cpath d='M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2
2 0 012 2v1'/%3E%3C/svg%3E");
+ }
+
+ &:hover {
+ background-color: rgba(31, 41, 55, 1);
+
+ &::after {
+ background-image: url("data:image/svg+xml,%3Csvg
xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24'
stroke='%23f9fafb' stroke-width='2'%3E%3Crect x='9' y='9' width='13'
height='13' rx='2' ry='2'/%3E%3Cpath d='M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2
2 0 012 2v1'/%3E%3C/svg%3E");
+ }
+ }
+ }
+ }
+}
+
+.td-content .highlight {
+ position: relative;
+ margin-top: 0.1rem !important;
+ margin-bottom: 1rem !important;
+
+ pre {
+ padding-right: 5rem;
+ }
+}
+
+.td-content {
+ p:has(+ .highlight),
+ p:has(+ pre),
+ ol:has(+ .highlight),
+ ol:has(+ pre),
+ ul:has(+ .highlight),
+ ul:has(+ pre) {
+ padding-left: 0;
+ margin-left: 0;
+ }
+
+ p + .highlight,
+ p + pre,
+ ol + .highlight,
+ ol + pre,
+ ul + .highlight,
+ ul + pre {
+ margin-top: 0.1rem !important;
+ }
+
+ > p:not(:first-child) {
+ padding-left: 0;
+ margin-left: 0;
+ }
+
+ .btn-copy,
+ button[data-clipboard-target],
+ .copy-button,
+ [class*="copy"] {
+ top: 1rem;
+ right: 0.75rem;
+ }
+}
+
/* Force size constraints on figures */
figure {
&.diagram-small img {
@@ -1007,5 +1325,27 @@ div.alert > em.javascript-required {
overflow-x: hidden;
white-space: normal;
word-break: break-word;
- padding-right: 12px;
+ padding-right: 10px;
+
+ &::-webkit-scrollbar {
+ width: 10px;
+ }
+
+ &::-webkit-scrollbar-track {
+ background: transparent;
+ margin-right: 0;
+ }
+
+ &::-webkit-scrollbar-thumb {
+ background-color: rgba(0, 0, 0, 0.2);
+ border-radius: 5px;
+ border: none;
+ }
+
+ &::-webkit-scrollbar-thumb:hover {
+ background-color: rgba(0, 0, 0, 0.3);
+ }
+
+ scrollbar-width: auto;
+ scrollbar-color: rgba(0, 0, 0, 0.2) transparent;
}
\ No newline at end of file
diff --git a/content/en/overview/home/_index.md
b/content/en/overview/home/_index.md
index 5a12ca85786..8fa837761bf 100644
--- a/content/en/overview/home/_index.md
+++ b/content/en/overview/home/_index.md
@@ -69,5 +69,5 @@ Follow the content below to quickly understand the features,
advantages, and bes
<br/>
<br/>
-[//]: # ({{% docs/document_box %}})
+{{% docs/document_box %}}
diff --git a/content/en/overview/mannual/java-sdk/tasks/extensibility/_index.md
b/content/en/overview/mannual/java-sdk/tasks/extensibility/_index.md
index b2a71ed1646..24a8f771dea 100755
--- a/content/en/overview/mannual/java-sdk/tasks/extensibility/_index.md
+++ b/content/en/overview/mannual/java-sdk/tasks/extensibility/_index.md
@@ -14,53 +14,51 @@ This section introduces Dubbo's extensibility features
through the following tas
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
- <div class="lead"></div><header class="article-meta">
- </header><div class="row">
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
+ <div class="lead"></div>
+ <header class="article-meta"></header>
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./filter/" >}}'>Custom Filter</a>
</h4>
<p>Custom filters can be dynamically loaded using the SPI
mechanism, allowing for unified processing and validation of returned results,
reducing interruptions for developers.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./router/" >}}'>Custom Router</a>
</h4>
<p>Custom routing strategies can be implemented based on
actual usage scenarios during service calls, effectively improving service
throughput and latency.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./protocol/" >}}'>Custom Protocol</a>
</h4>
- <p>Custom transport protocols can be used for different
heterogeneous systems, masking the differences between protocols for better
system integration.
- </p>
+ <p>Custom transport protocols can be used for different
heterogeneous systems, masking the differences between protocols for better
system integration.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./registry/" >}}'>Custom Registry
Center</a>
</h4>
- <p>Integrating services from different registry centers into
the Dubbo framework, custom registry centers serve as a cutting edge for
bridging heterogeneous service systems.
- </p>
+ <p>Integrating services from different registry centers into
the Dubbo framework, custom registry centers serve as a cutting edge for
bridging heterogeneous service systems.</p>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
+ <h4 class="card-title">
+ <a href='{{< relref "./spi/" >}}'>Custom SPI Extension</a>
+ </h4>
+ <p>Through Dubbo's SPI plugin extension mechanism, you can
customize SPI extensions to implement custom RPC protocols, filters, routers,
and other extension points.</p>
</div>
</div>
</div>
+ <hr>
</div>
-<hr>
-</div>
-
{{< /blocks/section >}}
diff --git
a/content/en/overview/mannual/java-sdk/tasks/traffic-management/_index.md
b/content/en/overview/mannual/java-sdk/tasks/traffic-management/_index.md
index 597580b272a..90ff384e0a9 100755
--- a/content/en/overview/mannual/java-sdk/tasks/traffic-management/_index.md
+++ b/content/en/overview/mannual/java-sdk/tasks/traffic-management/_index.md
@@ -1,5 +1,5 @@
---
-aliases:
[/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/traffic/]
+aliases: [/en/overview/mannual/java-sdk/advanced-features-and-usage/traffic/]
description: Demonstration of how to use Dubbo's traffic governance features.
linkTitle: Traffic Control
no_list: true
@@ -12,91 +12,75 @@ We demonstrate the basic usage of Dubbo's traffic control
rules through a mall m
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
- <div class="lead"></div><header class="article-meta">
- </header><div class="row">
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
+ <div class="lead"></div>
+ <header class="article-meta"></header>
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./timeout/" >}}'>Adjust Timeout</a>
</h4>
<p>By dynamically adjusting the service timeout at runtime, it
can effectively address issues such as unreasonable timeout settings and
frequent timeouts caused by system emergencies, improving system stability.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./retry/" >}}'>Increase Retry
Count</a>
</h4>
<p>Retrying after a failed initial service call can
effectively improve the overall success rate of calls.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./accesslog/" >}}'>Access Log</a>
</h4>
<p>Access logs can effectively record all service request
information processed by a machine over a period, and enabling access logs
dynamically at runtime is very helpful for troubleshooting.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./region/" >}}'>Same Data
Center/Region Priority</a>
</h4>
<p>Same data center/region priority means prioritizing service
providers in the same data center/region when the application calls the
service, avoiding network latency caused by crossing regions, thereby reducing
response time.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./isolation/" >}}'>Environment
Isolation</a>
</h4>
<p>By dividing one or more applications in the cluster into
logically isolated environments, it can be used to build gray environments or
multiple testing environments.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./arguments/" >}}'>Parameter
Routing</a>
</h4>
<p>For example, routing traffic based on user ID, forwarding a
small portion of user requests to the newly released product version to verify
the stability of the new version and gather user experience feedback.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./weight/" >}}'>Weight Ratio</a>
</h4>
<p>By dynamically adjusting the weights of a single or a group
of machines, the distribution of request traffic can be changed at runtime,
achieving dynamic proportional traffic routing.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./mock/" >}}'>Service Downgrade</a>
</h4>
<p>The core goal of service downgrade is to maintain
functional integrity as much as possible by returning degraded results when
weak dependencies are unavailable or fail.</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./host/" >}}'>Fixed Machine Traffic
Guidance</a>
</h4>
@@ -104,9 +88,7 @@ We demonstrate the basic usage of Dubbo's traffic control
rules through a mall m
</div>
</div>
</div>
+ <hr>
</div>
-<hr>
-</div>
-
{{< /blocks/section >}}
diff --git a/content/en/overview/mesh/concepts/_index.md
b/content/en/overview/mesh/concepts/_index.md
new file mode 100644
index 00000000000..555b7c38666
--- /dev/null
+++ b/content/en/overview/mesh/concepts/_index.md
@@ -0,0 +1,44 @@
+---
+description: Core Features
+linkTitle: Core Features
+title: Core Features
+type: docs
+weight: 2
+no_list: true
+---
+Gain an in-depth understanding of Dubbo Service Mesh's core capabilities,
helping you systematically understand the structure of its components and the
underlying abstraction mechanisms.
+
+{{< blocks/section color="white" height="auto">}}
+<div class="td-content list-page">
+ <div class="lead"></div>
+ <header class="article-meta"></header>
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
+ <h4 class="card-title">
+ <a href='{{< relref "traffic-management" >}}'>Traffic
Management</a>
+ </h4>
+ <p>Describes Dubbo's traffic routing and control
capabilities.</p>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
+ <h4 class="card-title">
+ <a href='{{< relref "security" >}}'>Security</a>
+ </h4>
+ <p>Describes Dubbo's authentication and authorization
mechanisms.</p>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
+ <h4 class="card-title">
+ <a href='{{< relref "observability" >}}'>Observability</a>
+ </h4>
+ <p>Describes Dubbo's telemetry and monitoring capabilities.</p>
+ </div>
+ </div>
+ </div>
+ <hr>
+</div>
+{{< /blocks/section >}}
+
diff --git a/content/en/overview/reference/pixiu/deploy/_index.md
b/content/en/overview/reference/pixiu/deploy/_index.md
new file mode 100644
index 00000000000..ecdcceb1122
--- /dev/null
+++ b/content/en/overview/reference/pixiu/deploy/_index.md
@@ -0,0 +1,17 @@
+---
+aliases:
+- /en/docs3-v2/dubbo-go-pixiu/deploy/
+- /en-cn/docs3-v2/dubbo-go-pixiu/deploy/
+- /en/overview/reference/pixiu/deploy/
+- /en/overview/mannual/dubbo-go-pixiu/deploy/
+description: Pixiu gateway usage guide
+linkTitle: Gateway Usage Guide
+title: Gateway Usage Guide
+type: docs
+weight: 60
+---
+
+Pixiu Gateway is used to manage Pixiu Proxy, whether it runs as a standalone
application gateway or is integrated in Kubernetes as an application gateway.
Through Gateway API resources, you can deploy and maintain Pixiu Proxy
instances managed by this controller.
+
+> Pixiu Gateway is currently in the initial experimental stage. More
deployment methods and standard feature support will be added in the future.
+
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/extensibility/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/extensibility/_index.md
index 2778fcca2b1..8ea7bbd6c78 100755
--- a/content/zh-cn/overview/mannual/java-sdk/tasks/extensibility/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/tasks/extensibility/_index.md
@@ -14,52 +14,50 @@ weight: 6
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
- <div class="lead"></div><header class="article-meta">
- </header><div class="row">
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
+ <div class="lead"></div>
+ <header class="article-meta"></header>
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./filter/" >}}'>自定义过滤器</a>
</h4>
<p>通过SPI机制动态加载自定义过滤器，可以对返回的结果进行统一的处理、验证等，减少对开发人员的打扰。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./router/" >}}'>自定义路由</a>
</h4>
<p>在服务调用的过程中根据实际使用场景自定义路由策略，可以有效的改善服务吞吐量和耗时。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./protocol/" >}}'>自定义协议</a>
</h4>
- <p>针对不同的异构系统可以使用自定义传输协议，为系统之间的整合屏蔽了协议之间的差异。
- </p>
+ <p>针对不同的异构系统可以使用自定义传输协议，为系统之间的整合屏蔽了协议之间的差异。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./registry/" >}}'>自定义注册中心</a>
</h4>
- <p>将不同注册中心中的服务都纳入到 Dubbo 体系中，自定义注册中心是打通异构服务体系之间的利刃。
- </p>
+ <p>将不同注册中心中的服务都纳入到 Dubbo 体系中，自定义注册中心是打通异构服务体系之间的利刃。</p>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
+ <h4 class="card-title">
+ <a href='{{< relref "./spi/" >}}'>自定义 SPI 扩展</a>
+ </h4>
+ <p>通过 Dubbo 的 SPI 插件扩展机制，可以自定义 SPI 扩展，实现自定义的 RPC
协议、过滤器、路由等扩展点。</p>
</div>
</div>
</div>
+ <hr>
</div>
-<hr>
-</div>
-
{{< /blocks/section >}}
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/_index.md
index 7b5fde9e4b2..d0fea0c8304 100755
---
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/_index.md
+++
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/_index.md
@@ -25,9 +25,9 @@ weight: 70
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./traffic/" >}}'>Traffic
Management</a>
+ <a href='{{< relref "./traffic/" >}}'>流量管理</a>
</h4>
- <p>Tasks that demonstrates how to use Istio's traffic routing
features.</p>
+ <p>演示如何使用 Istio 的流量路由功能的任务。</p>
</div>
</div>
</div>
@@ -35,9 +35,9 @@ weight: 70
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./security/" >}}'>Security</a>
+ <a href='{{< relref "./security/" >}}'>安全</a>
</h4>
- <p>Demonstrates how to secure Dubbo proxyless mesh.</p>
+ <p>演示如何保护 Dubbo proxyless 服务网格。</p>
</div>
</div>
</div>
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/traffic/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/traffic/_index.md
index 6eca306ef19..eacdceac423 100755
---
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/traffic/_index.md
+++
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-proxyless/traffic/_index.md
@@ -25,9 +25,9 @@ weight: 10
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Request
Routing</a>
+ <a href='{{< relref "./request-routing/" >}}'>请求路由</a>
</h4>
- <p>This task shows you how to configure dynamic request
routing to multiple versions of a microservice.</p>
+ <p>此任务演示如何配置动态请求路由到微服务的多个版本。</p>
</div>
</div>
</div>
@@ -35,9 +35,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Traffic
Shifting</a>
+ <a href='{{< relref "./request-routing/" >}}'>流量迁移</a>
</h4>
- <p>Shows you how to migrate traffic from an old to new version
of a service.</p>
+ <p>演示如何将流量从服务的旧版本迁移到新版本。</p>
</div>
</div>
</div>
@@ -45,10 +45,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>TCP Traffic
Shifting</a>
- <p>Shows you how to migrate TCP traffic from an old to new
version of a TCP service.</p>
+ <a href='{{< relref "./request-routing/" >}}'>TCP 流量迁移</a>
</h4>
- <p></p>
+ <p>演示如何将 TCP 流量从 TCP 服务的旧版本迁移到新版本。</p>
</div>
</div>
</div>
@@ -56,10 +55,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Request
Timeouts</a>
- <p>This task shows you how to set up request timeouts in
Envoy using Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>请求超时</a>
</h4>
- <p></p>
+ <p>此任务演示如何使用 Istio 在 Envoy 中设置请求超时。</p>
</div>
</div>
</div>
@@ -67,10 +65,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Mirroring</a>
- <p>This task demonstrates the traffic mirroring/shadowing
capabilities of Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>流量镜像</a>
</h4>
- <p></p>
+ <p>此任务演示 Istio 的流量镜像/影子功能。</p>
</div>
</div>
</div>
@@ -78,10 +75,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Locality
Load Balancing</a>
- <p>This series of tasks demonstrate how to configure
locality load balancing in Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>本地负载均衡</a>
</h4>
- <p></p>
+ <p>此系列任务演示如何在 Istio 中配置本地负载均衡。</p>
</div>
</div>
</div>
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/_index.md
index 5d1be6f6d53..9e0362a22c7 100755
---
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/_index.md
+++
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/_index.md
@@ -25,9 +25,9 @@ weight: 70
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./traffic/" >}}'>Traffic
Management</a>
+ <a href='{{< relref "./traffic/" >}}'>流量管理</a>
</h4>
- <p>Tasks that demonstrates how to use Istio's traffic routing
features.</p>
+ <p>演示如何使用 Istio 的流量路由功能的任务。</p>
</div>
</div>
</div>
@@ -35,9 +35,9 @@ weight: 70
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./security/" >}}'>Security</a>
+ <a href='{{< relref "./security/" >}}'>安全</a>
</h4>
- <p>Demonstrates how to secure Dubbo mesh.</p>
+ <p>演示如何保护 Dubbo 服务网格。</p>
</div>
</div>
</div>
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/traffic/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/traffic/_index.md
index 0d89f84427f..ce43d82e542 100755
---
a/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/traffic/_index.md
+++
b/content/zh-cn/overview/mannual/java-sdk/tasks/mesh/bookinfo-sidecar/traffic/_index.md
@@ -25,9 +25,9 @@ weight: 10
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Request
Routing</a>
+ <a href='{{< relref "./request-routing/" >}}'>请求路由</a>
</h4>
- <p>This task shows you how to configure dynamic request
routing to multiple versions of a microservice.</p>
+ <p>此任务演示如何配置动态请求路由到微服务的多个版本。</p>
</div>
</div>
</div>
@@ -35,9 +35,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Traffic
Shifting</a>
+ <a href='{{< relref "./request-routing/" >}}'>流量迁移</a>
</h4>
- <p>Shows you how to migrate traffic from an old to new version
of a service.</p>
+ <p>演示如何将流量从服务的旧版本迁移到新版本。</p>
</div>
</div>
</div>
@@ -45,10 +45,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>TCP Traffic
Shifting</a>
- <p>Shows you how to migrate TCP traffic from an old to new
version of a TCP service.</p>
+ <a href='{{< relref "./request-routing/" >}}'>TCP 流量迁移</a>
</h4>
- <p></p>
+ <p>演示如何将 TCP 流量从 TCP 服务的旧版本迁移到新版本。</p>
</div>
</div>
</div>
@@ -56,10 +55,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Request
Timeouts</a>
- <p>This task shows you how to set up request timeouts in
Envoy using Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>请求超时</a>
</h4>
- <p></p>
+ <p>此任务演示如何使用 Istio 在 Envoy 中设置请求超时。</p>
</div>
</div>
</div>
@@ -67,10 +65,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Mirroring</a>
- <p>This task demonstrates the traffic mirroring/shadowing
capabilities of Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>流量镜像</a>
</h4>
- <p></p>
+ <p>此任务演示 Istio 的流量镜像/影子功能。</p>
</div>
</div>
</div>
@@ -78,10 +75,9 @@ weight: 10
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a href='{{< relref "./request-routing/" >}}'>Locality
Load Balancing</a>
- <p>This series of tasks demonstrate how to configure
locality load balancing in Istio.</p>
+ <a href='{{< relref "./request-routing/" >}}'>本地负载均衡</a>
</h4>
- <p></p>
+ <p>此系列任务演示如何在 Istio 中配置本地负载均衡。</p>
</div>
</div>
</div>
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/traffic-management/_index.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/traffic-management/_index.md
index 6811d4244be..b8088a007bb 100755
--- a/content/zh-cn/overview/mannual/java-sdk/tasks/traffic-management/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/tasks/traffic-management/_index.md
@@ -12,107 +12,82 @@ weight: 5
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
- <div class="lead"></div><header class="article-meta">
- </header><div class="row">
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
+ <div class="lead"></div>
+ <header class="article-meta"></header>
+ <div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./timeout/" >}}'>调整超时时间</a>
</h4>
<p>通过在运行期动态的调整服务超时时间，可以有效的应对超时设置不合理、系统突发情况等导致的服务频繁超时、服务阻塞等问题，提升系统稳定性。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./retry/" >}}'>增加重试次数</a>
</h4>
<p>在服务初次调用失败后，通过重试能有效的提升总体调用成功率。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./accesslog/" >}}'>访问日志</a>
</h4>
- <p>访问日志可以很好的记录某台机器在某段时间内处理的所有服务请求信息，运行态动态的开启访问日志对于排查问题非常有帮助。
- </p>
+
<p>访问日志可以很好的记录某台机器在某段时间内处理的所有服务请求信息，运行态动态的开启访问日志对于排查问题非常有帮助。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./region/" >}}'>同机房/区域优先</a>
</h4>
-
<p>同机房/区域优先是指应用调用服务时，优先调用同机房/区域的服务提供者，避免了跨区域带来的网络延时，从而减少了调用的响应时间。
- </p>
+
<p>同机房/区域优先是指应用调用服务时，优先调用同机房/区域的服务提供者，避免了跨区域带来的网络延时，从而减少了调用的响应时间。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./isolation/" >}}'>环境隔离</a>
</h4>
- <p>通过为集群中的某一个或多个应用划分逻辑隔离环境，可用于灰度环境或多套测试环境搭建。
- </p>
+ <p>通过为集群中的某一个或多个应用划分逻辑隔离环境，可用于灰度环境或多套测试环境搭建。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./arguments/" >}}'>参数路由</a>
</h4>
- <p>如基于用户 ID 路由流量，将一小部分用户请求转发到最新发布的产品版本，以验证新版本的稳定性、获取用户的产品体验反馈等。
- </p>
+ <p>如基于用户 ID
路由流量，将一小部分用户请求转发到最新发布的产品版本，以验证新版本的稳定性、获取用户的产品体验反馈等。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./weight/" >}}'>权重比例</a>
</h4>
- <p>通过规则动态调整单个或一组机器的权重，可以在运行态改变请求流量的分布，实现动态的按比例的流量路由。
- </p>
+ <p>通过规则动态调整单个或一组机器的权重，可以在运行态改变请求流量的分布，实现动态的按比例的流量路由。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./mock/" >}}'>服务降级</a>
</h4>
- <p>服务降级的核心目标就是针对这些弱依赖项，在弱依赖不可用或调用失败时，通过返回降级结果尽可能的维持功能完整。
- </p>
+ <p>服务降级的核心目标就是针对这些弱依赖项，在弱依赖不可用或调用失败时，通过返回降级结果尽可能的维持功能完整。</p>
</div>
</div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100">
<h4 class="card-title">
<a href='{{< relref "./host/" >}}'>固定机器导流</a>
</h4>
- <p>通过将请求固定的转发某一台提供者机器，帮助快速复现开发或线上问题。
- </p>
+ <p>通过将请求固定的转发某一台提供者机器，帮助快速复现开发或线上问题。</p>
</div>
</div>
</div>
+ <hr>
</div>
-<hr>
-</div>
-
{{< /blocks/section >}}
