Wikipedia:スタイルマニュアル/Infobox

Infobox (インフォボックス)とは、通常記事の右上、デスクトップ版Wikipediaでは導入部の隣、モバイル版Wikipediaでは記事の導入部の最初の段落の後に表示されるパネルで、ページの主題に関する重要な情報を要約します。インフォボックスには画像や地図を含めることもできます。

Wikipediaのインフォボックスは、ほとんどの場合、テンプレートソフトウェア機能を使用しています。テンプレートには引数(パラメータ)があり、正しく動作させるには、テンプレートをページに挿入する際に引数値を指定する必要があります。これにより、各インフォボックスには記事の主題に関連する情報を表示することができ、各記事内での記述は最小限で済みます。

インフォボックスの目的は、記事に記載されている重要な事実を要約することであり、それらを置き換えるものではありません。以下に挙げる特定の例外を除き、記事はインフォボックスを無視して完結するべきです。インフォボックスに含まれる情報が少ないほど、その目的をより効果的に果たし、読者が重要な事実を一目で把握できるようになります。インフォボックスによっては、多くのフィールドを使用する必要がある場合もありますが、可能な限り簡潔な形式で情報を提示し、不要なコンテンツは排除する必要があります。記事内のセクション(節)へのリンクは避けてください。目次がその役割を果たします。

重要な専門情報をインフォボックスに掲載できるものの、本文に組み込むのが難しいという例外があります。例としては、{{Infobox Language}}のISO 639や類似のコード、{{Chembox}}のほとんどの引数などが挙げられます。

インフォボックスを使用すると、そのデータはDBペディアなどの第三者の再利用者に、多くの場合マイクロフォーマットを用いたきめ細かな機械可読形式で提供されます。インフォボックスはウィキデータからインポートしたデータ(例:Wikidataを使用したカテゴリ:インフォボックステンプレート)も表示できますが、インポートしたデータは日本版Wikipediaの方針に準拠している必要があります。

同じインフォボックスを使用する記事間では、全般的な一貫性を保つようにしてください。適切なガイドラインとして、正当な理由がない限り、デフォルトのインフォボックスのスタイルに余分な書式設定を追加しないようにしましょう。インフォボックスは、記事本文で一般的に使用されるよりも省略形が多くなる傾向があります。ノーブレークスペースの使用、Wikipedia:表記ガイド#数字 Wikipedia:表記ガイド#年月日・時間(数字と日付)、WP:COLOR(色の使用)といった一般的なガイドラインは特に重要です。ナビゲーションテンプレートと同様に、インフォボックスの目的は特定の情報への容易なアクセスを可能にすることであり、装飾的な外観を優先すべきではありません。

インフォボックスに画像を追加する際、サムネイルは使用しないでください。インフォボックステンプレートは、画像のフォーマットを支援するInfoboxImageモジュールを実装する必要があります。これにより、ファイル名を指定するだけで動作します。例えば、File:Image PlaceHolder.pngを使用する場合は、|image=Image PlaceHolder.pngと記述するだけです。キャプションは|caption=オプションで指定する必要があります。インフォボックスはそれぞれ異なるため、画像とキャプションに適切なパラメータについては、該当するインフォボックスのドキュメントを参照してください。

一貫性を保つために、以下のガイドラインが適用されます。

• 新しいインフォボックステンプレートを作成する前に、適切なインフォボックスが既に存在するかどうかを確認してください。
• テンプレートの名前は [[Template:Infobox ある主題]] とします(「ある主題」は通常の用法(記事名の付け方を参照)に従い、単数形で大文字で表記します。例:「Infobox settle」や「Infobox NFL player」など)。
• 新しいインフォボックスを作成するには、{{infobox}} テンプレートを使用します。
• テンプレートには、大きく太字のタイトル行が必要です。表題またはヘッダーを使用できます。タイトルは記事の主題の一般名にする必要がありますが、正式名(正式名)を含めても構いません。Wikipedia のタイトルと一致する必要はありませんが、{{PAGENAMEBASE}} を使用して代替タイトルとして使用しても通常は問題ありません。リンクを含めてはいけません。
• インフォボックス内の パラメータ は、以下の点に注意する必要があります。
  • 将来的な利用に備えて、番号ではなく名前を付けます。
  • 固有名詞でない限り、小文字を使用します。
  • インフォボックス間で一貫性を持たせます。例えば、{{Infobox 人物}}は、他の多くの経歴インフォボックスと同様に |birth_date= を使用します。そのため、新しい経歴インフォボックスで既存のパラメータ名を再利用せずに |date of birth= などを使用すると混乱を招く可能性があります。
  • スネークケース(例: |birth_date=)を使用してください。キャメルケース(例: |birthDate=)やタイトルケース(例: |BirthDate=)は使用しないでください。
  • スペースはアンダースコアで表してください。例: |birth_place= であって、|birth-place= や |birth place= ではありません。
