「ヘルプ:読み方」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(en:Help:Reading (ID: 387009 付近から) ID: 583314 の版の状態に同期)
(前書き部分の追加訳出(ID: 15819 の版での同期部分の翻訳))
13行目: 13行目:
 
{{Related|ヘルプ:スタイル}}
  
{{Related|ヘルプ:スタイル}}
 
{{Related articles end}}
  
{{Related articles end}}
  +
ArchWiki には Arch Linux (または GNU/Linux 全般) に初めて接したユーザーにとってはわかりにくい部分もあるため、記事を読んだ時に混乱が生じないように、また繰り返しを避けるために、基本的な取り決めごとについてここでざっと述べます。
−  
−
ArchWiki には Arch Linux (or GNU/Linux in general) に初めて接したユーザーにとってはわかりにくい部分もあるため、記事を読んだ時に混乱が生じないように、また繰り返しを避けるために、基本的な取り決めごとについてここでざっと述べます。
  
   
 
== 編成 ==
  
== 編成 ==

2020年3月28日 (土) 00:16時点における版

関連記事

ArchWiki には Arch Linux (または GNU/Linux 全般) に初めて接したユーザーにとってはわかりにくい部分もあるため、記事を読んだ時に混乱が生じないように、また繰り返しを避けるために、基本的な取り決めごとについてここでざっと述べます。

編成

ArchWiki のほとんどの記事はあるトピックに対して1から10まで説明するようには書かれていません。DRY 原則に従って、記事に何かわからないところがあったらユーザーは自分で他の資料を探したり読むだろうということが前提になっています。場合によっては、参考になる文献が示されているでしょう。via special formatting, see #書式.

このような編成を取っている以上、ArchWiki の記事を完全に理解するには関連するページも一緒に見なければならないときがあります。特に、Arch (あるいはもっと一般的に GNU/Linux) の初心者は簡単に解決できる問題でも色々なページから前提知識を手に入れる必要があります。他の人に助けを求めに行く前に関連ページを読むことは非常に重要なことです。

書式

通常ユーザーまたは root

以下のように書かれている行もあれば: 

# mkinitcpio -p linux

別の記号が前についていることもあります: 

$ makepkg -s

