vesoft-inc · abby-cyber · May 4, 2023 · Feb 7, 2023 · Feb 7, 2023 · Feb 7, 2023
diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml
@@ -10,7 +10,7 @@ jobs:
     steps:
       - uses: actions/checkout@v2
         with:
-          fetch-depth: 0 # fetch all commits/branches
+          fetch-depth: 1 # fetch all commits/branches
 
       - name: Setup Python
         uses: actions/setup-python@v1

diff --git a/README.md b/README.md
@@ -1,10 +1,17 @@
 [![Publish docs via GitHub Pages](https://github.com/vesoft-inc/nebula-docs-cn/actions/workflows/deploy.yaml/badge.svg?branch=master)](https://github.com/vesoft-inc/nebula-docs-cn/actions/workflows/deploy.yaml)
 
-# NebulaGraph 文档
+# {{nebula.name}} 文档
 
+{{ ent.ent_begin }}
 - [中文](https://docs.nebula-graph.com.cn/)
 - [English](https://docs.nebula-graph.io)
+{{ ent.ent_end }}
+
+{{ comm.comm_begin }}
+- [中文](https://docs.nebula-graph.com.cn/)
+- [English](https://docs.nebula-graph.io)
+{{ comm.comm_end }}
 
 ## 贡献文档
 
-如果发现文档问题，请随时创建一个 [Issue](https://github.com/vesoft-inc/nebula-docs-cn/issues) 告知我们或直接创建一个 [PR](https://github.com/vesoft-inc/nebula-docs-cn/pulls) 修复或更新。请参阅 NebulaGraph [中文文档贡献指南](CONTRIBUTING.md)开始贡献。
+如果发现文档问题，请随时创建一个 [Issue](https://github.com/vesoft-inc/nebula-docs-cn/issues) 告知我们或直接创建一个 [PR](https://github.com/vesoft-inc/nebula-docs-cn/pulls) 修复或更新。请参阅{{nebula.name}} [中文文档贡献指南](CONTRIBUTING.md)开始贡献。
diff --git a/docs-2.0/1.introduction/0-0-graph.md b/docs-2.0/1.introduction/0-0-graph.md
@@ -14,7 +14,7 @@
 
 ## 图、图片与图论
 
-图无处不在。当听到图这个词时，很多人都会想到条形图或折线图，因为有时候我们确实会把它们称作图。从传统意义上来说，图是用来展示两个或多个数据系统之间的联系的。最简单的例子如下图，下图展示了 NebulaGraph GitHub 仓库星星数量随时间推移的变化。
+图无处不在。当听到图这个词时，很多人都会想到条形图或折线图，因为有时候我们确实会把它们称作图。从传统意义上来说，图是用来展示两个或多个数据系统之间的联系的。最简单的例子如下图，下图展示了{{nebula.name}} GitHub 仓库星星数量随时间推移的变化。
 
 ![image](https://user-images.githubusercontent.com/42762957/91426247-d3861000-e88e-11ea-8e17-e3d7d7069bd1.png "这不是本书所说的图")
 

diff --git a/docs-2.0/1.introduction/0-1-graph-database.md b/docs-2.0/1.introduction/0-1-graph-database.md
@@ -153,7 +153,7 @@ Cypher 启发了一系列后续的图查询语言，包括
 
 [^GSQL]: https://docs.tigergraph.com/dev/gsql-ref
 
-2019 年，NebulaGraph 以 openCypher 为基础发布其扩展的图语言 NebulaGraph Query Language, nGQL。
+2019 年，{{nebula.name}}以 openCypher 为基础发布其扩展的图语言 NebulaGraph Query Language, nGQL。
 
 ![Image](https://docs-cdn.nebula-graph.com.cn/books/images/langhis.jpg "图语言的历史")
 
@@ -240,6 +240,6 @@ Oracle graph[^Oracle] 是关系型数据库巨头 Oracle 在图技术与图数
 
 [^Oracle]: https://www.oracle.com/database/graph/
 
-#### 新一代开源分布式图数据库 NebulaGraph
+#### 新一代开源分布式图数据库{{nebula.name}}
 
-在下一章，我们将正式介绍新一代开源分布式图数据库 NebulaGraph。
+在下一章，我们将正式介绍新一代开源分布式图数据库{{nebula.name}}。
diff --git a/docs-2.0/1.introduction/0-2.relates.md b/docs-2.0/1.introduction/0-2.relates.md
@@ -55,7 +55,7 @@ NoSQL 数据库的列式存储与 NoSQL 数据库的键值存储有许多相似
 
 #### 图存储
 
-最后一类 NoSQL 数据库是图数据库。本书重点讨论的 NebulaGraph 也是一种图数据库。虽然同为 NoSQL 型数据库，但是图数据库与上述 NoSQL 数据库有本质上的差异。图数据库以点、边、属性的形式存储数据。其优点在于灵活性高，支持复杂的图形算法，可用于构建复杂的关系图谱。我们将在随后的章节中详细讨论图数据库。不过在本章中，你只要知道图数据库是一种 NoSQL 类型的数据库就可以了。常见的图数据库有：NebulaGraph、Neo4j、OrientDB 等。
+最后一类 NoSQL 数据库是图数据库。本书重点讨论的{{nebula.name}}也是一种图数据库。虽然同为 NoSQL 型数据库，但是图数据库与上述 NoSQL 数据库有本质上的差异。图数据库以点、边、属性的形式存储数据。其优点在于灵活性高，支持复杂的图形算法，可用于构建复杂的关系图谱。我们将在随后的章节中详细讨论图数据库。不过在本章中，你只要知道图数据库是一种 NoSQL 类型的数据库就可以了。常见的图数据库有：{{nebula.name}}、Neo4j、OrientDB 等。
 
 ## 图技术方面
 

diff --git a/docs-2.0/1.introduction/1.what-is-nebula-graph.md b/docs-2.0/1.introduction/1.what-is-nebula-graph.md
@@ -1,8 +1,8 @@
-# 什么是 NebulaGraph
+# 什么是{{nebula.name}}
 
-NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库，能够承载包含数千亿个点和数万亿条边的超大规模数据集，并且提供毫秒级查询。
+{{nebula.name}}是一款开源的、分布式的、易扩展的原生图数据库，能够承载包含数千亿个点和数万亿条边的超大规模数据集，并且提供毫秒级查询。
 
-![NebulaGraph 鸟瞰图](https://docs-cdn.nebula-graph.com.cn/figures/architecture_map_2022-08-08_17-37-15.png)
+![{{nebula.name}}鸟瞰图](https://docs-cdn.nebula-graph.com.cn/figures/architecture_map_2022-08-08_17-37-15.png)
 
 ## 什么是图数据库
 
@@ -12,78 +12,79 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库
 
 图数据库适合存储大多数从现实抽象出的数据类型。世界上几乎所有领域的事物都有内在联系，像关系型数据库这样的建模系统会提取实体之间的关系，并将关系单独存储到表和列中，而实体的类型和属性存储在其他列甚至其他表中，这使得数据管理费时费力。
 
-NebulaGraph 作为一个典型的图数据库，可以将丰富的关系通过边及其类型和属性自然地呈现。
+{{nebula.name}}作为一个典型的图数据库，可以将丰富的关系通过边及其类型和属性自然地呈现。
 
-## NebulaGraph 的优势
+## {{nebula.name}}的优势
 
+{{ comm.comm_begin }}
 ### 开源
 
-NebulaGraph 是在 Apache 2.0 条款下开发的。越来越多的人，如数据库开发人员、数据科学家、安全专家、算法工程师，都参与到 NebulaGraph 的设计和开发中来，欢迎访问 [NebulaGraph GitHub 主页](https://github.com/vesoft-inc/nebula)参与开源项目。
+{{nebula.name}}是在 Apache 2.0 条款下开发的。越来越多的人，如数据库开发人员、数据科学家、安全专家、算法工程师，都参与到{{nebula.name}}的设计和开发中来，欢迎访问 [{{nebula.name}} GitHub 主页](https://github.com/vesoft-inc/nebula)参与开源项目。
+{{ comm.comm_end }}
 
 ### 高性能
 
-基于图数据库的特性使用 C++ 编写的 NebulaGraph，可以提供毫秒级查询。众多数据库中，NebulaGraph 在图数据服务领域展现了卓越的性能，数据规模越大，NebulaGraph 优势就越大。详情请参见 [NebulaGraph benchmarking 页面](https://discuss.nebula-graph.com.cn/t/topic/11727)。
+基于图数据库的特性使用 C++ 编写的{{nebula.name}}，可以提供毫秒级查询。众多数据库中，{{nebula.name}}在图数据服务领域展现了卓越的性能，数据规模越大，{{nebula.name}}优势就越大。详情请参见 [{{nebula.name}} benchmarking 页面](https://discuss.nebula-graph.com.cn/t/topic/11727)。
 
 ### 易扩展
 
-NebulaGraph 采用 shared-nothing 架构，支持在不停止数据库服务的情况下扩缩容。
+{{nebula.name}}采用 shared-nothing 架构，支持在不停止数据库服务的情况下扩缩容。
 
 ### 易开发
 
-NebulaGraph 提供 Java、Python、C++ 和 Go 等流行编程语言的客户端，更多客户端仍在开发中。详情请参见 [NebulaGraph clients](../14.client/1.nebula-client.md)。
+{{nebula.name}}提供 Java、Python、C++ 和 Go 等流行编程语言的客户端，更多客户端仍在开发中。详情请参见 [{{nebula.name}} clients](../14.client/1.nebula-client.md)。
 
 ### 高可靠访问控制
 
-NebulaGraph 支持严格的角色访问控制和 LDAP（Lightweight Directory Access Protocol）等外部认证服务，能够有效提高数据安全性。详情请参见[验证和授权](../7.data-security/1.authentication/1.authentication.md)。
+{{nebula.name}}支持严格的角色访问控制和 LDAP（Lightweight Directory Access Protocol）等外部认证服务，能够有效提高数据安全性。详情请参见[验证和授权](../7.data-security/1.authentication/1.authentication.md)。
 
 ### 生态多样化
 
-NebulaGraph 开放了越来越多的原生工具，例如 [NebulaGraph Studio](https://github.com/vesoft-inc/nebula-studio)、[NebulaGraph Console](https://github.com/vesoft-inc/nebula-console)、[NebulaGraph Exchange](https://github.com/vesoft-inc/nebula-exchange) 等，更多工具可以查看[生态工具概览](../20.appendix/6.eco-tool-version.md)。
+{{nebula.name}}开放了越来越多的原生工具，例如 [NebulaGraph Studio](https://github.com/vesoft-inc/nebula-studio)、[NebulaGraph Console](https://github.com/vesoft-inc/nebula-console)、[NebulaGraph Exchange](https://github.com/vesoft-inc/nebula-exchange) 等，更多工具可以查看[生态工具概览](../20.appendix/6.eco-tool-version.md)。
 
-此外，NebulaGraph 还具备与 Spark、Flink、HBase 等产品整合的能力，在这个充满挑战与机遇的时代，大大增强了自身的竞争力。
+此外，{{nebula.name}}还具备与 Spark、Flink、HBase 等产品整合的能力，在这个充满挑战与机遇的时代，大大增强了自身的竞争力。
 
 ### 兼容 openCypher 查询语言
 
-NebulaGraph 查询语言，简称为 nGQL，是一种声明性的、部分兼容 openCypher 的文本查询语言，易于理解和使用。详细语法请参见 [nGQL 指南](../3.ngql-guide/1.nGQL-overview/1.overview.md)。
+{{nebula.name}}查询语言，简称为 nGQL，是一种声明性的、部分兼容 openCypher 的文本查询语言，易于理解和使用。详细语法请参见 [nGQL 指南](../3.ngql-guide/1.nGQL-overview/1.overview.md)。
 
 ### 面向未来硬件，读写平衡
 
-闪存型设备有着极高的性能，并且[价格快速下降](https://blocksandfiles.com/wp-content/uploads/2021/01/Wikibon-SSD-less-than-HDD-in-2026.jpg)，
- NebulaGraph 是一个面向 SSD 设计的产品，相比于基于 HDD + 大内存的产品，更适合面向未来的硬件趋势，也更容易做到读写平衡。
+闪存型设备有着极高的性能，并且[价格快速下降](https://blocksandfiles.com/wp-content/uploads/2021/01/Wikibon-SSD-less-than-HDD-in-2026.jpg)，{{nebula.name}}是一个面向 SSD 设计的产品，相比于基于 HDD + 大内存的产品，更适合面向未来的硬件趋势，也更容易做到读写平衡。
 
 ### 灵活数据建模
 
-用户可以轻松地在 NebulaGraph 中建立数据模型，不必将数据强制转换为关系表。而且可以自由增加、更新和删除属性。详情请参见[数据模型](2.data-model.md)。
+用户可以轻松地在{{nebula.name}}中建立数据模型，不必将数据强制转换为关系表。而且可以自由增加、更新和删除属性。详情请参见[数据模型](2.data-model.md)。
 
 ### 广受欢迎
 
-腾讯、美团、京东、快手、360 等科技巨头都在使用 NebulaGraph。详情请参见 [NebulaGraph 官网](https://nebula-graph.com.cn/)。
+腾讯、美团、京东、快手、360 等科技巨头都在使用{{nebula.name}}。详情请参见 [{{nebula.name}}官网](https://nebula-graph.com.cn/)。
 
 ## 适用场景
 
-NebulaGraph 可用于各种基于图的业务场景。为节约转换各类数据到关系型数据库的时间，以及避免复杂查询，建议使用 NebulaGraph。
+{{nebula.name}}可用于各种基于图的业务场景。为节约转换各类数据到关系型数据库的时间，以及避免复杂查询，建议使用{{nebula.name}}。
 
 ### 欺诈检测
 
-金融机构必须仔细研究大量的交易信息，才能检测出潜在的金融欺诈行为，并了解某个欺诈行为和设备的内在关联。这种场景可以通过图来建模，然后借助 NebulaGraph，可以很容易地检测出诈骗团伙或其他复杂诈骗行为。
+金融机构必须仔细研究大量的交易信息，才能检测出潜在的金融欺诈行为，并了解某个欺诈行为和设备的内在关联。这种场景可以通过图来建模，然后借助{{nebula.name}}，可以很容易地检测出诈骗团伙或其他复杂诈骗行为。
 
 ### 实时推荐
 
-NebulaGraph 能够及时处理访问者产生的实时信息，并且精准推送文章、视频、产品和服务。
+{{nebula.name}}能够及时处理访问者产生的实时信息，并且精准推送文章、视频、产品和服务。
 
 ### 知识图谱
 
-自然语言可以转化为知识图谱，存储在 NebulaGraph 中。用自然语言组织的问题可以通过智能问答系统中的语义解析器进行解析并重新组织，然后从知识图谱中检索出问题的可能答案，提供给提问人。
+自然语言可以转化为知识图谱，存储在{{nebula.name}}中。用自然语言组织的问题可以通过智能问答系统中的语义解析器进行解析并重新组织，然后从知识图谱中检索出问题的可能答案，提供给提问人。
 
 ### 社交网络
 
-人际关系信息是典型的图数据，NebulaGraph 可以轻松处理数十亿人和数万亿人际关系的社交网络信息，并在海量并发的情况下，提供快速的好友推荐和工作岗位查询。
+人际关系信息是典型的图数据，{{nebula.name}}可以轻松处理数十亿人和数万亿人际关系的社交网络信息，并在海量并发的情况下，提供快速的好友推荐和工作岗位查询。
 
 ## 视频
 
 用户也可以通过视频了解什么是图数据。
 
-- [图数据库 NebulaGraph 介绍视频](https://www.bilibili.com/video/BV1kf4y1v7LM)（01 分 39 秒）
+- [{{nebula.name}}介绍视频](https://www.bilibili.com/video/BV1kf4y1v7LM)（01 分 39 秒）
 
 <iframe src="//player.bilibili.com/player.html?aid=287936425&bvid=BV1kf4y1v7LM&cid=259888281&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" width="720px" height="480px"> </iframe>
 

diff --git a/docs-2.0/1.introduction/2.data-model.md b/docs-2.0/1.introduction/2.data-model.md
@@ -1,10 +1,10 @@
 # 数据模型
 
-本文介绍 NebulaGraph 的数据模型。数据模型是一种组织数据并说明它们如何相互关联的模型。
+本文介绍{{nebula.name}}的数据模型。数据模型是一种组织数据并说明它们如何相互关联的模型。
 
 ## 数据模型
 
-NebulaGraph 数据模型使用 6 种基本的数据模型：
+{{nebula.name}}数据模型使用 6 种基本的数据模型：
 
 - 图空间（Space）
 
@@ -19,7 +19,7 @@ NebulaGraph 数据模型使用 6 种基本的数据模型：
 
   !!! Compatibility
 
-        NebulaGraph 2.x 及以下版本中的点必须包含至少一个 Tag。
+        {{nebula.name}} 2.x 及以下版本中的点必须包含至少一个 Tag。
 
 - 边（Edge）
 
@@ -55,7 +55,7 @@ NebulaGraph 数据模型使用 6 种基本的数据模型：
 
 ## 有向属性图
 
-NebulaGraph 使用有向属性图模型，指点和边构成的图，这些边是有方向的，点和边都可以有属性。
+{{nebula.name}}使用有向属性图模型，指点和边构成的图，这些边是有方向的，点和边都可以有属性。
 
 下表为篮球运动员数据集的结构示例，包括两种类型的点（**player**、**team**）和两种类型的边（**serve**、**follow**）。
 
@@ -68,10 +68,10 @@ NebulaGraph 使用有向属性图模型，指点和边构成的图，这些边
 
 !!! Note
 
-    NebulaGraph 中没有无向边，只支持有向边。
+    {{nebula.name}}中没有无向边，只支持有向边。
 
 !!! compatibility
 
-    由于 NebulaGraph {{ nebula.release }} 的数据模型中，允许存在"悬挂边"，因此在增删时，用户需自行保证“一条边所对应的起点和终点”的存在性。详见 [INSERT VERTEX](../3.ngql-guide/12.vertex-statements/1.insert-vertex.md)、[DELETE VERTEX](../3.ngql-guide/12.vertex-statements/4.delete-vertex.md)、[INSERT EDGE](../3.ngql-guide/13.edge-statements/1.insert-edge.md)、[DELETE EDGE](../3.ngql-guide/13.edge-statements/4.delete-edge.md)。
+    由于{{nebula.name}} {{ nebula.release }} 的数据模型中，允许存在"悬挂边"，因此在增删时，用户需自行保证“一条边所对应的起点和终点”的存在性。详见 [INSERT VERTEX](../3.ngql-guide/12.vertex-statements/1.insert-vertex.md)、[DELETE VERTEX](../3.ngql-guide/12.vertex-statements/4.delete-vertex.md)、[INSERT EDGE](../3.ngql-guide/13.edge-statements/1.insert-edge.md)、[DELETE EDGE](../3.ngql-guide/13.edge-statements/4.delete-edge.md)。
 
     不支持 openCypher 中的 MERGE 语句。
diff --git a/docs-2.0/1.introduction/3.nebula-graph-architecture/1.architecture-overview.md b/docs-2.0/1.introduction/3.nebula-graph-architecture/1.architecture-overview.md
@@ -1,22 +1,22 @@
-# NebulaGraph 架构总览
+# {{nebula.name}}架构总览
 
-NebulaGraph 由三种服务构成：Graph 服务、Meta 服务和 Storage 服务，是一种存储与计算分离的架构。
+{{nebula.name}}由三种服务构成：Graph 服务、Meta 服务和 Storage 服务，是一种存储与计算分离的架构。
 
-每个服务都有可执行的二进制文件和对应进程，用户可以使用这些二进制文件在一个或多个计算机上部署 NebulaGraph 集群。
+每个服务都有可执行的二进制文件和对应进程，用户可以使用这些二进制文件在一个或多个计算机上部署{{nebula.name}}集群。
 
-下图展示了 NebulaGraph 集群的经典架构。
+下图展示了{{nebula.name}}集群的经典架构。
 
-![NebulaGraph architecture](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-architecture_3.png "NebulaGraph architecture")
+![{{nebula.name}} architecture](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-architecture_3.png "{{nebula.name}} architecture")
 
 ## Meta 服务
 
-在 NebulaGraph 架构中，Meta 服务是由 nebula-metad 进程提供的，负责数据管理，例如 Schema 操作、集群管理和用户权限管理等。
+在{{nebula.name}}架构中，Meta 服务是由 nebula-metad 进程提供的，负责数据管理，例如 Schema 操作、集群管理和用户权限管理等。
 
 Meta 服务的详细说明，请参见 [Meta 服务](2.meta-service.md)。
 
 ## Graph 服务和 Storage 服务
 
-NebulaGraph 采用计算存储分离架构。Graph 服务负责处理计算请求，Storage 服务负责存储数据。它们由不同的进程提供，Graph 服务是由 nebula-graphd 进程提供，Storage 服务是由 nebula-storaged 进程提供。计算存储分离架构的优势如下：
+{{nebula.name}}采用计算存储分离架构。Graph 服务负责处理计算请求，Storage 服务负责存储数据。它们由不同的进程提供，Graph 服务是由 nebula-graphd 进程提供，Storage 服务是由 nebula-storaged 进程提供。计算存储分离架构的优势如下：
 
 - 易扩展