• 地理座標系を使用するインフォボックスでは、パラメータ名として |coordinates=を使用し、パラメータ値には {{coord}}テンプレートを含める必要があります。
• パラメータが該当しない、または情報が利用できない場合は、空白のままにして、テンプレートをコーディングして、情報を選択的に非表示にするか、定義されていないパラメータのデフォルト値を提供する必要があります。

特定の種類の記事について、利用可能な要約情報に不整合が生じる要因はいくつかあります。

デザインの不整合

インフォボックス、特に同じカテゴリーの記事のインフォボックスフォークは、関連するインフォボックスと、特にレイアウト、色、構造に関して、一貫性のある外観を維持する必要があります。例えば、読者はロンドンの記事とニューヨークの記事を閲覧する際に、ある程度の類似性を期待します(驚き最小の原則)。

歴史的不完全性

特定の情報は、時間の経過とともに失われている可能性があります。例えば、現代の銀行を説明するインフォボックスは、中世の銀行では提供されていない特定の財務情報を提供している場合があります。

階層構造の不整合

階層関係を示すインフォボックスは、記事の主題が階層構造のどこに位置しているかによって、微妙に異なる要件を持つ場合があります。例えば、法人に関するインフォボックスは、親会社を説明し子会社を示す記事と、子会社を説明し親会社を示す記事とで内容が異なります。 ; 機能の不一致

単一のセット内の項目には、インフォボックスに一般的に記載されるオプション機能が含まれている場合があります。例えば、大学に関する記事のインフォボックスにはモットーが含まれている場合がありますが、すべての大学がモットーを掲載しているわけではありません。

情報不足

アルバムや映画のプロデューサーなど、インフォボックス内の項目の中には、すぐには入手できない、あるいは全く入手できないものがあります。このような場合は、入手可能な情報を提供し、入手できない可能性のあるフィールドは非表示にするのが適切です。

任意フィールドが利用可能だからといって、すべてのフィールドを任意にすべきだということや、インフォボックステンプレートのレイアウトや使いやすさを無視して、あまり使用されないフィールドを大量に追加すべきということではありません。場合によっては、フィールドのマークアップは、表示されていない場合でもダウンロードする必要があります。無関係なフィールドを多数含む、過度に長いテンプレートを作成することは推奨されません。

インフォボックステンプレートを設計する際には、以下の質問を検討してください。

フィールドは価値があるか?:インフォボックスを使用する記事にとって、そのフィールドはどの程度重要ですか?要約情報ですか?それとも、記事本文に記述した方がよい詳細な情報ですか?

フィールドは、インフォボックスを使用する多くの記事に関連しますか?:フィールドに関連する記事が非常に少ない場合は、おそらく含めるべきではありません。逆に、非常に一般的なフィールドは、たとえ対象記事の一部には該当しない場合でも、テンプレートに含めて任意にすることができます。

{{Infobox 航空機}}のようにインフォボックスに航空機の性能を網羅するように記入することは過剰として、{{航空機スペック}}と分けて使用することをプロジェクト:航空で議論されました。

フィールドが空になる可能性はどのくらいですか?

空になっても問題ないフィールドは、おそらくオプションにすべきです。しかし、通常空になっているフィールドは、特に有用であったり関連性があったりしないかもしれません。

フィールド名は他の場所から再利用できますか?

例えば、人物の死亡日を入力するフィールドを伝記インフォボックステンプレートに追加する場合は、{{Infobox 人物}} の |death_date= を使用し、|date_of_death= や |died= のような類似した名前は使用しないでください。

フィールドは人物、場所、または組織に関するものですか?

その場合は、hCard マイクロフォーマットを含めてください。

フィールドは日付が指定されたイベントに関するものですか?

