ヘルプ:編集

提供: ArchWiki
2020年3月17日 (火) 23:58時点におけるNy-a (トーク | 投稿記録)による版 (英語版と同期)
ナビゲーションに移動 検索に移動

関連記事

ArchWiki は MediaWiki で動いています。MediaWiki は PHP によって書かれたフリーソフトウェアの wiki パッケージであり、本来は Wikipedia のためにデザインされました。より細かいヘルプは MediaWiki のヘルプ:コンテンツ や Wikipedia のヘルプ:目次 にあります。

このページは ArchWiki の編集についての簡単なチュートリアルです。ページを編集・作成する前に、ユーザーは、全体的な調子・レイアウト・存在しているページの文体に慣れるようにしてください。wiki 全体の一貫性が保たれるようにする配慮をお願いします。ArchWiki:貢献やヘルプ:読み方に一般的な文体の決まりごとの概要が書かれています。より詳しくはヘルプ:スタイルを見て下さい。wiki マークアップの総覧はヘルプ:チートシートを見て下さい。

Creating an account

You must create an account before being able to edit ArchWiki articles; answering the captcha question requires an up-to-date Arch Linux environment: Arch Linux を使用していない場合でも自由にアカウントを作成して記事を編集できます, and in order to answer the question they can for example boot into a live Arch system with the latest installation image.

Once you have an account, Special:UserLogin からログインしてください。

編集

ページの編集を始めるには、ページ上部の編集タブをクリックします。又は、各セクションの右にある編集リンクをクリックすることで、ページの特定のセクションを編集することができます。表示される編集ページは、次のように構成されています:

  • 編集ツールバー (optional)
  • 編集ボックス
  • 編集内容の要約ボックス
  • 変更を保存, プレビューを表示, 差分を表示, 取り消しリンク

編集ボックスには現行版のページやセクションの wikitext (サーバーがウェブページを作るための編集可能なソースコード) が入っています。編集するには:

  1. 必要なだけ wikitext を修正します (詳しくは下の #フォーマット を見て下さい)。
  2. 編集内容の要約ボックスに編集の説明を書きます （例: "typo の修正"、"xyz に関する情報の追加" (詳しくは Help:要約欄 を読んで下さい))。
    ノート: 編集には全て要約の記述を付け加えるべきです。要約によって管理者や他のメンテナは議論を呼ぶ編集や破壊行為を楽に見つけることができます。 See en2:ArchWiki:Contributing#The 3 fundamental rules for more information.
  3. プレビューを表示ボタンを使えば校正や保存する前のフォーマットの確認が楽にできます。
  4. その編集が表面的で議論の余地がない場合は、「細部の編集」ボックスをチェックして、編集を minor としてマークしてください。
  5. 変更を保存をクリックして変更を保存します。不満足なら、代わりに取り消しをクリック（もしくは満足いくまで編集を繰り替え）します。
ノート: 記事には署名をつけてはいけません、なぜなら共同の成果物だからです。一人の編集者が他の貢献者をさしおいて自分の名前を冠することは許されません。
ヒント: vim などの外部エディタを使うつもりがないのならば、wikEd を使うことで、MediaWiki の標準エディタを代替して、シンタックスハイライトや正規表現などの機能を使うことができます。この greasemonkey スクリプトは問題なく ArchWiki で動きます。 Remember to always double-check any automated tasks!

編集の取り消し

ページを誤って編集していまったときは、以下の作業でページを前の版にさし戻すことができます。ある１つの編集を戻すには:

  1. ページ上部の履歴タブ （編集タブの隣）をクリックします。版の一覧が表示されます。
  2. 問題の編集の右の取り消しリンクをクリックします。編集プレビューが表示され、左側に現在の版、右側に保存される文章が表示されます。
  3. Write the reason why you are undoing this edit to the edit summary field.
  4. 満足したら、ページ下部の変更を保存ボタンをクリックして下さい。

その wiki ページの状態がオリジナルに戻ったでしょうか。

