「ヘルプ:記事の書き方」の版間の差分
(TranslationStatus を末尾に移動) |
|||
| (2人の利用者による、間の12版が非表示) | |||
| 1行目: | 1行目: | ||
[[Category:ヘルプ]] |
[[Category:ヘルプ]] |
||
| + | [[el:Help:Writing article introductions]] |
||
[[en:Help:Writing article introductions]] |
[[en:Help:Writing article introductions]] |
||
| + | [[es:Help:Writing article introductions]] |
||
| + | [[pt:Help:Writing article introductions]] |
||
{{Related articles start}} |
{{Related articles start}} |
||
{{Related|ArchWiki:About}} |
{{Related|ArchWiki:About}} |
||
| 8行目: | 11行目: | ||
{{Related|ヘルプ:効果的な見出し}} |
{{Related|ヘルプ:効果的な見出し}} |
||
{{Related articles end}} |
{{Related articles end}} |
||
| − | |||
この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。 |
この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。 |
||
| 15行目: | 17行目: | ||
== 記事のイントロダクション == |
== 記事のイントロダクション == |
||
| + | 記事のイントロダクションは (大抵は) 読者が始めに出くわすものであり、これには記事の主題を彼らに紹介する目的があります。 |
||
| − | The article introduction is (usually) the first thing readers encounter and has the purpose of introducing them to the topic. |
||
| + | それぞれの記事は一連の仮定から始まっています。これらの仮定が大抵の読者に当てはまることはほとんどなく、記事のイントロダクションは著者の仮定を満たす読者をフィルタリングする目的をもっています。読者に記事の残り部分の紹介をする必要は特にありませんが、記事全体を何度読んでもはっきりしないままになるような部分を整理するのに役立つことがあります。 |
||
| − | Each article is started with a set of assumptions. These assumptions are seldom true for most readers, and an article introduction has the purpose of filtering readers that fulfill the assumptions made by writers. You do not really have to introduce readers to the rest of the article, but it may help clear some things up, that would otherwise remain unclear even after reading the whole article... many times over. |
||
| + | たとえば、ある特定のやり方によるシステムの設定についての記事を書いたとします。しかし、それは読者がクリーンで最新の Arch Linux をプライマリハードドライブにインストールしたことを想定していました。たとえば、もしカーネルがカスタマイズされていたら、その方法はどのような影響を受けるでしょうか。または、もし パッケージ X が存在していなかったら、手順3はどのように動作するでしょうか。 |
||
| − | For instance, you may have written an article about configuring the system in a certain way. However, you have assumed that readers have a clean and freshly installed Arch Linux on their primary hard drive. How would your method be affected if the kernel was, for example, customized? Or, how would step 3 work if package X was missing? |
||
| + | 記事を書き始める前にその方法に必要な条件を考え、示す必要があります。これには2つの重要なメリットがあります: |
||
| − | You need to think about prerequisites for your method and present those prerequisites before you start your article. This has two key benefits: |
||
| + | #読者がその記事を読みたいかを、先に行き過ぎてしまう前に、判断できるようになります。 |
||
| − | #It allows readers to decide if they want to read the article, before they have gone too far. |
||
| + | #主題からずれたことを多く入れすぎずに記事が書けるようになります。 |
||
| − | #It enables you to write an article without too many unnecessary digressions. |
||
| + | 2番目は読者のパフォーマンスに対して大きな影響を与え、現に記事がスリム化されます。 |
||
| − | Number two has a huge impact on reader performance, and actually makes your article more streamlined. |
||
| + | 記事のイントロダクションに含めるべき内容はたくさんあると思われるかもしれませんが、ここではより重要なものをいくつか順不同で示します: |
||
| − | There are a number of things you might consider including in your article introduction, but here are some of the more important ones in no particular order: |
||
| + | * 要求される前歴と知識 |
||
| − | * previous experiences and knowledge required |
||
| + | * システムの状態と設定 |
||
| − | * system states and configuration |
||
| + | * ハードウェアコンポーネントの所有権 |
||
| − | * ownership of hardware components |
||
| + | * 読者がその記事に期待''できない''こと |
||
| − | * what readers are ''not'' going to find in the article |
||
== テキスト == |
== テキスト == |
||
| + | 既に記事のイントロダクションで述べるかもしれないことをいくつか挙げました。以下では、効果的で役に立つ記事のイントロダクションの作成に関わる問題を見ていきます。 |
||
| − | We have already mentioned some things you might mention in an article introduction. We will now take a look at some of the problems in formulating an effective and useful article introduction. |
||
=== 前歴と知識 === |
=== 前歴と知識 === |
||
| + | 前歴について述べる場合、この単語に2つの意味があることを頭に入れておく必要があります。1つ目の意味は、より一般的です。ある人のことをその人の知識・経験・評判から総合的に判断し、''初心者''や''グル''と呼ぶことがあります。もう1つの意味は、イベントや活動への参加 (そして、これらを通して得た知識) という具体的な経験を指します。実際的な理由から、後者の意味での前歴を要求するほうが望ましいです。ArchWiki のほとんどの記事には特定の主題について述べる文脈が存在します。ある文脈で、''初心者''が自分の熟練度を誇示したり、一方で''グル''が関心がないことをあらわにするかもしれません。明確な前歴を要求すれば、読者が記事の続きについて行けるかどうかを判断できる可能性が高まります。 |
||
| − | When talking about previous experience, you need to keep in mind that there are two meanings of the words. One is a more general meaning. We may call someone a ''newbie'' or a ''guru'' based on the overall knowledge/experience/reputation of that individual. The other is a concrete experience of participating in an event or activity (and the knowledge derived from that). For practical reasons, it is better to demand previous experience(s) in the latter sense. Most articles on ArchWiki talk about topics that are specific, and in some context. In a given context, a ''newbie'' may display proficiency, whereas a ''guru'' may show lack of interest. If you require specific previous experiences, readers have a better chance of judging their ability to follow the rest of the article. |
||
| + | 読者が記事を理解するために要求される知識を得る手助けになるような資料へのリンクを提供することもできます。 |
||
| − | You may also want to provide readers with links to resources that would help them gain knowledge required to understand the article. |
||
=== システムの状態と設定 === |
=== システムの状態と設定 === |
||
| + | パッケージ不足や設定が異なったシステム構成により、そのシステムで時々記事が全く役に立たなくなることがあります。したがって、可能ならばいつでも関連する (rc.config パラメータ、必要なパッケージなどのような) すべてのシステム設定を調べて定義しなければなりません。 |
||
| − | Sometimes, a missing package or a differently configured system component may render an article useless on some systems. Therefore, you need to track down and define all relevant system configuration (like, relevant rc.config parameters, required packages, etc) whenever possible. |
||
=== ハードウェアの要件 === |
=== ハードウェアの要件 === |
||
| + | ハードウェアの要件は大抵単純明快です。ダイアルアップモデム XYZ のドライバインストールについて述べていたら、モデム ZYX について話していると考える人は誰もいないでしょう。しかし、場合によっては明確なハードウェアの要件を挙げておくほうがよいことがあります。たとえば、XYZ-123 のドライバをインストールする記事を書いている場合、同じことが XYZ-456 には適用されない場合があることをユーザーに注意することができます。 |
||
| − | Hardware requirements are usually fairly obvious. If you are talking about installing drivers for dial-up modem XYZ, nobody will ever think you are talking about a modem ZYX. However, in some cases it is good to mention the specific hardware requirements. For instance, if you are writing an article about installing drivers for XYZ-123, you may warn users that the same might not apply to XYZ-456. |
||
| + | 記事で述べようとしているハードウェアの写真を追加するのもよい計らいといえます。 |
||
| − | It is also a nice touch to add the photo of the hardware your article is about to discuss. |
||
=== 読者が記事に期待''できない''こと === |
=== 読者が記事に期待''できない''こと === |
||
| + | 時々、記事のタイトルは誤解を招くことがあります。そのため、読者に記事の実際の主題を知らせ、可能であれば読者が探していた他記事へのリンクを提供する必要があります。 |
||
| − | Sometimes, the article's title may be slightly misleading. Therefore you may need to warn readers about the actual topic of the article, and possibly offer a link to other articles that readers might have been looking for. |
||
| + | たとえば、この記事が wiki テキストを用いたページの整形の仕方に関するものだと思った読者がいるかもしれません。したがって、そのような読者にはこれが探しているページではないことを知らせ、適切なページヘのリンクを提供しました。 |
||
| − | For example, some readers might have thought this article was about how to format pages using wiki text. Therefore, those readers have been warned that this is not the page they were looking for, and the link to the right page was provided. |
||
== フォーマット == |
== フォーマット == |
||
| + | 記事のイントロダクションのフォーマットは、通常の [[ヘルプ:編集|ArchWiki の慣習]]に従ってください。しかし、より注意を払う必要がある細かい点がまだあります。 |
||
| − | The formatting of the article introduction follows the usual [[ヘルプ:編集|ArchWiki customs]]. However, there are still details that deserve closer attention. |
||
| + | |||
| + | 必要な条件を列挙する方法は2つあります。1つ目の方法では、条件とその他の導入メモを簡潔な (記事で使用する言語がここに入ります) で冗長に説明します。もう1つの方法は、よくまとまった条件のリストを提供します。 |
||
| + | {{TranslationStatus|Help:Writing article introductions|2020-04-25|547170}} |
||
| − | When listing requirements, you have two approaches. One is to verbosely explain the requirements and other introductory notes in plain (your language here). The other method is to offer a well-organized list of requirements. |
||
2022年1月2日 (日) 14:51時点における最新版
この記事は wiki の作者や編集者を対象にかかれており、実用的な記事を作成して ArchWiki の読者に見聞を広めるのを補助します。
この記事を読むのに wiki ページを編集する方法を知る必要はありません。技術的な編集ハウツーよりも、もっと全般的なスタイルガイドです。
記事のイントロダクション
記事のイントロダクションは (大抵は) 読者が始めに出くわすものであり、これには記事の主題を彼らに紹介する目的があります。
それぞれの記事は一連の仮定から始まっています。これらの仮定が大抵の読者に当てはまることはほとんどなく、記事のイントロダクションは著者の仮定を満たす読者をフィルタリングする目的をもっています。読者に記事の残り部分の紹介をする必要は特にありませんが、記事全体を何度読んでもはっきりしないままになるような部分を整理するのに役立つことがあります。
たとえば、ある特定のやり方によるシステムの設定についての記事を書いたとします。しかし、それは読者がクリーンで最新の Arch Linux をプライマリハードドライブにインストールしたことを想定していました。たとえば、もしカーネルがカスタマイズされていたら、その方法はどのような影響を受けるでしょうか。または、もし パッケージ X が存在していなかったら、手順3はどのように動作するでしょうか。
記事を書き始める前にその方法に必要な条件を考え、示す必要があります。これには2つの重要なメリットがあります:
- 読者がその記事を読みたいかを、先に行き過ぎてしまう前に、判断できるようになります。
- 主題からずれたことを多く入れすぎずに記事が書けるようになります。
2番目は読者のパフォーマンスに対して大きな影響を与え、現に記事がスリム化されます。
記事のイントロダクションに含めるべき内容はたくさんあると思われるかもしれませんが、ここではより重要なものをいくつか順不同で示します:
- 要求される前歴と知識
- システムの状態と設定
- ハードウェアコンポーネントの所有権
- 読者がその記事に期待できないこと
テキスト
既に記事のイントロダクションで述べるかもしれないことをいくつか挙げました。以下では、効果的で役に立つ記事のイントロダクションの作成に関わる問題を見ていきます。
前歴と知識
前歴について述べる場合、この単語に2つの意味があることを頭に入れておく必要があります。1つ目の意味は、より一般的です。ある人のことをその人の知識・経験・評判から総合的に判断し、初心者やグルと呼ぶことがあります。もう1つの意味は、イベントや活動への参加 (そして、これらを通して得た知識) という具体的な経験を指します。実際的な理由から、後者の意味での前歴を要求するほうが望ましいです。ArchWiki のほとんどの記事には特定の主題について述べる文脈が存在します。ある文脈で、初心者が自分の熟練度を誇示したり、一方でグルが関心がないことをあらわにするかもしれません。明確な前歴を要求すれば、読者が記事の続きについて行けるかどうかを判断できる可能性が高まります。
読者が記事を理解するために要求される知識を得る手助けになるような資料へのリンクを提供することもできます。
システムの状態と設定
パッケージ不足や設定が異なったシステム構成により、そのシステムで時々記事が全く役に立たなくなることがあります。したがって、可能ならばいつでも関連する (rc.config パラメータ、必要なパッケージなどのような) すべてのシステム設定を調べて定義しなければなりません。
ハードウェアの要件
ハードウェアの要件は大抵単純明快です。ダイアルアップモデム XYZ のドライバインストールについて述べていたら、モデム ZYX について話していると考える人は誰もいないでしょう。しかし、場合によっては明確なハードウェアの要件を挙げておくほうがよいことがあります。たとえば、XYZ-123 のドライバをインストールする記事を書いている場合、同じことが XYZ-456 には適用されない場合があることをユーザーに注意することができます。
記事で述べようとしているハードウェアの写真を追加するのもよい計らいといえます。
読者が記事に期待できないこと
時々、記事のタイトルは誤解を招くことがあります。そのため、読者に記事の実際の主題を知らせ、可能であれば読者が探していた他記事へのリンクを提供する必要があります。
たとえば、この記事が wiki テキストを用いたページの整形の仕方に関するものだと思った読者がいるかもしれません。したがって、そのような読者にはこれが探しているページではないことを知らせ、適切なページヘのリンクを提供しました。
フォーマット
記事のイントロダクションのフォーマットは、通常の ArchWiki の慣習に従ってください。しかし、より注意を払う必要がある細かい点がまだあります。
必要な条件を列挙する方法は2つあります。1つ目の方法では、条件とその他の導入メモを簡潔な (記事で使用する言語がここに入ります) で冗長に説明します。もう1つの方法は、よくまとまった条件のリストを提供します。