「ヘルプ:効果的な見出し」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(TranslationStatus を末尾に移動)
 
(同じ利用者による、間の19版が非表示)
9行目: 9行目:
 
{{Related|ヘルプ:スタイル}}
 
{{Related|ヘルプ:スタイル}}
 
{{Related articles end}}
 
{{Related articles end}}
 
 
この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。
 
この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。
   
40行目: 39行目:
 
==== パラグラフをサブトピックにまとめる ====
 
==== パラグラフをサブトピックにまとめる ====
   
  +
ほとんどの場合、ページはただ1つのトピックだけにとどまらず、主要なトピックを説明して拡大するために、関連するトピックに''寄り道する''必要があるでしょう。そのような寄り道は、読者が全体をざっと読むときには混乱を招くかもしれません。そのため、そのような寄り道を知らせる必要があります。
Most of the time, your article will not treat just one topic, and you will need to ''visit'' some more or less related topics in order to explain and expand your main topic. Such visits may be confusing when a reader is trying to scan through the article. Therefore, you need to signal for such deviations.
 
   
 
==== 重要な部分を目立たせる ====
 
==== 重要な部分を目立たせる ====
   
  +
時々、読者はページの中で特に興味のある部分を探すため、目次だけを見たいかもしれません。見出しだけを見るかもしれません。どちらの場合も、明確に書かれた見出しはページの重要なセクションを見つけるのに役立ちます。さらに、目次は自動で生成され、ページ内のヘディングをリストアップします。
Sometimes, readers just want to look through the table of contents (TOC) in order to identify parts of the article that are of special interest. They may also do so by looking at the headers themselves. In both cases, clearly defined headers serve the purpose of quick identification of important sections of your article. Moreover, TOC is created by automatically listing the headings in your article.
 
   
 
=== 見出しと目次 ===
 
=== 見出しと目次 ===
   
  +
ページの目次は、2つ以上の見出しがあるときに自動で生成されます。目次を隠すには、ページのどこかに次のコードの行を追加する必要があります。
A table of contents for an article is created automatically when more than two headers are defined. In order to hide the TOC, you may include a line with the following code anywhere in your article:
 
   
 
<nowiki>__NOTOC__</nowiki>
 
<nowiki>__NOTOC__</nowiki>
54行目: 53行目:
 
== 見出しのレベルについて ==
 
== 見出しのレベルについて ==
   
  +
ヘディングのレベルについて、いくつか重要なことがあります。
There are some important things to note when talking about heading levels.
 
   
 
=== 重要性が等価なら同じレベルの見出しを使う ===
 
=== 重要性が等価なら同じレベルの見出しを使う ===
   
  +
これは文字通りだと思うかもしれませんが、見た目ほど簡単ではありません。次の例を見てください。
This may sound self-explanatory, but it is not quite as straightforward as it seems. Consider this example:
 
   
 
*Introduction
 
*Introduction
69行目: 68行目:
 
*Conclusions
 
*Conclusions
   
  +
このリストを慎重に分析すると、ステップ2から4はステップ1と6よりも重要性が低く、ステップ5は最も重要性が低いことに気付くでしょう。これらのステップが他のステップよりもテキストの量が多い・少ないということを言っているのではありません。重要なのは概念として重要かどうかです。
If you carefully analyze this list, you will notice that steps 2 to 4 are actually of less significance than steps 1 and 6, and that step 5 is of least significance. This is not to say that all those steps have more or less text than the others. It is the conceptual significance that is important.
 
   
  +
これを修正するには、以下のように変更します。
To amend this, we will modify the headings like so:
 
   
 
*Introduction
 
*Introduction
83行目: 82行目:
 
*Conclusions
 
*Conclusions
   
  +
