[update] : Updated jp docs

Author: Hayao0819

default.conf

@@ -293,21 +293,18 @@ dependence=(
 #   "archiso"
     "arch-install-scripts"
     "curl"
-    "cmake"
     "dosfstools"
     "git"
     "libburn"
     "libisofs"
     "lz4"
     "lzo"
     "make"
-    "ninja"
     "pyalpm"
     "squashfs-tools"
     "libisoburn"
 #   "lynx"
     "xz"
-    "yay"
     "zlib"
     "zstd"
     "qt5-base"

docs/jp/AUR.md

@@ -3,6 +3,7 @@ AlterISO 3ではAURのパッケージをビルドに含めることができま
 
 ## yayについて
 yayは最も使用されているAURヘルパーです。AlterISOはまず一時的な一般ユーザーを作成した後、yayをmakepkgでビルドしてインストールします。  
+全てのAURパッケージはyayコマンドを利用してインストールされます。それにより高度な依存関係の解決を行うことができます。
 
 ## AURビルドを無効化する
 チャンネルの`config.<arch>`かビルド時に`--noaur`を指定することでAURのビルドをスキップできます。  
@@ -14,3 +15,4 @@ AURビルドを無効化すると一部のパッケージがインストール
 # Do not install the AUR package.
 noaur=true
 ```
+AURからのインストールを無効化すると、その後の`PKGBUILD`からのパッケージのインストールのための依存関係をインストールできず、エラーが発生する場合があります。（デフォルトで設定されているCalamaresはAURのパッケージを依存関係に含んでいます。）エラーが発生する場合には`--nopkgbuild`も一緒に指定することでこのエラーを回避できます。

docs/jp/BUILD.md

@@ -2,7 +2,8 @@
 ビルドは実機のArch Linuxを利用する方法とDocker上でビルドする方法があります。  
 Dockerでビルドする方法は[この手順](DOCKER.md)を参照してください。  
 
-実機でビルドする場合は、必ずOSがArch LinuxかAlter Linuxでなければなりません。  
+実機でビルドする場合は、OSがArch LinuxかAlter Linuxでなければなりません。  
+（Manjaroや他のディストリビューションでも必要なコマンドをインストールすれば理論上は可能ですが動作は保証されません。）
 以下では実機でビルドする方法を解説します。  
 
 ArchやAlter上で直接ビルドする場合、ビルドはいくつかの方法で行うことができます。
@@ -31,12 +32,7 @@ sudo ./tools/keyring.sh --alter-add --arch32-add
 ビルドに必要なパッケージをインストールします。
 
 ```bash
-sudo pacman -S --needed git make ninja arch-install-scripts squashfs-tools libisoburn dosfstools ninja cmake pyalpm
-git clone https://aur.archlinux.org/yay.git
-cd yay
-makepkg -siAcC
-cd ..
-rm -rf yay/
+sudo pacman -S --needed curl dosfstools git libburn libisofs lz4 lzo make pyalpm squashfs-tools libisoburn xz zlib zstd qt5-base
 ```
 
 ### TUIを使用する
@@ -96,19 +92,20 @@ sudo ./build.sh [options] [channel]
 
 - Plymouthを有効化
 - 圧縮方式は`gzip`
-- カーネルは`linux-lqx`
+- カーネルは`linux-lts`
 - パスワードは`ilovearch`
+- チャンネルは`xfce`
 
 ```bash
-./build.sh -b -c "gzip" -k "lqx" -p 'ilovearch' xfce
+./build.sh -b -c "gzip" -k "lts" -p 'ilovearch' xfce
 ```
 
 
 ### 注意事項
 #### チャンネルについて
 チャンネルは、インストールするパッケージと含めるファイルを切り替えます。  
 この仕組みにより様々なバージョンのAlter Linuxをビルドすることが可能になります。  
-2020年8月17日現在でサポートされているチャンネルは以下のとおりです。  
+2021年5月07日現在でサポートされているチャンネルは以下のとおりです。  
 完全なチャンネルの一覧は`./build.sh -h`を参照して下さい。  
 
 名前 | 目的
@@ -120,6 +117,7 @@ i3 | i3とカスタマイズ可能なpolybarを搭載したrelengを除いて最
 lxde | LXDEと最小限のアプリケーションのみが入っている軽量なチャンネル
 plasma | PlasmaとQtアプリを搭載した現在開発中のチャンネル
 releng | 純粋なArchLinuxのライブ起動ディスクをビルドできるチャンネル
+serene | Serene Linuxを移植したチャンネル
 xfce | デスクトップ環境にXfce4を使用し、様々なソフトウェアを追加したデフォルトのチャンネル
 xfce-pro | xfceチャンネルのウィンドウマネージャを変更し、多くのソフトを追加したチャンネル
 
@@ -129,7 +127,7 @@ xfce-pro | xfceチャンネルのウィンドウマネージャを変更し、
 また`x86_64`では公式カーネルに加えて以下ようなカーネルをサポートしています。  
 カーネルの説明は[ArchWiki](https://wiki.archlinux.jp/index.php/%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB)を引用しています。  
 AlterISO3からは非公式なカーネルはyayによりコンパイル、インストールされます。カーネルのコンパイルに時間がかかる場合が有るので注意してください。  
-この一覧に無いカーネルもサポートしています。完全な一覧は[x86_64のカーネル設定ファイル](/system/kernel-x86_64)を参照してください。  
+この一覧に無いカーネルもサポートしています。完全な一覧は`./build.sh -h`を参照して下さい。  
 
 名前 | 特徴
 --- | ---

docs/jp/CHANNEL.md

@@ -11,7 +11,7 @@ AlterISO 2の複数アーキテクチャ対応により大幅に仕様が変更
 
 
 # ドキュメントの見方
-`<arch>`はビルド時のアーキテクチャ名、`<locale>`は言語名、`<ch_name>`はチャンネル名に置き換えてください。  
+`<arch>`はビルド時のアーキテクチャ名、`<locale>`は言語名、`<ch_name>`はチャンネル名、`<md_name>`はモジュール名に置き換えてください。  
 
 
 # スクリプトにチャンネルを認識させる
@@ -153,6 +153,9 @@ Plymouthを強制的に無効化したい場合は`exclude`ではなく各チャ
 
 また、`exclude`はパッケージを削除するわけではないため依存関係によってインストールされるパッケージを除外することはできません。  
 
+#### additional_exclude_pkg
+もしビルドに失敗するなどの理由で一時的にインストールしたくないパッケージが存在する場合、`custom.con`を使用して`additional_exclude_pkg`配列を設定することでそのパッケージのインストールを除外することができます。
+
 
 ### excludeの適用されるタイミング
 `exclude`はパッケージが全て読み込まれた後に適用されます。  
@@ -191,18 +194,20 @@ PNG形式の画像で640x480の画像を配置してください。この変更
 既存のビルド設定を上書きするスクリプトです。かならずシェルスクリプトの構文で記述して下さい。  
 雛形が`build.sh`と同じ階層に設置してあります。  
 各チャンネルのディレクトリに配置された設定ファイルは**引数による設定さえ**上書きしてしまうため、最小限の必須項目のみを記述するようしてください。（例えばPlymouthのテーマ名やパッケージ名など）  
+引数によって変更可能な変数をこのファイルで設定することは推奨されていません。  
 
 ### 警告
 スクリプト内では変数のスコープを明示しないでください。また、変数定義以外の処理を記述すると思わぬ動作につながる場合はあります。  
 
 
 ### アーキテクチャごとの設定と優先順位
-`channels/<ch_name>/config.any`が読み込まれた後`channels/<ch_name>/config.<arch>`が読み込まれます。
+`channels/<ch_name>/config.any`が読み込まれた後`channels/<ch_name>/config.<arch>`が読み込まれます。  
+このアーキテクチャの優先順位はモジュールにおいても共通です。  
 
 
 ## architecture
 そのチャンネルで利用可能なアーキテクチャの一覧です。`#`はコメントとして扱われます。  
-AlterISO 3は現在`x86_64`と`i686`アーキテクチャのみをサポートしています。
+チャンネル内でカーネル設定ファイルやpacman設定ファイルなどを適切に設定することでアーキテクチャを独自で定義することも可能です。
 
 ## kernel_list-<arch>
 使用可能なカーネルの一覧を記述します。このファイルが存在しない場合、対応している全てのカーネルを使用可能です。  
@@ -229,10 +234,11 @@ rt
 `over_isofs`ディレクトリ内でビルドされるISOファイルの`/`にファイルを上書きします。  
 `airootfs`と似ていますが`over_isofs`ではビルドされるイメージファイル内のファイルを直接操作することができます。  
 既存のファイルを上書きしてしまうとブートできなくなる可能性があるので注意して下さい。  
+`over_isofs`はsquashfsの作成が終わった後にisoファイルを作成する直前で上書きされます。  
 
 ## pkgbuild.any pkgbuild.<arch>
-チャンネルディレクトリ内に`pkgbuild.any(arch)/パッケージ名/PKGBUILD`を配置するとmakepkgによってビルドし、インストールされます。  
+チャンネルディレクトリ内に`pkgbuild.any(arch)/任意のディレクトリ名/PKGBUILD`を配置するとmakepkgによってビルドし、インストールされます。  
 依存関係もpacmanによって自動的にインストールされますが、注意が必要です。  
 自動的にインストールされる依存関係はあくまでArch Linuxの公式リポジトリに存在しているものだけです。  
 依存しているパッケージが一つでもAUR上に存在している場合は、その依存パッケージをAURのパッケージリストに書かなければなりません。  
-また、PKGBUILDを格納するパッケージ名も他のモジュールなどと重複してはいけません。重複してしまうとディレクトリが上書きされてしまいます。
+また、PKGBUILDを格納するディレクトリ名は絶対に重複しないようにしてください。

docs/jp/CHANNEL_2_to_3.md

@@ -21,6 +21,10 @@ AlterISO3では様々な新機能が追加されました。そしてそれと
 以前の`japanese`変数は意味を成しません。AlterISO3では言語名を`locale_name`変数で行っています。  
 特定の言語を強制的に使用させたい場合は、`-l`オプションで指定する言語名を`locale_name`変数で指定して下さい。  
 
+### モジュールについて
+AlterISO 3.1用に開発する場合はモジュール一覧も定義する必要があります。  
+詳細は後ほど追記します。
+
 #### 詳細設定を行う
 AlterISO3は`locale_name`の値を元にいくつかの変数を`system/locale-<arch>`から参照します。  
 チャンネルの`config`ファイルでは変数を上書きできるので、これらを詳細に書き換えることができます。  

docs/jp/SOFTWARE.md

@@ -13,12 +13,9 @@ Alter Linuxのリポジトリを使用する場合は鍵を追加する必要が
 
 ソースコード | PKGBUILD
 --- | ---
-[alterlinux-calamares](https://github.com/FascodeNet/alterlinux-calamares) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-calamares)
+[alterlinux-calamares](https://github.com/FascodeNet/alterlinux-calamares) | [PKGBUILD](https://github.com/FascodeNet/alterlinux/tree/noroot/modules/share-extra/pkgbuild.any/alterlinux-calamares)
 [alterlinux-fcitx-conf](https://github.com/FascodeNet/alterlinux-fcitx-conf) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-fcitx-conf)
-[alterlinux-gtk-bookmarks](https://github.com/FascodeNet/alterlinux-desktop-file/tree/master/alterlinux-gtk-bookmarks) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-gtk-bookmarks)
 [alterlinux-i3-manager](https://github.com/FascodeNet/alterlinux-i3-manager) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-i3-manager)
 [alterlinux-keyring](https://github.com/FascodeNet/alterlinux-keyring) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-keyring)
-[alterlinux-desktop-file](https://github.com/FascodeNet/alterlinux-desktop-file) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-desktop-file)
 [alterlinux-mirrorlist](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-mirrorlist) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-mirrorlist)
-[alterlinux-wallpapers](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-wallpapers) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-wallpapers)
-[alterlinux-welcome-page](https://github.com/FascodeNet/alterlinux-desktop-file/tree/master/alterlinux-welcome-page) | [PKGBUILD](https://github.com/FascodeNet/alterlinux-pkgbuilds/tree/master/alter-stable/any/alterlinux-welcome-page)
+