(レコードのリリースやスポーツの試合など) その場合は、hCalendar マイクロフォーマットを含めてください。

地理的項目(例:都市や国)のインフォボックスには、通常、記事のタイトルを先頭に置きますが、正式名称(例:モンテネグロ の「モンテネグロ共和国」)を代用することもできます。記事のタイトルが曖昧でない場合は、主題が明確であれば、平易な名称をインフォボックスの先頭に置けます(例:サンパウロ州 の「サンパウロ」)。必要に応じて、別名や現地名をその下に表示することもできます。アウグスブルク のように、詳細な歴史的名称は、2つ目のインフォボックスに置く方がよい場合が多いです。

理論上は、インフォボックス内のフィールドは、それを使用するすべての記事で一貫しているべきです。しかし、実際には、いくつかの理由から、そうであることはほとんどありません。インフォボックスのテンプレートは、特定のフィールドの有無に応じて動的に適応するように設計する必要があります。

静的インフォボックスと同様に、インフォボックスは記事の主題に関する概要情報を提示するために設計されており、類似の主題は統一された外観と共通のフォーマットで表示されます。しかし、テンプレート技術により、テンプレートページという中心的な場所からスタイルと共通テキストを更新できます。

動的なインフォボックスには、複数の(フォークされた)テンプレートを使用する、フィールドを空白のままにするなど、いくつかの代替手段がありますが、いくつかの理由から避けるべきです。

読者の数が編集者の数をはるかに上回っている:考慮すべき最も重要なグループは、Wikipediaを頻繁に読む読者であり、彼らは大規模な編集を行うことはありません。多くの空白フィールド、疑問符、または「不明」を含むインフォボックステンプレートは、プロフェッショナルな印象を与えません。

記事編集者の数がテンプレート編集者の数をはるかに上回っている:平均的な編集者は、テンプレートに変更を加えることなくそのまま使用します。開発者にとって物事を楽にするために、開発者が熟知しなければならないさまざまなテンプレートの数を最小限に抑えることを目指す必要があります。したがって、テンプレートのフォークを複数作成することは望ましくありません。

新しいインフォボックスを設計する前に、その要件を評価しましょう。新しいインフォボックスを開発する際には、以下の点に留意する必要があります。

1. 十分かつ適切な個別パラメータ
2. 既存のインフォボックスでは対応できない機能
3. 既存のインフォボックスのラッパーを作成しても対応できない機能

Template:Infobox をベースに新しいインフォボックステンプレートを作成することで、デザイナーはどのフィールドを含めるかに集中できます。デフォルトのスタイル設定や、記事内で特定のフィールドに値が設定されていない行の表示を抑制するといった機能は自動的に処理されます。

パーサー関数を使用すると、1つ以上のテンプレートパラメータの値に基づいて、インフォボックス内の特定のコンテンツ(表の行など)を個別に表示または非表示にすることができます。

例えば、あるパラメータは、別のパラメータが存在する場合にのみ表示されるように設計できます。画像が存在する場合にのみキャプションを表示する単純なテストは、次のようになります。

| caption = {{#if:{{{image|}}}|{{{caption|}}} }}

いくつかのサブテンプレート(および独立したテンプレート)には、共通のプレフィックスが付けられています。これらのテンプレートは、特定のパラメータの値に基づいてインフォボックスに含まれ、このパラメータが名前のサフィックスとして機能します。例えば、{{Infobox Ship/Military}}}>と{{Infobox Ship/Civilian}}}>を作成し、{{Infobox Ship/{{{type}}}}>を使用します。記事内で|type=Militaryを使用すると、{{Infobox Ship/Military}}}>が使用されます。

各フィールドが 1 つのテンプレートのパラメータに対応するのではなく、インフォボックスは各フィールドの個別のサブテンプレートで構成されます。たとえば、Template:Taxobox を参照してください。

テンプレートはモジュール方式で設計できるため、様々な組み合わせが可能です。組み合わせは、ページ上に単一のインフォボックスとして表示されることもあります。

例えば、聖人伝グループが静的インフォボックスをベースにテンプレートを設計したい場合、Template:Infobox 人物を使用し、追加情報のみを含むプロジェクト固有のテンプレートを設計することで、両方のページが「重ねて」表示されます。

インフォボックスは、どの記事においても必須でも禁止でもありません。インフォボックスを含めるか、どのインフォボックスを含めるか、そしてインフォボックスのどの部分を使用するかは、各記事の編集者による議論と合意によって決定されます。

