You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by ju...@apache.org on 2021/02/26 13:40:16 UTC
[apisix] branch master updated: docs: Added title to markdown under
`docs` (#3685)
This is an automated email from the ASF dual-hosted git repository.
juzhiyuan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix.git
The following commit(s) were added to refs/heads/master by this push:
new 9c5ba91 docs: Added title to markdown under `docs` (#3685)
9c5ba91 is described below
commit 9c5ba9184ad000ee97afe808ade029f4bebc1771
Author: guoqqqi <72...@users.noreply.github.com>
AuthorDate: Fri Feb 26 21:40:08 2021 +0800
docs: Added title to markdown under `docs` (#3685)
---
docs/en/latest/admin-api.md | 6 +++++-
docs/en/latest/architecture-design.md | 4 ++++
docs/en/latest/aws.md | 6 ++++--
docs/en/latest/batch-processor.md | 6 ++++--
docs/en/latest/benchmark.md | 4 ++++
docs/en/latest/control-api.md | 4 ++++
docs/en/latest/customize-nginx-configuration.md | 6 ++++--
docs/en/latest/debug-function.md | 4 ++++
docs/en/latest/discovery.md | 6 ++++--
docs/en/latest/discovery/consul_kv.md | 4 ++++
docs/en/latest/dns.md | 4 ++++
.../examples/plugins-hmac-auth-generate-signature.md | 6 ++++--
docs/en/latest/getting-started.md | 6 +++++-
docs/en/latest/grpc-proxy.md | 6 ++++--
docs/en/latest/health-check.md | 6 +++++-
docs/en/latest/how-to-build.md | 6 ++++--
docs/en/latest/https.md | 6 ++++--
docs/en/latest/install-dependencies.md | 18 ++++++++++--------
docs/en/latest/mtls.md | 6 ++++--
docs/en/latest/plugin-develop.md | 6 +++++-
docs/en/latest/plugin-interceptors.md | 6 ++++--
docs/en/latest/plugins.md | 4 ++++
docs/en/latest/plugins/api-breaker.md | 6 +++++-
docs/en/latest/plugins/authz-keycloak.md | 6 +++++-
docs/en/latest/plugins/basic-auth.md | 6 +++++-
docs/en/latest/plugins/batch-requests.md | 6 +++++-
docs/en/latest/plugins/consumer-restriction.md | 6 +++++-
docs/en/latest/plugins/cors.md | 6 +++++-
docs/en/latest/plugins/dubbo-proxy.md | 6 +++++-
docs/en/latest/plugins/echo.md | 6 +++++-
docs/en/latest/plugins/error-log-logger.md | 6 +++++-
docs/en/latest/plugins/fault-injection.md | 4 ++++
docs/en/latest/plugins/grpc-transcode.md | 4 ++++
docs/en/latest/plugins/hmac-auth.md | 6 +++++-
docs/en/latest/plugins/http-logger.md | 6 +++++-
docs/en/latest/plugins/ip-restriction.md | 6 +++++-
docs/en/latest/plugins/jwt-auth.md | 6 +++++-
docs/en/latest/plugins/kafka-logger.md | 6 +++++-
docs/en/latest/plugins/key-auth.md | 6 +++++-
docs/en/latest/plugins/limit-conn.md | 6 +++++-
docs/en/latest/plugins/limit-count.md | 6 +++++-
docs/en/latest/plugins/limit-req.md | 6 +++++-
docs/en/latest/plugins/log-rotate.md | 4 ++++
docs/en/latest/plugins/mqtt-proxy.md | 6 +++++-
docs/en/latest/plugins/node-status.md | 6 +++++-
docs/en/latest/plugins/openid-connect.md | 6 +++++-
docs/en/latest/plugins/prometheus.md | 6 ++++--
docs/en/latest/plugins/proxy-cache.md | 6 ++++--
docs/en/latest/plugins/proxy-mirror.md | 6 ++++--
docs/en/latest/plugins/proxy-rewrite.md | 6 +++++-
docs/en/latest/plugins/redirect.md | 6 +++++-
docs/en/latest/plugins/referer-restriction.md | 6 +++++-
docs/en/latest/plugins/request-id.md | 6 +++++-
docs/en/latest/plugins/request-validation.md | 6 +++++-
docs/en/latest/plugins/response-rewrite.md | 6 +++++-
docs/en/latest/plugins/server-info.md | 6 +++++-
docs/en/latest/plugins/serverless.md | 6 +++++-
docs/en/latest/plugins/skywalking.md | 6 +++++-
docs/en/latest/plugins/sls-logger.md | 6 +++++-
docs/en/latest/plugins/syslog.md | 6 +++++-
docs/en/latest/plugins/tcp-logger.md | 6 +++++-
docs/en/latest/plugins/traffic-split.md | 6 +++++-
docs/en/latest/plugins/udp-logger.md | 6 +++++-
docs/en/latest/plugins/uri-blocker.md | 6 +++++-
docs/en/latest/plugins/wolf-rbac.md | 6 +++++-
docs/en/latest/plugins/zipkin.md | 6 +++++-
docs/en/latest/powered-by.md | 8 +++++---
docs/en/latest/profile.md | 6 ++++--
docs/en/latest/router-radixtree.md | 6 ++++--
docs/en/latest/stand-alone.md | 6 ++++--
docs/en/latest/stream-proxy.md | 6 ++++--
docs/zh/latest/admin-api.md | 6 +++++-
docs/zh/latest/architecture-design.md | 6 +++++-
docs/zh/latest/batch-processor.md | 6 ++++--
docs/zh/latest/benchmark.md | 4 ++++
docs/zh/latest/customize-nginx-configuration.md | 6 ++++--
docs/zh/latest/debug-function.md | 4 ++++
docs/zh/latest/discovery.md | 6 ++++--
docs/zh/latest/getting-started.md | 6 ++++--
docs/zh/latest/grpc-proxy.md | 6 ++++--
docs/zh/latest/health-check.md | 4 ++++
docs/zh/latest/how-to-build.md | 6 ++++--
docs/zh/latest/https.md | 6 ++++--
docs/zh/latest/install-dependencies.md | 18 ++++++++++--------
docs/zh/latest/mtls.md | 6 ++++--
docs/zh/latest/plugin-develop.md | 6 +++++-
docs/zh/latest/plugin-interceptors.md | 6 ++++--
docs/zh/latest/plugins.md | 4 ++++
docs/zh/latest/plugins/api-breaker.md | 6 +++++-
docs/zh/latest/plugins/authz-keycloak.md | 6 +++++-
docs/zh/latest/plugins/basic-auth.md | 6 +++++-
docs/zh/latest/plugins/batch-requests.md | 6 +++++-
docs/zh/latest/plugins/consumer-restriction.md | 6 +++++-
docs/zh/latest/plugins/cors.md | 6 +++++-
docs/zh/latest/plugins/echo.md | 6 +++++-
docs/zh/latest/plugins/error-log-logger.md | 6 +++++-
docs/zh/latest/plugins/fault-injection.md | 6 ++++--
docs/zh/latest/plugins/grpc-transcode.md | 6 ++++--
docs/zh/latest/plugins/hmac-auth.md | 6 +++++-
docs/zh/latest/plugins/http-logger.md | 6 +++++-
docs/zh/latest/plugins/ip-restriction.md | 6 +++++-
docs/zh/latest/plugins/jwt-auth.md | 6 +++++-
docs/zh/latest/plugins/kafka-logger.md | 6 +++++-
docs/zh/latest/plugins/key-auth.md | 6 +++++-
docs/zh/latest/plugins/limit-conn.md | 6 ++++--
docs/zh/latest/plugins/limit-count.md | 6 +++++-
docs/zh/latest/plugins/limit-req.md | 6 +++++-
docs/zh/latest/plugins/log-rotate.md | 6 ++++--
docs/zh/latest/plugins/mqtt-proxy.md | 6 +++++-
docs/zh/latest/plugins/node-status.md | 6 +++++-
docs/zh/latest/plugins/openid-connect.md | 6 +++++-
docs/zh/latest/plugins/prometheus.md | 6 ++++--
docs/zh/latest/plugins/proxy-cache.md | 6 ++++--
docs/zh/latest/plugins/proxy-mirror.md | 6 ++++--
docs/zh/latest/plugins/proxy-rewrite.md | 6 +++++-
docs/zh/latest/plugins/redirect.md | 6 ++++--
docs/zh/latest/plugins/referer-restriction.md | 6 +++++-
docs/zh/latest/plugins/request-id.md | 6 +++++-
docs/zh/latest/plugins/request-validation.md | 6 +++++-
docs/zh/latest/plugins/response-rewrite.md | 6 +++++-
docs/zh/latest/plugins/server-info.md | 6 +++++-
docs/zh/latest/plugins/serverless.md | 6 ++++--
docs/zh/latest/plugins/skywalking.md | 6 +++++-
docs/zh/latest/plugins/sls-logger.md | 6 +++++-
docs/zh/latest/plugins/syslog.md | 6 +++++-
docs/zh/latest/plugins/tcp-logger.md | 6 +++++-
docs/zh/latest/plugins/traffic-split.md | 6 +++++-
docs/zh/latest/plugins/udp-logger.md | 6 +++++-
docs/zh/latest/plugins/uri-blocker.md | 6 +++++-
docs/zh/latest/plugins/wolf-rbac.md | 6 +++++-
docs/zh/latest/plugins/zipkin.md | 6 +++++-
docs/zh/latest/profile.md | 6 ++++--
docs/zh/latest/stand-alone.md | 6 ++++--
docs/zh/latest/stream-proxy.md | 9 +++++----
134 files changed, 629 insertions(+), 176 deletions(-)
diff --git a/docs/en/latest/admin-api.md b/docs/en/latest/admin-api.md
index 3e146b0..62a107c 100644
--- a/docs/en/latest/admin-api.md
+++ b/docs/en/latest/admin-api.md
@@ -1,3 +1,7 @@
+---
+title: Admin API
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Table of Contents
+## Table of Contents
* [Route](#route)
* [Service](#service)
diff --git a/docs/en/latest/architecture-design.md b/docs/en/latest/architecture-design.md
index a1ad7cc..6366f1c 100644
--- a/docs/en/latest/architecture-design.md
+++ b/docs/en/latest/architecture-design.md
@@ -1,3 +1,7 @@
+---
+title: Architecture Design
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/aws.md b/docs/en/latest/aws.md
index b3a3597..07a0e7d 100644
--- a/docs/en/latest/aws.md
+++ b/docs/en/latest/aws.md
@@ -1,3 +1,7 @@
+---
+title: Running APISIX in AWS with AWS CDK
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Running APISIX in AWS with AWS CDK
-
[APISIX](https://github.com/apache/apisix) is a cloud-native microservices API gateway, delivering the ultimate performance, security, open source and scalable platform for all your APIs and microservices.
## Architecture
diff --git a/docs/en/latest/batch-processor.md b/docs/en/latest/batch-processor.md
index b181aa6..64c96df 100644
--- a/docs/en/latest/batch-processor.md
+++ b/docs/en/latest/batch-processor.md
@@ -1,3 +1,7 @@
+---
+title: Batch Processor
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Batch Processor
-
The batch processor can be used to aggregate entries(logs/any data) and process them in a batch.
When the batch_max_size is set to zero the processor will execute each entry immediately. Setting the batch max size more
than 1 will start aggregating the entries until it reaches the max size or the timeout expires.
diff --git a/docs/en/latest/benchmark.md b/docs/en/latest/benchmark.md
index 9fcc178..a53cd9e 100644
--- a/docs/en/latest/benchmark.md
+++ b/docs/en/latest/benchmark.md
@@ -1,3 +1,7 @@
+---
+title: Benchmark
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/control-api.md b/docs/en/latest/control-api.md
index 37473a7..09ee2c9 100644
--- a/docs/en/latest/control-api.md
+++ b/docs/en/latest/control-api.md
@@ -1,3 +1,7 @@
+---
+title: Control API
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/customize-nginx-configuration.md b/docs/en/latest/customize-nginx-configuration.md
index 63cbf0b..5721396 100644
--- a/docs/en/latest/customize-nginx-configuration.md
+++ b/docs/en/latest/customize-nginx-configuration.md
@@ -1,3 +1,7 @@
+---
+title: Customize Nginx configuration
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Customize Nginx configuration
-
The Nginx configuration used by APISIX is generated via the template file `apisix/ngx_tpl.lua` and the options from `conf/config-default.yaml` / `conf/config.yaml`.
You can take a look at the generated Nginx configuration in `conf/nginx.conf` after running `./bin/apisix start`.
diff --git a/docs/en/latest/debug-function.md b/docs/en/latest/debug-function.md
index ef2b480..f0ff31d 100644
--- a/docs/en/latest/debug-function.md
+++ b/docs/en/latest/debug-function.md
@@ -1,3 +1,7 @@
+---
+title: Debug Function
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/discovery.md b/docs/en/latest/discovery.md
index 5572631..4a98cb2 100644
--- a/docs/en/latest/discovery.md
+++ b/docs/en/latest/discovery.md
@@ -1,3 +1,7 @@
+---
+title: Integration service discovery registry
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Integration service discovery registry
-
* [**Summary**](#summary)
* [**Supported discovery registries**](#supported-discovery-registries)
* [**How to extend the discovery client?**](#how-to-extend-the-discovery-client)
diff --git a/docs/en/latest/discovery/consul_kv.md b/docs/en/latest/discovery/consul_kv.md
index 6b1209b..c336529 100644
--- a/docs/en/latest/discovery/consul_kv.md
+++ b/docs/en/latest/discovery/consul_kv.md
@@ -1,3 +1,7 @@
+---
+title: consul_kv
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/dns.md b/docs/en/latest/dns.md
index 3268127..7d074ba 100644
--- a/docs/en/latest/dns.md
+++ b/docs/en/latest/dns.md
@@ -1,3 +1,7 @@
+---
+title: DNS
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/examples/plugins-hmac-auth-generate-signature.md b/docs/en/latest/examples/plugins-hmac-auth-generate-signature.md
index 1e38bd5..136be27 100644
--- a/docs/en/latest/examples/plugins-hmac-auth-generate-signature.md
+++ b/docs/en/latest/examples/plugins-hmac-auth-generate-signature.md
@@ -1,3 +1,7 @@
+---
+title: HMAC Generate Signature Examples
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# HMAC Generate Signature Examples
-
## Python 3
```python
diff --git a/docs/en/latest/getting-started.md b/docs/en/latest/getting-started.md
index 30bfa59..6592631 100644
--- a/docs/en/latest/getting-started.md
+++ b/docs/en/latest/getting-started.md
@@ -1,3 +1,7 @@
+---
+title: Getting Started
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Quick Start Guide
+## Quick Start Guide
The goal of this guide is to get started with APISIX and to configure a secured public API with APISIX.
By the end of this guide, you will have a working APISIX setup and a new service which will route to a public API, which is secured by an API key.
diff --git a/docs/en/latest/grpc-proxy.md b/docs/en/latest/grpc-proxy.md
index 72bc5f0..07cbf1f 100644
--- a/docs/en/latest/grpc-proxy.md
+++ b/docs/en/latest/grpc-proxy.md
@@ -1,3 +1,7 @@
+---
+title: grpc-proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# grpc-proxy
-
proxying gRPC traffic:
gRPC client -> APISIX -> gRPC/gRPCS server
diff --git a/docs/en/latest/health-check.md b/docs/en/latest/health-check.md
index fa2b04f..285a926 100644
--- a/docs/en/latest/health-check.md
+++ b/docs/en/latest/health-check.md
@@ -1,3 +1,7 @@
+---
+title: Health Check
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Health Checks for Upstream
+## Health Checks for Upstream
Health Check of APISIX is based on [lua-resty-healthcheck](https://github.com/Kong/lua-resty-healthcheck),
you can use it for upstream.
diff --git a/docs/en/latest/how-to-build.md b/docs/en/latest/how-to-build.md
index cf9562c..2dfcc1a 100644
--- a/docs/en/latest/how-to-build.md
+++ b/docs/en/latest/how-to-build.md
@@ -1,3 +1,7 @@
+---
+title: Build Apache APISIX
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Build Apache APISIX
-
## 1. Install dependencies
The runtime environment for Apache APISIX requires Nginx and etcd.
diff --git a/docs/en/latest/https.md b/docs/en/latest/https.md
index 49fc969..30c2325 100644
--- a/docs/en/latest/https.md
+++ b/docs/en/latest/https.md
@@ -1,3 +1,7 @@
+---
+title: HTTPS
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-### HTTPS
-
`APISIX` supports to load multiple SSL certificates by TLS extension Server Name Indication (SNI).
### Single SNI
diff --git a/docs/en/latest/install-dependencies.md b/docs/en/latest/install-dependencies.md
index 66008de..41917cb 100644
--- a/docs/en/latest/install-dependencies.md
+++ b/docs/en/latest/install-dependencies.md
@@ -1,3 +1,7 @@
+---
+title: Install Dependencies
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Install Dependencies
-
- [Install Dependencies](#install-dependencies)
- [Note](#note)
- [CentOS 7](#centos-7)
@@ -27,7 +29,7 @@
- [Debian 9 & 10](#debian-9--10)
- [Mac OSX](#mac-osx)
-# Note
+## Note
- Since v2.0 Apache APISIX would not support the v2 protocol storage to etcd anymore, and the minimum etcd version supported is v3.4.0. What's more, etcd v3 uses gRPC as the messaging protocol, while Apache APISIX uses HTTP(S) to communicate with etcd cluster, so be sure the [etcd gRPC gateway](https://etcd.io/docs/v3.4.0/dev-guide/api_grpc_gateway/) is enabled.
@@ -41,7 +43,7 @@
- WARNING: If you are using OpenResty which is older than `1.17.8`, please installing openresty-openss-devel instead of openresty-openssl111-devel.
-# CentOS 7
+## CentOS 7
```shell
# install etcd
@@ -64,7 +66,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Fedora 31 & 32
+## Fedora 31 & 32
```shell
# add OpenResty source
@@ -87,7 +89,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Ubuntu 16.04 & 18.04
+## Ubuntu 16.04 & 18.04
```shell
# add OpenResty source
@@ -113,7 +115,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Debian 9 & 10
+## Debian 9 & 10
```shell
# optional
@@ -144,7 +146,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Mac OSX
+## Mac OSX
```shell
# install OpenResty, etcd and some compilation tools
diff --git a/docs/en/latest/mtls.md b/docs/en/latest/mtls.md
index 70dded6..f983226 100644
--- a/docs/en/latest/mtls.md
+++ b/docs/en/latest/mtls.md
@@ -1,3 +1,7 @@
+---
+title: Mutual TLS authentication
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## Mutual TLS authentication
-
### Why use it
Mutual TLS authentication provides a better way to prevent unauthorized access to APISIX.
diff --git a/docs/en/latest/plugin-develop.md b/docs/en/latest/plugin-develop.md
index 275c84f..02d40dd 100644
--- a/docs/en/latest/plugin-develop.md
+++ b/docs/en/latest/plugin-develop.md
@@ -1,3 +1,7 @@
+---
+title: Plugin Develop
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# table of contents
+## table of contents
- [**where to put your plugins**](#where-to-put-your-plugins)
- [**check dependencies**](#check-dependencies)
diff --git a/docs/en/latest/plugin-interceptors.md b/docs/en/latest/plugin-interceptors.md
index ddd524e..1ce36cc 100644
--- a/docs/en/latest/plugin-interceptors.md
+++ b/docs/en/latest/plugin-interceptors.md
@@ -1,3 +1,7 @@
+---
+title: Plugin interceptors
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## Plugin interceptors
-
Some plugins will register API to serve their purposes.
Since these API are not added as regular [Route](admin-api.md), we can't add
diff --git a/docs/en/latest/plugins.md b/docs/en/latest/plugins.md
index c9329be..f7a404d 100644
--- a/docs/en/latest/plugins.md
+++ b/docs/en/latest/plugins.md
@@ -1,3 +1,7 @@
+---
+title: Plugins
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/plugins/api-breaker.md b/docs/en/latest/plugins/api-breaker.md
index 7b4e81a..a46d2c8 100644
--- a/docs/en/latest/plugins/api-breaker.md
+++ b/docs/en/latest/plugins/api-breaker.md
@@ -1,3 +1,7 @@
+---
+title: api-breaker
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/authz-keycloak.md b/docs/en/latest/plugins/authz-keycloak.md
index e9f0b2a..dcefb57 100644
--- a/docs/en/latest/plugins/authz-keycloak.md
+++ b/docs/en/latest/plugins/authz-keycloak.md
@@ -1,3 +1,7 @@
+---
+title: authz-keycloak
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/basic-auth.md b/docs/en/latest/plugins/basic-auth.md
index 55a3831..2ea4744 100644
--- a/docs/en/latest/plugins/basic-auth.md
+++ b/docs/en/latest/plugins/basic-auth.md
@@ -1,3 +1,7 @@
+---
+title: basic-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/batch-requests.md b/docs/en/latest/plugins/batch-requests.md
index 5e2824f..feb799b 100644
--- a/docs/en/latest/plugins/batch-requests.md
+++ b/docs/en/latest/plugins/batch-requests.md
@@ -1,3 +1,7 @@
+---
+title: batch-requests
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Description**](#description)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/consumer-restriction.md b/docs/en/latest/plugins/consumer-restriction.md
index ce1ccb2..137924d 100644
--- a/docs/en/latest/plugins/consumer-restriction.md
+++ b/docs/en/latest/plugins/consumer-restriction.md
@@ -1,3 +1,7 @@
+---
+title: consumer-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [Introduction](#introduction)
- [Attributes](#attributes)
diff --git a/docs/en/latest/plugins/cors.md b/docs/en/latest/plugins/cors.md
index 48d69ff..bd3ee75 100644
--- a/docs/en/latest/plugins/cors.md
+++ b/docs/en/latest/plugins/cors.md
@@ -1,3 +1,7 @@
+---
+title: cors
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Description**](#description)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/dubbo-proxy.md b/docs/en/latest/plugins/dubbo-proxy.md
index eaaeb4f..82ab574 100644
--- a/docs/en/latest/plugins/dubbo-proxy.md
+++ b/docs/en/latest/plugins/dubbo-proxy.md
@@ -1,3 +1,7 @@
+---
+title: dubbo-proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Requirement**](#requirement)
diff --git a/docs/en/latest/plugins/echo.md b/docs/en/latest/plugins/echo.md
index 911738e..af26611 100644
--- a/docs/en/latest/plugins/echo.md
+++ b/docs/en/latest/plugins/echo.md
@@ -1,3 +1,7 @@
+---
+title: echo
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/error-log-logger.md b/docs/en/latest/plugins/error-log-logger.md
index e0d5623..6ceab8d 100644
--- a/docs/en/latest/plugins/error-log-logger.md
+++ b/docs/en/latest/plugins/error-log-logger.md
@@ -1,3 +1,7 @@
+---
+title: error-log-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/fault-injection.md b/docs/en/latest/plugins/fault-injection.md
index f6d4ce4..0f329b4 100644
--- a/docs/en/latest/plugins/fault-injection.md
+++ b/docs/en/latest/plugins/fault-injection.md
@@ -1,3 +1,7 @@
+---
+title: fault-injection
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/plugins/grpc-transcode.md b/docs/en/latest/plugins/grpc-transcode.md
index a6ce656..2fab33a 100644
--- a/docs/en/latest/plugins/grpc-transcode.md
+++ b/docs/en/latest/plugins/grpc-transcode.md
@@ -1,3 +1,7 @@
+---
+title: grpc-transcode
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/plugins/hmac-auth.md b/docs/en/latest/plugins/hmac-auth.md
index 282cce4..2843f3d 100644
--- a/docs/en/latest/plugins/hmac-auth.md
+++ b/docs/en/latest/plugins/hmac-auth.md
@@ -1,3 +1,7 @@
+---
+title: hmac-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/http-logger.md b/docs/en/latest/plugins/http-logger.md
index 72d3583..84bc743 100644
--- a/docs/en/latest/plugins/http-logger.md
+++ b/docs/en/latest/plugins/http-logger.md
@@ -1,3 +1,7 @@
+---
+title: http-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/ip-restriction.md b/docs/en/latest/plugins/ip-restriction.md
index a12771c..82cee45 100644
--- a/docs/en/latest/plugins/ip-restriction.md
+++ b/docs/en/latest/plugins/ip-restriction.md
@@ -1,3 +1,7 @@
+---
+title: ip-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/jwt-auth.md b/docs/en/latest/plugins/jwt-auth.md
index 9289b6e..dca5d2a 100644
--- a/docs/en/latest/plugins/jwt-auth.md
+++ b/docs/en/latest/plugins/jwt-auth.md
@@ -1,3 +1,7 @@
+---
+title: jwt-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/kafka-logger.md b/docs/en/latest/plugins/kafka-logger.md
index d1f882c..ae7b301 100644
--- a/docs/en/latest/plugins/kafka-logger.md
+++ b/docs/en/latest/plugins/kafka-logger.md
@@ -1,3 +1,7 @@
+---
+title: kafka-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/key-auth.md b/docs/en/latest/plugins/key-auth.md
index 692181a..818a3a7 100644
--- a/docs/en/latest/plugins/key-auth.md
+++ b/docs/en/latest/plugins/key-auth.md
@@ -1,3 +1,7 @@
+---
+title: key-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/limit-conn.md b/docs/en/latest/plugins/limit-conn.md
index a0d735f..364fb5e 100644
--- a/docs/en/latest/plugins/limit-conn.md
+++ b/docs/en/latest/plugins/limit-conn.md
@@ -1,3 +1,7 @@
+---
+title: limit-conn
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/limit-count.md b/docs/en/latest/plugins/limit-count.md
index 9fc3e64..be13d45 100644
--- a/docs/en/latest/plugins/limit-count.md
+++ b/docs/en/latest/plugins/limit-count.md
@@ -1,3 +1,7 @@
+---
+title: limit-connt
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [Name](#name)
- [Attributes](#attributes)
diff --git a/docs/en/latest/plugins/limit-req.md b/docs/en/latest/plugins/limit-req.md
index 8da2eee..f160eaa 100644
--- a/docs/en/latest/plugins/limit-req.md
+++ b/docs/en/latest/plugins/limit-req.md
@@ -1,3 +1,7 @@
+---
+title: limit-req
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [Introduction](#introduction)
- [Attributes](#attributes)
diff --git a/docs/en/latest/plugins/log-rotate.md b/docs/en/latest/plugins/log-rotate.md
index 8967775..41bfa65 100644
--- a/docs/en/latest/plugins/log-rotate.md
+++ b/docs/en/latest/plugins/log-rotate.md
@@ -1,3 +1,7 @@
+---
+title: log-rotate
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/en/latest/plugins/mqtt-proxy.md b/docs/en/latest/plugins/mqtt-proxy.md
index ddf6430..ab7f502 100644
--- a/docs/en/latest/plugins/mqtt-proxy.md
+++ b/docs/en/latest/plugins/mqtt-proxy.md
@@ -1,3 +1,7 @@
+---
+title: mqtt-proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/node-status.md b/docs/en/latest/plugins/node-status.md
index 49bbd95..33be2c8 100644
--- a/docs/en/latest/plugins/node-status.md
+++ b/docs/en/latest/plugins/node-status.md
@@ -1,3 +1,7 @@
+---
+title: node-status
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/openid-connect.md b/docs/en/latest/plugins/openid-connect.md
index 087b7a5..43eea5d 100644
--- a/docs/en/latest/plugins/openid-connect.md
+++ b/docs/en/latest/plugins/openid-connect.md
@@ -1,3 +1,7 @@
+---
+title: openid-connect
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/prometheus.md b/docs/en/latest/plugins/prometheus.md
index 493ce14..2f6382e 100644
--- a/docs/en/latest/plugins/prometheus.md
+++ b/docs/en/latest/plugins/prometheus.md
@@ -1,3 +1,7 @@
+---
+title: prometheus
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# prometheus
-
This plugin exposes metrics in Prometheus Exposition format.
## Attributes
diff --git a/docs/en/latest/plugins/proxy-cache.md b/docs/en/latest/plugins/proxy-cache.md
index 94e4089..3616784 100644
--- a/docs/en/latest/plugins/proxy-cache.md
+++ b/docs/en/latest/plugins/proxy-cache.md
@@ -1,3 +1,7 @@
+---
+title: proxy-cache
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# proxy-cache
-
The proxy-cache plugin, which provides the ability to cache upstream response data and can be used with other plugins. The plugin supports disk-based caching and will support the memory-based caching in the future. The data that needs to be cached can be determined by the response code or request method and more complex caching policies can be configured by no_cache and cache_bypass attributes.
*Note*:
diff --git a/docs/en/latest/plugins/proxy-mirror.md b/docs/en/latest/plugins/proxy-mirror.md
index 73635df..5bcde86 100644
--- a/docs/en/latest/plugins/proxy-mirror.md
+++ b/docs/en/latest/plugins/proxy-mirror.md
@@ -1,3 +1,7 @@
+---
+title: proxy-mirror
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# proxy-mirror
-
The proxy-mirror plugin, which provides the ability to mirror client requests.
*Note*: The response returned by the mirror request is ignored.
diff --git a/docs/en/latest/plugins/proxy-rewrite.md b/docs/en/latest/plugins/proxy-rewrite.md
index 5be6c30..c4afb07 100644
--- a/docs/en/latest/plugins/proxy-rewrite.md
+++ b/docs/en/latest/plugins/proxy-rewrite.md
@@ -1,3 +1,7 @@
+---
+title: proxy-rewrite
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/redirect.md b/docs/en/latest/plugins/redirect.md
index 58ad6f2..e6f867d 100644
--- a/docs/en/latest/plugins/redirect.md
+++ b/docs/en/latest/plugins/redirect.md
@@ -1,3 +1,7 @@
+---
+title: redirect
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/referer-restriction.md b/docs/en/latest/plugins/referer-restriction.md
index f18e50c..24fe085 100644
--- a/docs/en/latest/plugins/referer-restriction.md
+++ b/docs/en/latest/plugins/referer-restriction.md
@@ -1,3 +1,7 @@
+---
+title: referer-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/request-id.md b/docs/en/latest/plugins/request-id.md
index 54ec0f0..a77ddc4 100644
--- a/docs/en/latest/plugins/request-id.md
+++ b/docs/en/latest/plugins/request-id.md
@@ -1,3 +1,7 @@
+---
+title: request-id
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/request-validation.md b/docs/en/latest/plugins/request-validation.md
index 503312a..9b36fef 100644
--- a/docs/en/latest/plugins/request-validation.md
+++ b/docs/en/latest/plugins/request-validation.md
@@ -1,3 +1,7 @@
+---
+title: request-validation
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/response-rewrite.md b/docs/en/latest/plugins/response-rewrite.md
index ed0348d..95ef63e 100644
--- a/docs/en/latest/plugins/response-rewrite.md
+++ b/docs/en/latest/plugins/response-rewrite.md
@@ -1,3 +1,7 @@
+---
+title: response-rewrite
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/server-info.md b/docs/en/latest/plugins/server-info.md
index 1378da5..6aacab2 100644
--- a/docs/en/latest/plugins/server-info.md
+++ b/docs/en/latest/plugins/server-info.md
@@ -1,3 +1,7 @@
+---
+title: server-info
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/serverless.md b/docs/en/latest/plugins/serverless.md
index e24ef17..7360ab4 100644
--- a/docs/en/latest/plugins/serverless.md
+++ b/docs/en/latest/plugins/serverless.md
@@ -1,3 +1,7 @@
+---
+title: serverless
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/skywalking.md b/docs/en/latest/plugins/skywalking.md
index d299325..a9eee4d 100644
--- a/docs/en/latest/plugins/skywalking.md
+++ b/docs/en/latest/plugins/skywalking.md
@@ -1,3 +1,7 @@
+---
+title: skywalking
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/sls-logger.md b/docs/en/latest/plugins/sls-logger.md
index 081a031..0569dd8 100644
--- a/docs/en/latest/plugins/sls-logger.md
+++ b/docs/en/latest/plugins/sls-logger.md
@@ -1,3 +1,7 @@
+---
+title: sls-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/syslog.md b/docs/en/latest/plugins/syslog.md
index d8bd93f..e9454b4 100644
--- a/docs/en/latest/plugins/syslog.md
+++ b/docs/en/latest/plugins/syslog.md
@@ -1,3 +1,7 @@
+---
+title: syslog
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/tcp-logger.md b/docs/en/latest/plugins/tcp-logger.md
index 1a99434..e0bbf87 100644
--- a/docs/en/latest/plugins/tcp-logger.md
+++ b/docs/en/latest/plugins/tcp-logger.md
@@ -1,3 +1,7 @@
+---
+title: tcp-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/traffic-split.md b/docs/en/latest/plugins/traffic-split.md
index ebf8ef7..80b84b7 100644
--- a/docs/en/latest/plugins/traffic-split.md
+++ b/docs/en/latest/plugins/traffic-split.md
@@ -1,3 +1,7 @@
+---
+title: traffic-split
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/udp-logger.md b/docs/en/latest/plugins/udp-logger.md
index 17c03ab..57ee799 100644
--- a/docs/en/latest/plugins/udp-logger.md
+++ b/docs/en/latest/plugins/udp-logger.md
@@ -1,3 +1,7 @@
+---
+title: udp-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/uri-blocker.md b/docs/en/latest/plugins/uri-blocker.md
index 170ff33..4d02f9f 100644
--- a/docs/en/latest/plugins/uri-blocker.md
+++ b/docs/en/latest/plugins/uri-blocker.md
@@ -1,3 +1,7 @@
+---
+title: uri-blocker
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/wolf-rbac.md b/docs/en/latest/plugins/wolf-rbac.md
index fd7d7d6..ae68388 100644
--- a/docs/en/latest/plugins/wolf-rbac.md
+++ b/docs/en/latest/plugins/wolf-rbac.md
@@ -1,3 +1,7 @@
+---
+title: wolf-rbac
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/plugins/zipkin.md b/docs/en/latest/plugins/zipkin.md
index e5b4806..f037de1 100644
--- a/docs/en/latest/plugins/zipkin.md
+++ b/docs/en/latest/plugins/zipkin.md
@@ -1,3 +1,7 @@
+---
+title: Zipkin
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## Summary
- [**Name**](#name)
- [**Attributes**](#attributes)
diff --git a/docs/en/latest/powered-by.md b/docs/en/latest/powered-by.md
index 850bb52..2a52e74 100644
--- a/docs/en/latest/powered-by.md
+++ b/docs/en/latest/powered-by.md
@@ -1,3 +1,7 @@
+---
+title: Powered by Apache APISIX
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Powered by Apache APISIX
-
This page documents an alphabetical list of institutions that are using APISIX for research and production,
or providing commercial products including APISIX.
@@ -71,7 +73,7 @@ Users are encouraged to add themselves to this page, [issue](https://github.com/
<img src="https://raw.githubusercontent.com/iresty/iresty.com/master/user-wall.jpg" width="900" height="500">
-# User Cases
+## User Cases
## NASA JPL
diff --git a/docs/en/latest/profile.md b/docs/en/latest/profile.md
index 214bc9d..af226c0 100644
--- a/docs/en/latest/profile.md
+++ b/docs/en/latest/profile.md
@@ -1,3 +1,7 @@
+---
+title: Configuration file switching based on environment variables
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Configuration file switching based on environment variables
-
The reason the configuration is extracted from the code is to better adapt to changes. Usually our applications have different
operating environments such as development environment and production environment. Certain configurations of these applications
will definitely be different, such as the address of the configuration center.
diff --git a/docs/en/latest/router-radixtree.md b/docs/en/latest/router-radixtree.md
index 92ca128..230e038 100644
--- a/docs/en/latest/router-radixtree.md
+++ b/docs/en/latest/router-radixtree.md
@@ -1,3 +1,7 @@
+---
+title: libradixtree
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# libradixtree
-
### what's libradixtree?
[libradixtree](https://github.com/iresty/lua-resty-radixtree), adaptive radix trees implemented in Lua for OpenResty.
diff --git a/docs/en/latest/stand-alone.md b/docs/en/latest/stand-alone.md
index cc4cfa6..f095534 100644
--- a/docs/en/latest/stand-alone.md
+++ b/docs/en/latest/stand-alone.md
@@ -1,3 +1,7 @@
+---
+title: Stand-alone mode
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## Stand-alone mode
-
Turning on the APISIX node in Stand-alone mode will no longer use the default etcd as the configuration center.
This method is more suitable for two types of users:
diff --git a/docs/en/latest/stream-proxy.md b/docs/en/latest/stream-proxy.md
index 42a9364..7eced3e 100644
--- a/docs/en/latest/stream-proxy.md
+++ b/docs/en/latest/stream-proxy.md
@@ -1,3 +1,7 @@
+---
+title: Stream Proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# Stream Proxy
-
TCP is the protocol for many popular applications and services, such as LDAP, MySQL, and RTMP. UDP (User Datagram Protocol) is the protocol for many popular non-transactional applications, such as DNS, syslog, and RADIUS.
APISIX can dynamic load balancing TCP/UDP proxy. In Nginx world, we call TCP/UDP proxy to stream proxy, we followed this statement.
diff --git a/docs/zh/latest/admin-api.md b/docs/zh/latest/admin-api.md
index c968721..0be7887 100644
--- a/docs/zh/latest/admin-api.md
+++ b/docs/zh/latest/admin-api.md
@@ -1,3 +1,7 @@
+---
+title: Admin API
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
* [Route](#route)
* [Service](#service)
diff --git a/docs/zh/latest/architecture-design.md b/docs/zh/latest/architecture-design.md
index b546f74..d33705f 100644
--- a/docs/zh/latest/architecture-design.md
+++ b/docs/zh/latest/architecture-design.md
@@ -1,3 +1,7 @@
+---
+title: 架构设计
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**APISIX**](#apisix)
- [**APISIX Config**](#apisix-config)
diff --git a/docs/zh/latest/batch-processor.md b/docs/zh/latest/batch-processor.md
index d83c20a..62e5b99 100644
--- a/docs/zh/latest/batch-processor.md
+++ b/docs/zh/latest/batch-processor.md
@@ -1,3 +1,7 @@
+---
+title: 批处理机
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 批处理机
-
批处理处理器可用于聚合条目（日志/任何数据）并进行批处理。
当batch_max_size设置为零时，处理器将立即执行每个条目。将批处理的最大大小设置为大于1将开始聚合条目，直到达到最大大小或超时到期为止
diff --git a/docs/zh/latest/benchmark.md b/docs/zh/latest/benchmark.md
index 27f3a08..ea153e7 100644
--- a/docs/zh/latest/benchmark.md
+++ b/docs/zh/latest/benchmark.md
@@ -1,3 +1,7 @@
+---
+title: 基准测试
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/zh/latest/customize-nginx-configuration.md b/docs/zh/latest/customize-nginx-configuration.md
index 67e3c78..ba21633 100644
--- a/docs/zh/latest/customize-nginx-configuration.md
+++ b/docs/zh/latest/customize-nginx-configuration.md
@@ -1,3 +1,7 @@
+---
+title: 自定义 Nginx 配置
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 自定义 Nginx 配置
-
APISIX 会通过 `apisix/ngx_tpl.lua` 这个模板和 `conf/config-default.yaml` 加 `conf/config.yaml` 的配置生成 Nginx 配置文件。
在执行完 `./bin/apisix start`，你可以在 `conf/nginx.conf` 看到生成的 Nginx 配置文件。
diff --git a/docs/zh/latest/debug-function.md b/docs/zh/latest/debug-function.md
index 4d4d0f3..539e67c 100644
--- a/docs/zh/latest/debug-function.md
+++ b/docs/zh/latest/debug-function.md
@@ -1,3 +1,7 @@
+---
+title: 调试功能
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/zh/latest/discovery.md b/docs/zh/latest/discovery.md
index 9988ad7..b0d0367 100644
--- a/docs/zh/latest/discovery.md
+++ b/docs/zh/latest/discovery.md
@@ -1,3 +1,7 @@
+---
+title: 集成服务发现注册中心
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 集成服务发现注册中心
-
* [**摘要**](#摘要)
* [**当前支持的注册中心**](#当前支持的注册中心)
* [**如何扩展注册中心**](#如何扩展注册中心)
diff --git a/docs/zh/latest/getting-started.md b/docs/zh/latest/getting-started.md
index a1e7a6a..e1a6aaf 100644
--- a/docs/zh/latest/getting-started.md
+++ b/docs/zh/latest/getting-started.md
@@ -1,3 +1,7 @@
+---
+title: 快速入门指南
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 快速入门指南
-
本指南的目的是介绍如何使用 APISIX 来配置出一个安全的可以对外提供服务的 API。当您读完本指南，你需要自己安装一下 APISIX 应用，并准备好一个可以对外提供服务的 API，该服务将由 API key 进行访问保护。
本指南会使用到以下 GET 请求，该服务可以回显发送到这个 API 的传参。
diff --git a/docs/zh/latest/grpc-proxy.md b/docs/zh/latest/grpc-proxy.md
index 7e39444..77b19bf 100644
--- a/docs/zh/latest/grpc-proxy.md
+++ b/docs/zh/latest/grpc-proxy.md
@@ -1,3 +1,7 @@
+---
+title: grpc-proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# grpc-proxy
-
通过 APISIX 代理 gRPC 连接，并使用 APISIX 的大部分特性管理你的 gRPC 服务。
## 参数
diff --git a/docs/zh/latest/health-check.md b/docs/zh/latest/health-check.md
index 296f12c..5180e05 100644
--- a/docs/zh/latest/health-check.md
+++ b/docs/zh/latest/health-check.md
@@ -1,3 +1,7 @@
+---
+title: 健康检查
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/zh/latest/how-to-build.md b/docs/zh/latest/how-to-build.md
index 497f588..fe1c7f9 100644
--- a/docs/zh/latest/how-to-build.md
+++ b/docs/zh/latest/how-to-build.md
@@ -1,3 +1,7 @@
+---
+title: 构建 Apache APISIX
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 构建 Apache APISIX
-
## 1. 安装依赖
Apache APISIX 的运行环境需要 Nginx 和 etcd，
diff --git a/docs/zh/latest/https.md b/docs/zh/latest/https.md
index e19b5da..e8ed5d2 100644
--- a/docs/zh/latest/https.md
+++ b/docs/zh/latest/https.md
@@ -1,3 +1,7 @@
+---
+title: HTTPS
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-### HTTPS
-
`APISIX` 支持通过 TLS 扩展 SNI 实现加载特定的 SSL 证书以实现对 https 的支持。
SNI(Server Name Indication)是用来改善 SSL 和 TLS 的一项特性，它允许客户端在服务器端向其发送证书之前向服务器端发送请求的域名，服务器端根据客户端请求的域名选择合适的SSL证书发送给客户端。
diff --git a/docs/zh/latest/install-dependencies.md b/docs/zh/latest/install-dependencies.md
index f588556..5a278f1 100644
--- a/docs/zh/latest/install-dependencies.md
+++ b/docs/zh/latest/install-dependencies.md
@@ -1,3 +1,7 @@
+---
+title: 安装依赖
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 安装依赖
-
- [注意](#注意)
- [CentOS 7](#centos-7)
- [Fedora 31 & 32](#fedora-31--32)
@@ -26,7 +28,7 @@
- [Debian 9 & 10](#debian-9--10)
- [Mac OSX](#mac-osx)
-# 注意
+## 注意
- Apache APISIX 从 v2.0 开始不再支持 `v2` 版本的 etcd，并且 etcd 最低支持版本为 v3.4.0，因此请使用 etcd 3.4.0+。更重要的是，因为 etcd v3 使用 gPRC 作为消息传递协议，而 Apache APISIX 使用 HTTP(S) 与 etcd 集群通信，因此请确保启用 [etcd gRPC gateway](https://etcd.io/docs/v3.4.0/dev-guide/api_grpc_gateway/) 功能。
@@ -40,7 +42,7 @@
- 警告：如果你正在使用低于 `1.17.8` 的 OpenResty 版本，请安装 openresty-openssl-devel，而不是 openresty-openssl111-devel。
-# CentOS 7
+## CentOS 7
```shell
# 安装 etcd
@@ -63,7 +65,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Fedora 31 & 32
+## Fedora 31 & 32
```shell
# 添加 OpenResty 源
@@ -86,7 +88,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Ubuntu 16.04 & 18.04
+## Ubuntu 16.04 & 18.04
```shell
# 添加 OpenResty 源
@@ -112,7 +114,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Debian 9 & 10
+## Debian 9 & 10
```shell
# 可选
@@ -143,7 +145,7 @@ curl https://raw.githubusercontent.com/apache/apisix/master/utils/linux-install-
nohup etcd &
```
-# Mac OSX
+## Mac OSX
```shell
# 安装 OpenResty, etcd 和 编译工具
diff --git a/docs/zh/latest/mtls.md b/docs/zh/latest/mtls.md
index c5c25d8..c0b1fed 100644
--- a/docs/zh/latest/mtls.md
+++ b/docs/zh/latest/mtls.md
@@ -1,3 +1,7 @@
+---
+title: 双向认证
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## 双向认证
-
### 为什么使用
双向认证可以更好的防止未经授权访问 APISIX ，客户端将向服务器提供其证书，服务器将检查证书是否由提供的 CA 签名并决定是否响应请求。
diff --git a/docs/zh/latest/plugin-develop.md b/docs/zh/latest/plugin-develop.md
index 28b1548..9b947fb 100644
--- a/docs/zh/latest/plugin-develop.md
+++ b/docs/zh/latest/plugin-develop.md
@@ -1,3 +1,7 @@
+---
+title: 插件开发
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**检查外部依赖**](#检查外部依赖)
- [**插件命名与配置**](#插件命名与配置)
diff --git a/docs/zh/latest/plugin-interceptors.md b/docs/zh/latest/plugin-interceptors.md
index 099ed1c..9caad0a 100644
--- a/docs/zh/latest/plugin-interceptors.md
+++ b/docs/zh/latest/plugin-interceptors.md
@@ -1,3 +1,7 @@
+---
+title: 插件拦截器
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## Plugin interceptors
-
有些插件为实现它的功能会注册额外的接口。
由于这些接口不是通过 admin API 添加的，所以没办法像管理 Route 那样管理它们。为了能够保护这些接口不被利用，我们引入了 interceptors 的概念。
diff --git a/docs/zh/latest/plugins.md b/docs/zh/latest/plugins.md
index 3279180..d214683 100644
--- a/docs/zh/latest/plugins.md
+++ b/docs/zh/latest/plugins.md
@@ -1,3 +1,7 @@
+---
+title: 插件
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/zh/latest/plugins/api-breaker.md b/docs/zh/latest/plugins/api-breaker.md
index d89342a..25d203c 100644
--- a/docs/zh/latest/plugins/api-breaker.md
+++ b/docs/zh/latest/plugins/api-breaker.md
@@ -1,3 +1,7 @@
+---
+title: api-breaker
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/authz-keycloak.md b/docs/zh/latest/plugins/authz-keycloak.md
index 33b3f2f..a876f84 100644
--- a/docs/zh/latest/plugins/authz-keycloak.md
+++ b/docs/zh/latest/plugins/authz-keycloak.md
@@ -1,3 +1,7 @@
+---
+title: authz-keycloak
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/basic-auth.md b/docs/zh/latest/plugins/basic-auth.md
index 4a219f9..fa57e0d 100644
--- a/docs/zh/latest/plugins/basic-auth.md
+++ b/docs/zh/latest/plugins/basic-auth.md
@@ -1,3 +1,7 @@
+---
+title: basic-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/batch-requests.md b/docs/zh/latest/plugins/batch-requests.md
index 9839242..aa42e30 100644
--- a/docs/zh/latest/plugins/batch-requests.md
+++ b/docs/zh/latest/plugins/batch-requests.md
@@ -1,3 +1,7 @@
+---
+title: batch-requests
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**简介**](#简介)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/consumer-restriction.md b/docs/zh/latest/plugins/consumer-restriction.md
index 7463360..dfc1c8e 100644
--- a/docs/zh/latest/plugins/consumer-restriction.md
+++ b/docs/zh/latest/plugins/consumer-restriction.md
@@ -1,3 +1,7 @@
+---
+title: consumer-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [简介](#简介)
- [属性](#属性)
diff --git a/docs/zh/latest/plugins/cors.md b/docs/zh/latest/plugins/cors.md
index 5d6d025..cef32de 100644
--- a/docs/zh/latest/plugins/cors.md
+++ b/docs/zh/latest/plugins/cors.md
@@ -1,3 +1,7 @@
+---
+title: cors
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**简介**](#简介)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/echo.md b/docs/zh/latest/plugins/echo.md
index d717a17..c9df63c 100644
--- a/docs/zh/latest/plugins/echo.md
+++ b/docs/zh/latest/plugins/echo.md
@@ -1,3 +1,7 @@
+---
+title: echo
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**简介**](#简介)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/error-log-logger.md b/docs/zh/latest/plugins/error-log-logger.md
index c2af9e0..fd19c1b 100644
--- a/docs/zh/latest/plugins/error-log-logger.md
+++ b/docs/zh/latest/plugins/error-log-logger.md
@@ -1,3 +1,7 @@
+---
+title: error-log-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 摘要
+## 摘要
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/fault-injection.md b/docs/zh/latest/plugins/fault-injection.md
index 42c368b..cb4b8a3 100644
--- a/docs/zh/latest/plugins/fault-injection.md
+++ b/docs/zh/latest/plugins/fault-injection.md
@@ -1,3 +1,7 @@
+---
+title: fault-injection
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# fault-injection
-
故障注入插件，该插件可以和其他插件一起使用，并且会在其他插件前被执行，配置 `abort` 参数将直接返回给客户端指定的响应码并且终止其他插件的执行，配置 `delay` 参数将延迟某个请求，并且还会执行配置的其他插件。
## 参数
diff --git a/docs/zh/latest/plugins/grpc-transcode.md b/docs/zh/latest/plugins/grpc-transcode.md
index 75d95d6..e2a5f54 100644
--- a/docs/zh/latest/plugins/grpc-transcode.md
+++ b/docs/zh/latest/plugins/grpc-transcode.md
@@ -1,3 +1,7 @@
+---
+title: grpc-transcode
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# grpc-transcode
-
HTTP(s) -> APISIX -> gRPC server
## Proto
diff --git a/docs/zh/latest/plugins/hmac-auth.md b/docs/zh/latest/plugins/hmac-auth.md
index f40d655..6f8a229 100644
--- a/docs/zh/latest/plugins/hmac-auth.md
+++ b/docs/zh/latest/plugins/hmac-auth.md
@@ -1,3 +1,7 @@
+---
+title: hmac-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/http-logger.md b/docs/zh/latest/plugins/http-logger.md
index bce2130..3120177 100644
--- a/docs/zh/latest/plugins/http-logger.md
+++ b/docs/zh/latest/plugins/http-logger.md
@@ -1,3 +1,7 @@
+---
+title: http-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/ip-restriction.md b/docs/zh/latest/plugins/ip-restriction.md
index 3ec79a0..fffc112 100644
--- a/docs/zh/latest/plugins/ip-restriction.md
+++ b/docs/zh/latest/plugins/ip-restriction.md
@@ -1,3 +1,7 @@
+---
+title: ip-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/jwt-auth.md b/docs/zh/latest/plugins/jwt-auth.md
index fe3e37c..0601afc 100644
--- a/docs/zh/latest/plugins/jwt-auth.md
+++ b/docs/zh/latest/plugins/jwt-auth.md
@@ -1,3 +1,7 @@
+---
+title: jwt-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/kafka-logger.md b/docs/zh/latest/plugins/kafka-logger.md
index 555b28a..2bfcd5f 100644
--- a/docs/zh/latest/plugins/kafka-logger.md
+++ b/docs/zh/latest/plugins/kafka-logger.md
@@ -1,3 +1,7 @@
+---
+title: kafka-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**简介**](#简介)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/key-auth.md b/docs/zh/latest/plugins/key-auth.md
index 2ed7de6..82b8c82 100644
--- a/docs/zh/latest/plugins/key-auth.md
+++ b/docs/zh/latest/plugins/key-auth.md
@@ -1,3 +1,7 @@
+---
+title: key-auth
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/limit-conn.md b/docs/zh/latest/plugins/limit-conn.md
index c78e462..3dd7372 100644
--- a/docs/zh/latest/plugins/limit-conn.md
+++ b/docs/zh/latest/plugins/limit-conn.md
@@ -1,3 +1,7 @@
+---
+title: limit-conn
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# limit-conn
-
限制并发请求（或并发连接）插件。
### 属性
diff --git a/docs/zh/latest/plugins/limit-count.md b/docs/zh/latest/plugins/limit-count.md
index f0c4f43..68ed5aa 100644
--- a/docs/zh/latest/plugins/limit-count.md
+++ b/docs/zh/latest/plugins/limit-count.md
@@ -1,3 +1,7 @@
+---
+title: limit-count
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [简介](#简介)
- [参数](#参数)
diff --git a/docs/zh/latest/plugins/limit-req.md b/docs/zh/latest/plugins/limit-req.md
index c63019a..2aa6bd3 100644
--- a/docs/zh/latest/plugins/limit-req.md
+++ b/docs/zh/latest/plugins/limit-req.md
@@ -1,3 +1,7 @@
+---
+title: limit-req
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [简介](#简介)
- [属性](#属性)
diff --git a/docs/zh/latest/plugins/log-rotate.md b/docs/zh/latest/plugins/log-rotate.md
index f1de2a8..ab84c63 100644
--- a/docs/zh/latest/plugins/log-rotate.md
+++ b/docs/zh/latest/plugins/log-rotate.md
@@ -1,3 +1,7 @@
+---
+title: log-rotate
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# log-rotate
-
本插件可自动完成 logs 目录下的 access 和 error 日志的定期切分。
通过配置参数可以设置每间隔多久切分一次日志，以及最近保留多少份日志（超过指定数量后，自动删除老文件）。
diff --git a/docs/zh/latest/plugins/mqtt-proxy.md b/docs/zh/latest/plugins/mqtt-proxy.md
index 1f97bc7..5eb2661 100644
--- a/docs/zh/latest/plugins/mqtt-proxy.md
+++ b/docs/zh/latest/plugins/mqtt-proxy.md
@@ -1,3 +1,7 @@
+---
+title: mqtt-proxy
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/node-status.md b/docs/zh/latest/plugins/node-status.md
index 3360bcb..a88dde8 100644
--- a/docs/zh/latest/plugins/node-status.md
+++ b/docs/zh/latest/plugins/node-status.md
@@ -1,3 +1,7 @@
+---
+title: node-status
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**插件简介**](#插件简介)
- [**插件属性**](#插件属性)
diff --git a/docs/zh/latest/plugins/openid-connect.md b/docs/zh/latest/plugins/openid-connect.md
index e72d120..f40c53d 100644
--- a/docs/zh/latest/plugins/openid-connect.md
+++ b/docs/zh/latest/plugins/openid-connect.md
@@ -1,3 +1,7 @@
+---
+title: openid-connect
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/prometheus.md b/docs/zh/latest/plugins/prometheus.md
index 051472a..eeacde0 100644
--- a/docs/zh/latest/plugins/prometheus.md
+++ b/docs/zh/latest/plugins/prometheus.md
@@ -1,3 +1,7 @@
+---
+title: prometheus
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# prometheus
-
此插件是提供符合prometheus数据格式的监控指标数据。
## 属性
diff --git a/docs/zh/latest/plugins/proxy-cache.md b/docs/zh/latest/plugins/proxy-cache.md
index 6560893..ca51183 100644
--- a/docs/zh/latest/plugins/proxy-cache.md
+++ b/docs/zh/latest/plugins/proxy-cache.md
@@ -1,3 +1,7 @@
+---
+title: proxy-cache
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# proxy-cache
-
代理缓存插件，该插件提供缓存后端响应数据的能力，它可以和其他插件一起使用。该插件支持基于磁盘的缓存，未来也会支持基于内存的缓存。目前可以根据响应码、请求 Method 来指定需要缓存的数据，另外也可以通过 no_cache 和 cache_bypass 配置更复杂的缓存策略。
基于磁盘的缓存需要注意：
diff --git a/docs/zh/latest/plugins/proxy-mirror.md b/docs/zh/latest/plugins/proxy-mirror.md
index 17fac27..8d41f93 100644
--- a/docs/zh/latest/plugins/proxy-mirror.md
+++ b/docs/zh/latest/plugins/proxy-mirror.md
@@ -1,3 +1,7 @@
+---
+title: proxy-mirror
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# proxy-mirror
-
代理镜像插件，该插件提供了镜像客户端请求的能力。
注：镜像请求返回的响应会被忽略。
diff --git a/docs/zh/latest/plugins/proxy-rewrite.md b/docs/zh/latest/plugins/proxy-rewrite.md
index 017271d..6e2d6d1 100644
--- a/docs/zh/latest/plugins/proxy-rewrite.md
+++ b/docs/zh/latest/plugins/proxy-rewrite.md
@@ -1,3 +1,7 @@
+---
+title: proxy-rewrite
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [简介](#简介)
- [属性](#属性)
diff --git a/docs/zh/latest/plugins/redirect.md b/docs/zh/latest/plugins/redirect.md
index 9c30e42..277d76c 100644
--- a/docs/zh/latest/plugins/redirect.md
+++ b/docs/zh/latest/plugins/redirect.md
@@ -1,3 +1,7 @@
+---
+title: redirect
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# redirect
-
URI 重定向插件。
### 参数
diff --git a/docs/zh/latest/plugins/referer-restriction.md b/docs/zh/latest/plugins/referer-restriction.md
index 7e3b1f0..184cef2 100644
--- a/docs/zh/latest/plugins/referer-restriction.md
+++ b/docs/zh/latest/plugins/referer-restriction.md
@@ -1,3 +1,7 @@
+---
+title: referer-restriction
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/request-id.md b/docs/zh/latest/plugins/request-id.md
index dfd59cd..298006d 100644
--- a/docs/zh/latest/plugins/request-id.md
+++ b/docs/zh/latest/plugins/request-id.md
@@ -1,3 +1,7 @@
+---
+title: request-id
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名称**](#名称)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/request-validation.md b/docs/zh/latest/plugins/request-validation.md
index 1c9363f..f9ab2c4 100644
--- a/docs/zh/latest/plugins/request-validation.md
+++ b/docs/zh/latest/plugins/request-validation.md
@@ -1,3 +1,7 @@
+---
+title: request-validation
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名称**](#名称)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/response-rewrite.md b/docs/zh/latest/plugins/response-rewrite.md
index 40f3605..2f23b87 100644
--- a/docs/zh/latest/plugins/response-rewrite.md
+++ b/docs/zh/latest/plugins/response-rewrite.md
@@ -1,3 +1,7 @@
+---
+title: response-rewrite
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**response-rewrite**](#response-rewrite)
- [**配置参数**](#配置参数)
diff --git a/docs/zh/latest/plugins/server-info.md b/docs/zh/latest/plugins/server-info.md
index 7fd0b1d..2837dc5 100644
--- a/docs/zh/latest/plugins/server-info.md
+++ b/docs/zh/latest/plugins/server-info.md
@@ -1,3 +1,7 @@
+---
+title: server-info
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# Summary
+## 目录
- [插件简介](#插件简介)
- [插件属性](#插件属性)
diff --git a/docs/zh/latest/plugins/serverless.md b/docs/zh/latest/plugins/serverless.md
index 7a092f8..52b74ca 100644
--- a/docs/zh/latest/plugins/serverless.md
+++ b/docs/zh/latest/plugins/serverless.md
@@ -1,3 +1,7 @@
+---
+title: serverless
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# serverless
-
serverless 的插件有两个，分别是 `serverless-pre-function` 和 `serverless-post-function`，
前者会在指定阶段的最开始运行，后者是在指定阶段的最后运行。
diff --git a/docs/zh/latest/plugins/skywalking.md b/docs/zh/latest/plugins/skywalking.md
index ff95e15..2c68351 100644
--- a/docs/zh/latest/plugins/skywalking.md
+++ b/docs/zh/latest/plugins/skywalking.md
@@ -1,3 +1,7 @@
+---
+title: skywalking
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [名字](#名字)
- [属性](#属性)
diff --git a/docs/zh/latest/plugins/sls-logger.md b/docs/zh/latest/plugins/sls-logger.md
index e03aadb..b1bb69d 100644
--- a/docs/zh/latest/plugins/sls-logger.md
+++ b/docs/zh/latest/plugins/sls-logger.md
@@ -1,3 +1,7 @@
+---
+title: sls-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 摘要
+## 摘要
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/syslog.md b/docs/zh/latest/plugins/syslog.md
index dccd3d2..7f492a6 100644
--- a/docs/zh/latest/plugins/syslog.md
+++ b/docs/zh/latest/plugins/syslog.md
@@ -1,3 +1,7 @@
+---
+title: syslog
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 摘要
+## 摘要
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/tcp-logger.md b/docs/zh/latest/plugins/tcp-logger.md
index d47b155..108e936 100644
--- a/docs/zh/latest/plugins/tcp-logger.md
+++ b/docs/zh/latest/plugins/tcp-logger.md
@@ -1,3 +1,7 @@
+---
+title: tcp-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 摘要
+## 摘要
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/traffic-split.md b/docs/zh/latest/plugins/traffic-split.md
index 9c8cfb4..efdc07c 100644
--- a/docs/zh/latest/plugins/traffic-split.md
+++ b/docs/zh/latest/plugins/traffic-split.md
@@ -1,3 +1,7 @@
+---
+title: traffic-split
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [名字](#名字)
- [属性](#属性)
diff --git a/docs/zh/latest/plugins/udp-logger.md b/docs/zh/latest/plugins/udp-logger.md
index 3d8dec2..c5c2863 100644
--- a/docs/zh/latest/plugins/udp-logger.md
+++ b/docs/zh/latest/plugins/udp-logger.md
@@ -1,3 +1,7 @@
+---
+title: udp-logger
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 摘要
+## 摘要
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/uri-blocker.md b/docs/zh/latest/plugins/uri-blocker.md
index 4eccdf9..551796f 100644
--- a/docs/zh/latest/plugins/uri-blocker.md
+++ b/docs/zh/latest/plugins/uri-blocker.md
@@ -1,3 +1,7 @@
+---
+title: uri-blocker
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**定义**](#定义)
- [**属性列表**](#属性列表)
diff --git a/docs/zh/latest/plugins/wolf-rbac.md b/docs/zh/latest/plugins/wolf-rbac.md
index 91b0a85..4ed258d 100644
--- a/docs/zh/latest/plugins/wolf-rbac.md
+++ b/docs/zh/latest/plugins/wolf-rbac.md
@@ -1,3 +1,7 @@
+---
+title: wolf-rbac
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/plugins/zipkin.md b/docs/zh/latest/plugins/zipkin.md
index b0f4483..42ca9e3 100644
--- a/docs/zh/latest/plugins/zipkin.md
+++ b/docs/zh/latest/plugins/zipkin.md
@@ -1,3 +1,7 @@
+---
+title: zipkin
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,7 +21,7 @@
#
-->
-# 目录
+## 目录
- [**名字**](#名字)
- [**属性**](#属性)
diff --git a/docs/zh/latest/profile.md b/docs/zh/latest/profile.md
index 5f219dc..be83a1c 100644
--- a/docs/zh/latest/profile.md
+++ b/docs/zh/latest/profile.md
@@ -1,3 +1,7 @@
+---
+title: 基于环境变量进行配置文件切换
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-# 基于环境变量进行配置文件切换
-
配置之所以从代码中提取出来，就是为了更好适应变化。通常我们的应用都有开发环境、生产环境等不同运行环境，这些环境下应用的一些配置肯定会有不同，比如：配置中心的地址等。
如果把所有环境的配置都放在同一个文件里，非常不好管理，我们接到新需求后，在开发环境进行开发时，需要将配置文件中的参数都改成开发环境的，提交代码时还要改回去，这样改来改去非常容易出错。
diff --git a/docs/zh/latest/stand-alone.md b/docs/zh/latest/stand-alone.md
index 095a64a..fe993b8 100644
--- a/docs/zh/latest/stand-alone.md
+++ b/docs/zh/latest/stand-alone.md
@@ -1,3 +1,7 @@
+---
+title: Stand-alone mode
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,8 +21,6 @@
#
-->
-## Stand-alone mode
-
开启 Stand-alone 模式的 APISIX 节点，将不再使用默认的 etcd 作为配置中心。
这种方式比较适合两类用户：
diff --git a/docs/zh/latest/stream-proxy.md b/docs/zh/latest/stream-proxy.md
index bdc07e0..fc2c669 100644
--- a/docs/zh/latest/stream-proxy.md
+++ b/docs/zh/latest/stream-proxy.md
@@ -1,3 +1,7 @@
+---
+title: Stream 代理
+---
+
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,10 +21,7 @@
#
-->
-# Stream 代理
-
- 众多的闻名的应用和服务，像 LDAP、 MYSQL 和 RTMP ，选择 TCP 作为通信协议。 但是像 DNS、 syslog 和 RADIUS 这类非事务性的应用，他们选择了
- UDP协议。
+众多的闻名的应用和服务，像 LDAP、 MYSQL 和 RTMP ，选择 TCP 作为通信协议。 但是像 DNS、 syslog 和 RADIUS 这类非事务性的应用，他们选择了UDP协议。
APISIX 可以对 TCP/UDP 协议进行代理并实现动态负载均衡。 在 nginx 世界，称 TCP/UDP 代理为 stream 代理，在 APISIX 这里我们也遵循了这个声明.