git: bcfe49d831 - main - Split Simplified Chinese porter's handbook

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Sat, 27 Nov 2021 19:29:55 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=bcfe49d83196d773e1e61405001a6661ce70e9f4

commit bcfe49d83196d773e1e61405001a6661ce70e9f4
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-11-27 19:29:26 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-11-27 19:29:26 +0000

    Split Simplified Chinese porter's handbook
---
 .../content/zh-cn/books/arch-handbook/_index.adoc  | 38 ++---------
 .../bibliography/{chapter.adoc => _index.adoc}     |  2 +-
 .../content/zh-cn/books/arch-handbook/book.adoc    | 78 ++++++++++++++++++++++
 .../boot/{chapter.adoc => _index.adoc}             |  2 +-
 .../zh-cn/books/arch-handbook/chapters-order.adoc  | 37 +++++-----
 .../driverbasics/{chapter.adoc => _index.adoc}     |  2 +-
 .../isa/{chapter.adoc => _index.adoc}              |  0
 .../jail/{chapter.adoc => _index.adoc}             |  0
 .../kobj/{chapter.adoc => _index.adoc}             |  0
 .../locking/{chapter.adoc => _index.adoc}          |  0
 .../mac/{chapter.adoc => _index.adoc}              |  0
 .../newbus/{chapter.adoc => _index.adoc}           |  0
 .../content/zh-cn/books/arch-handbook/parti.adoc   | 18 +++++
 .../content/zh-cn/books/arch-handbook/partii.adoc  | 18 +++++
 .../content/zh-cn/books/arch-handbook/partiii.adoc | 18 +++++
 .../pccard/{chapter.adoc => _index.adoc}           |  2 +-
 .../pci/{chapter.adoc => _index.adoc}              |  0
 .../scsi/{chapter.adoc => _index.adoc}             |  0
 .../smp/{chapter.adoc => _index.adoc}              |  2 +-
 .../sound/{chapter.adoc => _index.adoc}            |  0
 .../sysinit/{chapter.adoc => _index.adoc}          |  0
 .../usb/{chapter.adoc => _index.adoc}              |  0
 .../arch-handbook/vm/{chapter.adoc => _index.adoc} |  0
 23 files changed, 162 insertions(+), 55 deletions(-)

diff --git a/documentation/content/zh-cn/books/arch-handbook/_index.adoc b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
index 2c20857249..0228d5fd49 100644
--- a/documentation/content/zh-cn/books/arch-handbook/_index.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
@@ -5,21 +5,22 @@ authors:
   - author: FreeBSD 中文计划
 copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project
 trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
+next: books/arch-handbook/parti
+add_single_page_link: true
 isIndex: true
 ---
 
 = FreeBSD 系统结构手册
 :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/arch-handbook/
 
 ifdef::env-beastie[]
 ifdef::backend-html5[]