場合によっては、一度に複数の編集を戻す必要があるかもしれません。前の版に記事を戻すには:

  1. ページ上部の履歴タブ （編集タブの隣）をクリックします。版の一覧が表示されます。
  2. 戻したい版（つまり最後の良い版）を見るために適切なタイムスタンプをクリックします。その版が表示されます。
  3. ページの一番上にある編集タブをクリックして下さい。警告が表示されます: このページの古い版を編集しています。
  4. Write the revision timestamp (displayed at the top of page) and a reason why you are reverting page state to the edit summary field.
  5. 満足したら、変更を保存ボタンをクリックすればその版に revert されます。
ノート: 取り消しと編集を同時に行わないで下さい！ まず編集を戻し、それから追記してください; 版のプレビューを編集してはいけません。

ページの作成

新しいページを作る前に、以下の点を考えて下さい:

  1. あなたのトピックは Arch Linux に関係ありますか？ 無関係な、役に立たない記事は削除されるでしょう。
  2. あなたのトピックは他の人にも役に立ちますか？ あなたが書きたいことだけでなく、他の人が読みたいことも考えましょう。個人的な事柄はあなたの user ページに。
  3. あなたのトピックは新しいページにする価値がありますか？ wiki に似たような記事がないか検索しましょう。もしあったなら、既に存在する記事に追記することを考えてみて下さい。
  4. あなたの貢献は意味をもつでしょうか？ 後で拡張するつもりがないスタブを作るのは避けましょう。

新しいページを作るには タイトル と適切な カテゴリ を決める必要があります。

ヘルプ:記事命名ガイドラインに記事の名前をつけるときのアドバイスが書かれています。ページタイトルに "Arch Linux" やその変形を含んではいけません。ここは Arch Linux の wiki です、記事は Arch Linux に関係しているはずです。 (例: Installing Openbox; ダメな例 Installing Openbox in Arch Linux).

目次から適切なカテゴリを選びましょう。１つのページを複数のカテゴリに含めることもできます。

新しいページをあるカテゴリ (例: "My New Page" を "Some Category" へ) に追加するには:

  1. 新しいページを作るために新しいタイトルが入った https://wiki.archlinux.jp/index.php/My_New_Page をブラウズします (忘れずに "My_New_Page" を新しいタイトルに置き換えて下さい！)
  2. あなたのページの一番上に [[Category:Some Category]] を加えます。
ノート: カテゴリがないページを作ってはいけません！全てのページは少なくとも１つのカテゴリに属している必要があります。適切なカテゴリが見つからない場合は、新しいカテゴリを作って下さい。

At this stage the new article is still considered an orphan. To complete the job, take a little extra time to link to the new article from others: this will improve its visibility and encourage more users to contribute to it. Likely candidates are articles about related software, more generic overview pages, or even simple lists such as en2:List of applications.

In some cases it may make sense to instead create a subpage, i.e. a child of another page: subpage titles are separated from the superpage title with "/" symbols (slash). This is often useful to prepare drafts under one's own User page, for example https://wiki.archlinux.org/index.php/User:Myself/My_new_subpage.

フォーマット

テキストのフォーマットは可能な限り wiki のマークアップで行います; HTML を覚える必要はありません。また普遍的なフォーマットのために様々なテンプレートも用意されています。テンプレートについてはヘルプ:テンプレートを見て下さい。ヘルプ:チートシートに一番重要なフォーマットオプションが要約されています。

見出しと小見出し

見出しと小見出しによって記事のまとまりを良くすることができます。別個のトピックが混ざっているなら、それぞれのセクションに見出しをつけて記事を分配できます。詳しい使い方はヘルプ:スタイル#セクションの見出しやヘルプ:効果的な見出しを見て下さい。

見出しはセカンドレベルから使うことができます, and can be created like this: 

==Second-level heading==
===Third-level heading===
====Fourth-level heading====
=====Fifth-level heading=====
======Sixth-level heading======
ノート: ファーストレベルの見出しは使えません、記事のタイトルのために予約されているからです。

記事に４つ以上見出しが存在すると、自動的に目次 (table of contents, TOC) が作られます。これを消すには、__NOTOC__ を加えて下さい。TOC がどうなるかはサンドボックスで試すことができます。

