43 files changed, 924 insertions, 877 deletions

diff --git a/documentation/content/zh-tw/books/handbook/_index.adoc b/documentation/content/zh-tw/books/handbook/_index.adoc
index 44a59fc25c..d6d051d3c5 100644
--- a/documentation/content/zh-tw/books/handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD 使用手冊
 authors:
   - author: FreeBSD 文件計劃
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
 trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] 
 next: books/handbook/preface
+isIndex: true
 ---
 
 = FreeBSD 使用手冊
@@ -15,18 +15,32 @@ next: books/handbook/preface
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
+:images-path: books/handbook/
 
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
 [.abstract-title]
 摘要
@@ -37,10 +51,10 @@ include::shared/zh-tw/mailing-lists.adoc[]
 
 '''
 
-include::content/zh-tw/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
 
-include::content/zh-tw/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
 
-include::content/zh-tw/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
 
-include::content/zh-tw/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc b/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
index 9c49175adf..957bffb932 100644
--- a/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[advanced-networking-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/audit/_index.adoc b/documentation/content/zh-tw/books/handbook/audit/_index.adoc
index 1ad3ae721c..c1172d91c7 100644
--- a/documentation/content/zh-tw/books/handbook/audit/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[audit-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/basics/_index.adoc b/documentation/content/zh-tw/books/handbook/basics/_index.adoc
index e27653b5c4..e4a694e9c8 100644
--- a/documentation/content/zh-tw/books/handbook/basics/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[basics-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc b/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
index bda8b005d8..2c0797a9c2 100644
--- a/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
 [[bibliography]]
 = 參考書目
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
 
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 雖然操作手冊提供 FreeBSD 作業系統各個部分完整的說明，卻難免有「小學而大遺」之憾，像是如何讓整個作業系統運作順暢。因此，身邊有 UNIX(TM) 系統管理的好書以及好的使用手冊是不可或缺的。
 
diff --git a/documentation/content/zh-tw/books/handbook/book.adoc b/documentation/content/zh-tw/books/handbook/book.adoc
index e5b39e931b..586d7fde1f 100644
--- a/documentation/content/zh-tw/books/handbook/book.adoc
+++ b/documentation/content/zh-tw/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD 使用手冊
 authors:
   - author: FreeBSD 文件計劃
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
 trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] 
 ---
 
@@ -12,52 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
 :book: true
 :pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
-:chapters-path: content/zh-tw/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
@@ -74,95 +56,95 @@ toc::[]
 
 :sectnums!:
 
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
 
 :sectnums:
 
 // Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
 
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
 
 // Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
 
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
 
 // Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
 
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
 
 // Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
 
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
 
 // Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
 
 :sectnums!:
 
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
 
 :sectnums:
diff --git a/documentation/content/zh-tw/books/handbook/boot/_index.adoc b/documentation/content/zh-tw/books/handbook/boot/_index.adoc
index 74d620f13c..7bcdcd5f86 100644
--- a/documentation/content/zh-tw/books/handbook/boot/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[boot-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc b/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
index 3af5550c37..2633268d77 100644
--- a/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[bsdinstall-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/config/_index.adoc b/documentation/content/zh-tw/books/handbook/config/_index.adoc
index babbd9fa67..31891f049a 100644
--- a/documentation/content/zh-tw/books/handbook/config/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[config-synopsis]]
 == 概述
@@ -286,7 +284,7 @@ Starting background file system checks in 60 seconds.
 
 透過仔細的設定每個啟動 Script 的這些關鍵字，管理者便可對 Script 的啟動順序進行微調，而不需使用到其他 UNIX(TM) 作業系統所使用的 "runlevels"。
 
-額外的資訊可在 man:rc[8] 以及 man:rc.subr[8] 中找到。請參考 link:{rc-scripting}[此文章] 來取得如何建立自訂 man:rc[8] Script 的操作說明。
+額外的資訊可在 man:rc[8] 以及 man:rc.subr[8] 中找到。請參考 extref:{rc-scripting}[此文章] 來取得如何建立自訂 man:rc[8] Script 的操作說明。
 
 [[configtuning-core-configuration]]
 === 管理系統特定的設定
diff --git a/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc b/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
index 5b2db37acb..b0ce170f03 100644
--- a/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[updating-upgrading-synopsis]]
 == 概述
@@ -388,7 +386,7 @@ before running "/usr/sbin/freebsd-update install"
 
 本節將說明如何使用原始碼與 FreeBSD Port 套件集來取得最新版本 FreeBSD 文件本地複本。
 
-有關編輯與提出修正說明文件的資訊，請參考 FreeBSD 文件計畫入門書 (link:{fdp-primer}[FreeBSD Documentation Project Primer])。
+有關編輯與提出修正說明文件的資訊，請參考 FreeBSD 文件計畫入門書 (extref:{fdp-primer}[FreeBSD Documentation Project Primer])。
 
 [[updating-installed-documentation]]
 === 自原始碼更新說明文件
diff --git a/documentation/content/zh-tw/books/handbook/desktop/_index.adoc b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
index ee388acd4f..3a7314ce14 100644
--- a/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[desktop-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/disks/_index.adoc b/documentation/content/zh-tw/books/handbook/disks/_index.adoc
index 576534b016..93b2fbbf87 100644
--- a/documentation/content/zh-tw/books/handbook/disks/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[disks-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc b/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
index 811a2e4525..f1964e688a 100644
--- a/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/usb-device-mode
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[dtrace-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/eresources/_index.adoc b/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
index e8fc43ca34..8ac105b2a6 100644
--- a/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
 [[eresources]]
 = 網路資源
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
 
-include::shared/mirrors.adoc[]
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 The rapid pace of FreeBSD progress makes print media impractical as a means of following the latest developments. Electronic resources are the best, if not often the only, way to stay informed of the latest advances. Since FreeBSD is a volunteer effort, the user community itself also generally serves as a "technical support department" of sorts, with electronic mail, web forums, and USENET news being the most effective way of reaching that community.
 
diff --git a/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc b/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
index f6cd8f9cbc..6598962d87 100644
--- a/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[filesystems-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc b/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
index b0107b060d..07729db7f4 100644
--- a/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[firewalls-intro]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/geom/_index.adoc b/documentation/content/zh-tw/books/handbook/geom/_index.adoc
index 0bc8f410c5..cba6b206ca 100644
--- a/documentation/content/zh-tw/books/handbook/geom/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/zfs
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[geom-synopsis]]
 == 概述
@@ -1139,4 +1137,4 @@ In the case of several slices, a journal will be created for each individual sli
 
 Journaling may also be enabled on current file systems by using `tunefs`. However, _always_ make a backup before attempting to alter an existing file system. In most cases, `gjournal` will fail if it is unable to create the journal, but this does not protect against data loss incurred as a result of misusing `tunefs`. Refer to man:gjournal[8] and man:tunefs[8] for more information about these commands.
 
-It is possible to journal the boot disk of a FreeBSD system. Refer to the article link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
+It is possible to journal the boot disk of a FreeBSD system. Refer to the article extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
diff --git a/documentation/content/zh-tw/books/handbook/introduction/_index.adoc b/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
index 261bee1ae6..cf4e68dca3 100644
--- a/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
 :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
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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]]
 == 概述
@@ -94,7 +92,7 @@ FreeBSD 能應用的情境完全限制在你的想像力上。 從軟體開發�
 * __教育：__您是電腦科學相關領域的學生嗎？再也沒有比使用 FreeBSD 能學到更多作業系統、計算機結構、及網路的方法了。其中許多免費提供的 CAD，數學和圖形設計套件對於那些需要在電腦完成 __其他__ 工作的人也非常有用！
 * __研究：__有了完整的原始程式碼，FreeBSD 是研究作業系統及電腦科學的極佳環境。 具有免費且自由取得特性的 FreeBSD 也使得一個分置兩地的合作計劃，不必擔心版權及系統開放性的問題， 而能自在的交流。
 * _網路：_ 你如果需要 路由器、名稱伺服器 (DNS) 或安全的防火牆， FreeBSD 可以輕易的將你沒有用到的 386 或 486 PC 變身成為絕佳的伺服器，甚至具有過濾封包的功能。
-* _嵌入式：_ FreeBSD 是一套可用來建立嵌入式系統的傑出平台。  支援 ARM(TM), MIPS(TM) 以及 PowerPC(TM) 平台，再加上健全的網路環境、尖端的功能以及自由的 link:{faq}#bsd-license-restrictions[BSD 授權條款]，FreeBSD 成為用來建置嵌入式路由器、防火牆及其他裝置的絕佳基礎。
+* _嵌入式：_ FreeBSD 是一套可用來建立嵌入式系統的傑出平台。  支援 ARM(TM), MIPS(TM) 以及 PowerPC(TM) 平台，再加上健全的網路環境、尖端的功能以及自由的 extref:{faq}[BSD 授權條款, bsd-license-restrictions]，FreeBSD 成為用來建置嵌入式路由器、防火牆及其他裝置的絕佳基礎。
 * _桌面:_ FreeBSD 同時也是低成本桌面解決方案中不錯的選擇，使用了免費的 X11 伺服器。FreeBSD 提供許多開源桌面環境可選擇，包含了標準 GNOME 及 KDE 圖型化使用者介面。FreeBSD 甚至可以透過中央伺服器做 "無磁碟" 開機，讓個人工作站變的更便宜、更易於管理。
 * _軟體開發：_ 基本安裝的 FreeBSD 就包含了完整的程式開發工具，如 C/C++ 編譯器及除錯器。 透過 Port 與套件管理系統也可支援需多其他語言。
 
@@ -179,7 +177,7 @@ FreeBSD 計劃的目標在於提供可作任意用途的軟體而不附帶任何
 [[development]]
 === FreeBSD 開發模式
 
-FreeBSD 的開發是一個非常開放且具彈性的過程，就像從 link:{contributors}[貢獻者名單] 所看到的，是由全世界成千上萬的貢獻者發展起來的。 FreeBSD 的開發基礎架構允許數以百計的開發者透過網際網路協同工作。 我們也經常關注著那些對我們的計畫感興趣的新開發者和新的創意， 那些有興趣更進一步參與計劃的人只需要在 http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[FreeBSD 技術討論郵遞論壇] 連繫我們。 http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[FreeBSD 公告郵遞論壇] 對那些希望了解我們進度的人也是相當有用的。
+FreeBSD 的開發是一個非常開放且具彈性的過程，就像從 extref:{contributors}[貢獻者名單] 所看到的，是由全世界成千上萬的貢獻者發展起來的。 FreeBSD 的開發基礎架構允許數以百計的開發者透過網際網路協同工作。 我們也經常關注著那些對我們的計畫感興趣的新開發者和新的創意， 那些有興趣更進一步參與計劃的人只需要在 http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[FreeBSD 技術討論郵遞論壇] 連繫我們。 http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[FreeBSD 公告郵遞論壇] 對那些希望了解我們進度的人也是相當有用的。
 
 無論是單獨開發者或者封閉式的團隊合作，多瞭解 FreeBSD 計劃和它的開發過程會是不錯的：
 
diff --git a/documentation/content/zh-tw/books/handbook/jails/_index.adoc b/documentation/content/zh-tw/books/handbook/jails/_index.adoc
index 009ca198c7..d3801e3303 100644
--- a/documentation/content/zh-tw/books/handbook/jails/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[jails-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc b/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
index 462ad9dfcf..f7e08e5de6 100644
--- a/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[kernelconfig-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/l10n/_index.adoc b/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
index 74f28a455a..e08ad133d5 100644
--- a/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[l10n-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc b/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
index 18db640d73..4aec095145 100644
--- a/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[linuxemu-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/mac/_index.adoc b/documentation/content/zh-tw/books/handbook/mac/_index.adoc
index 16fd90a81e..e294ee0bc2 100644
--- a/documentation/content/zh-tw/books/handbook/mac/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[mac-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/mail/_index.adoc b/documentation/content/zh-tw/books/handbook/mail/_index.adoc
index b344860205..bb7a686ce8 100644
--- a/documentation/content/zh-tw/books/handbook/mail/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[mail-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
index 6f8a241032..5ff76e4b54 100644
--- a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
 [[mirrors]]
 = 取得 FreeBSD
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
 
-include::shared/mirrors.adoc[]
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[mirrors-cdrom]]
 == CD 與 DVD 合集
diff --git a/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc b/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
index 54046b3cc0..7377415062 100644
--- a/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[multimedia-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc b/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
index c7b67b941d..741c8ee8ae 100644
--- a/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[network-servers-synopsis]]
 == 概述
@@ -1174,7 +1172,7 @@ FreeBSD 並未提供內建的 LDAP 伺服器，要開始設定前請先安裝 pa
 # pkg install openldap-server
 ....
 
-在link:{linux-users}#software[套件]中已開啟了許多的預設選項，可以透過執行 `pkg info openldap-server` 來查看已開啟的選項，若有不足的地方 (例如需要開啟 SQL 的支援)，請考慮使用適當的crossref:ports[ports-using,方式]重新編譯該 Port。
+在extref:{linux-users}[套件, software]中已開啟了許多的預設選項，可以透過執行 `pkg info openldap-server` 來查看已開啟的選項，若有不足的地方 (例如需要開啟 SQL 的支援)，請考慮使用適當的crossref:ports[ports-using,方式]重新編譯該 Port。
 
 安裝程序會建立目錄 [.filename]#/var/db/openldap-data# 來儲存資料，同時需要建立儲存憑證的目錄：
 
diff --git a/documentation/content/zh-tw/books/handbook/parti.adoc b/documentation/content/zh-tw/books/handbook/parti.adoc
index 9c3c5ed8a6..5eae92418f 100644
--- a/documentation/content/zh-tw/books/handbook/parti.adoc
+++ b/documentation/content/zh-tw/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
 next: books/handbook/introduction
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[getting-started]]
 = 入門
 
@@ -17,4 +25,4 @@ next: books/handbook/introduction
 
 我們試著儘可能的讓這段文字的參考連結數目降到最低，讓您在讀使用手冊的這部份時可以不太需要常常前後翻頁。
 
-include::content/zh-tw/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partii.adoc b/documentation/content/zh-tw/books/handbook/partii.adoc
index bdb4d986b2..af524ce51f 100644
--- a/documentation/content/zh-tw/books/handbook/partii.adoc
+++ b/documentation/content/zh-tw/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
 next: books/handbook/desktop
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[common-tasks]]
 = 一般作業
 
@@ -17,4 +25,4 @@ next: books/handbook/desktop
 
 這些章節中有些需要您預先閱讀些相關文件，在各章節開頭的概要內會提及。
 
-include::content/zh-tw/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partiii.adoc b/documentation/content/zh-tw/books/handbook/partiii.adoc
index 2d492ec3ac..cbf9274e48 100644
--- a/documentation/content/zh-tw/books/handbook/partiii.adoc
+++ b/documentation/content/zh-tw/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
 next: books/handbook/config
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[system-administration]]
 = 系統管理
 
@@ -11,4 +19,4 @@ FreeBSD 使用手冊剩下的這些章節涵蓋了全方位的 FreeBSD 系統管
 
 這些章節是讓您在需要查資料的時候翻閱用的。 您不需要依照特定的順序來讀，也不需要將這些章節全部過讀之後才開始用 FreeBSD。
 
-include::content/zh-tw/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partiv.adoc b/documentation/content/zh-tw/books/handbook/partiv.adoc
index 79163aaff0..6cc27f7020 100644
--- a/documentation/content/zh-tw/books/handbook/partiv.adoc
+++ b/documentation/content/zh-tw/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
 next: books/handbook/serialcomms
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[network-communication]]
 = 網路通訊
 
@@ -18,4 +26,4 @@ FreeBSD 是一種廣泛的被使用在高效能的網路伺服器中的作業系
 
 這些章節是讓您在需要查資料的時候翻閱用的。 您不需要依照特定的順序來讀，也不需要將這些章節全部讀過之後才將 FreeBSD 用在網路環境下。
 
-include::content/zh-tw/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partv.adoc b/documentation/content/zh-tw/books/handbook/partv.adoc
index c4004a9e04..46a56c5a83 100644
--- a/documentation/content/zh-tw/books/handbook/partv.adoc
+++ b/documentation/content/zh-tw/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
 next: books/handbook/mirrors
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[appendices]]
 = 附錄 
 
-include::content/zh-tw/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc b/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
index 5758a5cfa9..f5ae897d5b 100644
--- a/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
 [[pgpkeys]]
 = OpenPGP 金鑰
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
 
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
 
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
-The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
 
 [[pgpkeys-officers]]
 == Officers
diff --git a/documentation/content/zh-tw/books/handbook/ports/_index.adoc b/documentation/content/zh-tw/books/handbook/ports/_index.adoc
index 537c083d4b..156e027917 100644
--- a/documentation/content/zh-tw/books/handbook/ports/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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]]
 == 概述
@@ -593,7 +591,7 @@ FreeBSD 的基礎系統內含 Portsnap，這是一個可用來取得 Port 套件
 ====
 *Procedure: Subversion 方法*
 
-若要取得更多對 Port 樹的控制，或若有本地的變更需要維護，可以使用 Subversion 來取得 Port 套件集。請參考 link:{committers-guide}#subversion-primer[Subversion Primer] 來取得 Subversion 的詳細說明。
+若要取得更多對 Port 樹的控制，或若有本地的變更需要維護，可以使用 Subversion 來取得 Port 套件集。請參考 extref:{committers-guide}[Subversion Primer, subversion-primer] 來取得 Subversion 的詳細說明。
 
 . 必須安裝 Subversion 才可用來取出 (Check out) Port 樹。若已存在 Port 樹的複本，可使用此方式安裝 Subversion：
 +
@@ -633,7 +631,7 @@ Port 套件集中含有代表不同軟體分類的目錄，每個分類底下的
 * [.filename]#pkg-descr#：提供程式更詳細的說明。
 * [.filename]#pkg-plist#：Port 安裝的所有檔案清單，也同時會告訴 Port 系統解除安裝時要移除那一些檔案。
 
-部份 Port 含有 [.filename]#pkg-message# 或其他檔案用來處理特殊情況。要取得有關這些檔案的詳細資訊，以及 Port 的概要可參考 link:{porters-handbook}[FreeBSD Porter's Handbook]。
+部份 Port 含有 [.filename]#pkg-message# 或其他檔案用來處理特殊情況。要取得有關這些檔案的詳細資訊，以及 Port 的概要可參考 extref:{porters-handbook}[FreeBSD Porter's Handbook]。
 
 Port 中並不含實際的原始碼，即為 [.filename]#distfile#，在編譯 Port 解壓縮時會自動下載的原始碼到 [.filename]#/usr/ports/distfiles#。
 
@@ -1114,11 +1112,11 @@ custom: {
 +
 [NOTE]
 ====
-有一些 Port 並非由個人維護，而是由 link:{mailing-list-faq}[郵遞論壇] 維護，有許多，但並非全部，只要郵件地址長的像 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 都是，寄信時記得代入實際的論壇名稱。
+有一些 Port 並非由個人維護，而是由 extref:{mailing-list-faq}[郵遞論壇] 維護，有許多，但並非全部，只要郵件地址長的像 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 都是，寄信時記得代入實際的論壇名稱。
 
 尤其是由 mailto:ports@FreeBSD.org[ports@FreeBSD.org] 所維護的 Port 都不是由特定個人維護，而該 Port 的修正與支援都是來自訂閱該郵遞論壇的一般社群所提供，我們隨時歡迎志工參與!
 ====
 + 
-若寄信後沒有取得任何回應，可以依照 link:{problem-reports}[撰寫 FreeBSD 問題回報] 的說明使用 Bugzilla 提出問題回報。
-. 自行修正看看！link:{porters-handbook}[Porter's Handbook] 中含有 Port 基礎架構的詳細資訊，可提供資訊讓您可修正偶然損壞的 Port 或甚至您可以提交之自己的 Port！
+若寄信後沒有取得任何回應，可以依照 extref:{problem-reports}[撰寫 FreeBSD 問題回報] 的說明使用 Bugzilla 提出問題回報。
+. 自行修正看看！extref:{porters-handbook}[Porter's Handbook] 中含有 Port 基礎架構的詳細資訊，可提供資訊讓您可修正偶然損壞的 Port 或甚至您可以提交之自己的 Port！
 . 依照 <<pkgng-intro>> 中的說明安裝 Binary 套件，替代使用 Port 安裝。
diff --git a/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
index 1875b79581..738056c459 100644
--- a/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[ppp-and-slip-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/preface/_index.adoc b/documentation/content/zh-tw/books/handbook/preface/_index.adoc
index feccf55614..ae156941e1 100644
--- a/documentation/content/zh-tw/books/handbook/preface/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/preface/_index.adoc
@@ -13,14 +13,31 @@ next: books/handbook/parti
 :icons: font
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+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/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::[]
 
 [[preface-audience]]
 == 給讀者的話
diff --git a/documentation/content/zh-tw/books/handbook/printing/_index.adoc b/documentation/content/zh-tw/books/handbook/printing/_index.adoc
index c5fdd88e87..725cb16476 100644
--- a/documentation/content/zh-tw/books/handbook/printing/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 儘管很多人試圖淘汰列印功能，但列印資訊到紙上仍是一個重要的功能。列印由兩個基本元件組成，包含了資料傳送到印表機的方式以及印表機可以理解的資料形式。
 
@@ -742,7 +740,7 @@ Several other printing systems are available in addition to the built-in man:lpd
 [[printing-other-cups]]
 === CUPS (Common UNIX(TM) Printing System)
 
-CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: link:{cups}[CUPS]
+CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: extref:{cups}[CUPS]
 
 [[printing-other-hplip]]
 === HPLIP
diff --git a/documentation/content/zh-tw/books/handbook/security/_index.adoc b/documentation/content/zh-tw/books/handbook/security/_index.adoc
index fc639315b1..0c6e43e79c 100644
--- a/documentation/content/zh-tw/books/handbook/security/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[security-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc b/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
index a3db1b2e1a..22614eea8c 100644
--- a/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[serial-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc b/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
index 025db8ab8e..0366dcf61c 100644
--- a/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[usb-device-mode-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc b/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
index 1a0801a8a1..0465a03bf7 100644
--- a/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[virtualization-synopsis]]
 == 概述
diff --git a/documentation/content/zh-tw/books/handbook/x11/_index.adoc b/documentation/content/zh-tw/books/handbook/x11/_index.adoc
index bd6cf8473a..66a4d19344 100644
--- a/documentation/content/zh-tw/books/handbook/x11/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
 :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/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 [[x11-synopsis]]
 == 概述
@@ -1045,7 +1043,7 @@ dbus_enable="YES"
 
 桌面特效需要使用相當程度的顯示卡，對於以 nVidia 為基礎的顯示卡，需要使用專用的驅動程序來取得較佳的性能。其他顯示卡的使用可以跳過這一節，並繼續 [.filename]#xorg.conf# 設定。
 
-要知道需要那一種 nVidia 驅動程式可以查看 link:{faq}#idp59950544[FAQ 中與此主題相關的問題]。
+要知道需要那一種 nVidia 驅動程式可以查看 extref:{faq}[FAQ 中與此主題相關的問題, idp59950544]。
 
 知道您的顯示卡要使用那種驅動程式才是正確的之後，接下來的安裝程序跟安裝其他套件一樣簡單。
 
diff --git a/documentation/content/zh-tw/books/handbook/zfs/_index.adoc b/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
index 03771200a6..881290e3d0 100644
--- a/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+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-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.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::[]
 
 _Z 檔案系統_ 或 ZFS 是設計來克服許多在以往設計中發現的主要問題的一個先進的檔案系統。