ヘルプ:スタイル/書式と記号のソースを表示

[[カテゴリ:ヘルプ]]
[[en:Help:Style/Formatting and punctuation]]
[[es:Help:Style (Español)/Formatting and punctuation]]
[[pt:Help:Style (Português)/Formatting and punctuation]]
{{Related articles start}}
{{Related|ヘルプ:編集#フォーマット}}
{{Related|ヘルプ:スタイル#フォーマット}}
{{Related articles end}}
以下の説明は、ページのいろいろなパーツの内容が書式や記号を通してどのように強調されるかを定義しています。

== 全般的なルール ==

以下の全般的なルールは常に [[#特定のケース]] より優先します。このガイドに書かれていないケースは、[[Wikipedia:ja:Wikipedia:スタイルマニュアル]] を情報源として参照してください。

* それぞれのルールで明示的に許可されている場合を除いて、2つ以上の強調方法を組み合わせないでください。<br> このルールは既に CSS ルールによって書式がセットされている場合にも適用されます。例えば、[[ヘルプ:編集#定義リスト|定義リスト]] の太字などです。ルールによって標準の CSS 書式が許されていない場合(例: [[#ファイル名とパス]] での太字)、他の適合する wiki マークアップ(例: 定義リストの代わりに [[ヘルプ:編集#箇条書き|箇条書き]])に変える必要があります。
* このマニュアルで定義されているものとは違う強調方法を使わないでください。例としては、下線・点滅・全て大文字の語・色・アスタリスク・感嘆符・絵文字・{{ic|<nowiki>style</nowiki>}} 属性を持つ HTML タグなどがありますが、これに限定されません。

=== 一番目の用例 ===

* ページ内での関連する用語や名前(例: 実行ファイル名)の初めての出現は、そのページやセクションのトピックを考慮した上で注意を引く価値があると考えられる場合には ''強調'' (以下を参照)することができます。''関連する'' 初めての出現は厳密な初めての出現ではないかもしれません。その選択は編集者に委ねられています。
* 推奨される名前の強調の方法は、wiki 内や外部の強く関連するページ(例: Wikipedia)へのリンクを使うことです。適切なリンクがなければ、代わりに '''太字''' を使うことができます。
: パッケージとパッケージグループの名前は [[テンプレート:Pkg]]・[[テンプレート:AUR]]・[[テンプレート:Grp]] を使う必要があります。
* 名前がページのタイトルやセクション見出しにより既に導入されている場合、本文内での関連する初めての出現はリンクとしてのみ強調することができます。[[#名前/用語集]] のケースを除いて、単純に太字で強調することはできません。
* 初めての具体例の強調は、[[#特定のケース]] で明示的に許可されている場合にのみ適用することができます。

=== リンク ===

* リンクになっているテキストには書式を適用することができません。

=== 名前/用語集 ===

* 名前や用語のリスト内で書式の一貫性を維持することは、通常全ての項目に書式を適用する必要がなかったとしても許されていて、強制ではありません。これは例えば、通常斜体にするべきではない全て大文字の語や、ほとんどの項目が [[#一番目の用例]] に従って書式が適用されている場合も含まれます。<br> "リスト" は広い意味を意図していて、例えば連続する段落の初めの単語も用語のリストを形成しているとみなすことができます。

== 書式/記号のケース ==

<sup>1</sup> の付いているケースは [[#一番目の用例]] の影響を受けます。 <sup>m</sup> の付いているケースは等幅テキストが適用されます。

=== 斜体 ===

{{ic|<nowiki><i></nowiki>}} タグの代わりに MediaWiki の構文 {{ic|<nowiki>''斜体のテキスト''</nowiki>}} を使ってください。

*[[#実行ファイル/アプリケーションの名前]]<sup>1</sup>
*[[#ファイルの拡張子]]
*[[#リポジトリの名前]]<sup>1</sup>
*[[#パッケージとグループの名前]]<sup>1</sup>
*[[#ファイルやコマンドラインの疑似変数]]<sup>m</sup>
*[[#GUI/TUI テキスト]]
*[[#技術的用語]]<sup>1</sup>
*[[#強調する語・文]]
*[[#略語の展開]]

=== 太字 ===

{{ic|<nowiki><b></nowiki>}} タグの代わりに MediaWiki の構文 {{ic|<nowiki>'''太字のテキスト'''</nowiki>}} を使ってください。

*[[#ファイルやコマンドラインの内容の重要な部分]]<sup>m</sup>
*[[#強調する語・文]]
*[[#一番目の用例]]

=== 等幅 ===

コードブロックの外のテキストには、{{ic|<nowiki><code></nowiki>}} タグの代わりに [[テンプレート:ic]] {{ic|<nowiki>{{ic|等幅テキスト}}</nowiki>}} を使ってください。

*[[#ファイル名とパス]]
*[[#デーモン/サービス、カーネルモジュール]]
*[[#設定パラメータ・変数・オプション・プロパティ等]]
*[[#コマンド行]]
*[[#ファイルの内容]]
*[[#キーボードキー]]

=== 引用符 ===

{{ic|'引用テキスト'}} や曲線形の引用符 {{ic|“引用テキスト”}} の代わりに直線形の引用符 {{ic|"引用テキスト"}} を使ってください。

*[[#タイトルや見出しへの参照]]
*[[#単なる"テキストそのもの"への参照としての単語・文字]]
*[[#正しくない・疑わしい方法で使われる一般的な単語]]
*[[#引用]]

== 特定のケース ==

[[#全般的なルール]] は常に以下のルールより優先します。

=== 略語の展開 ===

''斜体'' を使ってください。

;例
* pacman は Arch Linux の ''pac''kage ''man''ager (パッケージマネージャ) です。
* [[Wikipedia:ja:Cat_(UNIX)|cat]] (''catenate'') はファイルを連結してリスト化する標準 Unix ユーティリティです。

=== コマンド行 ===

{{ic|等幅}} を使ってください。インラインのコマンド例である必要があり、[[#実行ファイル/アプリケーションの名前]] の単純な言及であってはいけません。あるいは、コンソールの出力やターミナルに貼り付けるために十分便利なテキストでも構いません。

;例
* コマンドの ''man'' ページを読むために {{ic|man ''コマンド''}} を入力することが推奨されます。
* {{ic|ip link}} コマンドを使ってインターフェースの名前を調べることができます。
* {{ic|ping: unknown host}} エラーが出た場合、まずケーブルや無線の信号強度に問題がないか確認してください。
* それ以上変更しないで終了するには、{{ic|yes}} を入力して ''Quit'' を選んで (または {{ic|q}} を押して) ください。
* {{ic|pacman -Syu}} を root 権限で実行してください。

=== 設定パラメータ・変数・オプション・プロパティ等 ===

{{ic|等幅}} を使ってください。コマンドオプション・ユーザーグループ・IP アドレス・環境変数・一般的な変数にも適用されます。

短い形式と長い形式の両方のコマンドオプションが表現される必要があるときは、間にスペースを入れずに "/" 記号を使ってください。例: {{ic|-a}}/{{ic|--anything}}。

;例

* 標準では、キーボードレイアウトは {{ic|us}} にセットされています。
* [...] このとき、''layout'' は {{ic|fr}}・{{ic|uk}}・{{ic|dvorak}}・{{ic|be-latin1}} などに置き換えてください。
* v197 以降、''udev'' は {{ic|wlanX}} や {{ic|ethX}} といった名前の付け方でネットワークインターフェースに名前を割り当てません。
* この例では、イーサネットインターフェースは {{ic|enp2s0f0}} です。
* 確証が持てないのであれば、イーサネットインターフェースはほとんどの場合 "e" の文字から始まり、{{ic|lo}} や "w" の文字から始まるものであることはほとんどないでしょう。
* 現在、最大3つの {{ic|nameserver}} の行を含めることができます。
* 追加で、サイズが 1007KiB でタイプコードが {{ic|EF02}} の [[GRUB#GUID Partition Table (GPT) specific instructions|BIOS ブートパーティション]] を作る必要があるでしょう。
* 全てのファイルはパーミッションが {{ic|644}} で所有者が {{ic|root:root}} である必要があります。
* {{Grp|base-devel}} グループの全てのパッケージを確認なしでインストールしたい場合は {{ic|-i}} スイッチを省略することができます。
* ユーザーを [[ユーザーとグループ|グループ]] ({{ic|sys}}・{{ic|disk}}・{{ic|lp}}・{{ic|network}}・{{ic|video}}・{{ic|audio}}・{{ic|optical}}・{{ic|storage}}・{{ic|scanner}}・{{ic|power}}など) に追加することは、systemd を使っているほとんどのケースで必要 ''ありません''。
* プロキシサーバーを使っている場合、{{ic|http_proxy}} と {{ic|ftp_proxy}} 環境変数を export する必要があります。
* 他の {{ic|LC_*}} 変数に他のロケールを使うには、{{ic|locale}} を実行して有効な選択肢を表示して、{{ic|locale.conf}} に追加してください。{{ic|LC_ALL}} 変数をセットするのは推奨されません。発展的な例は [[ロケール#システム全体のロケールを設定する]] を参照してください。
* [...] これは {{ic|DAEMONS}} 配列に含まれているものと大体同じです。
* プライベートネットワークを使っている場合、IP アドレスは {{ic|192.168.*.*}} の中から使い、サブネットマスクを {{ic|255.255.255.0}} にセットして、ブロードキャストアドレスに {{ic|192.168.*.255}} を使うと無難です。ゲートウェイは普通 {{ic|192.168.*.1}} か {{ic|192.168.*.254}} です。
* QEMU に {{ic|-net nic}} 引数を与えると、QEMU は通常仮想マシンにリンクレベルアドレスとして {{ic|52:54:00:12:34:56}} を持ったネットワークインターフェースを割り当てます。

=== デーモン/サービス、カーネルモジュール ===

{{ic|等幅}} を使ってください。

;例

* {{ic|dhcpcd.service}} は全てのネットワークインターフェースに対してデーモンを起動します。
* いくつかのユニット名は {{ic|@}} 記号を含みます (例: {{ic|name@''string''.service}})。
* 一般的な Bluetooth のドライバは {{ic|btusb}} カーネルモジュールです。

=== 実行ファイル/アプリケーションの名前 ===

全て小文字の名前の場合のみ ''斜体'' を使ってください。[[#一番目の用例]] の影響を受けます。

このルールはアプリケーション/ファイルそのものを表現するときのみ実行ファイルに適用され、[[#コマンド行]] で使われるときには適用されません。特に、通常何の引数も付けずに実行される実行ファイルに気を付けてください。[[ヘルプ:スタイル#スペル]] も参照してください。

;例
* {{ic|/etc/locale.gen}} の中の選択したロケールをアンコメントして、''locale-gen'' ユーティリティでロケールを生成してください。
* {{ic|/etc/locale.gen}} の中の選択したロケールをアンコメントして、{{ic|locale-gen}} でロケールを生成してください。
* v197 以降、''udev'' は {{ic|wlan''X''}} や {{ic|eth''X''}} といった名前の付け方でネットワークインターフェースに名前を割り当てません。
* Arch Linux のインストールメディアは、''fdisk''・''gdisk''・''cfdisk''・''cgdisk''・''parted'' のようなパーティショニングツールを含んでいます。
* pacman がパッケージの検証に失敗する場合、{{ic|cal}} でシステムの時間を確認してください。
* {{ic|passwd}} で root のパスワードをセットしてください。

=== ファイルの内容 ===

ファイルから読み込み・書き込みの両方を行うことができるか、テキストエディタからコピー・貼り付けするのに十分便利な内容には {{ic|等幅}} を使ってください。

;例
* 文字列の最後に {{ic|nomodeset}} を入力して、{{ic|Enter}} を押してください。あるいは、もし機能すればカーネルモードセッティングを無効化しない {{ic|1=video=SVIDEO-1:d}} を試してみてください。
* {{ic|/etc/locale.gen}} ファイル内の使いたい [http://www.greendesktiny.com/support/knowledgebase_detail.php?ref=EUH-483 ロケール] の前にある {{ic|#}} を削除してください。

=== ファイルの拡張子 ===

''斜体'' を使ってください。

;例
* pacman はプログラミング言語の C 言語で書かれていて、''.pkg.tar.zst'' パッケージ形式を使います。

=== ファイル名とパス ===

{{ic|等幅}} を使ってください。デバイス名と、ワイルドカードを含む名前にも適用されます。しかし、[[#ファイルの拡張子]] は違った方法で扱われます。

;例
* UEFI モードで起動しているか確認するには、ディレクトリ {{ic|/sys/firmware/efi}} が作成されているか確認してください。
* 全てのファイルとディレクトリは、異なる物理デバイスに保存されていたとしても、ルートディレクトリ {{ic|/}} の下に現われます。
* {{ic|/etc/resolv.conf}} を編集して、ネームサーバーの IP アドレスとローカルドメイン名を置き換えてください。
* インストールの前に、{{ic|mirrorlist}} ファイルを編集して適切なミラーを一番上に配置するとよいでしょう。
* カーネルモジュールを起動中に読み込むためには、{{ic|/etc/modules-load.d/}} にモジュールを使用するプログラム名を基に名前を付けた ''.conf'' ファイルを配置します。
* それぞれのパーティションは末尾の数字で区別されます。例えば、{{ic|sda1}} は1番目のドライブの1番目のパーティションを示し、{{ic|sda}} はドライブ全体を差し示します。

=== 正しくない・疑わしい方法で使われる一般的な単語 ===

"直線形の引用符" を使ってください。

;例
* 単なる "テキストそのもの" への参照としての単語・文字。

=== GUI/TUI テキスト ===

''斜体'' を使ってください。例としてはメニューの項目などがあります。メニューの中でのナビゲーションを表現するときは、''斜体'' のまま "''>''" 記号を使って、項目を分離してください。

;例
* その後、メニューから ''Boot Arch Linux'' を選んで {{ic|Enter}} を押すと、インストールが開始されます。
* Gparted を使う場合は、新しいパーティションテーブルを作る選択肢を選ぶと標準で ''msdos'' パーティションテーブルが作られます。アドバイスに従って GPT パーティションを作ることを意図している場合は、''Advanced'' を選んでから、ドロップダウンから ''gpt'' を選ぶ必要があります。
* それ以上変更しないで終了するには、{{ic|yes}} を入力して ''Quit'' を選んで (または {{ic|Q}} を押して) ください。
* プラグインをアップデートするためには、それらのアップデートリポジトリが ''Window > Preferences > Install/Update > Available Software Sites'' で有効化されていることを確認してください。

=== ファイルやコマンドラインの内容の重要な部分 ===

'''太字''' を使ってください。内容はコードそのもののため、テンプレートの外で参照するときには {{ic|等幅}} を維持して同時に使用する必要があります。

;例
* {{bc|# ln -s /usr/src/linux-'''$(uname -r)'''/include/generated/uapi/linux/version.h /usr/src/linux-'''$(uname -r)'''/include/linux/}}
: '''{{ic|$(uname -r)}}''' を現在実行していないカーネルに置き換えることができます。

=== キーボードキー ===

{{ic|等幅}} を使ってください。

;例
* POST が実行されている間にキー (通常 {{ic|Delete}}・{{ic|F1}}・{{ic|F2}}・{{ic|F11}}・{{ic|F12}}) を押す必要があります。

=== パッケージとグループの名前 ===

''斜体'' を使ってください。 [[#一番目の用例]] の影響を受け、[[Template:Pkg]]、[[Template:AUR]] か [[Template:Grp]] を使います。

;例
* {{Pkg|wireless_tools}} パッケージをインストールしてください。''wireless_tools'' が無線接続の管理のための基本的なツールセットを提供します。
* {AUR|downgrader-git}} パッケージは libalpm と一緒に機能するツールを提供します。''downgrader-git'' パッケージ内のツールは、pacman のログと、[[Arch Linux Archive]] やローカルのキャッシュ、[http://repo-arm.archlinuxcn.org ARM] を使ったパッケージのダウングレードに対応しています。
* 基本の GNOME デスクトップは {{Grp|gnome}} グループにより提供されます。''gnome'' はよく連携された [https://wiki.gnome.org/Apps アプリケーション] のサブセットも含みます。

=== ファイルやコマンドラインの疑似変数 ===

''斜体'' を使ってください。テンプレートの外で変数に言及するときは、{{ic|等幅}} を維持して同時に使用する必要があります。

変数がスペースを含まないようにしてください。代わりにその場所にアンダースコアを使ってください。

既に疑似変数が使われている場合、ページの他の部分と名前の一貫性を保つようにしてください。例えば、既に {{ic|''keyboard_layout''}} が使われているのであれば、新しい {{ic|''keyboardlayout''}} を導入しないでください。

;例

* {{bc|# loadkeys ''keyboard_layout''}}
: [...] このとき、{{ic|''keyboard_layout''}} は {{ic|fr}}・{{ic|uk}}・{{ic|dvorak}}・{{ic|be-latin1}} などに置き換えてください。
* {{ic|ip link set ''interface'' up}} でインターフェースを起動してください。
* 以下のコマンドでネットワークに接続することができます。
: {{bc|# wifi-menu ''interface_name''}}
: このとき、{{ic|''interface_name''}} はワイアレスチップセットのインターフェースに置き換えてください。

=== 引用 ===

インラインの引用には、"直線形の引用符" を使ってください。ブロックの引用には行をコロンで始めて、それ以外の記号や書式を適用しないインデントを使ってください。

;例
* "全てのユーザーのデータは私達に属します" &ndash; Google
* https://www.x.org/wiki/ から:
: X.Org プロジェクトは X Window System のオープンソース実装を提供しています。開発作業は freedesktop.org コミュニティと共同で行われています。X.Org Foundation は教育的な非営利の団体で、委員長がこの取り組みを担当して、委員がこれを機能するように導いています。

=== タイトルや見出しへの参照 ===

"直線形の引用符" を使ってください。しかし、セクション見出しに言及するときは、内部アンカーリンク ({{ic|<nowiki>[[#セクション]]</nowiki>}}) を使ってください。

;例
* カラム "dm-crypt +/- LUKS" は LUKS ("+") と プレーン ("-") の両方の暗号化モードのための dm-crypt の機能を示しています。その機能が LUKS の使用を必要とする場合、"(with LUKS)" と表示されます。同じように "(without LUKS)" は、その機能は LUKS の使用が逆効果でプレーンモードが使われるべきであることを示しています。

=== リポジトリの名前 ===

リポジトリの名前には ''斜体'' を使ってください。 [[#一番目の用例]] の影響を受けます。

;例
* ''testing'' リポジトリを有効にするには、{{ic|/etc/pacman.conf}} の中の {{ic|[testing]}} セクションをアンコメントする必要があります。
* ''testing'' リポジトリを有効にした場合、''community-testing'' リポジトリも有効にする必要があります。

=== 強調する語・文 ===

他の方法で文の意味の重要性が認識されない場合には ''斜体'' を使ってください。通常声に出して読む場合は強調して発音されます。

しかし、特定の注意が必要な、"ではありません"・"だけ"・"厳密に"・"強く"・"前に" などの単語の場合には、'''太字''' で強調することができます。

とても重要で、警告やノートとして分離しておくことができない、セクション自体のなくてはならない部分についても同じことが適用できます。

;例
* ''あなたの'' ニーズに一番合う環境を選んでください。
* このコマンドはリポジトリデータベースを同期して、''かつ'' システムのパッケージをアップデートします。
* スクリーンが空白に ''ならずに'' ブートプロセスが止まってしまった場合です。
* [...] そのため、見たものを ''正確に'' 入力するようにしてください。
* 他の全てを削除することで、そのミラー ''だけ'' を有効にすることも、希望するのであれば可能です。
* パーティショニングはデータを破壊する可能性があります。'''強く''' 気をつける必要があり、進める前に重要なデータのバックアップを取っておくとよいでしょう。
* システムをアップグレードする ''前に'' 手動の操作が必要となる Arch Linux での変更に追従しておいてください。
* '''システムをアップデートするとき、ユーザーは pacman の出力する全ての出力を読んで、判断力を働かせることが重要です。'''
* これは部分アップグレードが '''サポートされていない''' ことを意味します。

=== 技術的用語 ===

全て大文字の語(通常は略語)を除いて ''斜体'' を使ってください。[[#一番目の用例]] の影響を受けます。

;例
* コマンドの ''man'' ページを読むために {{ic|man ''コマンド''}} を入力することが推奨されます。
* このページでは、GNU/Linux システムにおけるいわゆる ''core'' ユーティリティを扱います。
* ''プライマリ'' パーティションは起動可能で、ディスクや RAID ボリュームあたり4つのパーティションに制限されています。
* これは、systemd によって ''tmpfs'' としてマウントされているおかげで、標準で既に分割されたパーティションになっています。
* POST (Power On Self-Test) フェーズの間にキー (通常 {{ic|Delete}}・{{ic|F1}}・{{ic|F2}}・{{ic|F11}}・{{ic|F12}}) を押す必要があります。

=== 単なる"テキストそのもの"への参照としての単語・文字 ===

"直線形の引用符" を使ってください。

;例
* しかし、特定の注意が必要な、"ではありません"・"だけ"・"厳密に"・"強く"・"前に" などの単語の場合には、'''太字''' で強調することができます。
* 確証が持てないのであれば、イーサネットインターフェースはほとんどの場合 "e" の文字から始まり、{{ic|lo}} や "w" の文字から始まるものであることはほとんどないでしょう。

{{TranslationStatus|Help:Style/Formatting and punctuation|2022-03-18|717343}}