Add Japanese documentation

Author: ophub

README.ja.md

@@ -8,7 +8,7 @@
 
 Armbianは、Debian/Ubuntuをベースに、ARMチップ向けに特別に構築された軽量Linuxディストリビューションです。Armbianシステムはスリムでクリーンであり、Debian/Ubuntuと100%互換性があり、その機能と豊富なソフトウェアエコシステムを継承しています。TF/SD/USBストレージおよびデバイスのeMMCで安全かつ安定して動作します。本プロジェクトは、公式Armbianシステムの完全性を維持しつつ、TVボックスなどの公式にサポートされていないデバイスへのサポートを拡張し、便利な管理コマンドのセットを追加しています。TVボックスのAndroid TVシステムをArmbianに置き換え、強力なサーバーに変身させることができます。
 
-本プロジェクトは多くの[コントリビューター](CONTRIBUTORS.md)に支えられ、`Amlogic`、`Rockchip`、`Allwinner`デバイス向けのArmbianシステムを構築しています。eMMCへの書き込み、カーネル更新などの機能をサポートしています。詳しい使い方は[Armbianユーザードキュメント](./documents/README.md)をご覧ください。最新のArmbianシステムは[Releases](https://github.com/ophub/amlogic-s9xxx-armbian/releases)からダウンロードできます。`Fork`してカスタマイズすることを歓迎します。本プロジェクトがお役に立ちましたら、右上の`Star`ボタンをクリックしてサポートをお願いします。
+本プロジェクトは多くの[コントリビューター](CONTRIBUTORS.md)に支えられ、`Amlogic`、`Rockchip`、`Allwinner`デバイス向けのArmbianシステムを構築しています。eMMCへの書き込み、カーネル更新などの機能をサポートしています。詳しい使い方は[Armbianユーザードキュメント](./documents/README.ja.md)をご覧ください。最新のArmbianシステムは[Releases](https://github.com/ophub/amlogic-s9xxx-armbian/releases)からダウンロードできます。`Fork`してカスタマイズすることを歓迎します。本プロジェクトがお役に立ちましたら、右上の`Star`ボタンをクリックしてサポートをお願いします。
 
 ## Armbianシステムのデフォルト情報
 
@@ -51,15 +51,15 @@ Armbianは、Debian/Ubuntuをベースに、ARMチップ向けに特別に構築
 | h618 | [OrangePi-Zero3](https://github.com/ophub/fnnas/issues/158) | [stable](https://github.com/ophub/kernel/releases/tag/kernel_stable) |
 
 > [!TIP]
-> 現在、[s905ボックス](https://github.com/ophub/amlogic-s9xxx-armbian/issues/1173)は`TF/SD/USB`でのみ使用できます。その他のボックスモデルは`EMMC`への書き込みに対応しています。詳細は[✅ 対応デバイス一覧](build-armbian/armbian-files/common-files/etc/model_database.conf)をご参照ください。新しいデバイスサポートの追加については、ドキュメントのセクション12.15：[新しい対応デバイスの追加方法](documents/README.md#1215-how-to-add-new-supported-devices)をご覧ください。ご使用前に[Armbianユーザードキュメント](./documents/README.md)をお読みください。よくある問題の解決方法が記載されています。
+> 現在、[s905ボックス](https://github.com/ophub/amlogic-s9xxx-armbian/issues/1173)は`TF/SD/USB`でのみ使用できます。その他のボックスモデルは`EMMC`への書き込みに対応しています。詳細は[✅ 対応デバイス一覧](build-armbian/armbian-files/common-files/etc/model_database.conf)をご参照ください。新しいデバイスサポートの追加については、ドキュメントのセクション12.15：[新しい対応デバイスの追加方法](documents/README.ja.md#1215-新しいサポートデバイスの追加方法)をご覧ください。ご使用前に[Armbianユーザードキュメント](./documents/README.ja.md)をお読みください。よくある問題の解決方法が記載されています。
 
 ## Armbianのインストールとアップグレード手順
 
 お使いのデバイスモデルに合ったArmbianシステムを選択してください。デバイス固有の使用方法については、対応するドキュメントをご参照ください。
 
 - ### ArmbianをEMMCにインストール
 
-1. `Rockchip`プラットフォームのデバイスについては、ドキュメントの[第8章](documents/README.md#8-installing-armbian-to-emmc)をご参照ください。
+1. `Rockchip`プラットフォームのデバイスについては、ドキュメントの[第8章](documents/README.ja.md#8-armbian-を-emmc-にインストールする)をご参照ください。
 
 2. `Amlogic`および`Allwinner`プラットフォームのデバイスについては、[Rufus](https://rufus.ie/)や[balenaEtcher](https://www.balena.io/etcher/)などのツールを使用してシステムをUSBメモリに書き込み、デバイスに挿入します。Armbianシステムにログイン（デフォルトユーザー：root、デフォルトパスワード：1234）し、以下のコマンドを入力します：
 
@@ -100,7 +100,7 @@ armbian-update
 
 `-k`パラメータでカーネルバージョンを指定する際、正確なバージョン番号（例：`armbian-update -k 5.15.50`）またはカーネルシリーズのみ（例：`armbian-update -k 5.15`）を指定できます。シリーズを指定した場合、そのシリーズ内の最新バージョンが自動的に使用されます。
 
-カーネル更新時、現在実行中のカーネルは自動的に`/ddbr/backup`ディレクトリにバックアップされ、最新の3つのバージョンが保持されます。新しくインストールしたカーネルが不安定な場合、いつでもバックアップカーネルを復元できます。カーネル更新によりシステムが起動できなくなった場合は、`armbian-update -s`でシステムカーネルを復元できます。詳細は[ヘルプドキュメント](documents/README.md#10-updating-armbian-kernel)をご覧ください。
+カーネル更新時、現在実行中のカーネルは自動的に`/ddbr/backup`ディレクトリにバックアップされ、最新の3つのバージョンが保持されます。新しくインストールしたカーネルが不安定な場合、いつでもバックアップカーネルを復元できます。カーネル更新によりシステムが起動できなくなった場合は、`armbian-update -s`でシステムカーネルを復元できます。詳細は[ヘルプドキュメント](documents/README.ja.md#10-armbian-カーネルの更新)をご覧ください。
 
 - ### Armbianソースの変更
 
@@ -110,7 +110,7 @@ Armbianシステムにログインし、以下のコマンドを入力します
 armbian-apt
 ```
 
-お住まいの国や地域に適したソフトウェアソースを選択することで、ダウンロード速度を大幅に向上させることができます。詳細は[ヘルプドキュメント](documents/README.md#11-installing-common-software)をご覧ください。
+お住まいの国や地域に適したソフトウェアソースを選択することで、ダウンロード速度を大幅に向上させることができます。詳細は[ヘルプドキュメント](documents/README.ja.md#11-よく使うソフトウェアのインストール)をご覧ください。
 
 - ### よく使うソフトウェアのインストール
 
@@ -167,7 +167,7 @@ armbian-ddbr
 
 - ### Armbian内でのカーネルコンパイル
 
-カーネルコンパイルの手順については、[カーネルコンパイル](compile-kernel/README.md)ドキュメントをご覧ください。Armbianシステムにログインし、以下のコマンドを入力します：
+カーネルコンパイルの手順については、[カーネルコンパイル](compile-kernel/README.ja.md)ドキュメントをご覧ください。Armbianシステムにログインし、以下のコマンドを入力します：
 
 ```shell
 armbian-kernel -u
@@ -182,7 +182,7 @@ armbian-kernel -k 6.6.12
 armbian-sync
 ```
 
-Armbian使用時のよくある問題とその解決方法については、[documents](documents/README.md)をご覧ください。
+Armbian使用時のよくある問題とその解決方法については、[documents](documents/README.ja.md)をご覧ください。
 
 ## ローカルパッケージング
 
@@ -265,7 +265,7 @@ sudo apt-get install -y $(cat compile-kernel/tools/script/ubuntu2404-build-armbi
 
 - ### GitHub Actions出力変数の説明
 
-`Releases`へのアップロードには、リポジトリの`ワークフロー読み取りおよび書き込み権限`が必要です。詳細は[使用方法の説明](documents/README.md#2-set-up-private-variable-github_token)をご覧ください。
+`Releases`へのアップロードには、リポジトリの`ワークフロー読み取りおよび書き込み権限`が必要です。詳細は[使用方法の説明](documents/README.ja.md#2-プライバシー変数-github_token-等の設定)をご覧ください。
 
 | パラメータ                        | デフォルト       | 説明                           |
 |----------------------------------|---------------|---------------------------------------|
@@ -279,7 +279,7 @@ Armbianシステムの[Docker](https://hub.docker.com/u/ophub)イメージの作
 
 ## GitHub Actionsを使用したカーネルコンパイル
 
-カーネルコンパイルの手順については、[compile-kernel](compile-kernel/README.md)をご覧ください。
+カーネルコンパイルの手順については、[compile-kernel](compile-kernel/README.ja.md)をご覧ください。
 
 ```yaml
 - name: Compile the kernel

build-armbian/README.cn.md

@@ -1,6 +1,6 @@
 # 构建文件说明
 
-查看英文说明 | [View English description](README.md)
+[View English description](README.md) | [查看中文说明](README.cn.md) | [日本語の説明を確認する](README.ja.md)
 
 编译 Armbian 系统所需的文件按功能分类存放在各个子目录中。
 

build-armbian/README.ja.md

@@ -0,0 +1,19 @@
+# ビルドファイルの説明
+
+[View English description](README.md) | [查看中文说明](README.cn.md) | [日本語の説明を確認する](README.ja.md)
+
+Armbian システムのコンパイルに必要なファイルは、機能別に各サブディレクトリに分類して格納されています。
+
+## armbian-files
+
+このディレクトリには、Armbian のビルドプロセスで必要なすべてのファイルが格納されています。`common-files` ディレクトリにはプラットフォームに依存しない共通ファイル、`platform-files` ディレクトリには各プラットフォーム専用ファイル、`different-files` ディレクトリには異なるデバイス向けの差分設定ファイルが格納されています。詳細は [documents](../documents/README.ja.md) の `12.15` セクションを参照してください。
+
+必要なファームウェアは [ophub/firmware](https://github.com/ophub/firmware) リポジトリから `common-files/usr/lib/firmware` ディレクトリに自動的にダウンロードされます。
+
+## kernel
+
+`kernel` ディレクトリ内にバージョン番号に対応するフォルダを作成します（例：`stable/5.10.125`）。複数のカーネルをコンパイルする必要がある場合は、各バージョンのディレクトリを順次作成し、対応するカーネルファイルを配置してください。カーネルファイルは [kernel](https://github.com/ophub/kernel) リポジトリからダウンロードするか、[自分でコンパイル](../compile-kernel)することもできます。ローカルにカーネルファイルが事前に配置されていない場合、ビルドスクリプトが kernel リポジトリから自動的にダウンロードします。
+
+## u-boot
+
+システムブートファイルです。使用するカーネルバージョンに応じて、対応する u-boot ファイルはインストールまたは更新スクリプトによって自動的に取得・設定されます。必要な u-boot は [ophub/u-boot](https://github.com/ophub/u-boot) リポジトリから `u-boot` ディレクトリに自動的にダウンロードされます。

build-armbian/README.md

@@ -1,6 +1,6 @@
 # Build Files Reference
 
-View Chinese description | [查看中文说明](README.cn.md)
+[View English description](README.md) | [查看中文说明](README.cn.md) | [日本語の説明を確認する](README.ja.md)
 
 The files required for compiling the Armbian system are organized in their respective directories.
 

compile-kernel/README.cn.md

@@ -1,6 +1,6 @@
 # 内核编译与使用指南
 
-查看英文说明 | [View English description](README.md)
+[View English description](README.md) | [查看中文说明](README.cn.md) | [日本語の説明を確認する](README.ja.md)
 
 本项目编译的内核兼容 `Armbian` 和 `OpenWrt` 系统，可用于 [amlogic-s9xxx-armbian](https://github.com/ophub/amlogic-s9xxx-armbian)、[amlogic-s9xxx-openwrt](https://github.com/ophub/amlogic-s9xxx-openwrt)、[flippy-openwrt-actions](https://github.com/ophub/flippy-openwrt-actions) 和 [unifreq/openwrt_packit](https://github.com/unifreq/openwrt_packit) 等项目。既可在编译固件时集成，也可安装到已有系统中使用。