diff options
Diffstat (limited to 'documentation/content/zh-tw/books')
76 files changed, 1795 insertions, 1546 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}._ diff --git a/documentation/content/zh-tw/books/faq/_index.adoc b/documentation/content/zh-tw/books/faq/_index.adoc index 59b4a7d274..b1b3ae06e0 100644 --- a/documentation/content/zh-tw/books/faq/_index.adoc +++ b/documentation/content/zh-tw/books/faq/_index.adoc @@ -3,8 +3,8 @@ title: FreeBSD 11.X and 12.X 常見問答集 authors: - author: FreeBSD 文件計畫 copyright: 1995-2020 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" -trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] +trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] +isIndex: true --- = FreeBSD {rel2-relx} and {rel-relx} 常見問答集 @@ -12,60 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", " :toc: macro :toclevels: 1 :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: 例 -:rel-numbranch: 3 -:rel-head: 13-CURRENT -:rel-head-relx: 13.X +:images-path: books/faq/ +:rel-numbranch: 4 +:rel-head: 14-CURRENT +:rel-head-relx: 14.X :rel-head-releng: head/ -:rel-relx: 12.X -:rel-stable: 12-STABLE -:rel-releng: stable/12/ +:rel-relx: 13.X +:rel-stable: 13-STABLE +:rel-releng: stable/13/ :rel-relengdate: December 2018 -:rel2-relx: 11.X -:rel2-stable: 11-STABLE -:rel2-releng: stable/11/ -:rel2-relengdate: October 2016 - -ifeval::["{backend}" == "html5"] -include::shared/mirrors.adoc[] +:rel2-relx: 12.X +:rel2-stable: 12-STABLE +:rel2-releng: stable/12/ +:rel2-relengdate: December 2018 +:rel3-relx: 11.X +:rel3-stable: 11-STABLE +:rel3-releng: stable/11/ +:rel3-relengdate: October 2016 + +ifdef::env-beastie[] +ifdef::backend-html5[] include::shared/authors.adoc[] +include::shared/mirrors.adoc[] include::shared/releases.adoc[] -include::shared/en/mailing-lists.adoc[] -include::shared/en/teams.adoc[] -include::shared/en/urls.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +endif::[] +ifdef::backend-pdf,backend-epub3[] +include::../../../../../shared/asciidoctor.adoc[] endif::[] - -ifeval::["{backend}" == "pdf"] -include::../../../../shared/mirrors.adoc[] -include::../../../../shared/authors.adoc[] -include::../../../../shared/releases.adoc[] -include::../../../../shared/en/mailing-lists.adoc[] -include::../../../../shared/en/teams.adoc[] -include::../../../../shared/en/urls.adoc[] endif::[] -ifeval::["{backend}" == "epub3"] -include::../../../../shared/mirrors.adoc[] -include::../../../../shared/authors.adoc[] -include::../../../../shared/releases.adoc[] -include::../../../../shared/en/mailing-lists.adoc[] -include::../../../../shared/en/teams.adoc[] -include::../../../../shared/en/urls.adoc[] +ifndef::env-beastie[] +include::../../../../../shared/asciidoctor.adoc[] endif::[] [.abstract-title] @@ -73,7 +59,7 @@ endif::[] 這份文件是 FreeBSD {rel-relx} 和 {rel2-relx} 常見問答集 ( (FAQ) )。我們盡可能地讓這份 FAQ 提供有用的資訊 ; 如果您有任何改善建議，請寄到 http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[FreeBSD 文件計畫郵件論壇]。 -本文件的最新版本可由 link:{faq}[FreeBSD 網站]取得。 也可以由 https://download.freebsd.org/ftp/doc/[FreeBSD FTP 伺服器] 以 HTTP 下載單一大型 link:.[HTML] 檔或是其他格式的檔案。 +本文件的最新版本可由 extref:{faq}[FreeBSD 網站]取得。 也可以由 https://download.freebsd.org/ftp/doc/[FreeBSD FTP 伺服器] 以 HTTP 下載單一大型 link:.[HTML] 檔或是其他格式的檔案。 ''' @@ -89,7 +75,7 @@ FreeBSD 是一個使用於桌機、筆電、伺服器與嵌入式系統平台的 FreeBSD 已被廣泛地被世界各地的公司行號、ISP、研究人員、電腦 專家、學生，以及家庭用戶所使用，用在工作、教育以及娛樂上。 -如果想看關於 FreeBSD 更深入的資料，請看 link:{handbook}[FreeBSD 使用手冊]。 +如果想看關於 FreeBSD 更深入的資料，請看 extref:{handbook}[FreeBSD 使用手冊]。 === 發展 FreeBSD 計畫的目的是什麼？ @@ -115,7 +101,7 @@ FreeBSD 計畫的目的是提供可以任意使用且沒有限制的穩定快速 但是如果你想要使用的應用程式只能在某個特定的作業系統上面執行 的話，你就不能輕易地把它換掉，或者指望在 FreeBSD 上有很相似的應用程式才有機會。如果你想要的是一個強健的辦公室或是網路伺服器，或是一部穩定的工作站，FreeBSD 無疑是您的最佳選擇。世界各地有很多使用者，包括初學或資深的 UNIX(TM) 管理人員都選用 FreeBSD 當他們唯一的桌上作業系統。 -如果你是從其他的 UNIX(TM)-like 環境轉換到 FreeBSD 的話會很熟悉。 Windows(TM) 或是 Mac OS(TM) 的使用者可能會對 https://www.trueos.org[TrueOS] 有興趣，他是基於 FreeBSD 的一個桌面環境發行版，非UNIX(TM) 使用者可能就要多花一點時間來學習怎麼用 UNIX(TM) 的 方法來做事。你可以從這份 FAQ 和 link:{handbook}[FreeBSD 使用手冊] 來入門。 +如果你是從其他的 UNIX(TM)-like 環境轉換到 FreeBSD 的話會很熟悉。 Windows(TM) 或是 Mac OS(TM) 的使用者可能會對 https://www.trueos.org[TrueOS] 有興趣，他是基於 FreeBSD 的一個桌面環境發行版，非UNIX(TM) 使用者可能就要多花一點時間來學習怎麼用 UNIX(TM) 的 方法來做事。你可以從這份 FAQ 和 extref:{handbook}[FreeBSD 使用手冊] 來入門。 === 為什麼要叫做 FreeBSD？ @@ -151,7 +137,7 @@ Releases 版 <<release-freq,每幾個月>> 才會發行一次。 雖然如此， === 什麼是 FreeBSD-CURRENT? -link:{handbook}#current[FreeBSD-CURRENT] 指的是正在發展中的作業系統版本，它終將在適當的時機成為 FreeBSD-STABLE 分支。它實在是只適合給系統發展者以及有毅力的業餘愛好者使用 。如果想要得到有關如何使用__-CURRENT__的深入資訊，請參考link:{handbook}[使用手冊]的link:{handbook}#current[相關部份]。 +extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] 指的是正在發展中的作業系統版本，它終將在適當的時機成為 FreeBSD-STABLE 分支。它實在是只適合給系統發展者以及有毅力的業餘愛好者使用 。如果想要得到有關如何使用__-CURRENT__的深入資訊，請參考extref:{handbook}[使用手冊]的extref:{handbook}updating-upgrading[相關部份, current]。 如果您對 FreeBSD 本身並不是很熟悉那麼您就不應該使用FreeBSD-CURRENT。 這個分支的程式碼有時候變動得很快，而且可能會因此 而使您有好幾天的時間無法更新您的系統。我們假設使用 FreeBSD-CURRENT 的使用者都有能力去分析他們所遇到的問題，除錯，並且回報問題。 @@ -170,7 +156,7 @@ link:{handbook}#current[FreeBSD-CURRENT] 指的是正在發展中的作業系統 === 什麼是 FreeBSD-STABLE ? -回溯到 FreeBSD 2.0.5 剛發表的時候，我們決定把 FreeBSD 的發展 分成兩支。一支叫做 link:{handbook}#stable[-STABLE]，另一支叫 link:{handbook}#current[-CURRENT]。主要發行版是由__FreeBSD-STABLE__ 這個開發分支而來。他的變動較慢，而且一般來說假設他們都已經先在FreeBSD-CURRENT測試過了。然而在任何時候，FreeBSD-STABLE的原始碼仍有可能不一定適合一般用途，因為他可能包含在 FreeBSD-CURRENT 沒有發現到的錯誤。沒有能力和資源的使用者應該改使用 FreeBSD 正式發行版。_FreeBSD-CURRENT_ 從2.0開始就是另一個分支，一直到12.0-RELEASE和之後的版本都還是。更多關於開發分支的資訊請見 "link:{handbook}#rel-branch[FreeBSD Release Engineering: Creating the Release Branch]" ，分支的開發狀態和接下來的發行計畫時間表可以在 https://www.FreeBSD.org/releng[Release Engineering 資訊] 找到。 +回溯到 FreeBSD 2.0.5 剛發表的時候，我們決定把 FreeBSD 的發展 分成兩支。一支叫做 extref:{handbook}updating-upgrading[-STABLE, stable]，另一支叫 extref:{handbook}updating-upgrading[-CURRENT, current]。主要發行版是由__FreeBSD-STABLE__ 這個開發分支而來。他的變動較慢，而且一般來說假設他們都已經先在FreeBSD-CURRENT測試過了。然而在任何時候，FreeBSD-STABLE的原始碼仍有可能不一定適合一般用途，因為他可能包含在 FreeBSD-CURRENT 沒有發現到的錯誤。沒有能力和資源的使用者應該改使用 FreeBSD 正式發行版。_FreeBSD-CURRENT_ 從2.0開始就是另一個分支，一直到12.0-RELEASE和之後的版本都還是。更多關於開發分支的資訊請見 "extref:{handbook}[FreeBSD Release Engineering: Creating the Release Branch]" ，分支的開發狀態和接下來的發行計畫時間表可以在 https://www.FreeBSD.org/releng[Release Engineering 資訊] 找到。 12.0-STABLE 是目前正在發展中的 _-STABLE_ 分支。最新的 12.0-STABLE 是在 2018年12月發行的 12.0-RELEASE。 @@ -186,7 +172,7 @@ _12-CURRENT_ 這個分支是 FreeBSD 的 _-CURRENT_ 分支，仍然不斷地在 === 誰負責 FreeBSD 的發展？ -如果是一些有關 FreeBSD 計畫的關鍵性決定，像是整個計畫的走向 或是決定誰可以改 source tree 裡的程式碼這類的事，是由一個由 9 個 人所組成的 https://www.FreeBSD.org/administration/#t-core[core team] 來決定。而有另一群超過 350 個人的 link:{contributors}#staff-committers[committers] 有權利可以直接修改 FreeBSD 的 source tree。 +如果是一些有關 FreeBSD 計畫的關鍵性決定，像是整個計畫的走向 或是決定誰可以改 source tree 裡的程式碼這類的事，是由一個由 9 個 人所組成的 https://www.FreeBSD.org/administration/#t-core[core team] 來決定。而有另一群超過 350 個人的 extref:{contributors}[committers, staff-committers] 有權利可以直接修改 FreeBSD 的 source tree。 無論如何，大多數的改變都會事前在 <<mailing,郵件論壇>>先討論過，而且不分角色，每個人都可以參與討論。 @@ -198,7 +184,7 @@ Every significant release of FreeBSD is available via anonymous FTP from the lin * <<current,-CURRENT>> 和 <<stable,-STABLE>> 分支的link:https://www.FreeBSD.org/snapshots/[Snapshot]版本通常每個月會做一次， 主要是為了提供給那些熱心的測試者和開發人員。 * The latest _11-STABLE_ release, 10.4-RELEASE can be found in the link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/10.4-RELEASE/[10.4-RELEASE directory]. -FreeBSD 的 CD、DVD，還有其他取得方式可以在 link:{handbook}#mirrors[the Handbook] 中找到解答。 +FreeBSD 的 CD、DVD，還有其他取得方式可以在 extref:{handbook}mirrors[the Handbook, mirrors] 中找到解答。 === 我要如何去查詢、提交問題回報(Problem Report，簡稱PR)資料庫呢？ @@ -206,13 +192,13 @@ FreeBSD 的 CD、DVD，還有其他取得方式可以在 link:{handbook}#mirrors 可以使用瀏覽器經由link:https://www.FreeBSD.org/support/bugreports/[網頁版的 PR 界面] 來傳送問題回報 -然而，在您回報問題之前，請先閱讀 link:{problem-reports}[如何撰寫 FreeBSD 的問題回報單]，這是一篇告訴你怎樣才能寫出一篇真正有用的問題回報單。 +然而，在您回報問題之前，請先閱讀 extref:{problem-reports}[如何撰寫 FreeBSD 的問題回報單]，這是一篇告訴你怎樣才能寫出一篇真正有用的問題回報單。 == 文件與技術支援 === 有哪些 FreeBSD 相關的好書呢？ -FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件，可在 https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs/] 取得。除此之外，也可以參閱使用手冊的 link:{handbook}#bibliography[參考書目]建議的其他書籍。 +FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件，可在 https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs/] 取得。除此之外，也可以參閱使用手冊的 extref:{handbook}bibliography[參考書目, bibliography]建議的其他書籍。 === 這些文件有其他格式的嗎？像是：純文字(ASCII)或 PostScript 之類的格式？ @@ -346,7 +332,7 @@ FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件，可在 https === 哪裡有關於 FreeBSD 的郵遞論壇(mailing lists)呢？ 有哪些可以使用的 FreeBSD 新聞群組(news groups)呢? -請參考FreeBSD 使用手冊上的 link:{handbook}#eresources-mail[郵件論壇 (mailing-lists)] 。 +請參考FreeBSD 使用手冊上的 extref:{handbook}eresources[郵件論壇 (mailing-lists), eresources-mail] 。 === 有 FreeBSD IRC (Internet Relay Chat)頻道嗎？ @@ -406,7 +392,7 @@ Any of the following can be used: |A minimal image that requires network access during installation to completely install FreeBSD. |=== -Full instructions on this procedure and a little bit more about installation issues in general can be found in the link:{handbook}#bsdinstall[Handbook entry on installing FreeBSD]. +Full instructions on this procedure and a little bit more about installation issues in general can be found in the extref:{handbook}bsdinstall[Handbook entry on installing FreeBSD, bsdinstall]. === What do I do if the install image does not boot? @@ -418,7 +404,7 @@ When using a command line FTP client, type _binary_ at the FTP command prompt af === 可以在哪邊找到安裝 FreeBSD 的解說步驟呢？ -安裝說明可以在 link:{handbook}#bsdinstall[使用手冊的安裝 FreeBSD] 找到。 +安裝說明可以在 extref:{handbook}bsdinstall[使用手冊的安裝 FreeBSD, bsdinstall] 找到。 === 要跑 FreeBSD 至少需要什麼樣的配備呢？ @@ -426,7 +412,7 @@ FreeBSD 需要 486 以上的 PC，64 MB 以上的 RAM，和至少 1.1 GB 的硬 === 要怎樣才能自行打造專用的安裝磁片呢？ -可以透過編譯客製化發行版本來建立客製化的 FreeBSD 安裝媒體。請參閱 link:{releng}[Release Engineering] 文章的說明。 +可以透過編譯客製化發行版本來建立客製化的 FreeBSD 安裝媒體。請參閱 extref:{releng}[Release Engineering] 文章的說明。 === Windows 可以與 FreeBSD 共存嗎？ @@ -516,7 +502,7 @@ PAE is not much used nowadays because most new x86 hardware also supports runnin ==== Does FreeBSD support architectures other than the x86? -Yes. FreeBSD divides support into multiple tiers. Tier 1 architectures, such as i386 or amd64; are fully supported. Tiers 2 and 3 are supported on a best-effort basis. A full explanation of the tier system is available in the link:{committers-guide}#archs[Committer's Guide.] +Yes. FreeBSD divides support into multiple tiers. Tier 1 architectures, such as i386 or amd64; are fully supported. Tiers 2 and 3 are supported on a best-effort basis. A full explanation of the tier system is available in the extref:{committers-guide}[Committer's Guide., archs] A complete list of supported architectures can be found on the https://www.FreeBSD.org/platforms/[platforms page.] @@ -691,7 +677,7 @@ The FreeBSD developers are interested in these errors, but need more information The FreeBSD kernel will only allow a certain number of processes to exist at one time. The number is based on the `kern.maxusers` man:sysctl[8] variable. `kern.maxusers` also affects various other in-kernel limits, such as network buffers. If the machine is heavily loaded, increase `kern.maxusers`. This will increase these other system limits in addition to the maximum number of processes. -To adjust the `kern.maxusers` value, see the link:{handbook}#kern-maxfiles[File/Process Limits] section of the Handbook. While that section refers to open files, the same limits apply to processes. +To adjust the `kern.maxusers` value, see the extref:{handbook}config-tuning[File/Process Limits, kern-maxfiles] section of the Handbook. While that section refers to open files, the same limits apply to processes. If the machine is lightly loaded but running a very large number of processes, adjust the `kern.maxproc` tunable by defining it in [.filename]#/boot/loader.conf#. The tunable will not get adjusted until the system is rebooted. For more information about tuning tunables, see man:loader.conf[5]. If these processes are being run by a single user, adjust `kern.maxprocperuid` to be one less than the new `kern.maxproc` value. It must be at least one less because one system program, man:init[8], must always be running. @@ -721,7 +707,7 @@ Following a fresh install of FreeBSD, it is also possible that domain and name s === Why does file: table is full show up repeatedly in dmesg8? -This error message indicates that the number of available file descriptors have been exhausted on the system. Refer to the link:{handbook}#kern-maxfiles[kern.maxfiles] section of the link:{handbook}#configtuning-kernel-limits[Tuning Kernel Limits] section of the Handbook for a discussion and solution. +This error message indicates that the number of available file descriptors have been exhausted on the system. Refer to the extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}config-tuning[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution. === Why does the clock on my computer keep incorrect time? @@ -819,8 +805,8 @@ FreeBSD supports compressed binary packages to easily install and uninstall port Any of the methods listed here work: -* Use portsnap for most use cases. Refer to link:{handbook}#ports-using[Using the Ports Collection] for instructions on how to use this tool. -* Use Subversion if custom patches to the ports tree are needed. Refer to link:{handbook}#svn[Using Subversion] for details. +* Use portsnap for most use cases. Refer to extref:{handbook}ports[Using the Ports Collection, ports-using] for instructions on how to use this tool. +* Use Subversion if custom patches to the ports tree are needed. Refer to extref:{handbook}mirrors[Using Subversion, svn] for details. === Does FreeBSD support Java? @@ -828,7 +814,7 @@ Yes. Refer to https://www.FreeBSD.org/java/[https://www.FreeBSD.org/java/] for m === Why can I not build this port on my 11.X -, or 12.X -STABLE machine? -If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in link:{handbook}#ports-using[Using the Ports Collection]. If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_. https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches. +If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}ports[Using the Ports Collection, ports-using]. If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_. https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches. === I just tried to build INDEX using make index, and it failed. Why? @@ -838,7 +824,7 @@ There are rare cases where [.filename]#INDEX# will not build due to odd cases in === I updated the sources, now how do I update my installed ports? -FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier. Additional tools are available to simplify port handling and are described the link:{handbook}#ports-using[Upgrading Ports] section in the FreeBSD Handbook. +FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier. Additional tools are available to simplify port handling and are described the extref:{handbook}ports[Upgrading Ports, ports-using] section in the FreeBSD Handbook. === Do I need to recompile every port each time I perform a major version update? @@ -846,7 +832,7 @@ Yes! While a recent system will run with software compiled under an older releas When the system is upgraded, various shared libraries, loadable modules, and other parts of the system will be replaced with newer versions. Applications linked against the older versions may fail to start or, in other cases, fail to function properly. -For more information, see link:{handbook}#freebsdupdate-upgrade[the section on upgrades] in the FreeBSD Handbook. +For more information, see extref:{handbook}updating-upgrading[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook. === Do I need to recompile every port each time I perform a minor version update? @@ -867,14 +853,14 @@ To create audio CDs from MIDI files, first install package:audio/timidity[] from % timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid .... -The WAV files can then be converted to other formats or burned onto audio CDs, as described in the link:{handbook}#creating-cds[FreeBSD Handbook]. +The WAV files can then be converted to other formats or burned onto audio CDs, as described in the extref:{handbook}disks[FreeBSD Handbook, creating-cds]. == Kernel Configuration [[make-kernel]] === I would like to customize my kernel. Is it difficult? -Not at all! Check out the link:{handbook}#kernelconfig[kernel config section of the Handbook]. +Not at all! Check out the extref:{handbook}kernelconfig[kernel config section of the Handbook, kernelconfig]. [NOTE] ==== @@ -920,7 +906,7 @@ Replace _accf_httpd ipfw_ with a list of needed modules. Only the listed modules Unneeded devices can be removed from the kernel to further reduce the size. See <<make-kernel>> for more information. -To put any of these options into effect, follow the instructions to link:{handbook}#kernelconfig-building[build and install] the new kernel. +To put any of these options into effect, follow the instructions to extref:{handbook}kernelconfig/[build and install, kernelconfig-building] the new kernel. For reference, the FreeBSD 11 amd64 kernel ([.filename]#/boot/kernel/kernel#) is approximately 25 MB. @@ -950,7 +936,7 @@ kern.sched.name: ULE === How can I add my new hard disk to my FreeBSD system? -See the link:{handbook}#disks-adding[Adding Disks] section in the FreeBSD Handbook. +See the extref:{handbook}disks[Adding Disks, disks-adding] section in the FreeBSD Handbook. === How do I move my system over to my huge new disk? @@ -1057,7 +1043,7 @@ The secondary DOS partitions are found after _all_ the primary partitions. For e === Is there a cryptographic file system for FreeBSD? -Yes, man:gbde[8] and man:geli[8]. See the link:{handbook}#disks-encrypting[Encrypting Disk Partitions] section of the FreeBSD Handbook. +Yes, man:gbde[8] and man:geli[8]. See the extref:{handbook}disks[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook. === How do I boot FreeBSD and Linux using GRUB? @@ -1123,23 +1109,23 @@ It is a good idea to add a line to [.filename]#/etc/fstab# (see man:fstab[5]) so === Why do I get Incorrect super block when mounting a CD? -The type of device to mount must be specified. This is described in the Handbook section on link:{handbook}#mounting-cd[Using Data CDs]. +The type of device to mount must be specified. This is described in the Handbook section on extref:{handbook}disks[Using Data CDs, mounting-cd]. === Why do I get Device not configured when mounting a CD? -This generally means that there is no CD in the drive, or the drive is not visible on the bus. Refer to the link:{handbook}#mounting-cd[Using Data CDs] section of the Handbook for a detailed discussion of this issue. +This generally means that there is no CD in the drive, or the drive is not visible on the bus. Refer to the extref:{handbook}disks[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue. === Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD? -The CD probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook section on link:{handbook}#mounting-cd[Using Data CD-ROMs]. +The CD probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook section on extref:{handbook}disks[Using Data CD-ROMs, mounting-cd]. === A CD burned under FreeBSD cannot be read under any other operating system. Why? -This means a raw file was burned to the CD, rather than creating an ISO 9660 file system. Take a look at the Handbook section on link:{handbook}#mounting-cd[Using Data CDs]. +This means a raw file was burned to the CD, rather than creating an ISO 9660 file system. Take a look at the Handbook section on extref:{handbook}disks[Using Data CDs, mounting-cd]. === How can I create an image of a data CD? -This is discussed in the Handbook section on link:{handbook}#mkisofs[Writing Data to an ISO File System]. For more on working with CD-ROMs, see the link:{handbook}#creating-cds[Creating CDs Section] in the Storage chapter in the Handbook. +This is discussed in the Handbook section on extref:{handbook}disks[Writing Data to an ISO File System, mkisofs]. For more on working with CD-ROMs, see the extref:{handbook}disks[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook. === Why can I not mount an audio CD? @@ -1205,7 +1191,7 @@ Note that Soft Updates can delay the freeing of disk space and it can take up to === How can I add more swap space? -This section link:{handbook}#adding-swap-space[of the Handbook] describes how to do this. +This section extref:{handbook}config-tuning[of the Handbook, adding-swap-space] describes how to do this. === Why does FreeBSD see my disk as smaller than the manufacturer says it is? @@ -1334,11 +1320,11 @@ After performing these steps, edit [.filename]#/etc/rc.conf# to fix the syntax e === Why am I having trouble setting up my printer? -See the link:{handbook}#printing[Handbook entry on printing] for troubleshooting tips. +See the extref:{handbook}printing[Handbook entry on printing, printing] for troubleshooting tips. === How can I correct the keyboard mappings for my system? -Refer to the Handbook section on link:{handbook}#using-localization[using localization], specifically the section on link:{handbook}#setting-console[console setup]. +Refer to the Handbook section on extref:{handbook}l10n[using localization, using-localization], specifically the section on extref:{handbook}l10n[console setup, setting-console]. === Why can I not get user quotas to work properly? @@ -1350,7 +1336,7 @@ options QUOTA .... + -Refer to the link:{handbook}#quotas[Handbook entry on quotas] for full details. +Refer to theextref:{handbook}disks[Handbook entry on quotas, quotas] for full details. . Do not turn on quotas on [.filename]#/#. . Put the quota file on the file system that the quotas are to be enforced on: + @@ -1398,7 +1384,7 @@ If you are still prompted to give the `root` password when entering the single-u [NOTE] ==== -If the root partition cannot be mounted from single-user mode, it is possible that the partitions are encrypted and it is impossible to mount them without the access keys. For more information see the section about encrypted disks in the FreeBSD link:{handbook}#disks-encrypting[Handbook]. +If the root partition cannot be mounted from single-user mode, it is possible that the partitions are encrypted and it is impossible to mount them without the access keys. For more information see the section about encrypted disks in the FreeBSD extref:{handbook}disks[Handbook, disks-encrypting]. ==== === How do I keep ControlAltDelete from rebooting the system? @@ -1463,7 +1449,7 @@ Long answer: FreeBSD derives its releases from one of two places. Major, dot-zer When a release is about to be made, the branch from which it will be derived from has to undergo a certain process. Part of this process is a code freeze. When a code freeze is initiated, the name of the branch is changed to reflect that it is about to become a release. For example, if the branch used to be called 6.2-STABLE, its name will be changed to 6.3-PRERELEASE to signify the code freeze and signify that extra pre-release testing should be happening. Bug fixes can still be committed to be part of the release. When the source code is in shape for the release the name will be changed to 6.3-RC to signify that a release is about to be made from it. Once in the RC stage, only the most critical bugs found can be fixed. Once the release (6.3-RELEASE in this example) and release branch have been made, the branch will be renamed to 6.3-STABLE. -For more information on version numbers and the various Subversion branches, refer to the link:{releng}[Release Engineering] article. +For more information on version numbers and the various Subversion branches, refer to the extref:{releng}[Release Engineering] article. === I tried to install a new kernel, and the chflags1 failed. How do I get around this? @@ -1561,7 +1547,7 @@ Install Xorg from FreeBSD packages: # pkg install xorg .... -After the installation of Xorg, follow the instructions from the link:{handbook}#x-config[X11 Configuration] section of the FreeBSD Handbook. +After the installation of Xorg, follow the instructions from the extref:{handbook}x11[X11 Configuration, x-config] section of the FreeBSD Handbook. === I tried to run X, but I get a No devices detected. error when I type startx. What do I do now? @@ -1770,7 +1756,7 @@ Type `xmodmap -e "pointer = 3 2 1"`. Add this command to [.filename]#~/.xinitrc# === How do I install a splash screen and where do I find them? -The detailed answer for this question can be found in the link:{handbook}#boot-splash[Boot Time Splash Screens] section of the FreeBSD Handbook. +The detailed answer for this question can be found in the extref:{handbook}boot[Boot Time Splash Screens, boot-splash] section of the FreeBSD Handbook. === Can I use the Windows keys on my keyboard in X? @@ -1836,29 +1822,29 @@ For ATI Rage 128 and Radeon see man:ati[4], man:r128[4] and man:radeon[4]. === Where can I get information on diskless booting? -"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, see link:{handbook}#network-diskless[the Handbook entry on diskless booting]. +"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, see extref:{handbook}advanced-networking[the Handbook entry on diskless booting, network-diskless]. === Can a FreeBSD box be used as a dedicated network router? -Yes. Refer to the Handbook entry on link:{handbook}#advanced-networking[advanced networking], specifically the section on link:{handbook}#network-routing[routing and gateways]. +Yes. Refer to the Handbook entry on extref:{handbook}advanced-networking[advanced networking, advanced-networking], specifically the section on extref:{handbook}advanced-networking[routing and gateways, network-routing]. === Can I connect my Windows box to the Internet via FreeBSD? Typically, people who ask this question have two PCs at home, one with FreeBSD and one with some version of Windows(TM) the idea is to use the FreeBSD box to connect to the Internet and then be able to access the Internet from the Windows(TM) box through the FreeBSD box. This is really just a special case of the previous question and works perfectly well. -Dialup users must use `-nat` and set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#. For more information, refer to man:ppp[8] or the link:{handbook}#userppp[Handbook entry on user PPP]. +Dialup users must use `-nat` and set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#. For more information, refer to man:ppp[8] or the extref:{handbook}ppp-and-slip[Handbook entry on user PPP, userppp]. -If the connection to the Internet is over Ethernet, use man:natd[8]. A tutorial can be found in the link:{handbook}#network-natd[natd] section of the Handbook. +If the connection to the Internet is over Ethernet, use man:natd[8]. A tutorial can be found in the extref:{handbook}[natd, network-natd] section of the Handbook. === Does FreeBSD support PPP? Yes. man:ppp[8] provides support for both incoming and outgoing connections. -For more information on how to use this, refer to the link:{handbook}#ppp-and-slip/[Handbook chapter on PPP]. +For more information on how to use this, refer to the extref:{handbook}ppp-and-slip/[Handbook chapter on PPP, ppp-and-slip]. === Does FreeBSD support NAT or Masquerading? -Yes. For instructions on how to use NAT over a PPP connection, see the link:{handbook}#userppp[Handbook entry on PPP]. To use NAT over some other sort of network connection, look at the link:{handbook}#network-natd[natd] section of the Handbook. +Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}ppp-and-slip[Handbook entry on PPP, userppp]. To use NAT over some other sort of network connection, look at the extref:{handbook}[natd, network-natd] section of the Handbook. === How can I set up Ethernet aliases? @@ -1876,7 +1862,7 @@ Otherwise, specify the network address and netmask as usual: # ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00 .... -More information can be found in the FreeBSD link:{handbook}#configtuning-virtual-hosts/[Handbook]. +More information can be found in the FreeBSD extref:{handbook}config-tuning/[Handbook, configtuning-virtual-hosts]. === Why can I not NFS-mount from a Linux box? @@ -1889,7 +1875,7 @@ Some versions of the Linux(TM) NFS code only accept mount requests from a privil === Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server? -The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Review man:exports[5] and the link:{handbook}#network-nfs/[NFS] entry in the Handbook, especially the section on link:{handbook}#configuring-nfs[configuring NFS]. +The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Review man:exports[5] and the extref:{handbook}network-servers/[NFS, network-nfs] entry in the Handbook, especially the section on extref:{handbook}[configuring NFS, configuring-nfs]. === How do I enable IP multicast support? @@ -1897,7 +1883,7 @@ Install the package:net/mrouted[] package or port and add `mrouted_enable="YES"` === Why do I have to use the FQDN for hosts on my site? -See the answer in the FreeBSD link:{handbook}#mail-trouble[Handbook]. +See the answer in the FreeBSD extref:{handbook}mail[Handbook, mail-trouble]. === Why do I get an error, Permission denied, for all networking operations? @@ -1912,7 +1898,7 @@ If the firewall is unintentionally misconfigured, restore network operability by Consider setting `firewall_type="open"` in [.filename]#/etc/rc.conf#. -For further information on configuring this firewall, see the link:{handbook}#firewalls-ipfw[Handbook chapter]. +For further information on configuring this firewall, see the extref:{handbook}firewalls[Handbook chapter, firewalls-ipfw]. === Why is my ipfw fwd rule to redirect a service to another machine not working? @@ -2084,7 +2070,7 @@ Some people use `toor` for day-to-day `root` tasks with a non-standard shell, le === I cannot make ppp8 work. What am I doing wrong? -First, read man:ppp[8] and the link:{handbook}#userppp[PPP section of the Handbook]. To assist in troubleshooting, enable logging with the following command: +First, read man:ppp[8] and the extref:{handbook}ppp-and-slip[PPP section of the Handbook, userppp]. To assist in troubleshooting, enable logging with the following command: [.programlisting] .... @@ -2134,7 +2120,7 @@ Another reason for the default route line being missing is that a default route delete ALL .... -If this is the case, go back to the link:{handbook}#userppp-final[Final System Configuration] section of the Handbook. +If this is the case, go back to the extref:{handbook}ppp-and-slip[Final System Configuration, userppp-final] section of the Handbook. === What does No route to host mean? @@ -2155,7 +2141,7 @@ delete ALL add 0 0 HISADDR .... -Refer to the link:{handbook}#userppp-dynamicip[PPP and Dynamic IP addresses] section of the Handbook for further details. +Refer to the extref:{handbook}[PPP and Dynamic IP addresses, userppp-dynamicip] section of the Handbook for further details. === Why does my connection drop after about 3 minutes? @@ -2330,7 +2316,7 @@ set dfilter 3 permit 0/0 0/0 This is not always suitable, as it will effectively break demand-dial capabilities. Most programs will need a DNS lookup before doing any other network related things. -In the DNS case, try to determine what is actually trying to resolve a host name. A lot of the time, Sendmail is the culprit. Make sure to configure Sendmail not to do any DNS lookups in its configuration file. See the section on link:{handbook}#dialup[using email with a dialup connection] in the FreeBSD Handbook for details. You may also want to add the following line to [.filename]#.mc#: +In the DNS case, try to determine what is actually trying to resolve a host name. A lot of the time, Sendmail is the culprit. Make sure to configure Sendmail not to do any DNS lookups in its configuration file. See the section on extref:{handbook}serialcomms[using email with a dialup connection, dialup] in the FreeBSD Handbook for details. You may also want to add the following line to [.filename]#.mc#: [.programlisting] .... @@ -2439,7 +2425,7 @@ This section answers common questions about serial communications with FreeBSD. === Which multi-port serial cards are supported by FreeBSD? -There is a list of these in the link:{handbook}#serial[Serial Communications] chapter of the Handbook. +There is a list of these in the extref:{handbook}serialcomms[Serial Communications, serial] chapter of the Handbook. Most multi-port PCI cards that are based on 16550 or clones are supported with no extra effort. @@ -2449,7 +2435,7 @@ Check man:uart[4] and man:sio[4] to get more information on configuring such car === How do I get the boot: prompt to show on the serial console? -See link:{handbook}#serialconsole-setup[this section of the Handbook]. +See extref:{handbook}serialcomms[this section of the Handbook, serialconsole-setup]. === How do I tell if FreeBSD found my serial ports or modem cards? @@ -2506,15 +2492,15 @@ The flags indicate that the master port has minor number `7` (`0x700`), and all === Can I set the default serial parameters for a port? -See the link:{handbook}#serial-hw-config[Serial Communications] section in the FreeBSD Handbook. +See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook. === How can I enable dialup logins on my modem? -Refer to the section about link:{handbook}#dialup[Dial-in Services] in the FreeBSD Handbook. +Refer to the section about extref:{handbook}serialcomms[Dial-in Services, dialup] in the FreeBSD Handbook. === How can I connect a dumb terminal to my FreeBSD box? -This information is in the link:{handbook}#term[Terminals] section of the FreeBSD Handbook. +This information is in the extref:{handbook}serialcomms[Terminals, term] section of the FreeBSD Handbook. === Why can I not run tip or cu? @@ -2576,7 +2562,7 @@ The Ports Collection also has package:emulators/dosbox[]. The main focus of this === What do I need to do to translate a FreeBSD document into my native language? -See the link:{fdp-primer}#translations[Translation FAQ] in the FreeBSD Documentation Project Primer. +See the extref:{fdp-primer}[Translation FAQ, translations] in the FreeBSD Documentation Project Primer. === Why does my email to any address at FreeBSD.org bounce? @@ -2616,7 +2602,7 @@ Xfig and eps drawings are available under [.filename]#/usr/shared/examples/BSD_d === I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look? -Refer to the link:{handbook}#freebsd-glossary[FreeBSD Glossary]. +Refer to the extref:{handbook}glossary[FreeBSD Glossary, freebsd-glossary]. === Why should I care what color the bikeshed is? @@ -2747,13 +2733,13 @@ Install package:games/sl[] and wait for her to mistype `sl` for `ls`. === How can I learn more about FreeBSD's internals? -See the link:{arch-handbook}[FreeBSD Architecture Handbook]. +See the extref:{arch-handbook}[FreeBSD Architecture Handbook]. Additionally, much general UNIX(TM) knowledge is directly applicable to FreeBSD. === How can I contribute to FreeBSD? What can I do to help? -We accept all types of contributions: documentation, code, and even art. See the article on link:{contributing}[Contributing to FreeBSD] for specific advice on how to do this. +We accept all types of contributions: documentation, code, and even art. See the article on extref:{contributing}[Contributing to FreeBSD] for specific advice on how to do this. And thanks for the thought! @@ -2910,4 +2896,4 @@ To find the correct value of _N_, divide the desired address space size (in mega This innocent little Frequently Asked Questions document has been written, rewritten, edited, folded, spindled, mutilated, eviscerated, contemplated, discombobulated, cogitated, regurgitated, rebuilt, castigated, and reinvigorated over the last decade, by a cast of hundreds if not thousands. Repeatedly. -We wish to thank every one of the people responsible, and we encourage you to link:{contributing}[join them] in making this FAQ even better. +We wish to thank every one of the people responsible, and we encourage you to extref:{contributing}[join them] in making this FAQ even better. 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 是設計來克服許多在以往設計中發現的主要問題的一個先進的檔案系統。 diff --git a/documentation/content/zh-tw/books/porters-handbook/_index.adoc b/documentation/content/zh-tw/books/porters-handbook/_index.adoc index d4553da521..9a78c5fe23 100644 --- a/documentation/content/zh-tw/books/porters-handbook/_index.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/_index.adoc @@ -3,8 +3,8 @@ title: FreeBSD Porter 手冊 authors: - author: The FreeBSD Documentation Project copyright: 2000-2020 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" -trademarks: ["freebsd", "sun", "unix", "general"] +trademarks: ["freebsd", "sun", "unix", "general"] +isIndex: true --- = FreeBSD Porter 手冊 @@ -12,48 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"] :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 -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[] -:chapters-path: content/zh-tw/books/porters-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/porters-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::[] ''' @@ -64,21 +50,21 @@ include::{chapters-path}toc-tables.adoc[] include::{chapters-path}toc-examples.adoc[] -include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}new-port/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1, lines=7..28;38..-1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}flavors/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..29;39..-1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}order/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=7..27;37..-1] -include::{chapters-path}uses/chapter.adoc[leveloffset=+1, lines=7..28;38..-1] -include::{chapters-path}versions/chapter.adoc[leveloffset=+1, lines=6..26;36..-1] +include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1] +include::{chapters-path}new-port/chapter.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] +include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1] +include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1] +include::{chapters-path}special/chapter.adoc[leveloffset=+1] +include::{chapters-path}flavors/chapter.adoc[leveloffset=+1] +include::{chapters-path}plist/chapter.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] +include::{chapters-path}testing/chapter.adoc[leveloffset=+1] +include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1] +include::{chapters-path}security/chapter.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] +include::{chapters-path}order/chapter.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] +include::{chapters-path}uses/chapter.adoc[leveloffset=+1] +include::{chapters-path}versions/chapter.adoc[leveloffset=+1] diff --git a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc index 314d7f8c7b..d7fb913a66 100644 --- a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/plist :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/porters-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::[] [[flavors-intro]] == An Introduction to Flavors diff --git a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc index 85621b2f00..d7007ede19 100644 --- a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/uses :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 16 +: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: 16 +:images-path: books/porters-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::[] The FreeBSD Ports Collection is constantly changing. Here is some information on how to keep up. diff --git a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc index d710f9affd..7e15a3648e 100644 --- a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc @@ -11,29 +11,37 @@ next: books/porters-handbook/special :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: :g-plus-plus: g++ -:sectnumoffset: 5 +:images-path: books/porters-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::[] Configuring the [.filename]#Makefile# is pretty simple, and again we suggest looking at existing examples before starting. Also, there is a <<porting-samplem,sample Makefile>> in this handbook, so take a look and please follow the ordering of variables and sections in that template to make the port easier for others to read. @@ -966,7 +974,7 @@ As the Ports Collection has grown over time, various new categories have been in Our existing practice has been to avoid creating a new physical category unless either a large number of ports would logically belong to it, or the ports that would belong to it are a logically distinct group that is of limited general interest (for instance, categories related to spoken human languages), or preferably both. -The rationale for this is that such a change creates a link:{committers-guide}#ports[fair amount of work] for both the committers and also for all users who track changes to the Ports Collection. In addition, proposed category changes just naturally seem to attract controversy. (Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.) +The rationale for this is that such a change creates a extref:{committers-guide}[fair amount of work, ports] for both the committers and also for all users who track changes to the Ports Collection. In addition, proposed category changes just naturally seem to attract controversy. (Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.) Here is the procedure: @@ -983,7 +991,7 @@ Here is the procedure: ** (for extra credit, include the other files that have to change, as per the procedure in the Committer's Guide.) . Since it affects the ports infrastructure and involves moving and patching many ports but also possibly running regression tests on the build cluster, assign the PR to the {portmgr}. -. If that PR is approved, a committer will need to follow the rest of the procedure that is link:{committers-guide}#PORTS[outlined in the Committer's Guide]. +. If that PR is approved, a committer will need to follow the rest of the procedure that is extref:{committers-guide}[outlined in the Committer's Guide, ports]. ==== Proposing a new virtual category is similar to the above but much less involved, since no ports will actually have to move. In this case, the only patches to include in the PR would be those to add the new category to `CATEGORIES` of the affected ports. @@ -2262,7 +2270,7 @@ Set your mail-address here. Please. _:-)_ Only a single address without the comment part is allowed as a `MAINTAINER` value. The format used is `user@hostname.domain`. Please do not include any descriptive text such as a real name in this entry. That merely confuses the Ports infrastructure and most tools using it. -The maintainer is responsible for keeping the port up to date and making sure that it works correctly. For a detailed description of the responsibilities of a port maintainer, refer to link:{contributing}#maintain-port[The challenge for port maintainers]. +The maintainer is responsible for keeping the port up to date and making sure that it works correctly. For a detailed description of the responsibilities of a port maintainer, refer to extref:{contributing}[The challenge for port maintainers, maintain-port]. [NOTE] ==== @@ -2270,7 +2278,7 @@ A maintainer volunteers to keep a port in good working order. Maintainers have t Some types of fixes have "blanket approval" from the {portmgr}, allowing any committer to fix those categories of problems on any port. These fixes do not need approval from the maintainer. -Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes. The current list is available in link:{committers-guide}#ports-qa-misc-blanket-approval[Ports section of the Committer's Guide]. +Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes. The current list is available in extref:{committers-guide}[Ports section of the Committer's Guide, ports-qa-misc-blanket-approval]. ==== Other changes to the port will be sent to the maintainer for review and approval before being committed. If the maintainer does not respond to an update request after two weeks (excluding major public holidays), then that is considered a maintainer timeout, and the update can be made without explicit maintainer approval. If the maintainer does not respond within three months, or if there have been three consecutive timeouts, then that maintainer is considered absent without leave, and all of their ports can be assigned back to the pool. Exceptions to this are anything maintained by the {portmgr}, or the {security-officer}. No unauthorized commits may ever be made to ports maintained by those groups. diff --git a/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc index 2131e2aabc..296ea4fb96 100644 --- a/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/quick-porting :toclevels: 1 :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: -:sectnumoffset: 2 +:images-path: books/porters-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::[] 開始對製作新的 port 或更新現有 port 有一些興趣了嗎？太好囉！ diff --git a/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc index e848e16cd4..92375d174a 100644 --- a/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/keeping-up :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 15 +: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: 15 +:images-path: books/porters-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::[] The first sections of the [.filename]#Makefile# must always come in the same order. This standard makes it so everyone can easily read any port without having to search for variables in a random order. diff --git a/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc index 1c26a69302..f84f709772 100644 --- a/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/testing :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/porters-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::[] There are some tricks we have not mentioned yet about the [.filename]#pkg-*# files that come in handy sometimes. diff --git a/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc index 8fcd6787da..3dba67ceeb 100644 --- a/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/pkg-files :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/porters-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::[] [[plist-sub]] == Changing [.filename]#pkg-plist# Based on Make Variables diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc index c6eccca5a1..90bb0bef05 100644 --- a/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc @@ -11,40 +11,48 @@ next: books/porters-handbook/porting-samplem :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 13 +: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: :freebsd-version: __FreeBSD_version :freebsd: __FreeBSD__ -:sectnumoffset: 13 +:images-path: books/porters-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::[] [[dads-intro]] == Introduction -Here is a list of common dos and don'ts that are encountered during the porting process. Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted. Submit any comments on ports as described in link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary]. Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing. +Here is a list of common dos and don'ts that are encountered during the porting process. Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted. Submit any comments on ports as described in extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL]. Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing. [[porting-wrkdir]] == `WRKDIR` -Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see link:{handbook}#PORTS-CD[ installing ports from a CDROM] for an example of building ports from a read-only tree). The [.filename]##pkg-*## files can be modified by <<pkg-names,redefining a variable>> rather than overwriting the file. +Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see extref:{handbook}ports[ installing ports from a CDROM, PORTS-CD] for an example of building ports from a read-only tree). The [.filename]##pkg-*## files can be modified by <<pkg-names,redefining a variable>> rather than overwriting the file. [[porting-wrkdirprefix]] == `WRKDIRPREFIX` diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc index 1fc1ae1b6f..b7800427bc 100644 --- a/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/order :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 14 +: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: 14 +:images-path: books/porters-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::[] Here is a sample [.filename]#Makefile# that can be used to create a new port. Make sure to remove all the extra comments (ones between brackets). diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc index 09bbe8eca7..f596393064 100644 --- a/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/new-port :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/porters-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::[] 幾乎每個 FreeBSD 愛用者都是透過 FreeBSD Ports Collection 來裝各式應用程式("ports")。如同 FreeBSD 的其他部分一樣， 這些 ports 都主要來自許多志工的努力成果，所以在閱讀這份文件時， 請務必感恩在心。 diff --git a/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc index 6e9f487c6d..6be1b324f0 100644 --- a/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/slow-porting :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/porters-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::[] 本節主要介紹如何來快速打造 port，然而實際應用時這快速方法可能不足，完整的 "慢速打造 Port" 的步驟在 <<slow-porting>> 詳述。 @@ -235,5 +243,5 @@ Giving a good description in the summary of the problem report makes the work of 送出 port 之後，請耐心等候佳音。 有時候可能需要等個幾天或幾個月時間，才會在 FreeBSD ports tree 上正式出現。 等待中的 port PR 清單可以在 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[] 查閱。 -在看過新的 port 之後，如果需要的話，我們會回覆您，然後會將它提交到 port tree 。 您的大名會被列在 link:{contributors}#contrib-additional[Additional FreeBSD Contributors] 列表上，以及其他檔案中。 +在看過新的 port 之後，如果需要的話，我們會回覆您，然後會將它提交到 port tree 。 您的大名會被列在 extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] 列表上，以及其他檔案中。 diff --git a/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc index 9e42934945..a4deea774a 100644 --- a/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/porting-dads :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 12 +: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: 12 +:images-path: books/porters-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::[] [[security-intro]] == Why Security is So Important diff --git a/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc index 6c8b2ab3bc..27d89ca691 100644 --- a/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/makefiles :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/porters-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::[] Ok...事實上並不太可能這麼簡單，port 方面可能需要作些修改才能正常使用。 因此， 本節將一步一步來介紹如何修改上一章的樣本以正常使用。 diff --git a/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc index 77032655af..4e10c9c19a 100644 --- a/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/flavors :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/porters-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 section explains the most common things to consider when creating a port. @@ -4063,7 +4071,7 @@ See <<uses-sqlite>> for more information. [[rc-scripts]] == Starting and Stopping Services (`rc` Scripts) -[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service. Ports integrate into the system [.filename]#rc.d# framework. Details on its usage can be found in link:{handbook}#configtuning-rcd/[the rc.d Handbook chapter]. Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8]. Finally, there is link:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting. +[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service. Ports integrate into the system [.filename]#rc.d# framework. Details on its usage can be found in extref:{handbook}config-tuning/[the rc.d Handbook chapter, configtuning-rcd]. Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8]. Finally, there is extref:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting. With a mythical port called _doorman_, which needs to start a _doormand_ daemon. Add the following to the [.filename]#Makefile#: diff --git a/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc index d96624b2d4..fe566aff91 100644 --- a/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc @@ -11,28 +11,36 @@ next: books/porters-handbook/upgrading :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/porters-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::[] [[make-describe]] == Running `make describe` @@ -192,7 +200,7 @@ Use the host [.filename]#/etc/resolv.conf# inside jails for DNS. This is needed The FTP/HTTP server to use when the jails are installed from FreeBSD releases and updated with man:freebsd-update[8]. Choose a server location which is close, for example if the machine is located in Australia, use `ftp.au.freebsd.org`. `SVN_HOST`:: -The server from where jails are installed and updated when using Subversion. Also used for ports tree when not using man:portsnap[8]. Again, choose a nearby location. A list of official Subversion mirrors can be found in the link:{handbook}#svn-mirrors[FreeBSD Handbook Subversion section]. +The server from where jails are installed and updated when using Subversion. Also used for ports tree when not using man:portsnap[8]. Again, choose a nearby location. A list of official Subversion mirrors can be found in the extref:{handbook}mirrors[FreeBSD Handbook Subversion section, svn-mirrors]. [[testing-poudriere-create-jails]] === Creating Poudriere Jails diff --git a/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc index fc39415577..ce72ab3f4c 100644 --- a/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc @@ -11,32 +11,40 @@ next: books/porters-handbook/security :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/porters-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::[] When a port is not the most recent version available from the authors, update the local working copy of [.filename]#/usr/ports#. The port might have already been updated to the new version. -When working with more than a few ports, it will probably be easier to use Subversion to keep the whole ports collection up-to-date, as described in the link:{handbook}#ports-using/[Handbook]. This will have the added benefit of tracking all the port's dependencies. +When working with more than a few ports, it will probably be easier to use Subversion to keep the whole ports collection up-to-date, as described in the extref:{handbook}ports/[Handbook, ports-using]. This will have the added benefit of tracking all the port's dependencies. The next step is to see if there is an update already pending. To do this, there are two options. There is a searchable interface to the https://bugs.freebsd.org/search/[FreeBSD Problem Report (PR) or bug database]. Select `Ports & Packages` in the `Product` multiple select menu, and enter the name of the port in the `Summary` field. @@ -62,11 +70,11 @@ If some files have been added, copied, moved, or removed, add this information t To simplify common operations with patch files, use `make makepatch` as described in <<slow-patch>>. Other tools exists, like [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Before using it, please read [.filename]#/usr/ports/Tools/scripts/README.patchtool#. -If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer. FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the section in the link:{developers-handbook}#POLICIES-MAINTAINER[Developer's Handbook].) +If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer. FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the section in the extref:{developers-handbook}[Developer's Handbook]., POLICIES-MAINTAINER) To submit the diff, use the https://bugs.freebsd.org/submit/[bug submit form] (product `Ports & Packages`, component `Individual Port(s)`). Always include the category with the port name, followed by colon, and brief descripton of the issue. Examples: `_category/portname_: _add FOO option_`; `_category/portname_: _Update to X.Y_`. Please mention any added or deleted files in the message, as they have to be explicitly specified to man:svn[1] when doing a commit. Do not compress or encode the diff. -Before submitting the bug, review the link:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article. It contains far more information about how to write useful problem reports. +Before submitting the bug, review the extref:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article. It contains far more information about how to write useful problem reports. [IMPORTANT] ==== @@ -94,7 +102,7 @@ When possible, please submit a man:svn[1] diff. They are easier to handle than d <.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#. -<.> https://svn.FreeBSD.org/[svn.FreeBSD.org] is the FreeBSD public Subversion server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information. +<.> https://svn.FreeBSD.org/[svn.FreeBSD.org] is the FreeBSD public Subversion server. See extref:{handbook}mirrors[Subversion mirror sites, svn-mirrors] for more information. While in the port directory, make any changes that are needed. If adding, copying, moving, or removing a file, use `svn` to track these changes: @@ -147,7 +155,7 @@ The last step is to make a unified man:diff[1] of the changes: If files have been added, copied, moved, or removed, include the man:svn[1] `add`, `copy`, `move`, and `remove` commands that were used. `svn move` or `svn copy` must be run before the patch can be applied. `svn add` or `svn remove` must be run after the patch is applied. ==== -Send the patch following the link:{problem-reports}#pr-writing/[problem report submission guidelines]. +Send the patch following the extref:{problem-reports}[problem report submission guidelines, pr-writing]. [[moved-and-updating-files]] == [.filename]#UPDATING# and [.filename]#MOVED# diff --git a/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc index 58e4a93c47..fc2a800eac 100644 --- a/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc @@ -11,29 +11,36 @@ next: books/porters-handbook/versions :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 17 +: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: c++ -:sectnumoffset: 17 +:images-path: books/porters-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::[] [[uses-intro]] == An Introduction to `USES` diff --git a/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc index b7a2d3522f..bd29671154 100644 --- a/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc @@ -10,28 +10,36 @@ prev: books/porters-handbook/uses :toclevels: 1 :icons: font :sectnums: +:sectnumlevels: 6 +:sectnumoffset: 18 +: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: 18 +:images-path: books/porters-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::[] Here is a convenient list of `__FreeBSD_version` values as defined in http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup[sys/param.h]: |