blob: 900bc0b6cea515adf854e251b2ca0918c9ed8c6b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
#use wml::debian::template title="ユーザ文書"
#use wml::debian::translation-check translation="755893e6e0cd2bdf43a98ad6c7d58a4d54b496a6"
<p>いかなるオペレーティングシステムにおいても、文書、つまりプログラムの
動きや使いかたを記述した技術的なマニュアルは重要な位置を占めています。
高品質なフリーのオペレーティングシステムを作る努力の一部として、
Debian は、ユーザに適切な文書をより利用しやすい形態で提供できるよう
さまざまな作業を行なっています。</p>
<h2>クイックスタート</h2>
<p>もしあなたが Debian を<em>使うのが初めて</em>なら、
まずは以下の文書を読むことをお勧めします。</p>
<ul>
<li><a href="$(HOME)/releases/stable/installmanual">インストールガイド</a></li>
<li><a href="manuals/debian-faq/">Debian GNU/Linux FAQ</a></li>
</ul>
<p>最初に Debian
をインストールする際にはこれらの文書を手元に置いておいてください。そうすれば、
おそらく多くの疑問に対する答えが見つかり、新しい Debian
システムを稼働させるまでの手助けとなるでしょう。後でシステムを使用する際には、
以下の文書にも一通り目を通しておくとよいでしょう。</p>
<ul>
<li><a href="manuals/debian-handbook/">Debian 管理者ハンドブック</a>:
総合ユーザマニュアル</li>
<li><a href="manuals/debian-reference/">Debian リファレンス</a>:
シェルコマンドラインに重きを置いた簡潔なユーザガイド</li>
<li><a href="$(HOME)/releases/stable/releasenotes">リリースノート</a>:
アップグレードするユーザ向け</li>
<li><a href="https://wiki.debian.org/">Debian Wiki</a>:
初心者に対するよい情報源</li>
</ul>
<p>最後に、Debian システムにおける最も重要なコマンドの一覧である <a
href="https://www.debian.org/doc/manuals/refcard/refcard">Debian GNU/Linux
リファレンスカード</a>を印刷して、常に手元に置いておいてください。</p>
<p>これらの他にも、以下にリストアップするようにかなり多くの文書があります。</p>
<h2>文書の種類</h2>
<p>Debian に含まれる文書の大部分は GNU/Linux 一般向けに書かれたものです。
特に Debian に向けて書かれた文書もあります。
これらの文書は以下の基本的なカテゴリに分かれます:</p>
<ul>
<li><a href="#manuals">マニュアル</a></li>
<li><a href="#howtos">HOWTO</a></li>
<li><a href="#faqs">FAQ</a></li>
<li><a href="#other">その他の短い文書</a></li>
</ul>
<h3 id="manuals">マニュアル</h3>
<p>マニュアルは本に似ており、大きな話題を包括的に記述するものです。</p>
<h3>Debian に特有のマニュアル</h3>
<div class="line">
<div class="item col50">
<h4><a href="user-manuals">ユーザ用マニュアル</a></h4>
<ul>
<li><a href="user-manuals#faq">Debian GNU/Linux FAQ</a></li>
<li><a href="user-manuals#install">Debian インストールガイド</a></li>
<li><a href="user-manuals#relnotes">Debian リリースノート</a></li>
<li><a href="user-manuals#refcard">Debian リファレンスカード</a></li>
<li><a href="user-manuals#debian-handbook">Debian 管理者ハンドブック</a></li>
<li><a href="user-manuals#quick-reference">Debian リファレンス</a></li>
<li><a href="user-manuals#securing">Debian 安全化マニュアル</a></li>
<li><a href="user-manuals#aptitude">aptitude ユーザマニュアル</a></li>
<li><a href="user-manuals#java-faq">Debian GNU/Linux and Java FAQ</a></li>
</ul>
</div>
<div class="item col50 lastcol">
<h4><a href="devel-manuals">開発者向けマニュアル</a></h4>
<ul>
<li><a href="devel-manuals#policy">Debian ポリシーマニュアル</a></li>
<li><a href="devel-manuals#devref">Debian デベロッパーズリファレンス</a></li>
<li><a href="devel-manuals#debmake-doc">Debian Maintainer 向け案内書</a></li>
<li><a href="devel-manuals#packaging-tutorial">Debian パッケージ化入門</a></li>
<li><a href="devel-manuals#menu">Debian メニューシステム</a></li>
<li><a href="devel-manuals#i18n">i18n 入門</a></li>
<li><a href="devel-manuals#d-i-internals">Debian インストーラ内部</a></li>
<li><a href="devel-manuals#dbconfig-common">データベース利用パッケージメンテナ向けガイド</a></li>
<li><a href="devel-manuals#dbapp-policy">データベース利用パッケージ向けポリシー</a></li>
</ul>
<h4><a href="misc-manuals">その他のマニュアル</a></h4>
<ul>
<li><a href="misc-manuals#history">Debian プロジェクトの歴史</a></li>
<li><a href="misc-manuals#markup">Debiandoc-SGML マークアップマニュアル</a></li>
<li><a href="misc-manuals#sgml-howto">Debian SGML/XML マニュアル</a></li>
</ul>
</div>
</div>
<p class="clr">Debian のマニュアルやその他の文書の完全なリストは、<a
href="ddp">Debian
ドキュメンテーションプロジェクト</a>のウェブページにあります。</p>
<p>Debian GNU/Linux 向けに書かれ、 <a href="books">印刷された本</a>の
形態で入手できるユーザ向けのマニュアルもあります。</p>
<h3>GNU/Linux 一般についてのマニュアル</h3>
<p>Linux の文書やマニュアルで最も人気が高いものは
<a href="https://tldp.org/LDP/gs/gs.html">Linux Installation and
Getting Started</a>,
<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/">\
Linux Users' Guide</a>,
<a href="https://tldp.org/LDP/nag/nag.html">Network Administrators'
Guide</a>,
<a href="https://tldp.org/LDP/sag/">System Administrator's
Guide</a> などです。</p>
<p>Linux の文書は
<a href="https://tldp.org/">Linux Documentation Project</a> (LDP) の
努力によってまとめられています。LDP マニュアルのフルセットは <a
href="https://tldp.org/guides.html">LDP のウェブページ内</a>にあります。
他にも多くの文書が、電子形式と印刷用の形態で利用可能です。</p>
<h3 id="howtos">HOWTO</h3>
<p><a href="https://tldp.org/docs.html#howto">HOWTO
文書</a>は、その名前のとおり、何かを<em>どのように</em>するべきか述べます。
ふつうはより限定された話題を扱います。</p>
<p>Linux HOWTO のうち最も重要なものは:</p>
<ul>
<li><a href="https://tldp.org/HOWTO/Hardware-HOWTO/">Hardware
Compatibility HOWTO</a></li>
<li><a href="https://tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/">\
Unix and Internet Fundamentals HOWTO</a></li>
# <li><a href="https://tldp.org/HOWTO/Kernel-HOWTO.html">Kernel
# HOWTO</a></li>
<li><a href="https://tldp.org/HOWTO/Filesystems-HOWTO.html">Filesystems
HOWTO</a></li>
<li><a href="https://tldp.org/HOWTO/Config-HOWTO.html">Configuration
HOWTO</a></li>
<li><a href="https://tldp.org/HOWTO/Net-HOWTO/">Networking
HOWTO</a></li>
<li><a href="https://tldp.org/HOWTO/HOWTO-INDEX/categories.html">\
その他</a></li>
</ul>
<p>訳注: これらの日本語訳の多くは、<a
href="http://archive.linux.or.jp/JF/">JF Project</a> で見つかります。
これらは doc-linux-ja パッケージにもまとめられています。</p>
<h3 id="faqs">FAQ</h3>
<p>FAQ とは <em>frequently asked questions (よくある質問)</em> という意味で、
これらの質問に答える文書です。</p>
<p><a href="https://tldp.org/FAQ/Linux-FAQ/">Linux FAQ</a>
には Linux 一般に関する情報があります。</p>
<p>Debian に特化した質問は
<a href="manuals/debian-faq/">Debian FAQ</a> で答えられています。<a
href="../CD/faq/">Debian の CD/DVD イメージに関する FAQ</a>
もあります。</p>
<p>詳しくは <a href="https://tldp.org/FAQ/">LDP FAQ
index</a> をごらんください。</p>
<h3 id="other">その他の短い文書</h3>
<p>以下の文書にはより手っ取り早い、短い説明があります:</p>
<dl>
<dt><strong><a href="https://tldp.org/docs.html#man">マニュアルページ</a></strong></dt>
<dd>伝統的に、Unix のすべてのコマンドは<em>マニュアルページ</em>で
文書化されています。つまり <tt>man</tt> コマンドで利用できる
レファレンスマニュアルです。これはふつう初心者向きではありません。<a
href="https://manpages.debian.org/cgi-bin/man.cgi">https://manpages.debian.org/</a>
では、Debian で利用可能なマニュアルページの検索や閲覧が可能です。
</dd>
<dt><strong><a href="https://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">info ファイル</a></strong></dt>
<dd>多くの GNU ソフトウェアはマニュアルページではなく <em>info
ファイル</em>にて文書化されています。これらのファイルには、
プログラム自身の詳細な情報やオプション、利用例などが含まれていて、<tt>info</tt>
コマンドにより利用できます。
</dd>
<dt><strong>さまざまな README ファイル</strong></dt>
<dd><em>read me</em> ファイルも一般的です — これはひとつの事項、ふつうは
パッケージについて述べるシンプルテキストのファイルです。
Debian システムの <tt>/usr/share/doc/</tt> サブディレクトリの中に
いっぱいあります。
どのソフトウェアパッケージもこのディレクトリの下にサブディレクトリを持っていて、
README ファイルや設定例などが置かれています。大きなプログラムでは、
ドキュメントは通常別のパッケージ (元のパッケージと同じ名前で <em>-doc</em>
で終わるもの) で提供されています。
</dd>
<dt><strong>クイックリファレンスカード</strong></dt>
<dd>
<p>クイックリファレンスカードとは、特定の (サブ)
システムを非常に簡潔にまとめたものです。通常、このようなリファレンスカードは、
最もよく使われるコマンドを 1 枚の紙切れに収めて提供します。
いくつかの有名なリファレンスカードやリファレンスカード集としては、
以下のようなものがあります。</p>
<dl>
<dt><a href="https://www.debian.org/doc/manuals/refcard/refcard">Debian
GNU/Linux リファレンスカード</a></dt>
<dd>このカード (一枚の紙に印刷できます) は、Debian の新規ユーザのために、
重要なコマンドの一覧やよい参考となる情報を提供します。少なくとも、コンピュータ、
ファイル、ディレクトリ、そしてコマンドラインについての基本的な知識が必要です。
新規のユーザは、最初に <a href="user-manuals#quick-reference">Debian
リファレンス</a>を読んだ方がいいかもしれません。</dd>
</dl>
</dd>
</dl>
<hrline />
<p>上記の資料を調べてそれでも Debian 関連の疑問の答えや問題の解決法が
見つからなければ、<a href="../support">サポートページ</a>をご覧ください。</p>
|
