「ヘルプ:編集」の版間の差分
細 |
(→アカウントの作成: 訳出) |
||
(5人の利用者による、間の36版が非表示) | |||
1行目: | 1行目: | ||
[[Category:ヘルプ]] |
[[Category:ヘルプ]] |
||
+ | [[ar:Help:Editing]] |
||
[[cs:Help:Editing]] |
[[cs:Help:Editing]] |
||
[[en:Help:Editing]] |
[[en:Help:Editing]] |
||
[[es:Help:Editing]] |
[[es:Help:Editing]] |
||
− | [[fa:راهنما: |
+ | [[fa:راهنما:راهنمای_ویرایش_ویکی_آرچ]] |
− | [[fr: |
+ | [[fr:Help:Editing]] |
[[it:Help:Editing]] |
[[it:Help:Editing]] |
||
[[pl:Help:Editing]] |
[[pl:Help:Editing]] |
||
13行目: | 14行目: | ||
[[tr:Wikiye yazı yazmak]] |
[[tr:Wikiye yazı yazmak]] |
||
[[uk:Help:Editing]] |
[[uk:Help:Editing]] |
||
− | [[zh- |
+ | [[zh-hans:Help:Editing]] |
− | [[zh- |
+ | [[zh-hant:Help:Editing]] |
{{Related articles start}} |
{{Related articles start}} |
||
{{Related|ArchWiki:About}} |
{{Related|ArchWiki:About}} |
||
23行目: | 24行目: | ||
{{Related|ヘルプ:議論}} |
{{Related|ヘルプ:議論}} |
||
{{Related|サンドボックス}} |
{{Related|サンドボックス}} |
||
+ | {{Related|Wiki Monkey}} |
||
{{Related articles end}} |
{{Related articles end}} |
||
+ | ArchWiki は [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] で動いています。MediaWiki は PHP によって書かれたフリーソフトウェアの wiki パッケージであり、本来は Wikipedia のためにデザインされました。より細かいヘルプは [https://www.mediawiki.org/wiki/Help:Contents/ja MediaWiki のヘルプ:コンテンツ] や [https://ja.wikipedia.org/wiki/Help:%E7%9B%AE%E6%AC%A1 Wikipedia のヘルプ:目次] にあります。 |
||
+ | このページは [[ArchWiki:About|ArchWiki]] の編集についての簡単なチュートリアルです。ページを編集・作成する前に、ユーザーは、全体的な調子・レイアウト・存在しているページの文体に慣れるようにしてください。wiki 全体の一貫性が保たれるようにする配慮をお願いします。[[ArchWiki:貢献]]・[[ヘルプ:スタイル]]・[[ヘルプ:読み方]]に一般的な文体の決まりごとの概要が書かれています。より詳しくは[[ヘルプ:スタイル]]を見て下さい。試しに編集するには、[[サンドボックス]]を使ってください。wiki マークアップの総覧は[[ヘルプ:チートシート]]を見て下さい。 |
||
− | ArchWiki は [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] で動いています。MediaWiki は PHP によって書かれたフリーソフトウェアの wiki パッケージであり、本来は Wikipedia のためにデザインされました。このページは [[ArchWiki:About|ArchWiki]] の編集についての簡単なチュートリアルです。より細かいヘルプは [http://www.mediawiki.org/wiki/Help:Contents Help:Contents on MediaWiki] や [http://en.wikipedia.org/wiki/Help:Contents Help:Contents on Wikipedia] にあります。 |
||
+ | == アカウントの作成 == |
||
− | ページを編集するにはログインする必要があります。[[Special:UserLogin]] からアカウントを作成・ログインしてください。編集の練習は、[[サンドボックス]]を使って下さい。wiki マークアップの総覧は [[ArchWiki Cheatsheet]] を見て下さい。wiki のタスクについては、[[ArchWiki:貢献]] を見て下さい。 |
||
+ | ArchWiki のページを編集するためには、まず[[特別:アカウント作成|アカウントを作成]]する必要があります。captcha への回答は、最新の Arch Linux 環境が必要です。Arch Linux を使用していない場合でも自由にアカウントを作成して記事を編集できます。また、質問に答えるために例えば[https://www.archlinux.jp/download/ 最新のインストールイメージ]から Arch のライブ環境を起動することや、{{AUR|pacman-static}} (事前にコンパイルされたバイナリ)、または単に [[Docker]] などのコンテナイメージ使用ツールを使うことができます。 |
||
− | ページを編集・作成する前に、ユーザーは、全体的な調子・レイアウト・存在しているページの文体に慣れるようにしてください。wiki 全体の一貫性が保たれるようにする配慮をお願いします。[[ヘルプ:読み方]]に一般的な文体の決まりごとの概要が書かれています。より詳しくは[[ヘルプ:スタイル]]を見て下さい。 |
||
+ | |||
+ | アカウントを作成したら, [[特別:ログイン]] からログインしてください。 |
||
==編集== |
==編集== |
||
− | ページの編集を始めるには、ページ上部の |
+ | ページの編集を始めるには、ページ上部の'''編集'''タブをクリックします。又は、各セクションの右にある'''編集'''リンクをクリックすることで、ページの特定のセクションを編集することができます。表示される''編集''ページは、次のように構成されています: |
− | * 編集ツールバー ( |
+ | * 編集ツールバー (任意) |
* 編集ボックス |
* 編集ボックス |
||
* 編集内容の要約ボックス |
* 編集内容の要約ボックス |
||
− | * '' |
+ | * ''{{int:savechanges}}'' or ''{{int:savearticle}}'', ''{{int:showpreview}}'', ''{{int:showdiff}}'', and ''{{int:cancel}}'' リンク |
編集ボックスには現行版のページやセクションの '''wikitext''' (サーバーがウェブページを作るための編集可能なソースコード) が入っています。編集するには: |
編集ボックスには現行版のページやセクションの '''wikitext''' (サーバーがウェブページを作るための編集可能なソースコード) が入っています。編集するには: |
||
# 必要なだけ wikitext を修正します (詳しくは下の [[#フォーマット]] を見て下さい)。 |
# 必要なだけ wikitext を修正します (詳しくは下の [[#フォーマット]] を見て下さい)。 |
||
− | # ''編集内容の要約''ボックスに編集の説明を書きます (例: "typo の修正"、"xyz に関する情報の追加" (詳しくは [[Wikipedia:Help: |
+ | # ''編集内容の要約''ボックスに編集の説明を書きます (例: "typo の修正"、"xyz に関する情報の追加" (詳しくは [[Wikipedia:ja:Help:要約欄|Help:要約欄]] を読んで下さい))。{{Note|'''編集には全て要約の記述を付け加えるべきです。'''要約により他のユーザーによるレビューを楽にします。詳しくは [[ArchWiki:貢献#3つの基本的なルール]] を参照してください。}} |
− | # ''' |
+ | # '''{{int:showpreview}}'''ボタンを使えば校正や保存する前のフォーマットの確認が楽にできます。 |
− | # その編集が表面的で議論の余地がない場合は、''' |
+ | # その編集が表面的で議論の余地がない場合は、'''{{int:minoredit}}''' ボックスをチェックして、編集を ''[[Wikipedia:ja:Help:細部の編集|細部の編集]]'' としてマークしてください。 |
− | # ''' |
+ | # '''{{int:savechanges}}''' をクリックして変更を保存します。不満足なら、代わりに '''{{int:cancel}}''' をクリック(もしくは満足いくまで編集を繰り替え)します。 |
+ | {{Note|記事には署名を'''つけてはいけません'''、なぜなら''共同の''成果物だからです。一人の編集者が他の貢献者をさしおいて自分の名前を冠することは許されません。}} |
||
− | {{Note|vim などの外部エディタを使うつもりがないのならば、[https://secure.wikimedia.org/wikipedia/en/wiki/User:Cacycle/wikEd wikEd] を使うことで、MediaWiki の標準エディタを代替して、シンタックスハイライトや正規表現などの機能を使うことができます。この greasemonkey スクリプトは問題なく ArchWiki で動きます。}} |
||
+ | {{Tip|vim などの外部エディタを使うつもりがないのならば、[https://secure.wikimedia.org/wikipedia/en/wiki/User:Cacycle/wikEd wikEd] を使うことで、MediaWiki の標準エディタを代替して、シンタックスハイライトや正規表現などの機能を使うことができます。この greasemonkey スクリプトは問題なく ArchWiki で動きます。自動化したタスクは常にダブルチェックすることを忘れないでください。}} |
||
− | {{Note|記事には署名は'''つきません'''、なぜなら''共同の''成果物だからです。一人の編集者が他人をさしおいて自分の名前を冠することは許されません。}} |
||
===編集の取り消し=== |
===編集の取り消し=== |
||
− | ページを誤って編集して |
+ | ページを誤って編集してしまったときは、以下の作業でページを前の版にさし戻すことができます。ある1つの編集を戻すには: |
− | #ページ上部の '''history''' タブ ('''edit''' タブの隣)をクリックします。版の一覧が表示されます。 |
+ | #ページ上部の '''{{int:vector-view-history}}''' タブ ('''{{int:vector-view-edit}}''' タブの隣) をクリックします。版の一覧が表示されます。 |
− | #問題の編集の右の ''' |
+ | #問題の編集の右の '''{{int:editundo}}''' リンクをクリックします。編集プレビューが表示され、左側に現在の版、右側に保存される文章が表示されます。 |
+ | #編集の要約欄に、編集を取り消す理由を書いてください。 |
||
− | #満足したら、ページ下部の '''Save page''' ボタンをクリックして下さい。 |
||
+ | #満足したら、ページ下部の '''{{int:savechanges}}''' ボタンをクリックして下さい。 |
||
− | その wiki ページの状態 |
+ | その wiki ページは元の状態に戻ったはずです。 |
場合によっては、一度に複数の編集を戻す必要があるかもしれません。前の版に記事を戻すには: |
場合によっては、一度に複数の編集を戻す必要があるかもしれません。前の版に記事を戻すには: |
||
− | #ページ上部の '''history''' タブ ('''edit''' タブの隣)をクリックします。版の一覧が表示されます。 |
+ | #ページ上部の '''{{int:vector-view-history}}''' タブ ('''{{int:vector-view-edit}}''' タブの隣)をクリックします。版の一覧が表示されます。 |
#戻したい版(つまり最後の''良い''版)を見るために適切なタイムスタンプをクリックします。その版が表示されます。 |
#戻したい版(つまり最後の''良い''版)を見るために適切なタイムスタンプをクリックします。その版が表示されます。 |
||
− | # |
+ | #ページの一番上にある '''{{int:vector-view-edit}}''' タブをクリックして下さい。警告が表示されます: '''{{int:editingold}}''' |
+ | #編集の要約欄に、版のタイムスタンプ(ページの一番上に表示されています)とページの状態を戻す理由を書いてください。 |
||
+ | #満足したら、'''{{int:savechanges}}''' ボタンをクリックすればその版に revert されます。 |
||
+ | {{Note| |
||
− | {{Note|'''undo と edit を同時に行わないで下さい!''' まず編集を戻し、それから追記してください; 版のプレビューを編集してはいけません。}} |
||
+ | * 取り消しと編集を同時に行わないで下さい。まず編集を戻し、それから追記してください; 版のプレビューを編集してはいけません。 |
||
+ | * 長くなる議論を避けるために、取り消しを行うときには特に詳細で冗長な要約を使うようにしてください。 |
||
+ | }} |
||
==ページの作成== |
==ページの作成== |
||
79行目: | 90行目: | ||
新しいページを作るには '''タイトル''' と適切な '''カテゴリ''' を決める必要があります。 |
新しいページを作るには '''タイトル''' と適切な '''カテゴリ''' を決める必要があります。 |
||
− | [[ |
+ | [[ヘルプ:記事命名ガイドライン]]や[[ヘルプ:スタイル#タイトル]]に記事の名前をつけるときのアドバイスが書かれています。ページタイトルに "Arch Linux" やその変形を含んではいけません。ここは Arch Linux の wiki です、記事は Arch Linux に関係しているはずです。 (例: ''Installing Openbox''; ダメな例 ''Installing Openbox in Arch Linux''). |
+ | [[目次]]から適切なカテゴリを選びましょう。1つのページを複数のカテゴリに含めることもできます。 |
||
− | # タイトルには大文字を適切に使って下さい: ''Title for New Page''; ダメな例 ''Title for new page''. |
||
− | # ページタイトルに "Arch Linux" やその変形を含んではいけません。ここは Arch Linux の wiki です、記事は Arch Linux に関係しているはずです。 (例: ''Installing Openbox''; ダメな例 ''Installing Openbox in Arch Linux''). |
||
− | + | 新しいページをあるカテゴリ (例: "新規ページ" を "とあるカテゴリ" へ) に追加するには: |
|
+ | # 新しいページを作るために新しいタイトルが入った {{canonicalurl:新規ページ}} をブラウズします (忘れずに "新規ページ" を新しいタイトルに置き換えて下さい!) |
||
− | 新しいページをあるカテゴリ (例: "My New Page" を "Some Category" へ) に追加するには: |
||
+ | # '''''あなたのページの一番上に''''' {{ic|<nowiki>[[Category:とあるカテゴリ]]</nowiki>}} を加えます。 |
||
− | |||
− | # 新しいページを作るために新しいタイトルが入った https://wiki.archlinux.org/index.php/My_New_Page をブラウズします (忘れずに "My_New_Page" を新しいタイトルに置き換えて下さい!) |
||
− | # '''''あなたのページの一番上に''''' {{ic|<nowiki>[[Category:Some Category]]</nowiki>}} を加えます。 |
||
{{Note|'''カテゴリがないページを作ってはいけません!'''全てのページは少なくとも1つのカテゴリに属している必要があります。適切なカテゴリが見つからない場合は、新しいカテゴリを作って下さい。}} |
{{Note|'''カテゴリがないページを作ってはいけません!'''全てのページは少なくとも1つのカテゴリに属している必要があります。適切なカテゴリが見つからない場合は、新しいカテゴリを作って下さい。}} |
||
+ | |||
+ | この段階では、新しいページはまだ[[特別:孤立しているページ|孤立している]]とみなされます。完了させるには、もう少し時間を取って他のページからの[[#リンク|リンク]]を追加してください。ページがより見つかりやすくなり、より多くのユーザーに貢献してもらうことができます。関連するソフトウェアのページ、より一般的な概要のページ、または[[アプリケーション一覧]]のようなシンプルなリストがリンク元の候補となるでしょう。 |
||
+ | |||
+ | いくつかのケースでは代わりに''サブページ''を作った方がよいこともあります。サブページは他のページの子となるページで、タイトルが親のページのタイトルと "/" (スラッシュ)の文字で分離されています。これは自分のユーザーページの子として下書きを準備するときにも便利です。例: {{canonicalurl:特別:利用者ページ/新しいサブページ}} |
||
==フォーマット== |
==フォーマット== |
||
− | テキストのフォーマットは可能な限り wiki のマークアップで行います; HTML を覚える必要はありません。また普遍的なフォーマットのために様々なテンプレートも用意されています。テンプレートについては |
+ | テキストのフォーマットは可能な限り wiki のマークアップで行います; HTML を覚える必要はありません。また普遍的なフォーマットのために様々なテンプレートも用意されています。テンプレートについては[[ヘルプ:テンプレート]]を見て下さい。[[ヘルプ:チートシート]]に一番重要なフォーマットオプションが要約されています。 |
===見出しと小見出し=== |
===見出しと小見出し=== |
||
− | 見出しと小見出しによって記事のまとまりを良くすることができます。別個のトピックが混ざっているなら、それぞれのセクションに見出しをつけて記事を分配できます。詳しい使い方は |
+ | 見出しと小見出しによって記事のまとまりを良くすることができます。別個のトピックが混ざっているなら、それぞれのセクションに見出しをつけて記事を分配できます。詳しい使い方は[[ヘルプ:スタイル#セクションの見出し]]や[[ヘルプ:効果的な見出し]]を見て下さい。 |
− | 見出しはセカンドレベルから |
+ | 見出しはセカンドレベルから始めなければいけません。以下のように作ることができます: |
==Second-level heading== |
==Second-level heading== |
||
109行目: | 121行目: | ||
{{Note|ファーストレベルの見出しは使えません、記事のタイトルのために予約されているからです。}} |
{{Note|ファーストレベルの見出しは使えません、記事のタイトルのために予約されているからです。}} |
||
− | 記事に4つ以上見出しが存在すると、自動的に目次 (table of contents, TOC) が作られます。これを消すには、{{ic|<nowiki>__NOTOC__</nowiki>}} を加えて下さい。TOC がどうなるかは |
+ | 記事に4つ以上見出しが存在すると、自動的に目次 (table of contents, TOC) が作られます。これを消すには、{{ic|<nowiki>__NOTOC__</nowiki>}} を加えて下さい。TOC がどうなるかは[[サンドボックス]]で試すことができます。 |
===改行=== |
===改行=== |
||
130行目: | 142行目: | ||
| |
| |
||
This is paragraph number one. |
This is paragraph number one. |
||
+ | |||
− | |||
This is paragraph number two. |
This is paragraph number two. |
||
| |
| |
||
148行目: | 160行目: | ||
|} |
|} |
||
− | 改行の使用については |
+ | 改行の使用については[[ヘルプ:スタイル/空白]]を見て下さい。 |
===太字と斜体=== |
===太字と斜体=== |
||
185行目: | 197行目: | ||
|} |
|} |
||
− | === |
+ | === リスト === |
− | {{Note|インデントを使うのは議論ページだけにするべきです、[http://en.wikipedia.org/wiki/Wikipedia:Indentation Wikipedia:Indentation] を見て下さい。}} |
||
− | |||
− | テキストをインデントするには、行頭にコロン ({{ic|:}}) を付けます。コロンをつければつけるほど、テキストが深くインデントされます。行を変えるとインデントは解除されます。 |
||
− | |||
− | {|border=1 width="79%" class="wikitable" |
||
− | !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. |
||
− | |- |
||
− | |} |
||
+ | wiki シンタックスは複数行のリストの項目をサポートしていません。改行の文字はリスト項目の定義を終了します。リスト項目の中で新しい行を始めるには、{{ic|<br>}} タグを使ってください。リスト項目の中に複数行のコードブロックを入れるには、 [[テンプレート:bc]] を使って、内容は {{ic|<nowiki>}} タグでエスケープしてください。[[ヘルプ:スタイル/空白]] や [[ヘルプ:テンプレート]] も参照してください。 |
||
− | === リスト === |
||
====箇条書き==== |
====箇条書き==== |
||
− | 箇条書きでは、項目にはっきりとした順序がありません |
+ | 箇条書きでは、項目にはっきりとした順序がありません。 |
+ | |||
+ | 条を加えるには、アスタリスク ({{ic|*}}) を使います。複数の {{ic|*}} を使えば階層を作れます。 |
||
{|border=1 width="79%" class="wikitable" |
{|border=1 width="79%" class="wikitable" |
||
213行目: | 210行目: | ||
|- |
|- |
||
| |
| |
||
− | * First item |
+ | * First item |
− | * Second item |
+ | * Second item |
** Sub-item |
** Sub-item |
||
− | * Third item |
+ | * Third item |
| |
| |
||
− | * First item |
+ | * First item |
− | * Second item |
+ | * Second item |
** Sub-item |
** Sub-item |
||
* Third item |
* Third item |
||
233行目: | 230行目: | ||
|- |
|- |
||
| |
| |
||
− | # First item |
+ | # First item |
− | # Second item |
+ | # Second item |
## Sub-item |
## Sub-item |
||
− | # Third item |
+ | # Third item |
| |
| |
||
# First item |
# First item |
||
294行目: | 291行目: | ||
|} |
|} |
||
− | 定義リストを単純にフォーマットのために使ってはいけません、[ |
+ | 定義リストを単純にフォーマットのために使ってはいけません、[https://www.w3.org/TR/html4/struct/lists.html#edef-DL W3's examples] を見て下さい。 |
+ | |||
+ | ===インデント=== |
||
+ | |||
+ | テキストをインデントするには、行頭にコロン ({{ic|:}}) を付けます。コロンをつければつけるほど、テキストが深くインデントされます。行を変えるとインデントは解除されます。 |
||
+ | |||
+ | {|border=1 width="79%" class="wikitable" |
||
+ | !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. |
||
+ | |- |
||
+ | |} |
||
+ | |||
+ | {{Note|望んだレイアウトにするためにどうしても必要なときだけインデントを使ってください。議論ページでは、返信をインデントするために使ってください。[[ヘルプ:議論]]を参照してください。}} |
||
===コード=== |
===コード=== |
||
− | wiki にコードを加えるには、[[ |
+ | wiki にコードを加えるには、[[ヘルプ:テンプレート#テンプレートのコードフォーマット|テンプレートのコードフォーマット]]の一つを使って下さい。または、単純に、それぞれの行の冒頭に半角スペースを一つずつ加えて下さい。例: |
+ | <span style="border:1px dashed #a9abb0;"> </span>$ echo Hello World |
||
− | [[Help:Style#Code formatting templates]] を見て下さい。 |
||
+ | |||
+ | [[ヘルプ:スタイル#コードのフォーマット]]も参照してください。 |
||
===表=== |
===表=== |
||
− | 効果的に使えば、表はデータをまとめるのに役立ちます。発展的な表の使い方については [[Wikipedia:Help:Table|Help:Table]] を見て下さい。 |
||
+ | {{Tip|自動的に表を生成するには [https://www.tablesgenerator.com/mediawiki_tables Mediawiki Tables Generator] を参照してください。}} |
||
− | {|border=1 width="79%" class="wikitable" |
||
+ | |||
− | !wikitext!!rendering |
||
+ | 効果的に使えば、表はデータをまとめるのに役立ちます。発展的な表の使い方については [[Wikipedia:ja:Help:表の作り方]] を見て下さい。 |
||
+ | |||
+ | {| width="79%" class="wikitable" |
||
+ | ! scope="col" width="50%" | wikitext |
||
+ | ! scope="col" width="50%" | rendering |
||
|- |
|- |
||
| |
| |
||
{{bc|<nowiki> |
{{bc|<nowiki> |
||
− | {| |
+ | {| class="wikitable" |
|+ Tabular data |
|+ Tabular data |
||
! Distro !! Color |
! Distro !! Color |
||
321行目: | 344行目: | ||
</nowiki>}} |
</nowiki>}} |
||
| |
| |
||
− | {| |
+ | {| class="wikitable" |
|+ Tabular data |
|+ Tabular data |
||
! Distro !! Color |
! Distro !! Color |
||
333行目: | 356行目: | ||
|- |
|- |
||
| |
| |
||
− | {{bc|<nowiki>{| class="wikitable |
+ | {{bc|<nowiki>{| class="wikitable" |
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on |
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on |
||
|- |
|- |
||
341行目: | 364行目: | ||
|}</nowiki>}} |
|}</nowiki>}} |
||
| |
| |
||
− | {| class="wikitable |
+ | {| class="wikitable" |
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on |
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on |
||
|- |
|- |
||
352行目: | 375行目: | ||
==リンク== |
==リンク== |
||
− | サイトのナビゲーションとしてリンクは読者にとって重要です。一般的に、編集者は全ての記事それぞれに他の記事に''出発する''リンクを配置するべきです ([[Special:DeadendPages| |
+ | サイトのナビゲーションとしてリンクは読者にとって重要です。一般的に、編集者は全ての記事それぞれに他の記事に''出発する''リンクを配置するべきです ([[Special:DeadendPages|行き止まりページ]]は作らないようにしてください)。そして他の記事から''到着する''ためのリンクを貼りましょう ([[Special:WhatLinksHere|リンク元]]ページでどこからリンクが貼られているか確認できます)。[[ヘルプ:スタイル/書式と記号#一番目の用例]] も参照してください。 |
===内部リンク=== |
===内部リンク=== |
||
− | 内部リンクを使うことで wiki のページを広くクロスリファレンスすることができます。 |
+ | 内部リンクを使うことで wiki のページを広くクロスリファレンスすることができます。同じ wiki 内の違うページへのリンクを作るには、単純にタイトルを2つの括弧で括って下さい。 |
− | |||
− | 同じ wiki 内の違うページへのリンクを作るには、単純にタイトルを2つの括弧で括って下さい。 |
||
例えば、[[pacman]] 記事にリンクを貼りたい場合: |
例えば、[[pacman]] 記事にリンクを貼りたい場合: |
||
<nowiki>[[pacman]]</nowiki> |
<nowiki>[[pacman]]</nowiki> |
||
+ | {{Note|リンク先のページが存在しない場合、[[赤いリンク]]として表示されます。[[ヘルプ:スタイル#ハイパーテキスト]] に従って回避する必要があります。}} |
||
− | 記事のタイトルとリンク文字を別にしたいときは、パイプ "|" の後にリンクにつける名前を加えて下さい ({{ic|Shift}} + {{ic|\}} on English-layout and similar keyboards)。 |
||
+ | |||
+ | 記事のタイトルとリンク文字を別にしたいときは、パイプ "|" の後にリンクにつける名前を加えて下さい。 |
||
例: |
例: |
||
− | + | The <nowiki>[[ArchWiki:About|ArchWiki]]</nowiki> is the primary documentation source for Arch Linux. |
|
上のリンクの表示例: |
上のリンクの表示例: |
||
+ | :The [[ArchWiki:About|ArchWiki]] is the primary documentation source for Arch Linux. |
||
− | :View [[Arch Linux|this]] article... |
||
+ | |||
+ | {{Tip|パイプ文字、あるいはバーティカルバー("{{!}}")は、英語キーボードやそれに似ているレイアウトでは {{ic|Shift+\}} で入力することができます。}} |
||
リンクに記事タイトルの複数形(などの接尾辞)を使いたい場合、直接、括弧の外側に文字を加えることができます。 |
リンクに記事タイトルの複数形(などの接尾辞)を使いたい場合、直接、括弧の外側に文字を加えることができます。 |
||
379行目: | 404行目: | ||
====ページのセクションへのリンク==== |
====ページのセクションへのリンク==== |
||
+ | |||
文章のセクションへのリンクを作るには、セクションの見出しの頭に {{ic|#}} を加えて下さい。 |
文章のセクションへのリンクを作るには、セクションの見出しの頭に {{ic|#}} を加えて下さい。 |
||
例: |
例: |
||
− | <nowiki>[[ |
+ | <nowiki>[[ヘルプ:編集#ページのセクションへのリンク]]</nowiki> |
上のリンクの表示例: |
上のリンクの表示例: |
||
− | :[[ |
+ | :[[ヘルプ:編集#ページのセクションへのリンク]] |
− | {{Tip|同じページ内のセクションにリンクする場合、ページ名は省略できます (例: {{ic|<nowiki>[[# |
+ | {{Tip|同じページ内のセクションにリンクする場合、ページ名は省略できます (例: {{ic|<nowiki>[[#ページのセクションへのリンク]]</nowiki>}})。}} |
+ | |||
+ | ==== パイプの裏技 ==== |
||
+ | |||
+ | いくつかのケースでは、[[Wikipedia:ja:Help:パイプ付きリンク#パイプの裏技|パイプの裏技]]を使って wiki リンクのラベルの指定を省略することができます。ArchWiki で使用可能な重要なケースは以下の通りです。 |
||
+ | |||
+ | # ページのタイトルでは、言語の接尾辞を隠すことができます。例えば、{{ic|<nowiki>[[Main page (Česky)|]]</nowiki>}} は [[en2:Main page (Česky)|Main page]] と表示されます。 |
||
+ | # 異なる名前空間や wiki へのリンクでは、接頭辞を隠すことができます。例えば、{{ic|<nowiki>[[ArchWiki:About|]]</nowiki>}} は [[ArchWiki:About|About]] と、{{ic|<nowiki>[[wikipedia:Help:Pipe trick|]]</nowiki>}} は [[wikipedia:Help:Pipe trick|Help:Pipe trick]] と表示されます。 |
||
+ | |||
+ | ページが保存されるとき、パイプの裏技はリンクに自動的にラベルを生成して、対応する wikitext を変更します。 |
||
===言語間リンク=== |
===言語間リンク=== |
||
− | [[ |
+ | [[ヘルプ:i18n#言語間リンク]] を見て下さい。 |
===wiki間リンク=== |
===wiki間リンク=== |
||
403行目: | 438行目: | ||
{{Note|パイプリンクは長い URL を略すために使って下さい。}} |
{{Note|パイプリンクは長い URL を略すために使って下さい。}} |
||
− | + | 参照: [[Wikipedia:Interwiki links]] |
|
+ | |||
+ | ArchWiki で有効なインターウィキのリストは [[特別:インターウィキ]] や [https://wiki.archlinux.org/api.php?action=query&meta=siteinfo&siprop=interwikimap API 経由] で確認することができます。 |
||
+ | |||
+ | {{Tip|デフォルトでは、全ての Wikipedia のページへのインターウィキリンクは英語版へのリンクと解釈されます。他の言語のページへのリンクを作りたい場合は、ページ名の前に言語の接頭辞を付けることができます。例えば、日本語のページへのリンクは {{ic|ja}} 接頭辞を付けてください。 |
||
+ | |||
+ | <nowiki>[[Wikipedia:ja:Arch Linux]]</nowiki> |
||
+ | |||
+ | [[Wikipedia:ja:Arch Linux]] と表示されます。 |
||
+ | |||
+ | 言語の接頭辞は、対象の wiki の [[en2:ArchWiki_talk:Administrators#Interwiki|interwiki configuration]] に依存することに注意してください。全ての wiki で機能するわけではありません。ただし、Wikipedia では機能します。}} |
||
===外部リンク=== |
===外部リンク=== |
||
外部サイトにリンクしたい場合、リンクしたいページの完全な URL を書けば十分です。 |
外部サイトにリンクしたい場合、リンクしたいページの完全な URL を書けば十分です。 |
||
− | <nowiki> |
+ | <nowiki>https://archlinux.org/</nowiki> |
− | URL をそのままリンクにするよりも、他の文字を表示したほうが見やすくなることはよくあります。括弧をつかって、URL の後ろに文字列を加えて下さい('''スペース'''で区切ります(パイプでは''ありません''))。[ |
+ | URL をそのままリンクにするよりも、他の文字を表示したほうが見やすくなることはよくあります。括弧をつかって、URL の後ろに文字列を加えて下さい('''スペース'''で区切ります(パイプでは''ありません''))。[https://archlinux.org/ Arch Linux] のようにリンクを表示するには: |
− | <nowiki>[ |
+ | <nowiki>[https://archlinux.org/ Arch Linux]</nowiki> |
+ | |||
+ | 自動で連番のラベルを生成することも可能です。単に一重の角括弧で URL を囲んでください。これは「[https://archlinux.org/ ここ]を参照してください」といった表現よりも好ましいことが多いです。「[https://archlinux.org/]を参照してください」といった表現(番号はページ内でのリンクの順番によって変わります)のように見せたいときは、単に以下のように入力してください。 |
||
+ | |||
+ | <nowiki>[https://archlinux.org/]を参照してください</nowiki> |
||
{{Note|ArchWiki や Wikipedia のページにリンクする時は、'''外部リンクではなく [[#内部リンク]] や [[#wiki間リンク]] を使って下さい!'''つまり、 https://wiki.archlinux.org/ で始まるリンクには'''内部リンクを使って下さい;''' http://en.wikipedia.org/ で始まるリンクには '''wiki間リンクを使って下さい!'''}} |
{{Note|ArchWiki や Wikipedia のページにリンクする時は、'''外部リンクではなく [[#内部リンク]] や [[#wiki間リンク]] を使って下さい!'''つまり、 https://wiki.archlinux.org/ で始まるリンクには'''内部リンクを使って下さい;''' http://en.wikipedia.org/ で始まるリンクには '''wiki間リンクを使って下さい!'''}} |
||
==リダイレクト== |
==リダイレクト== |
||
− | 違うページに自動的にリダイレクトさせるには、ページの冒頭に {{ic|<nowiki>#REDIRECT</nowiki>}} とリダイレクト先のページへの内部リンクを加えて下さい。 |
||
+ | 違うページに自動的にリダイレクトさせるには、ページの冒頭に {{ic|<nowiki>#redirect</nowiki>}} とリダイレクト先のページへの内部リンクを加えて下さい。 |
||
− | 例えば、"Cats" から "Cat" にリダイレクトさせたい場合: |
||
− | <nowiki>#REDIRECT [[Cat]]</nowiki> |
||
+ | 例えば、"Penguins" から "Penguin" にリダイレクトさせたい場合: |
||
− | これで、検索ボックスからどちらをタイピングした人も "Cat" に着くようになります。 |
||
+ | <nowiki>#redirect [[Penguin]]</nowiki> |
||
+ | これで、検索ボックスからどちらをタイピングした人も "Penguin" に着くようになります。 |
||
− | リダイレクトページのコンテンツは表示されません。しかし、カテゴリタグは機能するので、リダイレクトをカテゴリに含めることはできます。 |
||
+ | |||
+ | リダイレクトはリンクが作られた理由を追跡することもできます。例えばリンクを[[特別:リンク元|リンク元]]ページにまとめて、セクション名が変更されたときにそのリンクをすばやく更新することができます。リダイレクトの欠点は、ブラウザに完全なリンク先を表示しないことです。 |
||
+ | |||
+ | リダイレクトを作る前に、既存の同じようなリダイレクトを探すことができます。例: [https://wiki.archlinux.jp/index.php?title=特別:リンク元/Xorg&hidetrans=1&hidelinks=1 Xorg] |
||
+ | |||
+ | [[ヘルプ:スタイル#リダイレクトのページ]] や [[ヘルプ:操作手順#ページをリダイレクトした後の議論ページの扱い]] も参照してください。 |
||
+ | |||
+ | {{Note| |
||
+ | * 他のサイトにリダイレクトしないでください。 |
||
+ | * [[ヘルプ:カテゴリ|カテゴリページ]] ではリダイレクトは機能しません。 |
||
+ | * リダイレクトはサーバー内部で解決され、ページを開くのが遅くなることはありません。 |
||
+ | * 既存のページをリダイレクトさせると、[[特別:二重リダイレクト|二重リダイレクト]]を作ることがあります。修正するには [[ヘルプ:操作手順#二重リダイレクトを修正する]] を参照してください。 |
||
+ | }} |
||
==Wiki 変数・マジックワード・テンプレート== |
==Wiki 変数・マジックワード・テンプレート== |
||
− | MediaWiki は記事内の特定の文字列を認識して標準の振る舞いを変更します。例えば、{{ic|<nowiki>__NOTOC__</nowiki>}} を記事に加えると目次が作られなくなります。同じように、{{ic|<nowiki>__TOC__</nowiki>}} は目次を表示する位置を変えるのに使われます。詳しくは [ |
+ | MediaWiki は記事内の特定の文字列を認識して標準の振る舞いを変更します。例えば、{{ic|<nowiki>__NOTOC__</nowiki>}} を記事に加えると目次が作られなくなります。同じように、{{ic|<nowiki>__TOC__</nowiki>}} は目次を表示する位置を変えるのに使われます。詳しくは [[Wikipedia:ja:Help:マジックワード|ヘルプ:マジックワード]] を見て下さい。 |
テンプレートと変数は wikitext の一部として事前に定義されていてフォーマットされたコンテンツを表示するのに記事に挿入されます。 |
テンプレートと変数は wikitext の一部として事前に定義されていてフォーマットされたコンテンツを表示するのに記事に挿入されます。 |
||
− | 変数はシステムによって定義され、現在のページ・wiki・日付についての情報を表示するのに使われます。例えば、{{ic|<nowiki>{{SITENAME}}</nowiki>}} を使うと wiki のサイト名を表示します(この wiki では: '''''{{SITENAME}}''''')。現在のページに他のタイトルヘッダを設定するには、他の wiki 変数を使います: {{ic|<nowiki>{{DISPLAYTITLE:New Title}}</nowiki>}} (使用は大文字・小文字 |
+ | 変数はシステムによって定義され、現在のページ・wiki・日付についての情報を表示するのに使われます。例えば、{{ic|<nowiki>{{SITENAME}}</nowiki>}} を使うと wiki のサイト名を表示します(この wiki では: '''''{{SITENAME}}''''')。現在のページに他のタイトルヘッダを設定するには、他の wiki 変数を使います: {{ic|<nowiki>{{DISPLAYTITLE:New Title}}</nowiki>}} (しかし、その使用はかなり制限されています。大文字・小文字・アンダースコアを変更したい時だけ使用するようにしてください。標準化されたタイトルは実際のページの名前と一致していなければなりません。一致していなければ機能しません。タイトルの始めの文字を小文字で表示するには、{{ic|<nowiki>{{Lowercase title}}</nowiki>}} テンプレートを使ってください。) |
− | 一方、テンプレートは、ユーザによって定義されます。''どの''ページでも、{{ic|<nowiki>{{ |
+ | 一方、テンプレートは、ユーザによって定義されます。''どの''ページでも、{{ic|<nowiki>{{名前空間:ページ名}}</nowiki>}} を加えることで他のページを記事内に含めることができます。ただし ''Template'' 名前空間の外のページを使うのは稀です(名前空間が省かれる場合、''テンプレート'' を使います)。例えば、[[テンプレート:Note]] は記事内で次の wikitext によって用いられ: |
{{bc|<nowiki>{{Note|This is a note.}}</nowiki>}} |
{{bc|<nowiki>{{Note|This is a note.}}</nowiki>}} |
||
439行目: | 500行目: | ||
{{Note|This is a note.}} |
{{Note|This is a note.}} |
||
+ | 詳しくは[[ヘルプ:テンプレート]]を見て下さい。[[テンプレート:Tip]] や [[テンプレート:Warning]] といった利用可能なテンプレートの[[ヘルプ:テンプレート#テンプレート一覧|リスト]]があります。 |
||
− | 詳しくは [[Help:Template]] を見て下さい。 |
||
− | |||
− | ==議論ページ== |
||
− | 議論 ("talk") ページは他の ArchWiki ユーザーと連絡をするためのページです。 |
||
− | |||
− | ページを議論するには、そのページに行って、ページ上部の "discussion" タブをクリックしてください。ページの最後に新しいコメントを加えるか、他のコメントに返信をすることができます。あなたの議論をフォーマットするために[[#インデント|インデント]]を使って下さい。標準的な慣習として、あなたの返信は返信先の人より1段インデントしてください。さらに、他の人がやっているように、コメントは返信するコメントの下に加えて下さい。 |
||
− | |||
− | {{ic|<nowiki>~~~~</nowiki>}} でユーザー名とタイムスタンプを加えてコメントに署名をしましょう。他のユーザーのコメントを編集してはいけません。 |
||
− | |||
− | [[Talk:Sandbox|talk page of the Sandbox]] で実験することができます。 |
||
− | |||
− | ===ユーザートークページ=== |
||
− | ユーザーページとユーザートークページには違いがあります。全てのユーザーがユーザートークページを持ち、他の人がパブリックメッセージを残すことができます。トークページがあるユーザーになかった場合、あなたはコメントを残すためにページを作ることができます。誰かがあなたにメッセージを書いた時は、あなたは "You have new messages" の記述とあなたのユーザートークページへのリンクを見ることになるでしょう: この場合、あなたはメッセージに対して、適切なインデントを加えて、トークページに返信をするべきだと思います。別のトークページでの議論に返信することは避けてください、そのようにすると論題についての連絡したユーザーが持つ情報の流れを遮断してしまうことになります。 |
||
+ | {{TranslationStatus|Help:Editing|2022-03-22|719577}} |
||
− | 許可無く他人のユーザーページ (i.e. ''<nowiki>[[User:Name]]</nowiki>'') を編集してはいけません;それらはパーソナルスペースとして提供されているからです。連絡をとるには"ユーザー''トーク''ページ"を使って下さい(メールアドレスが記載されているならばEメールを送ることもできますが)。 |
2022年6月29日 (水) 09:43時点における最新版
ArchWiki は MediaWiki で動いています。MediaWiki は PHP によって書かれたフリーソフトウェアの wiki パッケージであり、本来は Wikipedia のためにデザインされました。より細かいヘルプは MediaWiki のヘルプ:コンテンツ や Wikipedia のヘルプ:目次 にあります。
このページは ArchWiki の編集についての簡単なチュートリアルです。ページを編集・作成する前に、ユーザーは、全体的な調子・レイアウト・存在しているページの文体に慣れるようにしてください。wiki 全体の一貫性が保たれるようにする配慮をお願いします。ArchWiki:貢献・ヘルプ:スタイル・ヘルプ:読み方に一般的な文体の決まりごとの概要が書かれています。より詳しくはヘルプ:スタイルを見て下さい。試しに編集するには、サンドボックスを使ってください。wiki マークアップの総覧はヘルプ:チートシートを見て下さい。
目次
アカウントの作成
ArchWiki のページを編集するためには、まずアカウントを作成する必要があります。captcha への回答は、最新の Arch Linux 環境が必要です。Arch Linux を使用していない場合でも自由にアカウントを作成して記事を編集できます。また、質問に答えるために例えば最新のインストールイメージから Arch のライブ環境を起動することや、pacman-staticAUR (事前にコンパイルされたバイナリ)、または単に Docker などのコンテナイメージ使用ツールを使うことができます。
アカウントを作成したら, 特別:ログイン からログインしてください。
編集
ページの編集を始めるには、ページ上部の編集タブをクリックします。又は、各セクションの右にある編集リンクをクリックすることで、ページの特定のセクションを編集することができます。表示される編集ページは、次のように構成されています:
- 編集ツールバー (任意)
- 編集ボックス
- 編集内容の要約ボックス
- 変更を保存 or ページを保存, プレビューを表示, 差分を表示, and 取り消し リンク
編集ボックスには現行版のページやセクションの wikitext (サーバーがウェブページを作るための編集可能なソースコード) が入っています。編集するには:
- 必要なだけ wikitext を修正します (詳しくは下の #フォーマット を見て下さい)。
- 編集内容の要約ボックスに編集の説明を書きます (例: "typo の修正"、"xyz に関する情報の追加" (詳しくは Help:要約欄 を読んで下さい))。
- プレビューを表示ボタンを使えば校正や保存する前のフォーマットの確認が楽にできます。
- その編集が表面的で議論の余地がない場合は、細部の編集 ボックスをチェックして、編集を 細部の編集 としてマークしてください。
- 変更を保存 をクリックして変更を保存します。不満足なら、代わりに 取り消し をクリック(もしくは満足いくまで編集を繰り替え)します。
編集の取り消し
ページを誤って編集してしまったときは、以下の作業でページを前の版にさし戻すことができます。ある1つの編集を戻すには:
- ページ上部の 履歴表示 タブ (編集 タブの隣) をクリックします。版の一覧が表示されます。
- 問題の編集の右の 取り消し リンクをクリックします。編集プレビューが表示され、左側に現在の版、右側に保存される文章が表示されます。
- 編集の要約欄に、編集を取り消す理由を書いてください。
- 満足したら、ページ下部の 変更を保存 ボタンをクリックして下さい。
その wiki ページは元の状態に戻ったはずです。
場合によっては、一度に複数の編集を戻す必要があるかもしれません。前の版に記事を戻すには:
- ページ上部の 履歴表示 タブ (編集 タブの隣)をクリックします。版の一覧が表示されます。
- 戻したい版(つまり最後の良い版)を見るために適切なタイムスタンプをクリックします。その版が表示されます。
- ページの一番上にある 編集 タブをクリックして下さい。警告が表示されます: 警告: このページの古い版を編集しています。
保存すると、この版以降になされた変更がすべて失われます。
- 編集の要約欄に、版のタイムスタンプ(ページの一番上に表示されています)とページの状態を戻す理由を書いてください。
- 満足したら、変更を保存 ボタンをクリックすればその版に revert されます。
ページの作成
新しいページを作る前に、以下の点を考えて下さい:
- あなたのトピックは Arch Linux に関係ありますか? 無関係な、役に立たない記事は削除されるでしょう。
- あなたのトピックは他の人にも役に立ちますか? あなたが書きたいことだけでなく、他の人が読みたいことも考えましょう。個人的な事柄はあなたの user ページに。
- あなたのトピックは新しいページにする価値がありますか? wiki に似たような記事がないか検索しましょう。もしあったなら、既に存在する記事に追記することを考えてみて下さい。
- あなたの貢献は意味をもつでしょうか? 後で拡張するつもりがないスタブを作るのは避けましょう。
新しいページを作るには タイトル と適切な カテゴリ を決める必要があります。
ヘルプ:記事命名ガイドラインやヘルプ:スタイル#タイトルに記事の名前をつけるときのアドバイスが書かれています。ページタイトルに "Arch Linux" やその変形を含んではいけません。ここは Arch Linux の wiki です、記事は Arch Linux に関係しているはずです。 (例: Installing Openbox; ダメな例 Installing Openbox in Arch Linux).
目次から適切なカテゴリを選びましょう。1つのページを複数のカテゴリに含めることもできます。
新しいページをあるカテゴリ (例: "新規ページ" を "とあるカテゴリ" へ) に追加するには:
- 新しいページを作るために新しいタイトルが入った https://wiki.archlinux.jp/index.php/%E6%96%B0%E8%A6%8F%E3%83%9A%E3%83%BC%E3%82%B8 をブラウズします (忘れずに "新規ページ" を新しいタイトルに置き換えて下さい!)
- あなたのページの一番上に
[[Category:とあるカテゴリ]]
を加えます。
この段階では、新しいページはまだ孤立しているとみなされます。完了させるには、もう少し時間を取って他のページからのリンクを追加してください。ページがより見つかりやすくなり、より多くのユーザーに貢献してもらうことができます。関連するソフトウェアのページ、より一般的な概要のページ、またはアプリケーション一覧のようなシンプルなリストがリンク元の候補となるでしょう。
いくつかのケースでは代わりにサブページを作った方がよいこともあります。サブページは他のページの子となるページで、タイトルが親のページのタイトルと "/" (スラッシュ)の文字で分離されています。これは自分のユーザーページの子として下書きを準備するときにも便利です。例: https://wiki.archlinux.jp/index.php/%E7%89%B9%E5%88%A5:%E5%88%A9%E7%94%A8%E8%80%85%E3%83%9A%E3%83%BC%E3%82%B8/%E6%96%B0%E3%81%97%E3%81%84%E3%82%B5%E3%83%96%E3%83%9A%E3%83%BC%E3%82%B8
フォーマット
テキストのフォーマットは可能な限り wiki のマークアップで行います; HTML を覚える必要はありません。また普遍的なフォーマットのために様々なテンプレートも用意されています。テンプレートについてはヘルプ:テンプレートを見て下さい。ヘルプ:チートシートに一番重要なフォーマットオプションが要約されています。
見出しと小見出し
見出しと小見出しによって記事のまとまりを良くすることができます。別個のトピックが混ざっているなら、それぞれのセクションに見出しをつけて記事を分配できます。詳しい使い方はヘルプ:スタイル#セクションの見出しやヘルプ:効果的な見出しを見て下さい。
見出しはセカンドレベルから始めなければいけません。以下のように作ることができます:
==Second-level heading== ===Third-level heading=== ====Fourth-level heading==== =====Fifth-level heading===== ======Sixth-level heading======
記事に4つ以上見出しが存在すると、自動的に目次 (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 |
ends the list |
改行の使用についてはヘルプ:スタイル/空白を見て下さい。
太字と斜体
太字と斜体は、それぞれ2つ・3つのアポストロフィー ('
) で単語やフレーズを囲むことで表示できます:
wikitext | rendering |
---|---|
|
斜体 |
|
太字 |
|
太字かつ斜体 |
取り消し線
すでに無効・不適切な文章には取り消し線を用います。
wikitext | rendering |
---|---|
<s>取り消し文章</s> |
|
リスト
wiki シンタックスは複数行のリストの項目をサポートしていません。改行の文字はリスト項目の定義を終了します。リスト項目の中で新しい行を始めるには、<br>
タグを使ってください。リスト項目の中に複数行のコードブロックを入れるには、 テンプレート:bc を使って、内容は <nowiki>
タグでエスケープしてください。ヘルプ:スタイル/空白 や ヘルプ:テンプレート も参照してください。
箇条書き
箇条書きでは、項目にはっきりとした順序がありません。
条を加えるには、アスタリスク (*
) を使います。複数の *
を使えば階層を作れます。
wikitext | rendering |
---|---|
* First item * Second item ** Sub-item * Third item |
|
番号付きリスト
番号付きリストはリストの項目に番号をふって順序を作ります。順番に意味がないのならば、普通は順序なしのリストを使って下さい。
番号付きリストを作るには、ナンバーサインかハッシュ記号 (#
) を使います。#
を複数使えば、階層を作れます。
wikitext | rendering |
---|---|
# First item # Second item ## Sub-item # Third item |
|
# First item # Second item #* Sub-item # 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:
or
|
Use additional colons if a definition has multiple definitions: ; Term : First definition : Second definition |
Use additional colons if a definition has multiple definitions:
|
定義リストを単純にフォーマットのために使ってはいけません、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.
|
コード
wiki にコードを加えるには、テンプレートのコードフォーマットの一つを使って下さい。または、単純に、それぞれの行の冒頭に半角スペースを一つずつ加えて下さい。例:
$ echo Hello World
ヘルプ:スタイル#コードのフォーマットも参照してください。
表
効果的に使えば、表はデータをまとめるのに役立ちます。発展的な表の使い方については Wikipedia:ja:Help:表の作り方 を見て下さい。
wikitext | rendering | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{| class="wikitable" |+ Tabular data ! Distro !! Color |- | Arch || Blue |- | Gentoo || Purple |- | Ubuntu || Orange |} |
| ||||||||||||||||||
{| class="wikitable" ! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on |- | rootfs || 922G || 463G || 413G || 53% || / |- | /dev || 1.9G || 0 || 1.9G || 0% || /dev |} |
|
リンク
サイトのナビゲーションとしてリンクは読者にとって重要です。一般的に、編集者は全ての記事それぞれに他の記事に出発するリンクを配置するべきです (行き止まりページは作らないようにしてください)。そして他の記事から到着するためのリンクを貼りましょう (リンク元ページでどこからリンクが貼られているか確認できます)。ヘルプ:スタイル/書式と記号#一番目の用例 も参照してください。
内部リンク
内部リンクを使うことで wiki のページを広くクロスリファレンスすることができます。同じ wiki 内の違うページへのリンクを作るには、単純にタイトルを2つの括弧で括って下さい。
例えば、pacman 記事にリンクを貼りたい場合:
[[pacman]]
記事のタイトルとリンク文字を別にしたいときは、パイプ "|" の後にリンクにつける名前を加えて下さい。
例:
The [[ArchWiki:About|ArchWiki]] is the primary documentation source for Arch Linux.
上のリンクの表示例:
- The ArchWiki is the primary documentation source for Arch Linux.
リンクに記事タイトルの複数形(などの接尾辞)を使いたい場合、直接、括弧の外側に文字を加えることができます。
例:
makepkg is used in conjunction with [[PKGBUILD]]s.
上のリンクの表示例:
- makepkg is used in conjunction with PKGBUILDs.
ページのセクションへのリンク
文章のセクションへのリンクを作るには、セクションの見出しの頭に #
を加えて下さい。
例:
[[ヘルプ:編集#ページのセクションへのリンク]]
上のリンクの表示例:
パイプの裏技
いくつかのケースでは、パイプの裏技を使って wiki リンクのラベルの指定を省略することができます。ArchWiki で使用可能な重要なケースは以下の通りです。
- ページのタイトルでは、言語の接尾辞を隠すことができます。例えば、
[[Main page (Česky)|]]
は Main page と表示されます。 - 異なる名前空間や wiki へのリンクでは、接頭辞を隠すことができます。例えば、
[[ArchWiki:About|]]
は About と、[[wikipedia:Help:Pipe trick|]]
は Help:Pipe trick と表示されます。
ページが保存されるとき、パイプの裏技はリンクに自動的にラベルを生成して、対応する wikitext を変更します。
言語間リンク
ヘルプ:i18n#言語間リンク を見て下さい。
wiki間リンク
いわゆる wiki間リンク は、Wikipedia などの、外部 Wiki の記事にリンクするために使われます。このリンクを貼るには、wiki の名前の後にコロン、そしてリンクしたい記事、それら全体をふたつの括弧で包みます。
Wikipedia:Arch Linux にリンクしたい場合:
[[Wikipedia:Arch Linux]]
Arch Linux Wikipedia article のようにリンク文字を変えるにはパイプを使います:
[[Wikipedia:Arch Linux|Arch Linux Wikipedia article]]
ArchWiki で有効なインターウィキのリストは 特別:インターウィキ や API 経由 で確認することができます。
外部リンク
外部サイトにリンクしたい場合、リンクしたいページの完全な URL を書けば十分です。
https://archlinux.org/
URL をそのままリンクにするよりも、他の文字を表示したほうが見やすくなることはよくあります。括弧をつかって、URL の後ろに文字列を加えて下さい(スペースで区切ります(パイプではありません))。Arch Linux のようにリンクを表示するには:
[https://archlinux.org/ Arch Linux]
自動で連番のラベルを生成することも可能です。単に一重の角括弧で URL を囲んでください。これは「ここを参照してください」といった表現よりも好ましいことが多いです。「[1]を参照してください」といった表現(番号はページ内でのリンクの順番によって変わります)のように見せたいときは、単に以下のように入力してください。
[https://archlinux.org/]を参照してください
リダイレクト
違うページに自動的にリダイレクトさせるには、ページの冒頭に #redirect
とリダイレクト先のページへの内部リンクを加えて下さい。
例えば、"Penguins" から "Penguin" にリダイレクトさせたい場合:
#redirect [[Penguin]]
これで、検索ボックスからどちらをタイピングした人も "Penguin" に着くようになります。
リダイレクトはリンクが作られた理由を追跡することもできます。例えばリンクをリンク元ページにまとめて、セクション名が変更されたときにそのリンクをすばやく更新することができます。リダイレクトの欠点は、ブラウザに完全なリンク先を表示しないことです。
リダイレクトを作る前に、既存の同じようなリダイレクトを探すことができます。例: Xorg
ヘルプ:スタイル#リダイレクトのページ や ヘルプ:操作手順#ページをリダイレクトした後の議論ページの扱い も参照してください。
Wiki 変数・マジックワード・テンプレート
MediaWiki は記事内の特定の文字列を認識して標準の振る舞いを変更します。例えば、__NOTOC__
を記事に加えると目次が作られなくなります。同じように、__TOC__
は目次を表示する位置を変えるのに使われます。詳しくは ヘルプ:マジックワード を見て下さい。
テンプレートと変数は wikitext の一部として事前に定義されていてフォーマットされたコンテンツを表示するのに記事に挿入されます。
変数はシステムによって定義され、現在のページ・wiki・日付についての情報を表示するのに使われます。例えば、{{SITENAME}}
を使うと wiki のサイト名を表示します(この wiki では: ArchWiki)。現在のページに他のタイトルヘッダを設定するには、他の wiki 変数を使います: {{DISPLAYTITLE:New Title}}
(しかし、その使用はかなり制限されています。大文字・小文字・アンダースコアを変更したい時だけ使用するようにしてください。標準化されたタイトルは実際のページの名前と一致していなければなりません。一致していなければ機能しません。タイトルの始めの文字を小文字で表示するには、{{Lowercase title}}
テンプレートを使ってください。)
一方、テンプレートは、ユーザによって定義されます。どのページでも、{{名前空間:ページ名}}
を加えることで他のページを記事内に含めることができます。ただし Template 名前空間の外のページを使うのは稀です(名前空間が省かれる場合、テンプレート を使います)。例えば、テンプレート:Note は記事内で次の wikitext によって用いられ:
{{Note|This is a note.}}
このように表示されます:
詳しくはヘルプ:テンプレートを見て下さい。テンプレート:Tip や テンプレート:Warning といった利用可能なテンプレートのリストがあります。