1 files changed, 25 insertions, 27 deletions

diff --git a/documentation/content/zh-cn/books/handbook/ports/_index.adoc b/documentation/content/zh-cn/books/handbook/ports/_index.adoc
index 62f98d025c..08d24a692a 100644
--- a/documentation/content/zh-cn/books/handbook/ports/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+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::[]
 
 [[ports-synopsis]]
 == 概述
@@ -419,7 +417,7 @@ Portsnap 是用于发布 Ports 套件的另一套系统。 请参阅 crossref:cu
 * 一个 [.filename]#pkg-descr# 文件。 这是一个提供更多细节，有软件的多行描述。
 * 一个 [.filename]#pkg-plist# 文件。 这是即将被安装的所有文件的列表。它告诉 ports 系统在卸载时需要删除哪些文件。
 
-一些ports还有些其它的文件， 例如 [.filename]#pkg-message#。 ports 系统在一些特殊情况下会用到这些文件。 如果您想知道这些文件更多的细节以及 ports 的概要， 请参阅 link:{porters-handbook}[FreeBSD Porter's Handbook]。
+一些ports还有些其它的文件， 例如 [.filename]#pkg-message#。 ports 系统在一些特殊情况下会用到这些文件。 如果您想知道这些文件更多的细节以及 ports 的概要， 请参阅 extref:{porters-handbook}[FreeBSD Porter's Handbook]。
 
 port里面包含着如何编译源代码的指令， 但不包含真正的源代码。 您可以在网上或 CD-ROM 上获得源代码。 源代码可能被开发者发布成任何格式。 一般来说应该是一个被 tar 和 gzip 过的文件， 或者是被一些其他的工具压缩或未压缩的文件。 ports中这个程序源代码标示文件叫 "distfile"， 安装 FreeBSD port的方法还不止这两种。
 
@@ -827,11 +825,11 @@ Portmaster 默认在删除一个现有的 port 前会做一个备份包。如果
 +
 [NOTE]
 ====
-某些 ports 并非一个人维护， 而是写了一个 link:{mailing-list-faq}[邮件列表]。 许多， 但并非所有 port， 使用类似 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 这样的地址。 请在提出问题时考虑这一点。
+某些 ports 并非一个人维护， 而是写了一个 extref:{mailing-list-faq}[邮件列表]。 许多， 但并非所有 port， 使用类似 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 这样的地址。 请在提出问题时考虑这一点。
 
 特别地， 由 mailto:ports@FreeBSD.org[ports@FreeBSD.org] 监护的 port， 实际上并没有人维护。 订阅这个邮件列表的人们会感谢您提供的修正和支持。 我们一直都需要更多志愿者！
 ====
 + 
-如果您没有得到回应， 则可以使用 man:send-pr[1] 来提交问题报告 (请参见 link:{problem-reports}[如何撰写 FreeBSD 问题报告])。
-. 修正它！ link:{porters-handbook}[Porter 手册] 中提供了关于 "Ports" 基础设施的详细信息， 通过了解这些内容， 您就能修正偶然坏掉的 port， 或甚至提交自己的 port 了！
+如果您没有得到回应， 则可以使用 man:send-pr[1] 来提交问题报告 (请参见 extref:{problem-reports}[如何撰写 FreeBSD 问题报告])。
+. 修正它！ extref:{porters-handbook}[Porter 手册] 中提供了关于 "Ports" 基础设施的详细信息， 通过了解这些内容， 您就能修正偶然坏掉的 port， 或甚至提交自己的 port 了！
 . 从较近的 FTP 站点下载一个编译好的安装包。 "中央的" package collection 在 `ftp.FreeBSD.org` 的 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[packages 目录中]， 但 _在此之前_ 请 _事先_ 检查一下是否存在较近的 crossref:mirrors[mirrors-ftp,镜像网站]！ 通常情况下这些安装包都可以直接使用， 而且应该比自行编译快一些。 安装过程本身可以通过 man:pkg_add[1] 来完成。