ご覧の通り、ステップ2から4を ''Configuring X'' というタイトルのヘディングに統合して、ヘディングを3つのサブヘディングに分割しました。さらに、ステップ5をステップ2cに移動して、サブヘディングに変更しました。
As you can see, we have merged steps 2 to 4 into a single heading titled ''Configuring X'', and divided the heading into 3 subheadings. Also, we have attached the step 5 to step 2c, and turned it into a subheading.
 
   
  +
=== 一番高いレベルのヘディングは常に最高レベルにする ===
=== Top level headings should always be of highest level ===
 
   
  +
これも常識のように聞こえるかもしれませんが、1つの小さい問題があります。見出しにはフォーマットスタイルが当てられます。多くの人はそのフォーマットのルールをページの見た目を変えるために使ってしまいます。これは壊れたヘディングの構造を作ります。
This may also sound like common sense, but there is one little problem. The headers have formatting style associated with them. Many people use those associated formatting rules to manipulate how their article looks. This in turns yield a broken heading structure.
 
   
  +
次の例を見てください。
Let us take a look at this example:
 
   
 
*Introduction
 
*Introduction
97行目: 96行目:
 
**Conclusion
 
**Conclusion
   
  +
このページの編集者は、レベル1のヘディングは ''Conclusion'' のような重要ではないセクションには大きすぎると思い、レベル2のヘディングを使う方がいいと考えました。これは最後のセクションが他のセクションより1レベル下であるヘディング構造の結果となります。正しい構造は以下のようになるでしょう。
The author of the article thought level 1 headings was too large for such an unimportant section like ''Conclusion'' and it would be a better idea to use level 2 headings. This results in a heading structure that has the last section one level below the other sections. The correct structure would be:
 
   
 
*Introduction
 
*Introduction
105行目: 104行目:
 
*Conclusion
 
*Conclusion
   
  +