ハッシュ記号 (#) はそのコマンドを root で実行しなくてはならないということを示し、逆にドル記号 ($) は通常ユーザーとしてそのコマンドを実行することを示しています。

ノート: # が前についているコマンドは root シェルから実行するよう意図されています。root シェルには sudo -i などを使って簡単にアクセスできます。大抵は、root シェルから command を実行しなくても、非特権のシェルから sudo command を実行するだけでも足ります。ただし、厳密に root シェルを必要とする、リダイレクトやコマンド置換などの例外も存在します。sudo を参照して下さい。

注意しなくてはならない例外: 

# This alias makes ls colorize the listing
alias ls='ls --color=auto'

上の例では、ハッシュ記号がついている部分がありますが、これはコマンドとして実行するべきものではありません。そうではなくてファイルの中を示しています。この場合、ハッシュ記号はコメントです。コメントとはプログラムによって解釈が行われない説明文のことです。Bash スクリプトのコメント記号は root PS1 と同じなのです。

さらに、# 記号の後の大文字が入っている文章からも、これがコマンドではないことがわかります。普通、Unix コマンドはこのように書かれたりせず、完全な英単語の代わりに短くした省略形が使われます (例: Copy は cp となっています)。

ついでに、ほとんどの記事では読者が簡単に区別できるように以下のように書かれています:

~/path/to/file に追加: 

# This alias makes ls colorize the listing
alias ls='ls --color=auto'

追加, 追記, 作成, 編集

ファイルの追加・追記・作成・編集の指示が出てきたときは、何らかの方法でファイルを操作する必要があります。

複数行にわたるファイルを作成・編集する場合はテキストエディタを使用することを推奨します。例えば nano を使って /etc/bash.bashrc ファイルを編集するコマンドは以下のようになります: 

# nano /etc/bash.bashrc

一単語だけのファイルを作成・編集する場合は 出力のリダイレクト を使うほうが簡単です。以下の例では /etc/hostname という名前のファイルを myhostname という中身で作成・上書きします: 

# echo myhostname > /etc/hostname

出力のリダイレクトを使ってファイルに文字列を追記することもできます。以下の例は /etc/pacman.conf ファイルに [custom-repo] というテキストを追記します: 

# echo "[custom-repo]" >> /etc/pacman.conf

ディレクトリを作成するように書かれていた場合、mkdir コマンドを使ってください: 

# mkdir /mnt/boot

実行可能属性の付与

ファイルを作成したら、(手動であるいは他のプログラムから) スクリプトとして実行できるようにするために実行可能属性を付与する必要があるかもしれません。例: 

$ chmod +x script

詳しくは chmod を見てください。ファイルマネージャなどのアプリケーションを使うことでグラフィカルインターフェイスで設定することもできます。

Source

コマンドラインシェルなどのアプリケーションはスクリプトを使って設定します。スクリプトに変更を加えたら source を実行しないと変更が適用されません。例えば Bash の場合、以下のように実行します (source は . に置き換えることができます): 

$ source ~/.bashrc

設定スクリプトを編集するように書かれている部分の近くに source を実行するように書かれているとは必ずしも限りません。and only in some cases it will point you to this section with a reminder link.

パッケージのインストール

記事に何かパッケージを通常の方法でインストールするように書くときは、インストール方法を詳しく説明する代わりに、シンプルに、必要なパッケージの名前を記述します。

ノート: Frequently, the インストール links are used to point to this article section. However, JavaScript has to be enabled for these links to work.

The subsections below give an overview of the generic installation procedures depending on the package type.

公式パッケージ

公式リポジトリにあるパッケージについては以下のような表記がされます:

package をインストールしてください。

この文章は次のコマンドを実行することを意味します: 

# pacman -S package

pacman の記事には Arch Linux における正しいパッケージ管理について詳しい説明が書かれています。

Arch User Repository

Arch User Repository (AUR) にあるパッケージについては以下のような表記がされます:

packageAUR をインストールしてください。

この文章は基本的に、packageAUR リンクを開いて、PKGBUILD アーカイブをダウンロードし、解凍して、中身を確認してから、PKGBUILD があるフォルダで以下のコマンドを実行することを意味します: 

$ makepkg -sri
ノート: AUR からパッケージをビルドしたり ABS を使うには base-devel グループのパッケージを先にインストールする必要があります。

Arch User Repository の記事に AUR パッケージの扱いについて詳しい説明とベストプラクティスが載っています。

systemd ユニットのコントロール

記事に systemd ユニット (例: service) を 起動, 有効化, 停止, 再起動 するよう書かれていて、詳しい方法が載っておらず以下のように表記されている場合:

example.service を起動して下さい。

この文章は次のコマンドを実行することを意味します: 

# systemctl start example.service

起動のリンク先は systemd の記事です。Arch Linux における systemd ユニットの正しい扱いについて詳しい説明が載っています。

ノート: The 起動, 有効化, 停止, 再起動... links are redirects to specific sections, which work only if JavaScript is enabled.

システム全体とユーザー個別の設定

GNU/Linux における設定には2種類あることを覚えておくと良いでしょう。システム全体の設定は全てのユーザーに影響を与えます。基本的にシステム全体の設定は /etc ディレクトリに置かれるため、設定を変更するには root 権限が必要になります。例えば、全てのユーザーに影響を与える Bash の設定を適用するには、/etc/bash.bashrc を編集します。

ユーザー個別の設定は一人のユーザーにしか影響を与えません。ユーザー個別の設定にはドットファイルが使われます。例えば、~/.bashrc ファイルはユーザー個別の設定ファイルです。エイリアスや関数、プロンプトなどのインタラクティブな機能など、それぞれのユーザーごとの設定を、他のユーザーには影響を与えずに定義できます。

ノート: ~/ と $HOME はユーザーのホームディレクトリのショートカットです。通常は /home/username/ です。

一般的なシェルファイル

Bash や Zsh などの Bourne 互換シェルは、シェルがログインシェルなのかインタラクティブシェルなのかによって読み込むファイルが違います。詳しくは Bash#設定ファイルや Zsh#設定ファイルを見てください。

コード例で使われる疑似変数

一部のコードブロックでは疑似変数が使われています。名前の通り、実際の変数ではありません。疑似変数が含まれているコードは実行する前に疑似変数を適切な文字列に置き換える必要があります。bash や zsh などにはタブ補完機能が存在し systemctl などの一般的なコマンドについてはパラメータを自動で補完してくれます。

ヘルプ:スタイル/書式と句読点に従っている記事では、疑似変数は斜体で表記するようになっています。例:

  • ip link コマンドの出力で確認できるネットワークインターフェイスを使うには dhcpcd@interface_name.service を有効化してください。

上記の例では systemd のテンプレートユニットの中で使われている interface_name が疑似変数です。全ての systemd テンプレートユニットには @ 記号が付いており、引数を指定する必要があります。詳しくは Systemd#ユニットを使うを見てください。

  • dd if=data_source of=/dev/sdX bs=sector_size count=sector_number seek=partitions_start_sector コマンドを root で実行することでパラメータで指定したパーティションを消去できます。

上記の例では置き換えるべきパラメータをあらわすために擬似変数が使われています。何に置き換えればいいかは上記のコマンドが書いてあるディスクの完全消去#消去するブロックを手動で計算セクションに説明があります。

名前を置き換える必要がある疑似変数をそのままにして設定ファイルに編集例を貼り付けた場合、プログラムが機能しなくなる可能性があります。

省略

大抵の場合、実際のコマンドの出力やファイルの中身に省略 (...) が含まれていることはありません。無関係の部分を省くために使われているにすぎません。

例えば HOOKS="... encrypt ... filesystems ..." という表記で使用したり、以下のように使われます: 

/etc/X11/xorg.conf.d/50-synaptics.conf
Section "InputClass"
    ...
    Option      "CircularScrolling"          "on"
    Option      "CircScrollTrigger"          "0"
    ...
EndSection

ときとして、省略している部分にも構文的に意味がある場合があります。中身を見ればすぐにわかるはずです。

「https://wiki.archlinux.jp/index.php?title=ヘルプ:読み方&oldid=15820」から取得