1 files changed, 26 insertions, 16 deletions
diff --git a/documentation/content/zh-cn/books/handbook/introduction/_index.adoc b/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
index 6a1e5ed67c..9643ec9937 100644
--- a/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
 
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
 
+ifndef::env-beastie[]
 toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
 [[introduction-synopsis]]
 == 概述
@@ -49,7 +59,7 @@ toc::[]
 [[nutshell]]
 == 欢迎来到 FreeBSD 的世界!
 
-FreeBSD 是一个支持 Intel (x86 和 Itanium(R))，AMD64， Sun UltraSPARC(R) 计算机的基于 4.4BSD-Lite 的操作系统。 到其他体系结构的移植也在进行中。 您也可以阅读 <<history,FreeBSD 的历史>>， 或者<<relnotes,最新的发行版本>>。 如果您有意捐助(代码， 硬件，基金)，请看link:{contributing}[为 FreeBSD 提供帮助]这篇文章。
+FreeBSD 是一个支持 Intel (x86 和 Itanium(R))，AMD64， Sun UltraSPARC(R) 计算机的基于 4.4BSD-Lite 的操作系统。 到其他体系结构的移植也在进行中。 您也可以阅读 <<history,FreeBSD 的历史>>， 或者<<relnotes,最新的发行版本>>。 如果您有意捐助(代码， 硬件，基金)，请看extref:{contributing}[为 FreeBSD 提供帮助]这篇文章。
 
 [[os-overview]]
 === FreeBSD 能做些什么？
@@ -176,7 +186,7 @@ FreeBSD 项目的目标是无附加条件地提供能够用于任何目的的软
 [[development]]
 === FreeBSD 开发模式
 
-FreeBSD 的开发是一个非常开放且有有伸缩性的过程， 就像从我们的link:{contributors}[ 贡献者列表]里看到的，它是完全由来自全世界的数以百计的贡献者发展起来的。 FreeBSD 的开发基础结构允许数以百计的开发者通过互联网协同工作。 我们也经常关注着那些对我们的计划感兴趣的新开发者和新的创意， 那些有兴趣更进一步参与项目的人只需要在 {freebsd-hackers} 联系我们。 {freebsd-announce} 对那些希望了解我们工作所涉及到哪些领域的人也是有用的。
+FreeBSD 的开发是一个非常开放且有有伸缩性的过程， 就像从我们的extref:{contributors}[ 贡献者列表]里看到的，它是完全由来自全世界的数以百计的贡献者发展起来的。 FreeBSD 的开发基础结构允许数以百计的开发者通过互联网协同工作。 我们也经常关注着那些对我们的计划感兴趣的新开发者和新的创意， 那些有兴趣更进一步参与项目的人只需要在 {freebsd-hackers} 联系我们。 {freebsd-announce} 对那些希望了解我们工作所涉及到哪些领域的人也是有用的。
 
 无论是独立地工作或者封闭式的团队工作， 了解 FreeBSD 计划和它的开发过程都是有益的：
 
@@ -189,7 +199,7 @@ _committer_ 是那些对 CVS 树有_写_权限的人， 他们被授权修改 Fr
 FreeBSD 核心团队[[development-core]]::
 如果把 FreeBSD 项目看作一家公司，那么 _FreeBSD 核心团队_就相当于董事会。 核心团队的主要任务是提出总体上的发展计划，然后确定一个正确的方向。 邀请那些富有献身精神和可靠的开发者加入到 committer 队伍中来也是核心团队的工作之一， 这些新的成员将作为新核心团队成员和其他人一起继续前进。 当前的核心团队是 2010 年 7 月从 committer 中选举产生的。选举每两年一次。 
 +
-一些核心团队的成员还负责特定的责任范围， 也就是说他们必须尽力确保某个子系统能工作正常。 FreeBSD 开发者的完整列表和他们的责任范围，请参见link:{contributors}[贡献者列表]
+一些核心团队的成员还负责特定的责任范围， 也就是说他们必须尽力确保某个子系统能工作正常。 FreeBSD 开发者的完整列表和他们的责任范围，请参见extref:{contributors}[贡献者列表]
 +
 [NOTE]
 ====
@@ -199,7 +209,7 @@ FreeBSD 核心团队[[development-core]]::
 外围贡献者::
 事实上，最大的开发团队正是为我们提供反馈和错误修补的用户自己。 FreeBSD 的非集中式的开发者保持联系的主要方式就是预订 {freebsd-hackers}，很多事情在那里讨论。查看crossref:eresources[eresources,Internet上的资源]了解众多 FreeBSD 邮件列表的更多信息。
 +
-link:{contributors}[FreeBSD 贡献者列表] 很长并在不断增长， 为什么不加入它来为 FreeBSD 做贡献呢？
+extref:{contributors}[FreeBSD 贡献者列表] 很长并在不断增长， 为什么不加入它来为 FreeBSD 做贡献呢？
 +
 提供代码不是为这个计划做贡献的唯一方式； 有一个更完整的需要做的事情的列表，可以参见 link:https://www.FreeBSD.org/[FreeBSD 项目网站]。