Erstellen und Editieren von Seiten

Die beiden häufigsten Aufgaben im MDN, die fast jeder MDN-Nutzer durchführen wird, sind das Anlegen und Ändern von Seiten. Dieser Artikel behandelt die Grundlagen dieser Aufgaben.

Editieren einer bestehenden Seite

Das geht ganz einfach:

  • Klick auf die Schaltfläche Bearbeiten rechts oben auf der Seite.
  • Die Seite wird im Bearbeitungsmodus neu geladen, so dass Du Informationen hinzufügen oder löschen kannst.
  • Du kannst Absätze hinzufügen, Text löschen, Überschriften einfügen und vieles mehr.

Vorschau der Änderungen

Um zu prüfen, wie Deine Änderungen aussehen:

  • Klick auf die Schaltfläche "Vorschau der Änderungen" (im Bearbeitungsmodus) rechts oben auf der Seite.
  • Das öffnet eine Vorschauseite inklusive Deiner Änderungen in einem neuen Fenster oder einem neuen Tab.
  • Jedes Mal, wenn Du auf "Vorschau der Änderungen" klickst wird die Vorschauseite mit all Deinen Änderungen angezeigt.

Vorsicht! Die Vorschau speichert nicht Deine Änderungen. Du solltest also die offene Seite mit dem Bearbeitungsmodus nicht schließen.

Änderungen kommentieren

Wenn Du mit der Vorschau Deiner Änderungen zufrieden bist, dann wirst Du Deine Änderungen speichern wollen. Vor dem Speichern kannst Du ganz unten auf der Seite Deine Änderungen kommentieren um anderen mitzuteilen, warum Du welche Änderungen vorgenommen hast. Zum Beispiel weil Du einen neuen Bereich eingefügt , einen Absatz verständlicher formuliert oder redundante Informationen heraus genommen hast.

Tags

Unterhalb des Bearbeitungsbereiches kannst Du Tags zum Beschreiben des Seiteninhalts und der Funktion hinzufügen oder löschen. Empfehlungen zum Setzen von Tags findes Du hier.

Überprüfung benötigt?

Wenn ein Experte oder ein erfahrener Mitarbeiter Deine Änderungen überprüfen soll, kannst Du eine technische Überprüfung (für Code, APIs oder Technologien), eine redaktionelle Überprüfung (für Prosa, Grammatik und Inhalt) oder eine Template-Überprüfung (für KumaScript Code) anfordern. Dafür mußt Du nur das entsprechende Kontrollkästchen im Bereich "Überprüfung benötigt?" am Seitenende aktivieren, bevor Du speicherst.

Dateien anhängen

Ganz unten am Seitenende kannst Du Dateien anhängen um z.B. eine Grafik oder weitere Informationen bereit zu stellen. Wenn Du ein Bild hochladen willst stelle bitte sicher, dass das Bild durch ein Optimierungs-Programm so weit wie möglich komprimiert wurde. Das verbessert die Ladezeit der Seite und hilft insgesamt der Performance des MDN. Du kannst gern Dein eigenes Optimierungs-Programm verwenden, wenn Du eines hast. Ansonsten empfehlen wir TinyPNG, eine handliche Web-Anwendung.

Speichern, verwerfen oder weiter bearbeiten

Wenn Du mit Deinen Änderungen fertig und mit der Vorschau zufrieden bist, kannst Du Deine Änderungen und Kommentare speichern. Klicke hierzu auf die grüne "Änderungen speichern" Schaltfläche rechts neben dem Seitentitel. Falls Du es Dir anders überlegst, kannst Du Deine Änderungen verwerfen durch Klick auf die rote Schaltfläche "Änderungen verwerfen" ganz rechts neben Seitentitel.

Das Drücken der Enter-Taste im Kommentarfeld ist gleichbedeutend mit einem Klick auf die Schaltfläche "Speichern und weiter bearbeiten".

Eine neue Seite erstellen