@@ -52,33 +53,4 @@ endif::[]
 
 '''
 
-toc::[]
-
-[[kernel]]
-= 内核
-
-include::{chapters-path}boot/chapter.adoc[leveloffset=+1]
-include::{chapters-path}locking/chapter.adoc[leveloffset=+1]
-include::{chapters-path}kobj/chapter.adoc[leveloffset=+1]
-include::{chapters-path}jail/chapter.adoc[leveloffset=+1]
-include::{chapters-path}sysinit/chapter.adoc[leveloffset=+1]
-include::{chapters-path}mac/chapter.adoc[leveloffset=+1]
-include::{chapters-path}vm/chapter.adoc[leveloffset=+1]
-include::{chapters-path}smp/chapter.adoc[leveloffset=+1]
-
-[[devicedrivers]]
-= 设备驱动程序
-
-include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1]
-include::{chapters-path}isa/chapter.adoc[leveloffset=+1]
-include::{chapters-path}pci/chapter.adoc[leveloffset=+1]
-include::{chapters-path}scsi/chapter.adoc[leveloffset=+1]
-include::{chapters-path}usb/chapter.adoc[leveloffset=+1]
-include::{chapters-path}newbus/chapter.adoc[leveloffset=+1]
-include::{chapters-path}sound/chapter.adoc[leveloffset=+1]
-include::{chapters-path}pccard/chapter.adoc[leveloffset=+1]
-
-[[appendices]]
-= 附录
-
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc
similarity index 97%
rename from documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc
index 53c29d8403..78e23c7a39 100644
--- a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc
@@ -1,6 +1,6 @@
 ---
 title: 参考书目
-prev: books/arch-handbook/pccard
+prev: books/arch-handbook/partiii
 ---
 
 [bibliography]
diff --git a/documentation/content/zh-cn/books/arch-handbook/book.adoc b/documentation/content/zh-cn/books/arch-handbook/book.adoc
new file mode 100644
index 0000000000..0eaba06ce3
--- /dev/null
+++ b/documentation/content/zh-cn/books/arch-handbook/book.adoc
@@ -0,0 +1,78 @@
+---
+title: FreeBSD 系统结构手册
+authors: 
+  - author: The FreeBSD Documentation Project
+  - author: FreeBSD 中文计划
+copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project
+trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
+add_split_page_link: true
+---
+
+= FreeBSD 系统结构手册
+: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/arch-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]
+摘要
+
+欢迎您阅读 FreeBSD系统结构手册。 这本手册还在不断由许多人_继续书写_。 许多章节还是空白,有的章节亟待更新。 如果您对这个项目感兴趣并愿意有所贡献,请发信给 {freebsd-doc}。
+
+本文档的最新英文原始版本可从 link:https:://www.FreeBSD.org[FreeBSD Web 站点] 获得, 由 link:http://www.FreeBSD.org.cn/[http://www.FreeBSD.org.cn] 维护的最新译本可以在 link:http://cnsnap.cn.FreeBSD.org/zh-cn/[http://www.FreeBSD.org.cn 快照 Web 站点] 和 link:http://cnsnap.cn.FreeBSD.org/doc/zh_CN.UTF-8/[http://www.FreeBSD.org.cn 文档快照] 处获得, 这一译本会不断向主站同步。 此外, 您也可以从 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP 服务器] 或众多的 extref:{handbook}mirrors/[镜像站点, mirrors-ftp] 得到这份文档的各种其他格式以及压缩形式的版本。
+
+'''
+
+toc::[]
+
+include::{chapters-path}parti.adoc[lines=15..16]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
+include::{chapters-path}locking/_index.adoc[leveloffset=+1]
+include::{chapters-path}kobj/_index.adoc[leveloffset=+1]
+include::{chapters-path}jail/_index.adoc[leveloffset=+1]
+include::{chapters-path}sysinit/_index.adoc[leveloffset=+1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
+include::{chapters-path}vm/_index.adoc[leveloffset=+1]
+include::{chapters-path}smp/_index.adoc[leveloffset=+1]
+
+include::{chapters-path}partii.adoc[lines=15..16]
+include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1]
+include::{chapters-path}isa/_index.adoc[leveloffset=+1]
+include::{chapters-path}pci/_index.adoc[leveloffset=+1]
+include::{chapters-path}scsi/_index.adoc[leveloffset=+1]
+include::{chapters-path}usb/_index.adoc[leveloffset=+1]
+include::{chapters-path}newbus/_index.adoc[leveloffset=+1]
+include::{chapters-path}sound/_index.adoc[leveloffset=+1]
+include::{chapters-path}pccard/_index.adoc[leveloffset=+1]
+
+include::{chapters-path}partiii.adoc[lines=15..16]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc
similarity index 99%
rename from documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc
index 431ac89f38..faadabd081 100644
--- a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc
@@ -1,6 +1,6 @@
 ---
 title: 第 1 章 引导过程与内核初始化
-prev: books/arch-handbook/
+prev: books/arch-handbook/parti
 next: books/arch-handbook/locking
 ---
 
