git: e82f4427f5 - main - Split Japanese porter's handbook

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Fri, 26 Nov 2021 20:39:33 UTC
The branch main has been updated by carlavilla:

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

commit e82f4427f55f4b567dd367a58065301400de5609
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-11-26 20:39:07 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-11-26 20:39:07 +0000

    Split Japanese porter's handbook
---
 .../content/ja/books/porters-handbook/_index.adoc  | 33 ++-------
 .../content/ja/books/porters-handbook/book.adoc    | 78 ++++++++++++++++++++++
 .../changes/{chapter.adoc => _index.adoc}          |  0
 .../ja/books/porters-handbook/chapters-order.adoc  | 38 +++++------
 .../makefile/{chapter.adoc => _index.adoc}         | 12 ++--
 .../own-port/{chapter.adoc => _index.adoc}         |  2 +-
 .../pkg-files/{chapter.adoc => _index.adoc}        |  0
 .../port-upgrading/{chapter.adoc => _index.adoc}   |  0
 .../{chapter.adoc => _index.adoc}                  |  0
 .../porting-dads/{chapter.adoc => _index.adoc}     |  0
 .../porting-info/{chapter.adoc => _index.adoc}     |  0
 .../porting-manpages/{chapter.adoc => _index.adoc} |  0
 .../{chapter.adoc => _index.adoc}                  |  0
 .../porting-motif/{chapter.adoc => _index.adoc}    |  0
 .../porting-samplem/{chapter.adoc => _index.adoc}  |  0
 .../quick-porting/{chapter.adoc => _index.adoc}    |  0
 .../shared/{chapter.adoc => _index.adoc}           |  0
 .../slow/{chapter.adoc => _index.adoc}             |  0
 .../special/{chapter.adoc => _index.adoc}          |  0
 .../testing/{chapter.adoc => _index.adoc}          |  0
 .../why-port/{chapter.adoc => _index.adoc}         |  0
 .../x11-fonts/{chapter.adoc => _index.adoc}        |  0
 22 files changed, 111 insertions(+), 52 deletions(-)

diff --git a/documentation/content/ja/books/porters-handbook/_index.adoc b/documentation/content/ja/books/porters-handbook/_index.adoc
index 280eb91b6c..80e1b593df 100644
--- a/documentation/content/ja/books/porters-handbook/_index.adoc
+++ b/documentation/content/ja/books/porters-handbook/_index.adoc
@@ -4,21 +4,22 @@ authors:
   - author: FreeBSD ドキュメンテーションプロジェクト
 copyright: 2000-2020 The FreeBSD Documentation Project
 trademarks: ["freebsd", "sun", "unix", "general"]
+next: books/porters-handbook/why-port
+add_single_page_link: true
 isIndex: true
 ---
 
-= FreeBSD port 作成者のためのハンドブック
+= FreeBSD Porter's Handbook
 :doctype: book
 :toc: macro
-:toclevels: 2
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:book: true
-:pdf: false
+:images-path: books/porters-handbook/
 
 ifdef::env-beastie[]
 ifdef::backend-html5[]