改行

空行によってパラグラフを分けることができます。標準のパラグラフにおいて、ただの改行では意味がありません。

HTML タグ <br> を使って手動で改行することもできますが、できるだけそれは避けましょう。手動での改行は、リストのような他のフォーマットで使うべきです。

wikitext rendering 
This sentence
is broken into
three lines.

This sentence is broken into three lines. 

This is paragraph number one.

This is paragraph number two.

This is paragraph number one.

This is paragraph number two. 

* This point <br> spans multiple lines
* This point
ends the list
  • This point
    spans multiple lines
  • This point

ends the list

改行の使用についてはヘルプ:スタイル/空白を見て下さい。

太字と斜体

太字と斜体は、それぞれ２つ・３つのアポストロフィー (') で単語やフレーズを囲むことで表示できます:

wikitext rendering

''斜体''

斜体

'''太字'''

太字

'''''太字かつ斜体'''''

太字かつ斜体

取り消し線

すでに無効・不適切な文章には取り消し線を用います。

wikitext rendering 
<s>取り消し文章</s>

取り消し文章

リスト

Remember that wiki syntax does not support multi-line list items; every newline character ends the list item definition. To start a new line inside a list item, use the <br> tag. To enter a multi-line code block inside a list item, use Template:bc and escape the content using <nowiki> tags. See also en2:Help:Style/White space and en2:Help:Template.

箇条書き

箇条書きでは、項目にはっきりとした順序がありません。

条を加えるには、アスタリスク (*) を使います。複数の * を使えば階層を作れます。

wikitext rendering 
* First item 
* Second item 
** Sub-item
* Third item
  • First item
  • Second item
    • Sub-item
  • Third item

番号付きリスト

番号付きリストはリストの項目に番号をふって順序を作ります。順番に意味がないのならば、普通は順序なしのリストを使って下さい。 番号付きリストを作るには、ナンバーサインかハッシュ記号 (#) を使います。# を複数使えば、階層を作れます。

wikitext rendering 
# First item 
# Second item 
## Sub-item
# Third item
  1. First item
  2. Second item
    1. Sub-item
  3. Third item
# First item
# Second item
#* Sub-item
# Third item
  1. First item
  2. Second item
    • Sub-item
  3. Third item

定義リスト

定義リストは、項目名にセミコロン (;)、それに続く文章にコロン (:) を付けます。

wikitext rendering 
Definition lists:
; Keyboard: Input device with buttons or keys
; Mouse: Pointing device for two-dimensional input
or
; Keyboard
: Input device with buttons or keys
; Mouse
: ointing device for two-dimensional input

Definition lists:

Keyboard
Input device with buttons or keys
Mouse
Pointing device for two-dimensional input

or

Keyboard
Input device with buttons or keys
Mouse
Pointing device for two-dimensional input
Use additional colons if a definition has multiple definitions:
; Term
: First definition
: Second definition

Use additional colons if a definition has multiple definitions:

Term
First definition
Second definition

定義リストを単純にフォーマットのために使ってはいけません、W3's examples を見て下さい。

インデント

テキストをインデントするには、行頭にコロン (:) を付けます。コロンをつければつけるほど、テキストが深くインデントされます。行を変えるとインデントは解除されます。

wikitext rendering 
This is not indented at all.
:This is indented slightly.
::This is indented more.

This is not indented at all.

This is indented slightly.
This is indented more.
ノート: Use indentation only when strictly necessary to obtain the desired layout. In talk pages, use it to indent replies (see en2:Help:Discussion).

コード

wiki にコードを加えるには、テンプレートのコードフォーマットの一つを使って下さい。または、単純に、それぞれの行の冒頭に半角スペースを一つずつ加えて下さい。例： 

 $ echo Hello World

ヘルプ:スタイル#コードのフォーマットも参照してください。

表

ヒント: See Mediawiki Tables Generator to automatically generate tables.

効果的に使えば、表はデータをまとめるのに役立ちます。発展的な表の使い方については Help:Table を見て下さい。

wikitext rendering 
{| border="1"
|+ Tabular data
! Distro !! Color
|-
| Arch || Blue
|-
| Gentoo || Purple
|-
| Ubuntu || Orange
|}
Tabular data
Distro Color
Arch Blue
Gentoo Purple
Ubuntu Orange 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| rootfs || 922G || 463G || 413G || 53% || /
|-
| /dev || 1.9G || 0 || 1.9G || 0% || /dev
|}
Filesystem Size Used Avail Use% Mounted on
rootfs 922G 463G 413G 53% /
/dev 1.9G 0 1.9G 0% /dev

リンク

サイトのナビゲーションとしてリンクは読者にとって重要です。一般的に、編集者は全ての記事それぞれに他の記事に出発するリンクを配置するべきです (行き止まりページは作らないようにしてください)。そして他の記事から到着するためのリンクを貼りましょう (リンク元ページでどこからリンクが貼られているか確認できます)。 See also en2:Help:Style/Formatting and punctuation#First instances.

内部リンク

内部リンクを使うことで wiki のページを広くクロスリファレンスすることができます。同じ wiki 内の違うページへのリンクを作るには、単純にタイトルを２つの括弧で括って下さい。

例えば、pacman 記事にリンクを貼りたい場合: 

[[pacman]]
ノート: If the target page does not exist, the result will be a red link, which should be avoided as per en2:Help:Style#Hypertext metaphor.

記事のタイトルとリンク文字を別にしたいときは、パイプ "|" の後にリンクにつける名前を加えて下さい。

例: 

The [[ArchWiki:About|ArchWiki]] is the primary documentation source for Arch Linux.

上のリンクの表示例:

The ArchWiki is the primary documentation source for Arch Linux.
ヒント: The pipe symbol ("|"), a.k.a. vertical bar symbol, can be composed with Shift+\ on English keyboard layout and similar.

リンクに記事タイトルの複数形（などの接尾辞）を使いたい場合、直接、括弧の外側に文字を加えることができます。

例: 

makepkg is used in conjunction with [[PKGBUILD]]s.

上のリンクの表示例:

makepkg is used in conjunction with PKGBUILDs.

ページのセクションへのリンク

この記事あるいはセクションで使われている用語や表現には問題が存在します。
議論: Rename to Section links. (議論: ヘルプ・トーク:編集#)

文章のセクションへのリンクを作るには、セクションの見出しの頭に # を加えて下さい。

例: 

[[ヘルプ:編集#ページのセクションへのリンク]]

上のリンクの表示例:

ヘルプ:編集#ページのセクションへのリンク
ヒント: 同じページ内のセクションにリンクする場合、ページ名は省略できます (例: [[#Links to sections of a document]])。

Pipe trick

In some cases, it is possible to use the pipe trick to save writing the label of wiki links. The most important cases usable on ArchWiki are:

  1. In article titles, it allows to hide the language suffix. For example, [[Main page (Česky)|]] is turned into Main page.
  2. In links to different namespace or wiki, the pipe trick hides the prefix. For example, [[ArchWiki:About|]] is turned into About and [[wikipedia:Help:Pipe trick|]] is turned into Help:Pipe trick.

When the page is saved, the pipe trick will automatically generate the label for the link and change the wikitext accordingly.

言語間リンク

ヘルプ:i18n#言語間リンク を見て下さい。

wiki間リンク

いわゆる wiki間リンク は、Wikipedia などの、外部 Wiki の記事にリンクするために使われます。このリンクを貼るには、wiki の名前の後にコロン、そしてリンクしたい記事、それら全体をふたつの括弧で包みます。

Wikipedia:Arch Linux にリンクしたい場合: 

[[Wikipedia:Arch Linux]]

Arch Linux Wikipedia article のようにリンク文字を変えるにはパイプを使います: 

[[Wikipedia:Arch Linux|Arch Linux Wikipedia article]]
ノート: パイプリンクは長い URL を略すために使って下さい。

参照: Wikipedia:Interwiki links

The list of all interwiki links available on ArchWiki can be viewed at Special:Interwiki and via the API.

ヒント: By default, all interwiki links to pages in Wikipedia are considered as links to English pages. If you want to create a link to a page in another language, you may add a language prefix to the page name. For example, to create a link to a Russian page, prefix its name with ru: 
[[Wikipedia:ru:Arch Linux]]

results in Wikipedia:ru:Arch Linux.

Note that it depends on the interwiki configuration for the target wiki, so it does not work on every wiki. It works for Wikipedia though.

外部リンク

外部サイトにリンクしたい場合、リンクしたいページの完全な URL を書けば十分です。 

http://www.google.com/

URL をそのままリンクにするよりも、他の文字を表示したほうが見やすくなることはよくあります。括弧をつかって、URL の後ろに文字列を加えて下さい（スペースで区切ります(パイプではありません)）。Google search engine のようにリンクを表示するには: 

[http://www.google.com/ Google search engine]

It is also possible to generate an auto-numbered label by simply enclosing the URL with single brackets. This is often preferred to phrases like "see here". To produce a phrase "see [1]", where the number will vary depending on the order of the link on the page, just type: 

see [https://www.google.com/]
ノート: ArchWiki や　Wikipedia のページにリンクする時は、外部リンクではなく #内部リンク や #wiki間リンク を使って下さい！つまり、 https://wiki.archlinux.org/ で始まるリンクには内部リンクを使って下さい; http://en.wikipedia.org/ で始まるリンクには wiki間リンクを使って下さい!

リダイレクト

この記事またはセクションは加筆を必要としています。
理由: Should be split into subsections to clearly describe 1) what is a redirect, 2) when/why to redirect a page, 3) how to redirect a page. (議論: ヘルプ・トーク:編集#)

違うページに自動的にリダイレクトさせるには、ページの冒頭に #redirect とリダイレクト先のページへの内部リンクを加えて下さい。

例えば、"Penguins" から "Penguin" にリダイレクトさせたい場合: 

#redirect [[Penguin]]

これで、検索ボックスからどちらをタイピングした人も "Penguin" に着くようになります。

Redirects also allow keeping track of the reason why links are made, for example grouping them in WhatLinksHere pages, and let quickly update link fragments in case of section renames. As a downside redirects do not show the ultimate link target in the browser.

Before creating a redirect, you can perform a search to check existing compatible ones. For example, Xorg.

See also en2:Help:Style#Redirect pages and en2:Help:Procedures#Deal with talk pages after redirecting a page to another.

ノート:

Wiki 変数・マジックワード・テンプレート

MediaWiki は記事内の特定の文字列を認識して標準の振る舞いを変更します。例えば、__NOTOC__ を記事に加えると目次が作られなくなります。同じように、__TOC__ は目次を表示する位置を変えるのに使われます。詳しくは ヘルプ:マジックワード を見て下さい。

テンプレートと変数は wikitext の一部として事前に定義されていてフォーマットされたコンテンツを表示するのに記事に挿入されます。

変数はシステムによって定義され、現在のページ・wiki・日付についての情報を表示するのに使われます。例えば、{{SITENAME}} を使うと wiki のサイト名を表示します（この wiki では: ArchWiki）。現在のページに他のタイトルヘッダを設定するには、他の wiki 変数を使います: {{DISPLAYTITLE:New Title}} (But it's very restricted:使用は大文字・小文字・アンダースコアの変化をしたい時だけにしてください — normalized title string must match with real page name, otherwise it will not work; use {{Lowercase title}} template to display first letter of title in lower case)。

一方、テンプレートは、ユーザによって定義されます。どのページでも、{{Namespace:Page Name}} を加えることで他のページを記事内に含めることができます。ただし Template 名前空間の外のページを使うのは稀です（名前空間が省かれる場合、Template を使います）。例えば、テンプレート:Note は記事内で次の wikitext によって用いられ: 

{{Note|This is a note.}}

このように表示されます:

ノート: This is a note.

詳しくはヘルプ:テンプレートを見て下さい。and a list of available templates such as Template:Tip or Template:Warning.

「https://wiki.archlinux.jp/index.php?title=ヘルプ:編集&oldid=15730」から取得