diff --git a/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc b/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc
index af38e8536e..ab4d8f3079 100644
--- a/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc
@@ -1,17 +1,20 @@
-boot/chapter.adoc
-locking/chapter.adoc
-kobj/chapter.adoc
-jail/chapter.adoc
-sysinit/chapter.adoc
-mac/chapter.adoc
-vm/chapter.adoc
-smp/chapter.adoc
-driverbasics/chapter.adoc
-isa/chapter.adoc
-pci/chapter.adoc
-scsi/chapter.adoc
-usb/chapter.adoc
-newbus/chapter.adoc
-sound/chapter.adoc
-pccard/chapter.adoc
-bibliography/chapter.adoc
+parti.adoc
+boot/_index.adoc
+locking/_index.adoc
+kobj/_index.adoc
+jail/_index.adoc
+sysinit/_index.adoc
+mac/_index.adoc
+vm/_index.adoc
+smp/_index.adoc
+partii.adoc
+driverbasics/_index.adoc
+isa/_index.adoc
+pci/_index.adoc
+scsi/_index.adoc
+usb/_index.adoc
+newbus/_index.adoc
+sound/_index.adoc
+pccard/_index.adoc
+partiii.adoc
+bibliography/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc
similarity index 99%
rename from documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc
index 9eeb83eb86..bec7d8bb40 100644
--- a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc
@@ -1,6 +1,6 @@
 ---
 title: 第 9 章 编写 FreeBSD 设备驱动程序
-prev: books/arch-handbook/smp
+prev: books/arch-handbook/partii
 next: books/arch-handbook/isa
 ---
 
diff --git a/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/isa/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/isa/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/jail/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/jail/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/kobj/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/kobj/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/locking/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/locking/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/mac/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/mac/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/newbus/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/newbus/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/parti.adoc b/documentation/content/zh-cn/books/arch-handbook/parti.adoc
new file mode 100644
index 0000000000..c4ade3e3a2
--- /dev/null
+++ b/documentation/content/zh-cn/books/arch-handbook/parti.adoc
@@ -0,0 +1,18 @@
+---
+title: Part I. 内核
+prev: books/arch-handbook
+next: books/arch-handbook/boot
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[kernel]]
+= 内核
+
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/zh-cn/books/arch-handbook/partii.adoc b/documentation/content/zh-cn/books/arch-handbook/partii.adoc
new file mode 100644
index 0000000000..cf1d799e46
--- /dev/null
+++ b/documentation/content/zh-cn/books/arch-handbook/partii.adoc
@@ -0,0 +1,18 @@
+---
+title: Part II. 设备驱动程序
+prev: books/arch-handbook/smp
+next: books/arch-handbook/driverbasics
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[devicedrivers]]
+= 设备驱动程序
+
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/zh-cn/books/arch-handbook/partiii.adoc b/documentation/content/zh-cn/books/arch-handbook/partiii.adoc
new file mode 100644
index 0000000000..ab4deab9b7
--- /dev/null
+++ b/documentation/content/zh-cn/books/arch-handbook/partiii.adoc
@@ -0,0 +1,18 @@
+---
+title: Part III. 附录
+prev: books/arch-handbook/pccard
+next: books/arch-handbook/bibliography
+---
+
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
+[[appendices]]
+= 附录
+
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc
similarity index 99%
rename from documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc
index 939141d559..459a28f986 100644
--- a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc
@@ -1,7 +1,7 @@
 ---
 title: 第 16 章 PC Card
 prev: books/arch-handbook/sound
-next: books/arch-handbook/bibliography
+next: books/arch-handbook/partiii
 ---
 
 [[pccard]]
diff --git a/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pci/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/pci/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/scsi/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/scsi/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc
similarity index 99%
rename from documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc
index 3fa37c019f..ce8fa9f980 100644
--- a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc
@@ -1,7 +1,7 @@
 ---
 title: 第 8 章 SMPng 设计文档
 prev: books/arch-handbook/vm
-next: books/arch-handbook/driverbasics
+next: books/arch-handbook/partii
 ---
 
 [[smp]]
diff --git a/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sound/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/sound/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sysinit/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/sysinit/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/usb/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/usb/_index.adoc
diff --git a/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/vm/_index.adoc
similarity index 100%
rename from documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc
rename to documentation/content/zh-cn/books/arch-handbook/vm/_index.adoc