@@ -53,26 +54,6 @@ endif::[]
 
 '''
 
-toc::[]
+include::{chapters-path}toc.adoc[] 
 
-include::{chapters-path}toc-examples.adoc[]
-
-include::{chapters-path}why-port/chapter.adoc[leveloffset=+1]
-include::{chapters-path}own-port/chapter.adoc[leveloffset=+1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
-include::{chapters-path}slow/chapter.adoc[leveloffset=+1]
-include::{chapters-path}makefile/chapter.adoc[leveloffset=+1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-masterdir/chapter.adoc[leveloffset=+1]
-include::{chapters-path}shared/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-manpages/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-motif/chapter.adoc[leveloffset=+1]
-include::{chapters-path}x11-fonts/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-info/chapter.adoc[leveloffset=+1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
-include::{chapters-path}port-upgrading/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}porting-autoplist/chapter.adoc[leveloffset=+1]
-include::{chapters-path}changes/chapter.adoc[leveloffset=+1]
+include::{chapters-path}toc-examples.adoc[] 
diff --git a/documentation/content/ja/books/porters-handbook/book.adoc b/documentation/content/ja/books/porters-handbook/book.adoc
new file mode 100644
index 0000000000..3e4af86dff
--- /dev/null
+++ b/documentation/content/ja/books/porters-handbook/book.adoc
@@ -0,0 +1,78 @@
+---
+title: FreeBSD port 作成者のためのハンドブック
+authors: 
+  - author: FreeBSD ドキュメンテーションプロジェクト
+copyright: 2000-2020 The FreeBSD Documentation Project
+trademarks: ["freebsd", "sun", "unix", "general"]
+add_split_page_link: true
+---
+
+= FreeBSD Porter's Handbook
+:doctype: book
+:toc: macro
+:toclevels: 2
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:partnums:
+:source-highlighter: rouge
+:experimental:
+:book: true
+:pdf: false
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
+[.abstract-title]
+概要
+
+このハンドブックは FreeBSD の port 作成者 (porter) 向けに、 具体的な port の作成方法や注意点などをまとめたものです。
+
+日本語版の作成は FreeBSD 日本語ドキュメンテーション プロジェクト (FreeBSD doc-jp) が行なっています。 日本語訳および、日本語版のみに関することは FreeBSD 日本語ドキュメンテーションプロジェクト <doc-jp@jp.FreeBSD.org> に おいて日本語で議論されています。 
+
+文書の日本語訳に関するお問い合わせや、 文書の原文に関する問い合わせをしたいが英語が得意でないという方は、 FreeBSD 日本語ドキュメンテーションプロジェクト <doc-jp@jp.FreeBSD.org> まで日本語でコメントをお寄せください。
+
+'''
+
+toc::[]
+
+include::{chapters-path}toc-examples.adoc[]
+
+include::{chapters-path}why-port/_index.adoc[leveloffset=+1]
+include::{chapters-path}own-port/_index.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1]
+include::{chapters-path}slow/_index.adoc[leveloffset=+1]
+include::{chapters-path}makefile/_index.adoc[leveloffset=+1]
+include::{chapters-path}special/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-masterdir/_index.adoc[leveloffset=+1]
+include::{chapters-path}shared/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-manpages/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-motif/_index.adoc[leveloffset=+1]
+include::{chapters-path}x11-fonts/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-info/_index.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1]
+include::{chapters-path}testing/_index.adoc[leveloffset=+1]
+include::{chapters-path}port-upgrading/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-autoplist/_index.adoc[leveloffset=+1]
+include::{chapters-path}changes/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/ja/books/porters-handbook/changes/chapter.adoc b/documentation/content/ja/books/porters-handbook/changes/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/changes/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/changes/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/chapters-order.adoc b/documentation/content/ja/books/porters-handbook/chapters-order.adoc
index 6ae8298094..52b1571174 100644
--- a/documentation/content/ja/books/porters-handbook/chapters-order.adoc
+++ b/documentation/content/ja/books/porters-handbook/chapters-order.adoc
@@ -1,19 +1,19 @@
-why-port/chapter.adoc
-own-port/chapter.adoc
-quick-porting/chapter.adoc
-slow/chapter.adoc
-makefile/chapter.adoc
-special/chapter.adoc
-porting-masterdir/chapter.adoc
-shared/chapter.adoc
-porting-manpages/chapter.adoc
-porting-motif/chapter.adoc
-x11-fonts/chapter.adoc
-porting-info/chapter.adoc
-pkg-files/chapter.adoc
-testing/chapter.adoc
-port-upgrading/chapter.adoc
-porting-dads/chapter.adoc
-porting-samplem/chapter.adoc
-porting-autoplist/chapter.adoc
-changes/chapter.adoc
+why-port/_index.adoc
+own-port/_index.adoc
+quick-porting/_index.adoc
+slow/_index.adoc
+makefile/_index.adoc
+special/_index.adoc
+porting-masterdir/_index.adoc
+shared/_index.adoc
+porting-manpages/_index.adoc
+porting-motif/_index.adoc
+x11-fonts/_index.adoc
+porting-info/_index.adoc
+pkg-files/_index.adoc
+testing/_index.adoc
+port-upgrading/_index.adoc
+porting-dads/_index.adoc
+porting-samplem/_index.adoc
+porting-autoplist/_index.adoc
+changes/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc b/documentation/content/ja/books/porters-handbook/makefile/_index.adoc
similarity index 99%
rename from documentation/content/ja/books/porters-handbook/makefile/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/makefile/_index.adoc
index cf4c25d1e4..a084f9a942 100644
--- a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/makefile/_index.adoc
@@ -1193,19 +1193,19 @@ EXTRACT_DEPENDS=
 |その port をビルドするのに `gmake` が必要です。
 
 |`USE_PERL5`
-|その port をビルドしてインストールするのに `perl 5` が必要です。 `perl` に関連して設定可能な他の変数については <<using-perl>> をご覧ください。
+|その port をビルドしてインストールするのに `perl 5` が必要です。 `perl` に関連して設定可能な他の変数については crossref:special[using-perl, perl の利用] をご覧ください。
 
 |`USE_X_PREFIX`