conclusion は他のセクションと同じレベルになりました。
The conclusion is now in line with the rest of the article.
 
   
  +
{{Note|''Introduction'' や ''Conclusion'' といったセクションがページのメインと同じ重要性を持つことは奇妙に映るかもしれませんが、そのようなセクションは実際重要です。ページの最後に(このような)ノートを追加したり、うまくまとまっていない・欠けているセクションを完全に除外したりして、セクションを見た目の問題のためだけに低いレベルに降格することを避けた方がよいです。}}
{{Note|It may seem somewhat awkward that sections like ''Introduction'' or ''Conclusion'' are given same importance as the main article, but those sections are in fact important. It is always better to add a note (one like this) at the end of the article, or completely exclude poorly formulated or lacking sections than to demote them into lower level headings and break the article's logical structure for the sake of aesthetic issues.}}
 
   
  +
== ヘディング構造のタイプ ==
== Types of heading structures ==
 
   
  +
使われているレベルの種類と目的に基づいて、ヘディング構造は以下のようなカテゴリに分類されます。
Based on the number of levels used and their purpose, heading structure may be divided into following categories:
 
   
  +
#1レベルだけの構造
#Single-level structure
 
  +
#間違った複数レベルの構造
#False multi-level structure
 
  +
#複数レベルの構造
#Multi-level structure
 
   
=== Single-level structure ===
+
=== 1レベルだけの構造 ===
   
  +
ページを編集するとき、一番率直な方法は複数のステップに分割することです。ステップは実際のステップである必要はなく、何か読者が取る必要のあるステップです。あるいは、編集者がページを書いていくときに取るステップかもしれません。どの場合も、ステップは連続していて、1レベルだけの構造になります。
When writing an article, the most straightforward way is to divide it into steps. Those steps may not necessarily be real steps, something that readers need to take. They may be steps that a writer takes in developing his article. In any case, those steps follow one another and are arranged in a single-level structure.
 
   
  +
このような種類のページの典型的な構成は以下のようになるでしょう。
A typical setup of this kind may look like this:
 
   
 
*Introduction
 
*Introduction
129行目: 128行目:
 
*Further reading
 
*Further reading
   
  +
これはシンプルな3つのステップの導入と、参照できるリンクです。
This is what a simple 3-step HOWTO with introduction and references may look.
 
   
  +
=== 間違った複数レベルの構造 ===
=== False multi-level structure ===
 
   
  +
時には、シンプルで連続した1レベルだけの構造から外れる必要があります。
Sometimes, there is a need to deviate from the simple and flowing single-level structure.
 
   
==== Side-note ====
+
==== ノート ====
   
  +
通常、何かを詳しく述べるためにメインの流れから少し外れる必要があるでしょう。
Usually, you need to deviate shortly from the main flow to elaborate on something.
 
   
 
*Introduction
 
*Introduction
146行目: 145行目:
 
*Further reading
 
*Further reading
   
  +
このような方法の代わりに、ノートやコメントを [[テンプレート:Note|ノートテンプレート]] で追加することを検討してください。
Consider this an alternative to adding notes and comments via the [[Template:Note|Note template]].
 
   
==== Mark auxiliary information ====
+
==== 補助の情報を強調する ====
   
  +
メインの議論への追加の議論となる部分や、メインの議論を他の方法で強化するなどの重要な部分に印を付けたくなるかもしれません。
Maybe you want to add a marker to some important part that acts as a additional argument to main discussion, or enhances the main discussion in some other way.
 
   
 
*Introduction
 
*Introduction
161行目: 160行目:
 
*Further reading
 
*Further reading
   
=== Multi-level structure ===
+
=== 複数レベルの構造 ===
   
  +
複数レベルの構造は長くて詳細なページに典型的です。しかし、短いハウツーにも効果的に使えるかもしれません。
Multi-level structure is typical of longer, more in-depth articles. However, it may also be effectively used in shorter HOWTOs.
 
   
  +
複数レベルの構造が便利ないくつかのケースを紹介します。
Here are some cases when a multi-level structure may come in handy.
 
   
  +
{{Note|ここではヘディングレベルの親子関係について記述していることと、親のレベルが1, 2, 3 であることは重要ではないことに注意してください。同じことは2か''より多くの''レベルを持つ複数レベルの構造にも適用できます。}}
{{Note|Keep in mind that we are describing parent-child relationships of heading levels, and that it is not important if the parent is level 1, or 2, or 3. The same applies to all multi-level structures that have 2 ''or more'' levels.}}
 
   
==== Group arguments together ====
+
==== 議論をグループ化する ====
   
  +
サブヘディングは、ヘディングがページ全体に対してどんな役割をするかのメインのヘディングになることができます。
Subheadings can be to main headings what headings are to the entire article.
 
   
  +
次のような例があります。
An example:
 
   
 
*Introduction
 
*Introduction
184行目: 183行目:
 
*Further reading
 
*Further reading
   
==== Alternative arguments ====
+
==== 代わりの議論 ====
   
  +
時には、議論の対象について読者に異なる視点を与える必要があります。
Sometimes, you need to give your readers a few different angles on a subject.
 
   
  +
次のような例があります。
For example:
 
   
 
*Introduction
 
*Introduction
198行目: 197行目:
 
*Further reading
 
*Further reading
   
==== Contradictory argument ====
+
==== 反対の議論 ====
   
  +
否定的な議論について記述する必要があるのであれば、それぞれにサブヘディングを作ることができます。
If you need to talk about opposing arguments, you may give each party a subheading of its own.
 
   
  +
具体的には以下のようになります。
For instance:
 
   
 
*Introduction
 
*Introduction
214行目: 213行目:
 
== 見出しの文章 ==
 
== 見出しの文章 ==
   
  +
ここではいくつかの鍵となる点をまとめました。より詳細な情報は、[[ヘルプ:記事命名ガイドライン]]を参照してください。ここに挙げられているものは見出しのテキストとページ名の両方に当てはまります。
We will summarize some of the key points here, and if you want a more detailed account, you may read [[ヘルプ:記事命名ガイドライン]]. The rules listed here apply to both header texts and article names.
 
   
  +
* 見出しのテキストはできるだけ具体的で、ヘディングのスコープを反映するようにする
* Header texts should be as specific as possible, and they should reflect the heading's scope
 
  +
* 見出しのテキストはヘディングを将来拡張することができるように一般的にするようにする
* Header texts should be general enough to allow for future enhancement of headings
 
* Header texts should be as short as possible (also see [[ヘルプ:記事命名ガイドライン]])
+
* 見出しのテキストはできるだけ短くする([[ヘルプ:記事命名ガイドライン]]を参照)
   
 
== フォーマット ==
 
== フォーマット ==
   
  +
既に述べたように、見た目のために見出しのフォーマットスタイルを濫用''しないこと''はとても重要です。見た目が気に入らないなら、[[ArchWiki:管理者|管理者に連絡]]して意見を聞くか、ヘディング構造を維持する方法での状況の解決を依頼してください。
As we already noted, it is crucial ''not'' to abuse header formatting styles to beautify your articles. If you do not like what you see, [[ArchWiki:管理者|contact the admins or sysops]] and ask for their opinion, or offer to fix the situation in a manner that would not compromise the heading structures.
 
   
  +
テキストをヘディングにするには、2つかそれ以上のイコール記号({{ic|1===}})を使わなければいけません。
To mark some text as a heading, two or more equal signs ({{ic|1===}}) must be used.
 
   
  +
{{Note|使用可能な一番低いレベルのヘディングレベルは実際は1({{ic|1==}})ですが、ページのタイトルのために''予約''されています。ページのセクションはレベル2から始めなければいけません。}}
{{Note|The lowest-supported heading level would actually be 1 ({{ic|1==}}), but its formatting is '''reserved''' for article titles: article sections must always start from level 2.}}
 
   
  +
見出しを示すコードは以下の通りです。
Here is the code for marking headers:
 
   
 
==Header level 2==
 
==Header level 2==
236行目: 235行目:
 
======Header level 6======
 
======Header level 6======
   
  +
見出しがどのように表示されるか見たいのであれば、[[サンドボックス]]を使うことができます。
If you want to see how these are formatted, you may use the [[Sandbox]].
 
  +
  +
{{TranslationStatus|Help:Effective use of headers|2020-04-10|605265}}

2022年1月1日 (土) 12:16時点における最新版

関連記事

この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。

この記事を読むのに wiki ページを編集する方法を知る必要はありません。技術的な編集ハウツーよりも、もっと全般的なスタイルガイドです。

記事の見出しについて

見出しは新しいセクションの始まりを示します。セクションはツリーの形で、他のセクションの中に配置することができます。セクションの構造を反映させるために、見出しは複数の書き方があります。セクションとその対応する見出しは、他のセクションとの相対的な位置によってレベル分けされます。

この記事で使用する用語

他のセクションに含まれているセクションは、そのコンテナ(または)よりも低レベルと呼ばれます。つまり親は高レベルということです。

それぞれの見出しと、同じレベルの次の見出しまでを表わすテキストは、ヘディングと呼ばれます。

ヘディングはツリーの中でのレベルを表現する番号を持っています。高いレベルのヘディングは小さい番号で、その逆も同じです。例えば、ArchWiki でのページのタイトルはヘディングレベル1です。

見出しの使用

見出しとヘディングはいくつかの重要な目的のために使われます。

  • より情報を吸収できるように読者の読む速度を下げる
  • ページの一部を論理的なグループにまとめる
  • 重要なテキストであることを示す

読者の足を止めさせる

読者にトピックを導入するとき、短いページでも読むのにある程度の時間が必要であることを知っている必要があります。見出しは、それに続くセクションを読む前に読者の読む速度を下げる緩衝材として機能します。これにより、読者に内容について考え、続くテキストを読む準備をさせることができます。

パラグラフをサブトピックにまとめる

ほとんどの場合、ページはただ1つのトピックだけにとどまらず、主要なトピックを説明して拡大するために、関連するトピックに寄り道する必要があるでしょう。そのような寄り道は、読者が全体をざっと読むときには混乱を招くかもしれません。そのため、そのような寄り道を知らせる必要があります。

重要な部分を目立たせる

時々、読者はページの中で特に興味のある部分を探すため、目次だけを見たいかもしれません。見出しだけを見るかもしれません。どちらの場合も、明確に書かれた見出しはページの重要なセクションを見つけるのに役立ちます。さらに、目次は自動で生成され、ページ内のヘディングをリストアップします。

見出しと目次

ページの目次は、2つ以上の見出しがあるときに自動で生成されます。目次を隠すには、ページのどこかに次のコードの行を追加する必要があります。

__NOTOC__

見出しのレベルについて

ヘディングのレベルについて、いくつか重要なことがあります。

重要性が等価なら同じレベルの見出しを使う

これは文字通りだと思うかもしれませんが、見た目ほど簡単ではありません。次の例を見てください。

  • Introduction
  • Step 1: Installing X
  • Step 2: Editing keyboard settings
  • Step 3: Editing mouse settings
  • Step 4: Editing display settings
  • Step 5: Adding fglrx options
  • Step 6: Starting X
  • Conclusions

このリストを慎重に分析すると、ステップ2から4はステップ1と6よりも重要性が低く、ステップ5は最も重要性が低いことに気付くでしょう。これらのステップが他のステップよりもテキストの量が多い・少ないということを言っているのではありません。重要なのは概念として重要かどうかです。

これを修正するには、以下のように変更します。

  • Introduction
  • Step 1: Installing X
  • Step 2: Configuring X
    • Step 2a: Editing keyboard settings
    • Step 2b: Editing mouse settings
    • Step 2c: Editing display settings
      • Step 2c-1: Adding fglrx options
  • Step 3: Starting X
  • Conclusions

ご覧の通り、ステップ2から4を Configuring X というタイトルのヘディングに統合して、ヘディングを3つのサブヘディングに分割しました。さらに、ステップ5をステップ2cに移動して、サブヘディングに変更しました。

一番高いレベルのヘディングは常に最高レベルにする

これも常識のように聞こえるかもしれませんが、1つの小さい問題があります。見出しにはフォーマットスタイルが当てられます。多くの人はそのフォーマットのルールをページの見た目を変えるために使ってしまいます。これは壊れたヘディングの構造を作ります。

次の例を見てください。

  • Introduction
  • Step 1
  • Step 2
  • Step 3
    • Conclusion

このページの編集者は、レベル1のヘディングは Conclusion のような重要ではないセクションには大きすぎると思い、レベル2のヘディングを使う方がいいと考えました。これは最後のセクションが他のセクションより1レベル下であるヘディング構造の結果となります。正しい構造は以下のようになるでしょう。

  • Introduction
  • Step 1
  • Step 2
  • Step 3
  • Conclusion

conclusion は他のセクションと同じレベルになりました。

ノート: IntroductionConclusion といったセクションがページのメインと同じ重要性を持つことは奇妙に映るかもしれませんが、そのようなセクションは実際重要です。ページの最後に(このような)ノートを追加したり、うまくまとまっていない・欠けているセクションを完全に除外したりして、セクションを見た目の問題のためだけに低いレベルに降格することを避けた方がよいです。

ヘディング構造のタイプ

使われているレベルの種類と目的に基づいて、ヘディング構造は以下のようなカテゴリに分類されます。

  1. 1レベルだけの構造
  2. 間違った複数レベルの構造
  3. 複数レベルの構造

1レベルだけの構造

ページを編集するとき、一番率直な方法は複数のステップに分割することです。ステップは実際のステップである必要はなく、何か読者が取る必要のあるステップです。あるいは、編集者がページを書いていくときに取るステップかもしれません。どの場合も、ステップは連続していて、1レベルだけの構造になります。

このような種類のページの典型的な構成は以下のようになるでしょう。

  • Introduction
  • Step 1: doing this or the other
  • Step 2: cleaning up
  • Step 3: troubleshooting
  • Further reading

これはシンプルな3つのステップの導入と、参照できるリンクです。

間違った複数レベルの構造

時には、シンプルで連続した1レベルだけの構造から外れる必要があります。

ノート

通常、何かを詳しく述べるためにメインの流れから少し外れる必要があるでしょう。

  • Introduction
  • Step 1: doing this or the other
    • Notes on configuring XYZ
  • Step 2: cleaning up
  • Step 3: troubleshooting
  • Further reading

このような方法の代わりに、ノートやコメントを ノートテンプレート で追加することを検討してください。

補助の情報を強調する

メインの議論への追加の議論となる部分や、メインの議論を他の方法で強化するなどの重要な部分に印を付けたくなるかもしれません。

  • Introduction
  • Step 1: doing this or the other
    • Here is the sample code
  • Step 2: cleaning up
    • Here is the sample code
  • Step 3: troubleshooting
    • Here is the sample code
  • Further reading

複数レベルの構造

複数レベルの構造は長くて詳細なページに典型的です。しかし、短いハウツーにも効果的に使えるかもしれません。

複数レベルの構造が便利ないくつかのケースを紹介します。

ノート: ここではヘディングレベルの親子関係について記述していることと、親のレベルが1, 2, 3 であることは重要ではないことに注意してください。同じことは2かより多くのレベルを持つ複数レベルの構造にも適用できます。

議論をグループ化する

サブヘディングは、ヘディングがページ全体に対してどんな役割をするかのメインのヘディングになることができます。

次のような例があります。

  • Introduction
  • Step 1: doing this or the other
  • Step 2: cleaning up
    • First do this
    • Then do that
    • You're done!
  • Step 3: troubleshooting
  • Further reading

代わりの議論

時には、議論の対象について読者に異なる視点を与える必要があります。

次のような例があります。

  • Introduction
  • Step 1: doing this or the other
    • This is one way to do it
    • This is another way to do it
  • Step 2: cleaning up
  • Step 3: troubleshooting
  • Further reading

反対の議論

否定的な議論について記述する必要があるのであれば、それぞれにサブヘディングを作ることができます。

具体的には以下のようになります。

  • Introduction
  • Step 1: doing this or the other
    • You want this
    • There are reasons for not wanting this, though
  • Step 2: cleaning up
  • Step 3: troubleshooting
  • Further reading

見出しの文章

ここではいくつかの鍵となる点をまとめました。より詳細な情報は、ヘルプ:記事命名ガイドラインを参照してください。ここに挙げられているものは見出しのテキストとページ名の両方に当てはまります。

  • 見出しのテキストはできるだけ具体的で、ヘディングのスコープを反映するようにする
  • 見出しのテキストはヘディングを将来拡張することができるように一般的にするようにする
  • 見出しのテキストはできるだけ短くする(ヘルプ:記事命名ガイドラインを参照)

フォーマット

既に述べたように、見た目のために見出しのフォーマットスタイルを濫用しないことはとても重要です。見た目が気に入らないなら、管理者に連絡して意見を聞くか、ヘディング構造を維持する方法での状況の解決を依頼してください。

テキストをヘディングにするには、2つかそれ以上のイコール記号(==)を使わなければいけません。

ノート: 使用可能な一番低いレベルのヘディングレベルは実際は1(=)ですが、ページのタイトルのために予約されています。ページのセクションはレベル2から始めなければいけません。

見出しを示すコードは以下の通りです。

==Header level 2==
===Header level 3===
====Header level 4====
=====Header level 5=====
======Header level 6======

見出しがどのように表示されるか見たいのであれば、サンドボックスを使うことができます。

翻訳ステータス: このページは en:Help:Effective use of headers の翻訳バージョンです。最後の翻訳日は 2020-04-10 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。