blob: 7fa04b601b5d25558515616649c73f449b02fde3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
---
title: コンテンツの作成
slug: MDN/User_guide/Writing
tags:
- MDN
- MDN Project
translation_of: Archive/Meta_docs/Writing_content
---
<p>MDN には、いつもたくさんのページの追加やアップデートがあります。たとえば、真新しいAPI のドキュメントや若干の変更がある古いAPIのページがあり、あなたの翻訳はいつでも役立ちます。</p>
<h2 id="既存のページを編集する">既存のページを編集する</h2>
<p>訂正したいページを見つけたら、右上の「編集」ボタンをクリックしてください。すると、該当ページが編集可能になったWYSIWYGエディタが開きます。どのように編集するかは、<a href="/docs/Project:MDN/Contributing/Editor_guide">MDN のエディタガイド</a>を読んでください。コンテンツの構築とレイアウトを自動的に手助けするマクロシステムなどの説明もあります。</p>
<p>次のような場合に、既存ページの編集が必要です。</p>
<ul>
<li>誤字脱字</li>
<li>わかりにくい表現</li>
<li>レイアウトや形式が乱雑</li>
<li>API ドキュメントの更新と、API のアップデートに合わせた更新</li>
<li>複数のブラウザの異なる振る舞いに関する情報</li>
<li>サンプルコードの追加と改善. 詳細は、{{anch("Add a code sample")}} を参照</li>
<li>仮ページ、または重要な情報の不足</li>
</ul>
<h2 id="新しいページを作成する">新しいページを作成する</h2>
<p>これは大きな出来事です！MDN に新しいページを追加すると、Webがあなたを愛しあなたを抱きしめてくれるでしょう。まだドキュメント化されていない API や新しい話題のチュートリアル・解説記事というように、新しいページの作成は、とても役に立ちます。</p>
<p>MDN には、次のように新しいページの作成を始める方法があります。<a href="/docs/Project:MDN/Contributing/Getting_started#Logging_into_MDN">ログイン</a>してから始めてください:</p>
<dl>
<dt>存在しないページのリンクをクリック</dt>
<dd>MDN をブラウズしていると、存在しないページへのリンクが見つかることがあるでしょう。リンク先のページを作らずに、記事を書くことがあるからです。これは、最終的にページ構成がどうなるか理解する手助けになるのですが、そこに取りかかるまでに、時間がかかる場合もあります。そんなところを見つけたら、自由に作業してみてください。リンクをクリックして、新規ページを編集すればいいのです。</dd>
<dt>サブページの作成</dt>
<dd>右上あたりの歯車マークから、<strong>"サブページを作成"</strong> を呼び出すことができます。この項目を選ぶと、そのとき表示していたページを親にした、新しいページの編集画面が開きます。タイトルとスラッグを設定したら、記事を書き始めましょう。</dd>
<dt>このページを複製</dt>
<dd>歯車マークの<strong>"このページを複製"</strong> オプションで、現在のページのコピーを作ることができます。この項目を選ぶと、そのとき表示していたページを複写した、新しいページの編集画面が開くので、タイトルとスラッグを設定しましょう。新しいページを作る場合、これはわりといい方法です。なぜなら、元と同じようなレイアウトで簡単にページを作れるからです。</dd>
<dt>存在しないページへのリンクを作成してクリック</dt>
<dd>これは、いくつかの方法の組み合わせです。どのページもどこからかリンクされている必要があるので、現在存在しているページから、新しいページにリンクを貼ってしまうのです。それから、元のページをいったん保存して、今挿入したリンクをクリックすれば、新しい記事の編集画面が開きます。</dd>
</dl>
<div class="note">
<p><strong>注記:</strong> ログインしていない場合、新しいページを編集するかわりに、404エラーが出るかもしれません。</p>
</div>
<h2 id="関連情報">関連情報</h2>
<p>ここでは、コンテンツ作成を始めるためのいくつかのヒントや確実に役立つ注意すべき情報を紹介しています。</p>
<dl>
<dt><a href="https://wiki.mozilla.org/Modules">モジュールオーナー一覧 (Module owner lists)</a></dt>
<dd>Mozilla プロジェクトは、モジュールオーナーベースで活動しており、主要なコンポーネントは、オーナーまたは責任者がいます。このオーナーたちは、あなたが何かするときの最適な情報源です。あるいは、誰と話をすればいいか見つける一番の方法です。</dd>
<dt><a href="http://mxr.mozilla.org/">Mozilla ソースのクロスリファレンス (Mozilla source cross-reference)</a></dt>
<dd>MXR (Mozilla クロスリファレンス、Mozilla cross-reference) は、Mozilla プロジェクトのすべてのソースコードにアクセスできる場所です (一部の例外を除きます。例えば、Firefox OS のソースコードは GitHub 上にあります)。コードとそこに書かれたコメントは、とても役に立つ情報源です。</dd>
<dt><a href="http://wiki.mozilla.org/">Mozilla wiki</a></dt>
<dd>The Mozilla wiki — "wikimo" とも呼ばれます — は、プロセスやデザインノート・ドラフト・計画・暫定の仕様などが保存されています。雑然と混乱していますが、多くの場合、貴重な情報の宝庫になっています。</dd>
</dl>
|
