Build offline documentation using Hugo and other improvements

* Allow to build the documentation offline using Hugo
* Fix link problems
* Remove SVN entities
* Fix lang problems to help weblate
* Move all the AsciiDoctor translations to the shared folder to
  help weblate
* Allow the possibility to build each document. For example each
document can be edited in and watched the result in real time in
VS Code or Vim/NeoVim.

Breaking changes:

Eliminate the possibility of building books or articles.
They must be builded at the same time.
This functionality will be restored when version 0.89.0 is in the
repositories in a couple of weeks.

Reviewed by:            dbaio@
Differential Revision:  https://reviews.freebsd.org/D31926

13 files changed, 315 insertions, 228 deletions

diff --git a/documentation/content/zh-tw/books/developers-handbook/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
index 4f2d623cd0..6a63a67756 100644
--- a/documentation/content/zh-tw/books/developers-handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Developers' Handbook
 authors:
   - author: FreeBSD 文件計畫
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
-trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"] 
+trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
 ---
 
 = FreeBSD Developers' Handbook
@@ -12,51 +12,35 @@ trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "
 :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
+:images-path: books/developers-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[]
-:imagesdir: ../../../../images/books/developers-handbook/
-:chapters-path: content/zh-tw/books/developers-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/developers-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[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+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[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
@@ -65,7 +49,7 @@ endif::[]
 
 歡迎使用 Developers' Handbook！ 這份文件是由許多人 _不斷撰寫_ 而成的， 而且許多章節仍需更新或者內容還是一片空白， 如果你想幫忙 FreeBSD 文件計劃， 請寄信到 {freebsd-doc}。 
 
-最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面， 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 link:{handbook}#mirrors-ftp/[mirror站]下載。 
+最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面， 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 extref:{handbook}mirrors/[mirror站, mirrors-ftp]下載。
 
 '''
 
@@ -75,29 +59,29 @@ toc::[]
 [[basics]]
 = 基本概念
 
-include::{chapters-path}introduction/chapter.adoc[leveloffset=+1, lines=10..30;40..-1]
-include::{chapters-path}tools/chapter.adoc[leveloffset=+1, lines=10..35;45..-1]
-include::{chapters-path}secure/chapter.adoc[leveloffset=+1, lines=9..29;39..-1]
-include::{chapters-path}l10n/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}policies/chapter.adoc[leveloffset=+1, lines=10..30;40..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
+include::{chapters-path}introduction/chapter.adoc[leveloffset=+1]
+include::{chapters-path}tools/chapter.adoc[leveloffset=+1]
+include::{chapters-path}secure/chapter.adoc[leveloffset=+1]
+include::{chapters-path}l10n/chapter.adoc[leveloffset=+1]
+include::{chapters-path}policies/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
 
 // Section two
 [[ipc]]
 = Interprocess Communication(IPC)
-include::{chapters-path}sockets/chapter.adoc[leveloffset=+1, lines=9..29;40..-1]
-include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1, lines=9..29;39..-1]
+include::{chapters-path}sockets/chapter.adoc[leveloffset=+1]
+include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1]
 
 // Section three
 [[kernel]]
 = Kernel(核心)
-include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1, lines=11..31;41..-1]
+include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1]
+include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1]
 
 // Section four
 [[architectures]]
 = Architectures(電腦架構)
-include::{chapters-path}x86/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
+include::{chapters-path}x86/chapter.adoc[leveloffset=+1]
 
 // Appendices
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1, lines=6..20;28..-1]
+include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
index b35397cdd2..1642722b36 100644
--- a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
@@ -10,20 +10,37 @@ prev: books/developers-handbook/x86
 :toc: macro
 :toclevels: 1
 :icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 [[COD,1]] [1] Dave A Patterson and John L Hennessy. Copyright(R) 1998 Morgan Kaufmann Publishers, Inc. 1-55860-428-6. Morgan Kaufmann Publishers, Inc. Computer Organization and Design. The Hardware / Software Interface. 1-2.
 
diff --git a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
index b81f6a6d52..61ee4970a5 100644
--- a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
@@ -14,28 +14,36 @@ next: books/developers-handbook/tools
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/developers-handbook/
 
-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/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-devel]]
 == 在 FreeBSD 開發程式
diff --git a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
index 02f69a0f4d..5cf1433a1e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
@@ -13,28 +13,36 @@ next: books/developers-handbook/kernelbuild
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 [[ipv6-implementation]]
 == IPv6/IPsec Implementation
diff --git a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
index c01d4aa826..0c4a4c4153 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
@@ -11,36 +11,44 @@ next: books/developers-handbook/kerneldebug
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 Being a kernel developer requires understanding of the kernel build process. To debug the FreeBSD kernel it is required to be able to build one. There are two known ways to do so:
 
-The supported procedure to build and install a kernel is documented in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
+The supported procedure to build and install a kernel is documented in the extref:{handbook}kernelconfig/[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.
 
 [NOTE]
 ====
-It is supposed that the reader of this chapter is familiar with the information described in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook. If this is not the case, please read through the above mentioned chapter to understand how the build process works.
+It is supposed that the reader of this chapter is familiar with the information described in the extref:{handbook}kernelconfig/[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook. If this is not the case, please read through the above mentioned chapter to understand how the build process works.
 ====
 
 [[kernelbuild-traditional]]
diff --git a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
index 94cff71150..50b8de3416 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
@@ -15,28 +15,36 @@ next: books/developers-handbook/x86
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 [[kerneldebug-obtain]]
 == Obtaining a Kernel Crash Dump
@@ -280,7 +288,7 @@ options KDB
 options DDB
 ....
 
-to your config file, and rebuild. (See link:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
+to your config file, and rebuild. (See extref:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
 
 Once your DDB kernel is running, there are several ways to enter DDB. The first, and earliest way is to use the boot flag `-d`. The kernel will start up in debug mode and enter DDB prior to any device probing. Hence you can even debug the device probe/attach functions. To use this, exit the loader's boot menu and enter `boot -d` at the loader prompt.
 
diff --git a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
index b95a6e5c75..849d840a4e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/policies
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/developers-handbook/
 
-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/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-programming]]
 == Programming I18N Compliant Applications
diff --git a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
index 3fa6638788..91cbf6b295 100644
--- a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
@@ -14,28 +14,36 @@ next: books/developers-handbook/testing
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 This chapter documents various guidelines and policies in force for the FreeBSD source tree.
 
diff --git a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
index 742a2c43d8..ec5a9cc4f5 100644
--- a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
@@ -13,28 +13,36 @@ next: books/developers-handbook/l10n
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 [[secure-synopsis]]
 == Synopsis
diff --git a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
index 80e6284948..db0b2db27e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
@@ -13,29 +13,36 @@ next: books/developers-handbook/ipv6
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/developers-handbook/
 
-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[]
-:imagesdir: ../../../../images/books/developers-handbook/
+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::[]
 
 [[sockets-synopsis]]
 == Synopsis
diff --git a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
index 9e730710de..7bf62f89e2 100644
--- a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/sockets
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 Regression tests are used to exercise a particular bit of the system to check that it works as expected, and to make sure that old bugs are not reintroduced.
 
diff --git a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
index ba8dcd4f44..fe6852d1d0 100644
--- a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
@@ -15,32 +15,39 @@ next: books/developers-handbook/secure
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :c-plus-plus-command: c++
 :g-plus-plus-command: g++
 :lg-plus-plus: -lg++
 :lstdc-plus-plus: -lstdc++
-:sectnumoffset: 2
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 [[tools-synopsis]]
 == 概敘
@@ -73,7 +80,7 @@ FreeBSD 提供一個非常棒的開發環境， 比如說像是 C、C++、Fortra
 
 下面這邊有份 Ports Collection 所提供的直譯器清單，還有討論一些比較受歡迎的直譯式語言
 
-至於如何使用 Ports Collection 安裝的說明，可參閱 FreeBSD Handbook 中的 link:{handbook}ports-using[Ports章節]。
+至於如何使用 Ports Collection 安裝的說明，可參閱 FreeBSD Handbook 中的 extref:{handbook}ports[Ports章節, ports-using]。
 
 BASIC::
 BASIC 是 Beginner's ALL-purpose Symbolic Instruction Code 的縮寫。 BASIC 於 1950 年代開始發展，最初開發這套語言的目的是為了教導當時的大學學生如何寫程式。 到了 1980，BASIC已經是很多 programmer 第一個學習的程式語言了。 此外，BASIC 也是 Visual Basic 的基礎。
@@ -622,10 +629,10 @@ The standard debugger supplied with FreeBSD {rel121-current} is called `lldb` (L
 
 [NOTE]
 ====
-The `lldb` command is available for FreeBSD {rel113-current} link:{handbook}#ports-using/[from ports or packages] as package:devel/llvm[]. This will install the default version of lldb (currently 9.0).
+The `lldb` command is available for FreeBSD {rel113-current} extref:{handbook}ports/[from ports or packages, ports-using] as package:devel/llvm[]. This will install the default version of lldb (currently 9.0).
 ====
 
-The other debugger available with FreeBSD is called `gdb` (GNU debugger). Unlike lldb, it is not installed by default on FreeBSD {rel121-current}; to use it, link:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages. The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well. It has quite good on-line help, as well as a set of info pages.
+The other debugger available with FreeBSD is called `gdb` (GNU debugger). Unlike lldb, it is not installed by default on FreeBSD {rel121-current}; to use it, extref:{handbook}ports/[install, ports-using] package:devel/gdb[] from ports or packages. The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well. It has quite good on-line help, as well as a set of info pages.
 
 Which one to use is largely a matter of taste. If familiar with one only, use that one. People familiar with neither or both but wanting to use one from inside Emacs will need to use `gdb` as `lldb` is unsupported by Emacs. Otherwise, try both and see which one you prefer.
 
diff --git a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
index 876f940252..fa49e3d364 100644
--- a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/bibliography
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例 
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/developers-handbook/
 
-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/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::[]
 
 _This chapter was written by {stanislav}._