) をクリックします。'Update Link' のダイアログが開き、 'Link To' 欄が強調されています。この記事は、新しい協力者に既存ページの編集と、新規ページを作成する手順を紹介します。
ページを編集するには以下のようにします。
MDN の組み込みエディターの使い方について詳しくは、MDN エディター UI のガイドのエディターの UI 要素を参照してください。
変更がどのように見えるかを確認するには、以下のようにします。
ページをプレビューしても進行状況は保存されませんので、開いている編集タブを閉じないように注意してください。
変更をプレビューしたら、このリビジョンを保存しましょう。保存する前に、編集ボックスより下にあるリビジョンコメントボックスを探して、他の寄稿者に変更を加えた理由を知らせるコメントを残してください。たとえば、新しいセクションを追加したり、いくつかの単語を変更して用語をより統一させたり、段落を書き換えて言語を明確にしたり、冗長であったため情報を削除したなどです。
記事の「このページ内」の節は、ページの見出しにリンクする自動生成されたリストです。見出しを編集することで、このリンクも編集することができます。「翻訳についての説明」を選択して「目次」ドロップダウンの値を変更することで、目次全体を消したり、リンクの数を減らしたりすることもできます。
ページの編集セクションの下に、ページの内容と機能を記述するタグを追加または削除できます。 適用するタグの情報については、ページに正しくタグ付けする方法を参照してください。
専門家、または経験豊富な寄稿者が編集内容を確認する必要がある場合は、技術レビュー (コード、API、技術などの場合)、編集レビュー(散文、文法、コンテンツの場合) を要求することができるので、保存する前に適切なボックスがオンになっていることを確認してください。
ファイルを添付するには、特殊なユーザー権限が必要です。詳細は Attachments in the MDN editor をご覧ください。そこにアップロード権限のリクエスト方法も書かれています。
編集作業が終わり、プレビューに満足したのであれば、ページタイトルの右側かページ最下部にある緑色の「公開」ボタンをクリックして、作業やコメントを保存することができます。そのまま編集を続行したい場合は、「公開して編集を続行」ボタンをクリックするして、編集インターフェイスを開いたまま作業を続けることができます。
気が変わったら、赤い「破棄」ボタンをクリックすると編集内容を破棄できます。なお、変更を破棄すると完全に破棄されます。
リビジョンコメントボックスでEnterキーを押すと、「公開して編集を続行」ボタンを押した場合と同じ結果になります。
注: 保存しようとしたとき、変更が不正であるとして保存できず、内容が MDN にとって適切だと思った場合は、 MDN の管理者チームにメールを送って、助けを求めてください。
セキュリティ上の理由から、新しく作成されたアカウントでは、新しいページを作成することができません。ページを作成しようとすると、ページを作成するための手引きページが表示されます。ページを作成する方法は2つあります。
ページ作成権限があれば、新しいページの作成を開始できます。
新しい記事をどこに置くべきか分からなくても、心配する必要はありません。それをどこ置いても、わたしたちはそれを見つけて適正な場所に移動するか、それが最も理にかなっている場合は既存のコンテンツにマージします。あなたはページを完璧にすることについても心配する必要はありません。私たちみんなでコンテンツをきれいに美しくします。
新しいページを作成するには、いくつかの方法があります。
ほとんどの Wiki と同様に、 MDN ではまだ存在しないページへのリンクを作成することができます。 たとえば作成者は、 API のメンバーのページを作成する前に、すべてのメンバーのリストを作成することができます。 MDN では、存在しないページへのリンクは通常赤字で表示されます。
「存在しないページ」へのリンクからページを作成するには
別のページからリンクせずに新しいページを作成するには、ブラウザの URL フィールドに一意のページ名を入力します。たとえば、次のように入力します。
https://developer.mozilla.org/en-US/docs/FooBar
MDN は "FooBar" というタイトルの新しいページを作成し、エディターを開いて新しいページにコンテンツを追加することができます。エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
別のページからリンクせずに新しいページを作成するには
https://developer.mozilla.org/en-US/docs/new
MDN は新しいページを作成し、エディターを開いて新しいページにコンテンツを追加することができます。エディターモードの使用方法については、この記事の「既存のページを編集する」セクションを参照してください。
既存のページの下の階層にサブページを作成することができます。
新しいページの土台として使用したい書式を持つ既存のページがある場合は、そのページを「複製」し、それから内容を変更してください。
これは、いくつかの方法の組み合わせです。現在存在しているページから、新しいページへのリンクを作成し、挿入したリンクをクリックします。
) をクリックします。'Update Link' のダイアログが開き、 'Link To' 欄が強調されています。ページがまだ存在しない場合、リンクは赤く表示されます。ページがすでに存在する場合、リンクは青く表示されます。新しいページを作成したいが、ページタイトルがすでに取られている場合、まずはすでにあるページの編集を助けたり改良したりするのがもっと意味があるのではないのかを確認してください。そうでない場合、新しいページに別の名前を考えてリンクを作成します。ガイドラインの page naming guide を参照してください。
新しいページに中身を追加するには、 (エディターを保存して閉じた後に) 作成したばかりの赤いリンクをクリックします。新しいページがエディターモードで開かれて、書き始められます。エディターモードの使用については、この記事の既存のページを編集する節を参照してください。
KumaScript のマクロの MDN 対応や、他のページの内容の統合は、パフォーマンス上の理由でページをキャッシュする必要により妨げられることがあります。ページはソースから構築され、その出力は将来のリクエストのためにキャッシュされます。そのため、マクロ (テンプレート) や (Page マクロを使用した) 統合はマクロやその出力、統合された素材の内容のその後の変更が反映されません。