Wenn Du nicht weißt wo ein neuer Artikel einzuordnen ist: keine Sorge. Füge die Seite einfach an einer beliebigen Stelle ein. Wir werden sie finden, mit vorhandenen Inhalten verschmelzen und dort einsortieren wo sie hingehört. Eine neue Seite muss auch nicht sofort perfekt sein. Wir haben jede Menge Freiwillige, die dabei helfen die Inhalte aufzubereiten.

Es gibt mehrere Möglichkeiten eine neue Seite anzulegen:

Wie bei den meisten Wiki-Seiten ist es auch im MDN möglich, Links zu (noch) nicht existierenden Seiten einzufügen. Beispiel: Ein Autor möchte eine Liste von Team-Mitgliedern eines API-Projekts anlegen, bevor er die Seiten für die einzelnen Team-Mitglieder anlegt. Im MDN werden Links zu nicht existierenden Seiten typischerweise rot dargestellt.

Um eine Seite aus einem solchen Link heraus zu erstellen:

  1. Melde Dich im MDN an, falls Du noch nicht angemeldest bist (wenn Du nicht angemeldet bist, dann wirst Du einen "Fehler 404: Seite nicht gefunden" bekommen wenn Du auf einen Link zu einer nicht existierenden Seite klickst)
  2. Wenn Du im normalen Anzeigemodus einer Seite bist: Klicke auf den Link. Wenn Du im Bearbeitungsmodus bist: Öffne mit der rechten Maustaste das  Kontextmenü des Links und klicke auf "Starten". Das MDN Editor UI startet und Du kannst die fehlende Seite anlegen.
  3. Fülle die Seite mit dem gewünschen Inhalt und speicher Deine Änderungen.

Um eine neue Seite ohne Link von einer vorhanden Seite anzulegen gibst Du einfach die gewünschte URL im Adressfeld Deines Browsers ein. Wenn Du z.B. eingibst

https://developer.mozilla.org/de/docs/FooBar

, dann legt MDN eine neue Seite namens "FooBar" an und startet den Editor, so dass Du die neue Seite mit Inhalt füllen kannst. Eine Anleitung zum Bedienen des Editors findest Du im MDN editor guide.

Unterseite zu einer existierenden Seite

Falls Du eine Seite hierarchisch unter einer bestehenden Seite anlegen möchtest:

  1. Klicke auf der bestehenden Seite auf das Erweitert-Menü (das Zahnrad in der Werkzeugleiste) und danach Neuer Unterartikel. Ein Editorfenster zum Erstellen eines neuen Dokumentes öffnet sich.
  2. Vergebe einen Namen für die Seite im Feld Titel.
  3. Falls nötig, ändere das Feld Adressname (z.B. wenn der Name sehr lang ist und Du eine kürzere URL generieren willst). Dieses Feld wird automatisch vom Editor gefüllt, wobei Leerzeichen durch Unterstriche ersetzt werden. In diesem Fall kannst Du nur den letzten Teil der URL ändern.
  4. Im Feld Inhaltsverzeichnis kannst Du auswählen, welche Überschriftenebenen automatisch im Inhaltsverzeichnis der Seite angezeigt werden sollen. Oder Du wählst den Eintrag "Kein Inhaltsverzeichnis", wenn die Seite kein Inhaltsverzeichnis benötigt.
  5. Schreibe den Inhalt der Seite in das Editorfenster und speicher die Änderungen. Hinweise zum Editor findest Du im MDN editor guide.

Klonen einer existierenden Seite