インフォボックスの各部分に与えられる意味は、そのインフォボックスの種類において同一であるべきです。例えば、あるインフォボックスの種類において、項目の一つが「体重」と呼ばれている場合、この項目を「出生時体重」と「成人時体重」のどちらか一方に使うのは不適切です。

各インフォボックスの種類には、各部分/項目の使用方法を説明する文書が必要です。

ナビゲーションテンプレートと同様に、インフォボックスには一般的に旗アイコンを含めるべきではありません。旗アイコンに関する詳細と、一般的なガイドラインの例外については、Wikipedia:アイコン#インフォボックスにおける旗アイコンの扱いを参照してください。

出典は場合によっては許容されますが、内容が他の場所で繰り返されている(または引用されている)場合、または情報が明白な場合は、インフォボックスでは通常不要です。資料に参照が必要であり(Wikipedia:出典を明記する/個別参照法を参照)、かつ情報が記事本文にも記載されていない場合は、参照をインフォボックスに含める必要があります。ただし、編集者はまず記事本文にその事実を記載することを検討する必要があります。

Wikipediaコミュニティは、伝記情報ボックスでの|民族=パラメータの使用を許可しないことを決定しました。

Wikipediaコミュニティは、一般的なインフォボックス伝記における|宗教=パラメータの使用を許可しないことを決定しました。このようなパラメータは、宗教がその著名さの不可欠な要素である人物の分類に関連するインフォボックス、例えば{{Infobox clergy}}にのみ記載されるべきです。

人物伝では、|国籍=フィールドは使用すべきではありません。以前は国籍に使用できましたが、ナショナル・アイデンティティや民族性と混同されることが多かったためです。

|citizenship= フィールドは、以下のガイドラインに従って使用できます。

• 出生国から推測できる場合は省略します(ほとんどの場合)。
  • これには、「出生地主義」出生権のある国とない国の両方が含まれます。例えば、ノルウェーで生まれた人はノルウェー国民であると読者が想定できるようにし、既知の例外を文書化します。
  • これには、主権の変更(例:植民地の独立)により市民権が変更されるが、出生時の市民権のみに依存するグループの変更も含まれます。
  • 「birth_place」フィールドに出生国が表示されていること(リンク先としてだけでなく)を確認し、生年月日に基づいて時代錯誤にならないようにしてください。
• 民族や国民のアイデンティティには使用しないでください。
• 市民権または国籍は、二重国籍、帰化、または一般的なケースからの例外の場合は記載できます。
• 誤った推測を避けるため、市民権と国籍法に注意してください。
• 特に存命人物の伝記については、インライン引用を含め、信頼できる情報源を使用してください。
• 国名(例:「キューバ」)または説明記事にリンクされた法的分類(例:「英国海外市民」)を使用し、愛称(例:「キューバ人」や「アメリカ人」)は使用しないでください。「アメリカ合衆国」または「米国」または「US」を使用し、「USA」は使用しないでください。
• 市民権の権利が地域によって異なる場合は、地域を明記してください。例:「イギリス海外領土市民 (バミューダ諸島)」。
• 非市民の国籍は、法的地位を明示的に指定することで示します。例:"citizenship=British subject (マサチューセッツ湾)" または "citizenship=United States national (アメリカ領サモア)"
• 以前の値を省略せず、特定の地位をいつ取得したかを説明する簡潔な文脈を追加してください。例:
  • "Germany (until 1945), United States (since 1945)"
• 複雑な場合は、情報ボックスから省略し、記事本文で説明してください。

法的国籍を示す必要がある場合は、ethnicity との混同を避けるため、「nationality」ではなく「national of」を使用してください。

|母校=パラメータは、|教育=パラメータのより簡潔な代替手段であり(追加ではなく)、多くの場合、最後に在籍した高等教育機関(中等学校ではない)のリンク名で構成されます。通常、大学を卒業していない人の場合、どちらのパラメータも含める必要はありませんが、記事のトークページでは、ハーバード大学を中退してマイクロソフトを設立したビル・ゲイツのように、異なる結論に至る可能性があります。

• インフォボックス
• Help:システムメッセージ – ウェブインターフェースボックスに表示されるメッセージ。
• Wikipedia:主要なテンプレート