Live manual Debian Live

# Debian Live Manual

# このマニュアルについて

4

# 1. このマニュアルについて

5

This manual serves as a single access point to all documentation related to the Debian Live Project and in particular applies to the software produced by the project for the Debian "bookworm" release. An up-to-date version can always be found at ‹https://live-team.pages.debian.net/live-manual/›

6

Live マニュアルは第一に Live システムのビルドの支援を扱い、エンドユーザ向けの話題は扱いませんが、エンドユーザにとって有用な情報がいくらかあるかもしれません: 基本 ではビルド済みイメージのダウンロードや、ウェブビルダーを使うかシステム上の live-build を直接実行することでメディアやネットワークからイメージをブートさせる準備について触れています。 実行時の挙動の変更 では、キーボードレイアウトやロケールの選択、再起動をまたいで状態を引き継がせる仕組みの利用等、ブートプロンプトで指定できるオプションをいくらか説明しています。

7

提示されているコマンドの一部にはスーパーユーザ権限で実行しなければならないものもあります。これは `su` で root ユーザになるか、`sudo` を使って実行します。権限のないユーザで実行できるコマンドと実行にスーパーユーザ権限を必要とするコマンドは、それぞれのコマンドの前に `$` があるか `#` があるかで区別します。この記号はコマンドの一部ではありません。

8

1.1 せっかちな人向け

9

このマニュアルにある全てが、少なくとも一部のユーザにとって重要だと確信していますが、触れている内容が多岐にわたることや、詳細を掘り下げるよりも先に、まずはソフトウェアをうまく使う経験をしたいであろうということをわかっています。したがって、以下の順に読み進めることを提案します。

10

最初にこの章 このマニュアルについて を始めから 用語 節まで読んでください。次に 例 節の最初にある3つのチュートリアルまで飛ばします。ここではイメージのビルドと独自化の基本について教えるようになっています。 例の使用 を最初に読み、引き続いて チュートリアル 1: デフォルトイメージ と チュートリアル 2: ウェブブラウザユーティリティ を、最後に チュートリアル 3: 私的イメージ を読んでください。チュートリアル群を終えるまでに、Live システムでできることが何なのかわかってくるでしょう。

11

それから戻り、マニュアルをもっと掘り下げて学習していくことを勧めています。恐らく、その次は 基本 を読み、 netboot イメージのビルド に軽く目を通して、 独自化概要 とそれに続く章を読んで終えるのがいいでしょう。この時点までに、Live システムでできることを知ることがすっかり面白くなってマニュアルの残りを隅から隅まで読む気になっていることを期待します。

12

1.2 用語

13

- Live システム: ハードドライブにインストールしなくてもブートできるオペレーティングシステムです。Live システムはそのコンピュータのハードドライブに既にインストールされているローカルのオペレーティングシステムやファイルを、そうするように指示しない限り改変しません。Live システムは通常、CDやDVD、USBメモリ等のメディアからブートされます。ネットワーク越しにブートできるもの (netboot イメージ経由、 netboot イメージのビルド 参照) やインターネット越しにブートできるもの (起動パラメータ `fetch=URL` 経由、 Webbooting 参照) もあります。

14

- Live メディア: Live システムとは異なり、Live メディアは live-build により作成されたバイナリを書き込んでその Live システムをブートするのに利用するCDやDVD、USBメモリを指します。もっと広い意味では、この語はネットワークブートファイルの位置等、Live システムをブートする目的でこのバイナリが置かれている任意の場所を指すこともあります。

15

- Debian Live Project: live-boot、live-build、live-config、live-tools、live-manual パッケージを特に保守しているプロジェクトです。

16

- ホストシステム: Live システムの作成に利用される環境です。

17

- ターゲットシステム: Live システムの実行に利用される環境です。

18

- live-boot: Live システムのブートに利用するスクリプト集です。

19

- live-build: 独自化した Live システムのビルドに利用するスクリプト集です。

20

- live-config: Live システムのブート処理中の設定に利用するスクリプト集です。

21

- live-tools: 実行中の Live システム内で有用なタスクを実行するのに利用する追加のスクリプト集です。

22

- live-manual: この文書は live-manual というパッケージで保守されています。

23

- Debian Installer (d-i): 公式の Debian ディストリビューション用インストールシステムです。

24

- ブートパラメータ: bootloader プロンプトで入力し、カーネルや live-config の動作を変更できるパラメータです。

25

- chroot: chroot プログラム。`chroot(8)` により、単一のシステム上で異なる GNU/Linux 環境を再起動せずに並行して実行できるようになります。

26

- Binary image: A file containing the live system, such as live-image-amd64.hybrid.iso or live-image-amd64.img.

27

- ターゲットディストリビューション: Live システムがベースとするディストリビューションです。これはホストシステムのディストリビューションとは別のものです。

28

- 安定版 (stable)/テスト版 (testing)/不安定版 (unstable): 安定版 (stable) ディストリビューション、現在のコード名bookwormには、公式にリリースされた最新の Debian ディストリビューションが含まれます。テスト版 (testing) ディストリビューション、一時的コード名 trixie は次期*{安定版 (stable)}* リリースを集める場です。このディストリビューションを使う主な利点はソフトウェアのバージョンが*{安定版 (stable)}* リリースと比べて新しいということです。unstable ディストリビューション、恒久的コード名 sid は Debian の開発が活発に行われる場です。通常、このディストリビューションは開発者や、苦労をいとわず最新版を使いたい人が利用します。マニュアル全体を通して、リリースを指すのに trixie や sid 等のコード名を使っています。それこそが、ツール自体がサポートしているものだからです。