Wenn Du das Format und den Aufbau einer vorhandenen Seite als Vorlage für Deine Seite verwenden möchtest, dann kannst Du diese Seite "klonen" und nur den Inhalt anpassen.

  1. Klicke dazu in der zu klonenden Seite auf das Erweitert-Menü (Zahnradsymbol in der Werkzeugleiste) und wähle Diesen Artikel klonen. Ein Editorfenster öffnet sich zum Erstellen einer neuen Seite.
  2. Ändere den Titel der Seite passend zum neuen Inhalt. Das Feld Adressname ändert sich automatisch mit dem Titel-Feld.
  3. Falls nötig, ändere den Pfad im Feld Adressname um das Dokument in einem anderen Hierarchie-Bereich einzuordnen (in den meisten Fällen sollte das nicht nötig sein, da der kopierte Inhalt ähnlich zum Original und somit die Seite an der gleichen Stelle in der Hierarchie zu finden sein sollte).
  4. Im Feld Inhaltsverzeichnis kannst Du auswählen, welche Überschriftenebenen automatisch im Inhaltsverzeichnis der Seite angezeigt werden sollen. Oder Du wählst den Eintrag "Kein Inhaltsverzeichnis", wenn die Seite kein Inhaltsverzeichnis benötigt.
  5. Schreibe den Inhalt der Seite in das Editorfenster und speicher die Änderungen. Hinweise zum Editor findest Du im MDN editor guide.

Das ist ein bischen eine Mischung der bisher vorgestellten Methoden. Du kannst einen neuen Link auf irgendeiner Seite irgendwo einfügen und diesen neuen Link anklicken, um eine neue Seite anzulegen.

  1. Gib den Namen der neuen Seite an einer sinnvollen Stelle im Text einer existierenden Seite ein.
  2. Markiere diesen Namen und klicke auf das Link Icon () in der Werkzeugleiste des Editors. Ein Link Fenster öffnet sich, der markierte Name befindet sich im Feld Suche nach Artikel-Titel / Link-Text.
  3. Das Feld URL ist mit "/en-US/docs/" vorbelegt. Trage den Namen der Seite direkt hinter "/en-US/docs/" ein. Der Name der Seite muss nicht identisch mit dem Link-Text sein.
  4. Klick auf OK zum Erstellen des Links.

Wenn die Seite noch nicht existiert, wird der link rot dargestellt. Falls die Seite bereits existiert, wird der Link blau dargestellt. Falls Du eine neue Seite anlegen willst deren Titel bereits von einer anderen Seite verwendet wird, prüfe bitte ob Du nicht besser die bereits existierende Seite anpassen bzw. erweitern kannst. Ansonsten solltest Du einen anderen Titel für Deine Seite verwenden und einen Link dafür anlegen. Im MDN style guide findest Du entsprechende Richtlinien.

Um Deine neue Seite mit Inhalt zu versehen klicke auf den gerade angelegten, rot dargestellten Link (nachdem Du gespeichert und den Editor geschlossen hast). Die neue Seite wird im Bearbeitungsmodus geöffnet, so dass Du mit dem Schreiben beginnen kannst. Hinweise zur Verwendung des Editors findest Du im MDN editor guide.

Seiteninhalt aktualisieren

MDN's Unterstützung von KumaScript Makros und Transklusion (Mehrfachverwendung von Inhalten, z.B. von Textbausteinen) wird hin und wieder etwas beeinträchtigt durch das Zwischenspeichern von generierten Seiten im Cache, was wiederum aus Performance-Gründen notwendig ist. Seiten werden aus ihrem Quellcode generiert und das Ergebnis wird für zukünftige Aufrufe im Cache gehalten. Von da an wirken sich Änderungen an den Makros, an deren Output oder am Inhalt der transkludierten Teile nicht auf die Makros oder Transklusionen aus, die das Page Makro verwenden.

  • Um die Anzeige einer Seite manuell zu aktualisieren, kannst Du die Seite im Browser neu laden. MDN erkennt das und sendet die aktualisierte Seite an den Browser, inklusive des aktualisierten Makro Outputs und der aktualisierten Transklusionen.
  • Du kannst Seiten auch so konfigurieren, dass sie automatisch periodisch neu geladen werden. Dies sollte nur gemacht werden, wenn es unbedingt nötig ist. Details hierzu findest Du in Page regeneration.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
 Mitwirkende an dieser Seite: 1000eyes, lxdiamond, hejackedbonsai, Patrick_St., Shia
 Zuletzt aktualisiert von: 1000eyes,