序章

本書の作成にあたり以下の編集指針を守りました。

	警告
	本文書だけに頼らず自分で答えを見出す努力をしっかりすることを期待します。本文書は効率的なスタートポイントを提供するだけです。

一義的情報源から自分自身で解決策を探し出すべきです。

bash(1) シェルコマンドの例示をする以下のような簡略化した表現スタイルで本書は情報を提供します。

# command-in-root-account
$ command-in-user-account

これらのシェルプロンプトは使われるアカウントを区別します。これはちょうど環境変数として: "PS1='\$'" と "PS2=' '" を設定した場合に相当します。これらの環境変数値はあくまで本書の読みやすさのためで、実際のインストール済みシステではほとんど見かけません。

すべてのコマンド例は英語ロケール "LANG=en_US.UTF8" 下で実行されます。コマンド例中の command-in-root-account や command-in-user-account 等のプレースホルダー文字列が翻訳されるとは期待しないで下さい。これは全ての翻訳された例が最新版であるようするための意識的な選択です。

	注記
	"PS1='\$'" と "PS2=' '" という環境変数値の意味は bash(1) を参照下さい。

システム管理者が行うべきアクションは命令文で書かれています: 例えば、「シェルに各コマンド文字列をタイプ後毎にエンターキーをタイプします。」 (必ずしも「〜しましょう。」とはせず簡潔に訳しています。)

英語では、テーブル中の説明や類似のコラムには、パッケージ説明の慣習に従い、定冠詞抜も不定冠詞も抜きの名詞句が入ります。これらには、マンページのコマンドの短い説明の慣習に従った頭の "to" 抜きの不定詞句が代わりに名詞句として入ることもあります。変だなとお考えの方もあるとは存じますが、これは本文書をできるだけ簡潔にするための著者の恣意的な文体の選択です。以上の短な説明慣行に従い、これら名詞句は大文字で始まらず読点もありません。 (対応部分は文切り型の体言止めの日本語表現に訳します。)

本文中に引用されるコマンドの断片はダブルクォーテションマーク間にタイプライターフォントで書き "aptitude safe-upgrade" のように表現されます。

本文中に設定ファイルから引用された文字データーはダブルクォーテションマーク間にタイプライターフォントで書き "deb-src" のように表現されます。

コマンドはその名前をタイプライターフォントで書き、場合によってはその後ろにマンページのセクション番号を括弧中に入れて書き bash(1) のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ man 1 bash

マンページはその名前をタイプライターフォントで書き、その後ろにマンページのセクション番号を括弧中に入れて書き sources.list(5) のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ man 5 sources.list

info ページはダブルクォーテションマーク間にタイプライターフォントというコマンドの断片形式で書き "info make" のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ info make

ファイル名はダブルクォーテションマーク間にタイプライターフォントで書き "/etc/passwd" のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ sensible-pager "/etc/passwd"

ディレクトリー名はダブルクォーテションマーク間にタイプライターフォントで書き "/etc/apt/" のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ mc "/etc/apt/"

パッケージ名はその名をタイプライターフォントで書き "vim" のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ dpkg -L vim
$ apt-cache show vim
$ aptitude show vim

文書は、その場所のファイル名でダブルクォーテションマーク間にタイプライターフォントで書き "/usr/share/doc/base-passwd/users-and-groups.txt.gz" や "/usr/share/doc/base-passwd/users-and-groups.html" のように表現されたり、その場所の URL で https://www.debian.org のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ zcat "/usr/share/doc/base-passwd/users-and-groups.txt.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "https://www.debian.org"

環境変数は、頭に "$" がついた名前をダブルクォーテションマーク間にタイプライターフォントで書き、"$TERM" のように表現されます。読者は以下のようにタイプして情報を得るように心がけて下さい。

$ echo "$TERM"

ポプコンのデーターは各パッケージの客観的人気の指標として提示されいます。それがダウンロードされた日付は 2024-03-03 11:51:37 UTC で、 198687 を越すバイナリーパッケージ数と 27 のアーキテクチャーにまたがる 237734 つの提出レポートからなります。

"votes" を意味する "V:" が前についたポプコンの数は "1000 * (PC で最近実行されたパッケージに関するポプコン提出)/(全ポプコン提出)" として計算される。

"installs" を意味する "I:" が前についたポプコンの数は "1000 * (PC にインストールされているパッケージに関するポプコン提出)/(全ポプコン提出)" として計算される。

各パッケージの客観的指標としてパッケージサイズデーターも提供されます。それは "apt-cache show" や "aptitude show" コマンドが ( 現在の amd64 アーキテクチャー上の unstable リリース上で) 表示する "Installed-Size:" です。サイズは KiB (Kibibyte = 1024 バイト単位) で表示されます。

何かこの文書に問題を発見した場合には、debian-reference パッケージに対して reportbug(1) を用いてバグ報告をして下さい。プレーンテキストバージョンかソースに対する "diff -u" による修正提案を含めて下さい。