29

1.3 著者

30

著者一覧 (アルファベット順):

31

- Ben Armstrong

32

- Brendan Sleight

33

- Carlos Zuferri

34

- Chris Lamb

35

- Daniel Baumann

36

- Franklin Piat

37

- Jonas Stein

38

- Kai Hendry

39

- Marco Amadori

40

- Mathieu Geli

41

- Matthias Kirschner

42

- Richard Nelson

43

- Roland Clobus

44

- Trent W. Buck

45

1.4 この文書への貢献

46

このマニュアルの作成はコミュニティ中心のプロジェクトで、改善提案や貢献は全て、非常に歓迎されます。コミットキーの取得方法や良いコミットを行うための詳細な情報については、 プロジェクトへの貢献 節を見てください。

47

1.4.1 変更の適用

48

マニュアルの英語版に変更を加える場合、`manual/en/` にある正しいファイルを編集しないといけませんが、その貢献を提出する前に出来上がりを確認してください。Live マニュアルの出来上がりを確認する際は、

49

# apt-get install make po4a ruby ruby-nokogiri sisu-complete

50

を実行してビルドに必要なパッケージがインストールされていることを確認してください。Gitにより取得した最上位のディレクトリから

51

$ make build

52

サポートされている全言語のマニュアルをビルドするのにはある程度時間がかかるため、著者が英語版のマニュアルに追加した新しい文書について見直す場合は見直し用に処理を省略させると好都合かもしれません。`PROOF=1` を使うと HTML 形式の live-manual をビルドしますが分割版の HTML ファイルを作成しません。`PROOF=2` を使うとPDF形式の live-manual をビルドしますがA4とレター縦だけです。これが `PROOF=` を指定すると時間の節約が見込める理由です。例えば:

53

$ make build PROOF=1

54

翻訳の一つを見直す場合に一つの言語だけをビルドすることもできます。例えば:

55

$ make build LANGUAGES=ja

56

を実行します。文書の種類を指定してビルドすることもできます。例えば

57

$ make build FORMATS=pdf

58

あるいは両方を組み合わせて

59

$ make build LANGUAGES=de FORMATS=html

60

修正が済んで全て良くなったらコミットですが、そのコミットで翻訳を更新するのでない限り `make commit` を使わないようにしてください。また、その場合にマニュアルの英語版への変更と翻訳を一度にコミットするのではなく、それぞれ分けてコミットするようにしてください。さらなる詳細については 翻訳 節を見てください。

61

1.4.2 翻訳

62

注意: man ページの翻訳については、 man ページの翻訳 を見てください。

63

live-manual を翻訳するには、新しく最初から翻訳を開始するのか、それとも既に存在する翻訳について作業を続けるのか、によって以下の手順を追ってください:

64

- 新しく最初から翻訳を開始する

65

- `manual/pot/` にある about_manual.ssi.pot 、about_project.ssi.pot、index.html.in.potファイルを (poedit 等) 好みのエディタで自分の言語に翻訳し、整合性確認のため翻訳した `.po` ファイルをメーリングリストに送ってください。live-manual の整合性確認では `.po` ファイルが 100% 翻訳されていることだけではなく誤りの可能性を検出します。

66

- Once checked, to enable a new language in the autobuild it is enough to add the initial translated files to `manual/po/${LANGUAGE}/` and edit `manual/_sisu/home/index.html` adding the name of the language and its name in English between brackets. And then, add the folder `manual/${LANGUAGE}/` to the file `.gitignore`. Finally, run `make commit`.

67

- 既に存在する翻訳について作業を続ける

68

- 対象の言語が既に追加されている場合は、(poedit 等) 好みのエディタで `manual/po/` にある残りの po ファイルを手当たり次第に翻訳を続けてください。

69

- 翻訳済みマニュアルが .po ファイルから更新されていることを確実にするためには `make commit` を行う必要があることと、`git add .`、`git commit -m "Translating..."`、`git push` を実行する前に `make build` を実行すると変更を確認できるということを忘れないでください。`make build` には相当の時間がかかる可能性があるため、 変更の適用 で説明しているように、見直しの際は1つの言語だけをビルドして確認できることを覚えておくといいでしょう。

70

`make commit` を実行するとテキストがいくらか流れていくのを目にするでしょう。これは基本的に処理状態についての情報を示すメッセージで、Live マニュアルの改善のために何ができるのかということを知る手がかりにもなります。致命的エラーが起きていない限り、通常はそのまま進めて貢献を提出できます。

71

Live マニュアルには、翻訳者が未翻訳や変更された文字列を検索するのを大きく支援する2つのユーティリティが付属しています。1つ目は「make translate」です。これは各 .po ファイル中にどれだけ未翻訳文字列があるのか、詳細を報告するスクリプトを実行します。2つ目は「make fixfuzzy」で、こちらは変更された文字列だけを対象としますが、1つ1つ見つけて修正する作業を支援します。

72

こういったユーティリティはコマンドラインで翻訳作業を行うのには実際に役立つかもしれませんが、推奨する作業方法は poedit のような専用ツールの利用だということに留意してください。Debian 地域化 (l10n) 文書や、特に Live マニュアル向けの 翻訳者向けのガイドライン を読むのも良いことです。

73

注意: gitツリーを push する前に `make clean` を実行してきれいにすることができます。この手順は .gitignore ファイルのおかげで強制ではありませんが、ファイルを意図せずコミットすることを避けられる良い実践となります。