-|その port は `PREFIX` ではなく `X11BASE` にインストールされます。 X11 に関連して設定可能な他の変数については、 <<using-x11>> をご覧ください。
+|その port は `PREFIX` ではなく `X11BASE` にインストールされます。 X11 に関連して設定可能な他の変数については、 crossref:special[using-x11, X11 の利用] をご覧ください。
 
 |`USE_AUTOMAKE`
-|その port のビルドに GNU `automake` が使われます。`automake` に関わる他に設定可能な変数については、 <<using-automake>> をご覧ください。
+|その port のビルドに GNU `automake` が使われます。`automake` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。
 
 |`USE_AUTOCONF`
-|その port のビルドに GNU `autoconf` が使われます。`autoconf` に関わる他に設定可能な変数については、 <<using-automake>> をご覧ください。
+|その port のビルドに GNU `autoconf` が使われます。`autoconf` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。
 
 |`USE_LIBTOOL`
-|その port のビルドに GNU `libtool` が使われます。`libtool` に関わる他に設定可能な変数については、 <<using-automake>> をご覧ください。
+|その port のビルドに GNU `libtool` が使われます。`libtool` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。
 
 |`GMAKE`
 |`gmake` が `PATH` に入っていない場合のフルパス
@@ -1214,7 +1214,7 @@ EXTRACT_DEPENDS=
 |その port のビルドに `bison` が使われます。
 
 |`USE_SDL`
-|その port のビルドや実行に `SDL` が使われます。 `USE_SDL` の使い方について、詳しくは <<using-sdl>> をご覧ください。
+|その port のビルドや実行に `SDL` が使われます。 `USE_SDL` の使い方について、詳しくは crossref:special[using-sdl,SDL の利用] をご覧ください。
 
 |`NO_INSTALL_MANPAGES`
 |`install.man` ターゲットを使いません。
diff --git a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/own-port/_index.adoc
similarity index 95%
rename from documentation/content/ja/books/porters-handbook/own-port/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/own-port/_index.adoc
index 3a18b9b46b..6a4eef7762 100644
--- a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/own-port/_index.adoc
@@ -44,7 +44,7 @@ endif::[]
 
 自分で port を作ることや、既存の port の 更新作業に興味があるのですか。それはすばらしい!
 
-ここでは FreeBSD 用の port を作る際の ガイドラインをいくつか示します。 既存の port を更新したいと考えている場合であっても、 まずこの章を読んでから、次に <<port-upgrading>> を読むようにしてください。
+ここでは FreeBSD 用の port を作る際の ガイドラインをいくつか示します。 既存の port を更新したいと考えている場合であっても、 まずこの章を読んでから、次に crossref:port-upgrading[port-upgrading, アップグレード] を読むようにしてください。
 
 この文書では充分に詳細がわからない場合には、 [.filename]#/usr/ports/Mk/bsd.port.mk# を参照してください。 このファイルは、port の Makefile が例外なくインクルードしているものです。 これには細かくコメントが書かれていますので、Makefile を読むのに あまり慣れていない人でも、たくさんの情報を得ることができるでしょう。 それでも解決できないような質問は、link:{freebsd-ports} にポストしてみるのも 良いでしょう。
 
diff --git a/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ja/books/porters-handbook/pkg-files/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/pkg-files/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/ja/books/porters-handbook/port-upgrading/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/port-upgrading/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-autoplist/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-autoplist/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-dads/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-dads/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-info/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-info/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-manpages/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-manpages/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-masterdir/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-masterdir/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-motif/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-motif/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-samplem/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/porting-samplem/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ja/books/porters-handbook/quick-porting/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/quick-porting/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/shared/chapter.adoc b/documentation/content/ja/books/porters-handbook/shared/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/shared/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/shared/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/slow/chapter.adoc b/documentation/content/ja/books/porters-handbook/slow/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/slow/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/slow/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/special/chapter.adoc b/documentation/content/ja/books/porters-handbook/special/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/special/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/special/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/testing/chapter.adoc b/documentation/content/ja/books/porters-handbook/testing/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/testing/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/testing/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/why-port/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/why-port/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/why-port/_index.adoc
diff --git a/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc b/documentation/content/ja/books/porters-handbook/x11-fonts/_index.adoc
similarity index 100%
rename from documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc
rename to documentation/content/ja/books/porters-handbook/x11-fonts/_index.adoc