git: 7d39fb6d23 - main - Split Traditional Chinese developers handbook
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 21 Nov 2021 21:05:34 UTC
The branch main has been updated by carlavilla:
URL: https://cgit.FreeBSD.org/doc/commit/?id=7d39fb6d2394704b59b2e06c70103e6c8dfdba67
commit 7d39fb6d2394704b59b2e06c70103e6c8dfdba67
Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-11-21 21:04:10 +0000
Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-11-21 21:04:10 +0000
Split Traditional Chinese developers handbook
Split Traditional Chinese developers handbook and remove
toc macro in German developers handbook index file
---
.../de/books/developers-handbook/_index.adoc | 2 -
.../content/de/books/developers-handbook/book.adoc | 2 +-
.../zh-tw/books/developers-handbook/_index.adoc | 39 ++--------
.../bibliography/{chapter.adoc => _index.adoc} | 2 +-
.../zh-tw/books/developers-handbook/book.adoc | 82 ++++++++++++++++++++++
.../books/developers-handbook/chapters-order.adoc | 29 ++++----
.../introduction/{chapter.adoc => _index.adoc} | 2 +-
.../ipv6/{chapter.adoc => _index.adoc} | 2 +-
.../kernelbuild/{chapter.adoc => _index.adoc} | 2 +-
.../kerneldebug/{chapter.adoc => _index.adoc} | 2 +-
.../l10n/{chapter.adoc => _index.adoc} | 0
.../zh-tw/books/developers-handbook/parti.adoc | 18 +++++
.../zh-tw/books/developers-handbook/partii.adoc | 18 +++++
.../zh-tw/books/developers-handbook/partiii.adoc | 18 +++++
.../zh-tw/books/developers-handbook/partiv.adoc | 19 +++++
.../zh-tw/books/developers-handbook/partv.adoc | 18 +++++
.../policies/{chapter.adoc => _index.adoc} | 0
.../secure/{chapter.adoc => _index.adoc} | 6 +-
.../sockets/{chapter.adoc => _index.adoc} | 2 +-
.../testing/{chapter.adoc => _index.adoc} | 2 +-
.../tools/{chapter.adoc => _index.adoc} | 2 +-
.../x86/{chapter.adoc => _index.adoc} | 4 +-
22 files changed, 208 insertions(+), 63 deletions(-)
diff --git a/documentation/content/de/books/developers-handbook/_index.adoc b/documentation/content/de/books/developers-handbook/_index.adoc
index 3f4829289d..8e0f81165b 100644
--- a/documentation/content/de/books/developers-handbook/_index.adoc
+++ b/documentation/content/de/books/developers-handbook/_index.adoc
@@ -55,6 +55,4 @@ Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[
'''
-toc::[]
-
include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/de/books/developers-handbook/book.adoc b/documentation/content/de/books/developers-handbook/book.adoc
index f1e3428e0a..c4cf490cfd 100644
--- a/documentation/content/de/books/developers-handbook/book.adoc
+++ b/documentation/content/de/books/developers-handbook/book.adoc
@@ -80,5 +80,5 @@ include::{chapters-path}partiv.adoc[lines=15..16]
include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
-include::{chapters-path}partv.adoc[lines=15..16]
+include::{chapters-path}partv.adoc[lines=15..16]
include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-tw/books/developers-handbook/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
index 6a63a67756..53047771e7 100644
--- a/documentation/content/zh-tw/books/developers-handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
@@ -4,21 +4,21 @@ authors:
- author: FreeBSD 文件計畫
copyright: 1995-2020 The FreeBSD Documentation Project
trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+next: books/developers-handbook/parti
+add_single_page_link: true
isIndex: true
---
= FreeBSD Developers' Handbook
:doctype: book
:toc: macro
-:toclevels: 2
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:book: true
-:pdf: false
:images-path: books/developers-handbook/
ifdef::env-beastie[]
@@ -53,35 +53,4 @@ endif::[]
'''
-toc::[]
-
-// Section one
-[[basics]]
-= 基本概念
-
-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]
-include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1]
-
-// Section three
-[[kernel]]
-= Kernel(核心)
-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]
-
-// Appendices
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc
similarity index 97%
rename from documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc
index 1642722b36..662ad09265 100644
--- a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc
@@ -1,6 +1,6 @@
---
title: 附錄
-prev: books/developers-handbook/x86
+prev: books/developers-handbook/partv
---
[bibliography]
diff --git a/documentation/content/zh-tw/books/developers-handbook/book.adoc b/documentation/content/zh-tw/books/developers-handbook/book.adoc
new file mode 100644
index 0000000000..bd34ef3d63
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/book.adoc
@@ -0,0 +1,82 @@
+---
+title: FreeBSD Developers' Handbook
+authors:
+ - author: FreeBSD 文件計畫
+copyright: 1995-2020 The FreeBSD Documentation Project
+trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+add_split_page_link: true
+---
+
+= FreeBSD Developers' Handbook
+:doctype: book
+:toc: macro
+:toclevels: 2
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:partnums:
+:source-highlighter: rouge
+:experimental:
+:book: true
+:pdf: false
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+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[]
+:chapters-path: content/{{% lang %}}/books/developers-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]
+[abstract]
+摘要
+
+歡迎使用 Developers' Handbook！ 這份文件是由許多人 _不斷撰寫_ 而成的， 而且許多章節仍需更新或者內容還是一片空白， 如果你想幫忙 FreeBSD 文件計劃， 請寄信到 {freebsd-doc}。
+
+最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面， 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 extref:{handbook}mirrors/[mirror站, mirrors-ftp]下載。
+
+'''
+
+toc::[]
+
+// Section one
+include::{chapters-path}parti.adoc[lines=15..16]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
+include::{chapters-path}tools/_index.adoc[leveloffset=+1]
+include::{chapters-path}secure/_index.adoc[leveloffset=+1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
+include::{chapters-path}policies/_index.adoc[leveloffset=+1]
+include::{chapters-path}testing/_index.adoc[leveloffset=+1]
+
+// Section two
+include::{chapters-path}partii.adoc[lines=15..16]
+include::{chapters-path}sockets/_index.adoc[leveloffset=+1]
+include::{chapters-path}ipv6/_index.adoc[leveloffset=+1]
+
+// Section three
+include::{chapters-path}partiii.adoc[lines=15..16]
+include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
+include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
+
+// Section four
+include::{chapters-path}partiv.adoc[lines=15..16]
+include::{chapters-path}x86/_index.adoc[leveloffset=+1]
+
+// Appendices
+include::{chapters-path}partv.adoc[lines=15..16]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc b/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc
index 90183764d6..ef978f645c 100644
--- a/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc
@@ -1,12 +1,17 @@
-introduction/chapter.adoc
-tools/chapter.adoc
-secure/chapter.adoc
-l10n/chapter.adoc
-policies/chapter.adoc
-testing/chapter.adoc
-sockets/chapter.adoc
-ipv6/chapter.adoc
-kernelbuild/chapter.adoc
-kerneldebug/chapter.adoc
-x86/chapter.adoc
-bibliography/chapter.adoc
+parti.adoc
+introduction/_index.adoc
+tools/_index.adoc
+secure/_index.adoc
+l10n/_index.adoc
+policies/_index.adoc
+testing/_index.adoc
+partii.adoc
+sockets/_index.adoc
+ipv6/_index.adoc
+partiii.adoc
+kernelbuild/_index.adoc
+kerneldebug/_index.adoc
+partiv.adoc
+x86/_index.adoc
+partv.adoc
+bibliography/_index.adoc
diff --git a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc
index 61ee4970a5..73cf9fac07 100644
--- a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc
@@ -3,7 +3,7 @@ title: 章 1. 簡介
authors:
- author: Murray Stokely
- author: Jeroen Ruigrok van der Werven
-prev: books/developers-handbook/
+prev: books/developers-handbook/parti
next: books/developers-handbook/tools
---
diff --git a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc
index 5cf1433a1e..8e5b5882f2 100644
--- a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc
@@ -3,7 +3,7 @@ title: 章 8. IPv6 Internals
authors:
- author: Yoshinobu Inoue
prev: books/developers-handbook/sockets
-next: books/developers-handbook/kernelbuild
+next: books/developers-handbook/partiii
---
[[ipv6]]
diff --git a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc
similarity index 98%
rename from documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc
index 0c4a4c4153..da8a124490 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc
@@ -1,6 +1,6 @@
---
title: 章 9. Building and Installing a FreeBSD Kernel
-prev: books/developers-handbook/ipv6
+prev: books/developers-handbook/partiii
next: books/developers-handbook/kerneldebug
---
diff --git a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc
index 50b8de3416..71b0e6b7ed 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc
@@ -5,7 +5,7 @@ authors:
- author: Jörg Wunsch
- author: Robert Watson
prev: books/developers-handbook/kernelbuild
-next: books/developers-handbook/x86
+next: books/developers-handbook/partiv
---
[[kerneldebug]]
diff --git a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/l10n/_index.adoc
similarity index 100%
rename from documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/l10n/_index.adoc
diff --git a/documentation/content/zh-tw/books/developers-handbook/parti.adoc b/documentation/content/zh-tw/books/developers-handbook/parti.adoc
new file mode 100644
index 0000000000..74cb4ce52b
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/parti.adoc
@@ -0,0 +1,18 @@
+---
+title: Part I. Grundlagen
+prev: books/developers-handbook
+next: books/developers-handbook/introduction
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[basics]]
+= 基本概念
+
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/zh-tw/books/developers-handbook/partii.adoc b/documentation/content/zh-tw/books/developers-handbook/partii.adoc
new file mode 100644
index 0000000000..b00d77ce88
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/partii.adoc
@@ -0,0 +1,18 @@
+---
+title: Part II. Interprozess-Kommunikation
+prev: books/developers-handbook/testing
+next: books/developers-handbook/sockets
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[ipc]]
+= Interprocess Communication(IPC)
+
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/zh-tw/books/developers-handbook/partiii.adoc b/documentation/content/zh-tw/books/developers-handbook/partiii.adoc
new file mode 100644
index 0000000000..72492990ca
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/partiii.adoc
@@ -0,0 +1,18 @@
+---
+title: Part III. Kernel
+prev: books/developers-handbook/ipv6
+next: books/developers-handbook/kernelbuild
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[kernel]]
+= Kernel(核心)
+
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/zh-tw/books/developers-handbook/partiv.adoc b/documentation/content/zh-tw/books/developers-handbook/partiv.adoc
new file mode 100644
index 0000000000..495e233fb0
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/partiv.adoc
@@ -0,0 +1,19 @@
+---
+title: Part IV. Architekturen
+prev: books/developers-handbook/kerneldebug
+next: books/developers-handbook/x86
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[architectures]]
+= Architectures(電腦架構)
+
+include::{chapters-path}toc-4.adoc[]
+
diff --git a/documentation/content/zh-tw/books/developers-handbook/partv.adoc b/documentation/content/zh-tw/books/developers-handbook/partv.adoc
new file mode 100644
index 0000000000..aad1558580
--- /dev/null
+++ b/documentation/content/zh-tw/books/developers-handbook/partv.adoc
@@ -0,0 +1,18 @@
+---
+title: Part V. Appendices
+prev: books/developers-handbook/x86
+next: books/developers-handbook/bibliography
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[appendices]]
+= Appendices
+
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/policies/_index.adoc
similarity index 100%
rename from documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/policies/_index.adoc
diff --git a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc
similarity index 94%
rename from documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc
index ec5a9cc4f5..998dca0993 100644
--- a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc
@@ -59,9 +59,9 @@ One of the pitfalls of the UNIX(R) environment is how easy it is to make assumpt
[[secure-bufferov]]
== Buffer Overflows
-Buffer Overflows have been around since the very beginnings of the von Neumann <<COD>> architecture. They first gained widespread notoriety in 1988 with the Morris Internet worm. Unfortunately, the same basic attack remains effective today. By far the most common type of buffer overflow attack is based on corrupting the stack.
+Buffer Overflows have been around since the very beginnings of the von Neumann crossref:bibliography[COD,1] architecture. They first gained widespread notoriety in 1988 with the Morris Internet worm. Unfortunately, the same basic attack remains effective today. By far the most common type of buffer overflow attack is based on corrupting the stack.
-Most modern computer systems use a stack to pass arguments to procedures and to store local variables. A stack is a last in first out (LIFO) buffer in the high memory area of a process image. When a program invokes a function a new "stack frame" is created. This stack frame consists of the arguments passed to the function as well as a dynamic amount of local variable space. The "stack pointer" is a register that holds the current location of the top of the stack. Since this value is constantly changing as new values are pushed onto the top of the stack, many implementations also provide a "frame pointer" that is located near the beginning of a stack frame so that local variables can more easily be addressed relative to this value. <<COD>> The return address for function calls is also stored on the stack, and this is the cause of stack-overflow exploits since overflowing a local variable in a function can overwrite the return address of that function, potentially allowing a malici
ous user to execute any code he or she wants.
+Most modern computer systems use a stack to pass arguments to procedures and to store local variables. A stack is a last in first out (LIFO) buffer in the high memory area of a process image. When a program invokes a function a new "stack frame" is created. This stack frame consists of the arguments passed to the function as well as a dynamic amount of local variable space. The "stack pointer" is a register that holds the current location of the top of the stack. Since this value is constantly changing as new values are pushed onto the top of the stack, many implementations also provide a "frame pointer" that is located near the beginning of a stack frame so that local variables can more easily be addressed relative to this value. crossref:bibliography[COD,1] The return address for function calls is also stored on the stack, and this is the cause of stack-overflow exploits since overflowing a local variable in a function can overwrite the return address of that function, potentia
lly allowing a malicious user to execute any code he or she wants.
Although stack-based attacks are by far the most common, it would also be possible to overrun the stack with a heap-based (malloc/free) attack.
@@ -109,7 +109,7 @@ May overflow the str buffer.
=== Example Buffer Overflow
-The following example code contains a buffer overflow designed to overwrite the return address and skip the instruction immediately following the function call. (Inspired by <<Phrack>>)
+The following example code contains a buffer overflow designed to overwrite the return address and skip the instruction immediately following the function call. (Inspired by crossref:bibliography[Phrack,4])
[.programlisting]
....
diff --git a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc
index db0b2db27e..952233ffeb 100644
--- a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc
@@ -2,7 +2,7 @@
title: 章 7. Sockets
authors:
- author: G. Adam Stanislav
-prev: books/developers-handbook/testing
+prev: books/developers-handbook/partii
next: books/developers-handbook/ipv6
---
diff --git a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc
index 7bf62f89e2..503c241da6 100644
--- a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc
@@ -1,7 +1,7 @@
---
title: 章 6. Regression and Performance Testing
prev: books/developers-handbook/policies
-next: books/developers-handbook/sockets
+next: books/developers-handbook/partii
---
[[testing]]
diff --git a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc
index fe6852d1d0..502a5ca091 100644
--- a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc
@@ -623,7 +623,7 @@ to the file. Once you have done this, you can type `info` and then select [.guim
Using a debugger allows running the program under more controlled circumstances. Typically, it is possible to step through the program a line at a time, inspect the value of variables, change them, tell the debugger to run up to a certain point and then stop, and so on. It is also possible to attach to a program that is already running, or load a core file to investigate why the program crashed. It is even possible to debug the kernel, though that is a little trickier than the user applications we will be discussing in this section.
-This section is intended to be a quick introduction to using debuggers and does not cover specialized topics such as debugging the kernel. For more information about that, refer to <<kerneldebug>>.
+This section is intended to be a quick introduction to using debuggers and does not cover specialized topics such as debugging the kernel. For more information about that, refer to crossref:kerneldebug[kerneldebug,Kernel Debugging].
The standard debugger supplied with FreeBSD {rel121-current} is called `lldb` (LLVM debugger). As it is part of the standard installation for that release, there is no need to do anything special to use it. It has good command help, accessible via the `help` command, as well as https://lldb.llvm.org/[a web tutorial and documentation].
diff --git a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc
similarity index 99%
rename from documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
rename to documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc
index fa49e3d364..599380f57d 100644
--- a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc
@@ -1,7 +1,7 @@
---
title: 章 11. x86 Assembly Language Programming
-prev: books/developers-handbook/kerneldebug
-next: books/developers-handbook/bibliography
+prev: books/developers-handbook/partiv
+next: books/developers-handbook/partv
---
[[x86]]