この記事は、新しい貢献者に既存ページの編集と、新規ページを作成する手順を紹介します。
既存のページを編集する
編集はとても簡単です。
- 訂正したいページを見つけたら、右上の「編集」ボタンをクリックしてください。
- ページが編集画面インターフェイスによってリロードされるので、直接ページ上で情報を追加または削除できるようになります。
- 段落を追加したり、テキストを削除したり、見出しを挿入したり、書いたり編集したりする事を含む基本的な機能の多くを使用することができます。MDNの組み込みエディターの使い方についてはMDN のエディターガイドのエディター UI 要素を参照してください。
変更をプレビューする
どのように変更を確認するのか。。
- ページタイトルの上にある「プレビュー」ボタン(編集機能の中)をクリックします。
- 新しいウィンドウまたはタブに、編集中のリビジョンを含むプレビューページが開きます。
- このボタンをクリックするたびに、最新の変更内容でプレビューページが更新されます。
ページをプレビューしても進行状況は保存されませんので、開いている編集タブを閉じないように注意してください。
リビジョンのコメント
変更をプレビューした後は、リビジョンを保存することになります。保存する前に、編集ボックスより下にあるリビジョンコメントボックスを探して、他の寄稿者に変更を加えた理由を知らせるコメントを残してください。 たとえば、新しいセクションを追加したり、いくつかの単語を変更して用語をより統一させたり、段落を書き換えて言語を明確にしたり、冗長であったため情報を削除したなどです。
目次
記事の "この記事内" 節は、記事の見出しへの自動生成されたリストです。見出しを編集することでこのリンクも編集できます。"翻訳についての説明"を選択して"TOC"ドロップダウンの値を変更することで、目次全体を消したり、リンクの数を減らすこともできます。
タグ
ページの編集セクションの下に、ページの内容と機能を記述するタグを追加または削除できます。 適用するタグの情報については、ページに正しくタグを付ける方法を参照してください。
レビューが必要な場合
専門家、または経験豊富な寄稿者が編集内容を確認する必要がある場合は、技術レビュー（コード、API、または技術の場合）、編集レビュー（散文、文法、コンテンツの場合）を要求できます。その方法は、保存する前に適切なボックスがオンになっていることを確認します。
添付ファイル
より明確な説明を追加するために、既存のページにファイルを添付したい場合は、ページの下部からアップロードしたいファイルを選択します。画像をアップロードするときは、画像最適化ツールを使用してファイルをできるだけ小さくしてダウンロードしてください。これにより、ページの読み込み時間が短縮され、MDN の全体的なパフォーマンスが向上します。お手持ちのツールがあれば、それを使用できます。それ以外の場合は、便利な Web ツールである TinyPNG をお勧めします。
保存、破棄、または編集を続行するには
編集作業が終わり、プレビューに満足すれば、ページタイトルかページ最下部の右側にある緑色の「公開」ボタンをクリックして、作業やコメントを保存することができます。そのまま編集を続行したい場合は、「公開して編集を続行」ボタン をクリックするして、編集インターフェイスを開いたまま作業を続けることができます。
気が変わったら、赤い「破棄」ボタンをクリックすると編集内容を破棄できます。なお、破棄された編集内容は元に戻りません。
リビジョンコメントボックスでEnterキーを押すと、「公開して編集を続行」ボタンを押した場合と同じ結果になります。
内容がMDNに適切な編集を保存しようとするのに、変更が不正なものであるとして保存できなかった場合、MDNの管理者チームにメールを送って、投稿できるよう助けを求めてください。
ページ作成権限を取得する
セキュリティ対策として、新しく作成したアカウントにはページを作成する権限はありません。権限がないアカウントで作成しようとする場合、ページを作成するための手引きページが表示されます。ページを作成する方法は2つあります。
- ページの作成を依頼する。依頼するには題名を「Create page: <ページの名前>」とするドキュメンテーション・リクエスト・バグを報告してください。URLフィールドには（もし知っていれば）MDNにおける位置を入力してください。また、コメントではなぜそのページを作成する必要があるかを説明してください。
- ページ作成の権限を申請する。ページ作成の権限を申請して、それが認められた場合、下記の方法でページを作成することができます。権限を申請するにはMDNの管理者チームにメールを送ってください。メールの内容にはあなたのユーザーネームと権限を申請する理由（例えば、新しいAPIのドキュメンテーションを書くために多くの新しいページを作成する必要がある、用語集に新しい用語を追加するためなど）を書いてください。申請する前に、サイトの内容に何らかの役に立つ貢献をしており、また一定の期間貢献をしてからにするべきです（時間の長さはあくまでも一つの考慮なので、何か固定の期間があるわけではありません）。
新しいページを作成する
ページ作成権限があれば、新しいページの作成を開始できます。
新しい記事をどこに置くべきか分からなくても、心配する必要はありません。それをどこ置いても、わたしたちはそれを見つけて適正な場所に移動するか、それが最も理にかなっている場合は既存のコンテンツにマージします。 あなたはページを完璧にすることについても心配する必要はありません。私たちみんなでコンテンツをきれいに美しくします。
新しいページを作成するには、いくつかの方法があります。
「存在しないページ」へのリンク
ほとんどのWikiと同様に、MDNではまだ存在しないページへのリンクを作成することができます。 たとえば作成者は、APIのメンバーのページを作成する前に、すべてのメンバーのリストを作成することができます。 MDNでは、存在しないページへのリンクは通常赤字で表示されます。
「存在しないページ」へのリンクからページを作成するには:
- MDNにログインしていて、ページ作成権限があることを確認してください。（もしログインしていない場合は、「存在しないページ」リンクが、404（ページが見つかりません）というエラーを表示します。）
- 「存在しないページ」リンクをクリックします。ページ作成権限があれば MDN EditorのUIが開き、新しくページを作成する準備が整います。
- ページの内容を書き込んで保存します。
リンクなしで新しいページを作成
別のページからリンクせずに新しいページを作成するには、ブラウザのURLフィールドに一意のページ名を入力します。 たとえば、次のように入力します。
https://developer.mozilla.org/en-US/docs/FooBar
MDNは "FooBar" というタイトルの新しいページを作成し、エディターを開いて新しいページにコンテンツを追加することができます。 エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
別のページからリンクせずに新しいページを作成するには:
- MDNにログインしていて、ページ作成権限があることを確認する
- ブラウザのURLフィールドに下記を入力する
https://developer.mozilla.org/en-US/docs/newMDN は新しいページを作成し、エディターを開いて新しいページにコンテンツを追加することができます。 エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
既存のページのサブページを作成
既存のページの下の階層にサブページを作成することができます。
- 「親」ページで、詳細設定メニュー（ツールバーの歯車アイコン）をクリックし、「新しいサブページ」をクリックします。 新しい文書を作成するためのエディタービューが開きます。
- 「タイトル」フィールドに文書のタイトルを入力します。
- 必要に応じて Slug フィールドを変更します。（たとえば、タイトルが非常に長く、URLを短くしたい場合など。）このフィールドは、タイトルのスペースにアンダースコアを代入することで、エディターによって自動的に入力されます。 この場合、文書のURLの最後の部分のみを変更することができます。
- TOC フィールドで、ページの目次に自動的に表示する見出しレベルを選択します。必要がない場合は「目次なし」を選択します。
- エディターペインにページの内容を書き込んで変更を保存します。 エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
既存のページを複製
既存のページが、新しいページに使用できる形式である場合は、そのページを「複製」して内容を変更できます。
- 元のページで、詳細設定メニュー（ツールバーの歯車アイコン）をクリックし、「このページを複製」をクリックします。 新しい文書を作成するためのエディタービューが開きます。
- 新しいコンテンツに適切となるようにページタイトルを変更します。 Slugフィールドは、「タイトル」フィールドを変更すると自動的に更新されます。
- 必要に応じて、Slug フィールドのパスを変更して、新しいドキュメントをドキュメント階層の別の部分に配置します。 （ほとんどの場合では必要ありません。なぜなら、複製されたページは元のコンテンツと似ているため、同様の場所に配置する必要があるためです。）
- TOC フィールドで、ページの目次に自動的に表示する見出しレベルを選択します。必要がない場合は「目次なし」を選択します。
- エディターペインにページの内容を書き込んで、変更を保存します。 エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
既存のページからリンク
これは、いくつかの方法の組み合わせです。現在存在しているページから、新しいページへのリンクを作成し、挿入したリンクをクリックします。
- 既存ページのテキスト内の(意味のある)どこかの場所に新しいページの名前を入力します。
- その名前をハイライトしてエディターツールバーから リンクアイコン (
) をクリックします 。"Update Link" のダイアログが開き、"Link To" フィールドがハイライトされています。 - 既定ではURLフィールドの最初に "/ja/docs/" が挿入されます。"/en-US/docs/" の後にページ名を入力します(ページ名はリンクテキストと同じである必要はありません)。
- OK をクリックしてリンクを作成、挿入します。
ページがまだ存在しない場合、リンクは赤く表示されます。ページがすでに存在する場合、リンクは青く表示されます。新しいページを作成したいが、ページタイトルがすでに取られている場合、まずはすでにあるページの編集を助けたり改良したりするのがもっと意味があるのではないのかを確認してください。そうでない場合、新しいページに別の名前を考えてリンクを作成します。ガイドラインの page naming guideを参照してください。
新しいページに中身を追加するには、(エディターを保存して閉じた後に)作成したばかりの赤いリンクをクリックします 。新しいページがエディターモードで開かれて、書き始められます。エディターモードの使用については、この記事の 既存のページを編集する 節を参照してください。
ページの内容をリフレッシュする
MDN の KumaScript マクロとページ間のトランスクルージョンのサポートは、パフォーマンス事由の生成ページのキャッシュ要求のため、妨げられることがあります。ページはソースからビルドされ、しかもアウトプットは将来のリクエストに備えてキャッシュされます。ここから、ページ内のマクロ(テンプレート)やトランスクルージョン (Page マクロを使っている)では、マクロに対する変更や、マクロの出力や、トランスクルージョンで生成されたコンテンツには反映されません。
- ページを手動で更新するには、ブラウザーで強制リフレッシュしてください。MDNはこれを検知してページのリビルドをかけて、更新されたマクロとトランスクルージョン後のページコンテンツを取り込みます。
- ページを定期的に自動リビルドするよう設定することもできます。これはページが頻繁に更新すると予測されない場合はすべきではありません。詳しくは ページの再生成 を参照してください。