(:toc-back:)

Wenn Sie nach der Bearbeitung auf Entwurf speichern klicken, wird der Seiteninhalt aktualisiert. Die Vorschau-Funktion erlaubt es Ihnen, einen Blick auf die Formatierung der Seite zu werfen, ohne die Änderungen sofort zu speichern.

Das Feld Zusammenfassung nimmt eine Kurzzusammenfassung einer Änderung auf, die dann in der Übersicht der letzten Änderungen erscheint. Auf diese Weise erleichtern Sie sich und anderen den Überblick über Veränderungen im Wiki. Typische Zusammenfassungen könnten sein: Einige Tippfehler behoben, Neuer Abschnitt zu Rechteverwaltung oder Screenshots aktualisiert. Das Feld Autor sollte Ihren Namen enthalten - so sind Änderungen Personen zuordenbar.

Login und Editierrechte

Ein Login ist derzeit nur erforderlich, um Administrationsaufgaben wahrzunehmen. Das sind:

• Publizieren von Entwurfsversionen
• Einrichten und Ändern von Accounts
• Setzen und Ändern von Zugriffsrechten für einzelne Seiten und Gruppen
• Nutzung von Übersichtsfunktionen

Mit Klick auf "Login" (oben rechts) können Sie sich bei der Wiki-Hilfe einloggen. Die Logins für die Basishilfe werden von Tobias Thelen vergeben, die Logins für lokale Sichten von den jeweiligen Administratoren vor Ort.

Vorhandene Seiten editieren (Entwurfsmodus)

Wenn Sie nach der Bearbeitung auf Entwurf speichern (1) klicken, wird der Seiteninhalt aktualisiert. Die Vorschau-Funktion (2) erlaubt es Ihnen, einen Blick auf die Formatierung der Seite zu werfen, ohne die Änderungen sofort zu speichern.

Das Feld Zusammenfassung (3) nimmt eine Kurzzusammenfassung einer Änderung auf, die dann in der Übersicht der letzten Änderungen erscheint. Auf diese Weise erleichtern Sie sich und anderen den Überblick über Veränderungen im Wiki. Typische Zusammenfassungen könnten sein: Einige Tippfehler behoben, Neuer Abschnitt zu Rechteverwaltung oder Screenshots aktualisiert. Das Feld Autor (4) sollte Ihren Namen enthalten - so sind Änderungen Personen zuordenbar.

Als nicht eingeloggter Autor können Sie Seiten nicht direkt ändern. Ihre Änderungen werden als Entwurf gespeichert und vor dem Publizieren von einem Administrator überprüft. Wenn für eine Seite bereits eine Entwurfsversion vorhanden ist, wird dies oben auf der Seite vermerkt, und Sie können sich diese Version anzeigen lassen. Eine Bearbeitung basiert dann immer auf der vorhandenen Entwurfsfassung.

Vorhandene Seiten editieren (Adminmodus) und Entwürfe publizieren

Als Administrator haben Sie neben der Option "Als Entwurf speichern" zusätzlich die Möglichkeit, eine Seite direkt zu publizieren.

Aufdie gleiche Weise publizieren Sie auch vorhandene Entwurfsversionen. Nachdem Sie Die dort enthaltenen Änderungen für gut befunden haben, klicken Sie auf "Seite bearbeiten" und dann auf "Publizieren".

Nach dem Publizieren einer Entwurfsversion wird die Entwurfsversion gelöscht.

Seiten werden gelöscht, indem der Text durch delete ersetzt wird.

Anschließend ist die Seite über das Wiki nicht mehr erreichbar, alle Versionsinformationen sind auch verloren. Intern wird die Datei umbenannt, so dass der Wiki-Administrator ggf. den Stand vor dem Löschen wiederherstellen kann.

Um ein vorhandenes Bild (das folgende gilt analog für alle Arten von Dateien) zu ersetzen, kann zum einen der vorhandene Link geändert und ein neues Bild hochgeladen werden. Vorteil: das alte Bild kann ggf. rekonstruiert werden. Nachteile: Es ist schwierig, weitere gute Namen zu finden und es bleiben unreferenzierte Dateien zurück.

Alternativ kann ein gleichnamiges Bild hochgeladen werden, das das vorhandene Bild überschreibt. Hierzu ist die Sicht "upload" geeignet, die einen Upload-Dialog bietet. Laden Sie hier eine Datei hoch und tragen Sie unter "optional anderer Name" den Namen der zu ersetzenden Datei ein, falls die hochgeladene Datei nicht ohnehin so heißt.

Andere Einträge auf der Seite sind sinnvoll, da die Seite auch als Inhaltsverzeichnis verwendet wird. Überschriften, Erklärungen hinter den Links etc. werden für die Navigation ignoriert, stören diese auch nicht und mahen die Seite übersichtlicher.

• ![[Basis.Forum]] wird nicht erkannt, weil es eine Überschrift ist
• *[[Basis.Forum]] wird als Kapitelüberschrift erkannt
• **[[Basis.ForumLetzteBeiträge]] wird als Unterkapitelüberschrift erkannt
• * So können Sie [[Basis.LiteraturBearbeiten]] wird nicht erkannt, weil der Link nicht direkt hinter dem Aufzählungszeichen steht

• Verwenden Sie kurze, treffende Beschreibungen für die Links, z.B. [[Basis.Homepage|Die eigene Homepage]]

Trail-Navigation und Menuspalte werden über die Einträge auf der Wiki-Seite Basis.MenuBar gesteuert. Bei der Bearbeitung dieser Seite bitte folgende Punkte beachten:

• Es werden nur Seiten erkannt, die als Links in Aufzählungen, direkt nach dem Aufzählungszeichen stehen
  • ![[Basis.Forum]] wird nicht erkannt, weil es eine Überschrift ist
  • *[[Basis.Forum]] wird als Kapitelüberschrift erkannt
  • **[[Basis.ForumLetzteBeiträge]] wird als Unterkapitelüberschrift erkannt
  • * So können Sie [[Basis.LiteraturBearbeiten]] wird nicht erkannt, weil der Link nicht direkt hinter dem Aufzählungszeichen steht

Kurzfassung: DOs und DONTs

(:toc-back:)

(:toc-back:)

(:toc-back:)

(:toc-back:)

(:toc-back:)

(:toc-back:)

(:tocback:)

(:tocback:)

(:tocback:)

(:tocback:)

(:tocback:)

(:tocback:)

Login und Editierrechte [noch nicht verfügbar]

Mit Klick auf … können Sie sich bei der Wiki-Hilfe einloggen. Berechtigt sind dazu alle Nutzer, die mindestens Tutorenrechte im Developer-Board (http://develop.studip.de) haben, Benutzername und Passwort sind mit denen des Developer-Boards identisch. Nach erfolgreichem Einloggen werden auf jeder Seite erweitere Möglichkeiten angezeigt:

• Bearbeiten: Seiten bearbeiten
• …

• Keine Seiten anlegen, die nicht auf die Menu-Seite eingetragen werden, das bringt die Navigationsmechanismen durcheinander.

• Alle Hilfeseiten für die Kerndistribution in die Gruppe Basis

• Keine Artikel, Präpositionen und andere Funktionswörter in Seitennamen verwenden. NeueMitgliederZuDerEinrichtungHinzufügen ist ungünstig, besser ist hier EinrichtungMitgliederHinzufügen

• Beschreibende Seitennamen unter Einbeziehung des Moduls wählen, z.B. Basis.LiteraturSuchen

• Keine zu allgemeinen Namen für hochgeladene Bilder und Dateien. screenshot.jpg ist eine schlechte Wahl.

• Alle Links sollen den Gruppennamen enthalten, also [[Basis.Forum]] statt nur [[Forum]]
• Alle Hilfeseiten für die Kerndistribution in die Gruppe
• Beschreibende Seitennamen unter Einbeziehung des Moduls wählen, z.B. Basis.LiteraturSuchen

Basis

Alle Bilder/Dateien einer Gruppe bilden einen gemeinsamen Namesraum. Sie können also z.B. die Datei achtung.gif auf vielen Seiten verwenden, ohne Sie mehrfach hochzuladen. Wählen Sie beschreibende, detaillierte Namen für Dateien, z.b. unter Einbeziehung des Modulnamens. literatur_suchen.jpg ist ein eher guter Name, screenshot.jpg ein eher ungeeigneter.

• Do:

• Don't:

Kurzfassung DOs und DONTs

• DO:
  • Alle Hilfeseiten für die Kerndistribution in die Gruppe Basis
• DONT:
  • Keine Seitennamen mit Punkten oder Schrägstrichen

Bilder/Dateien ersetzen/aktualisieren

Seiten löschen

Die Menuspalte links listet die Kapitellinks auf und klappt die mit der aktuellen Seite verbundenen Untereinträge (auch mehrfach geschachtelt) auf.

Die Menuspalte links und die Trail-Navigation über den Überschriften (im Screenshot gelb hinterlegt) werden automatisch aus einer Wiki-Seite gewonnen, die alle relevanten Hilfe-Seiten für eine Stud.IP-Rechtestufe aufführt.

Die Trail-Navigation ermöglicht einen sequentielle Durchgang durch die Hilfeseiten mit dem Optionen vorherige Seite, Inhaltsverzeichnis und nächste Seite. Verschachtelungen werden hier nicht gesondert berücksichtigt.

Die Menuspalte links und die Trail-Navigation über den Überschriften (im Screenshot gelb hinterlegt) werden automatisch aus einer Wiki-Seite gewonnen, die alle relevanten Hilfe-Seiten für eine Stud.IP-Rechtestufe aufführt.

Navigation und Menuspalte

Die Menuspalte links und die Trail-Navigation oben werden automatisch aus einer Wiki-Seite gewonnen, die alle relevanten Hilfe-Seiten für eine Stud.IP-Rechtestufe aufführt.

1. Verwenden des Markups Attach:dateiname.jpg und Absenden der Änderung

• Basis.DateienUpload
• Basis.LiteraturErfassen

Namenskonvention für Stud.IP-Hilfeseiten

Für die Verwendung innerhalb der Stud.IP-Hilfe sollten folgende Namenskonventionen beachtet werden, damit Namenskonflikte vermieden werden und die interne Verlinkung leichter fällt:

• Alle Hilfeseiten für Funktionen der Stud.IP-Kerndistribution gehören in die Gruppe Basis
• Seitennamen sind zweiteilig:
  • Modul-/Bereichsbezeichnung
  • Unterseitenbezeichnung innerhalb des Moduls
• Die Start-/Einsprungseite einer Modulhilfe trägt nur den Modulnamen. Beispiele:
  • Basis.Dateien
  • Basis.Literatur
  • Basis.Einrichtungen
• Die Unterseitenbezeichner bestehen aus einem oder mehreren ausgeschriebenen Wörtern, die mit Großbuchstaben beginnen. Beispiele:
  • Basis.DateienHochladen?
  • Basis.LiteraturVerwalten?
  • Basis.HomepageUniversitäreDaten
• Abkürzungen vermeiden!
• Nicht zu lange Namen wählen, zwei bis drei Wörter sollten ausreichen.
• Umlaute können in den Namen verwendet werden, ae, ue, oe etc. vermeiden!
• KEINE Punkte oder Schrägstriche in den Namen. Stud.IP soll als StudIP geschrieben werden.

In diesem Wiki gibt es folgende Gruppen:

• Main - enthält nur die Startseite mit Verzweigung zu den unterschiedlichen Sichten.
• Basis - Alle Hilfeseiten der Basis-Stud.IP-Distribution, keine Plugin-Hilfeseite, keine standortspezifischen Hilfeseiten
• HilfeWiki - Dokumentation des Hilfe-Wikis

Eine Besonderheit von pmwiki sind so genannte Gruppen. Die Seiten eines Wikis können sich auf beliebig viele Gruppen verteilen, wobei jede Gruppe einen eigenen Namensraum bildet, d.h. z.B. die Seite Homepage kann in jeder Gruppe unabhängig von den anderen gefüllt werden. Gruppen können nicht hierarchisch verschachtelt werden.

Ein Wiki-Seiten-Name setzt sich demnach aus zwei Teilen zusammen: Gruppe.Seite oder Gruppe/Seite. Beide Schreibweisen sind synonym. Wird der Gruppenteil eines Namens z.B. bei Links weggelassen, verweist der Link auf die bezeichnete Seite der aktuellen Gruppe. Wenn nicht besonder e Effekte durch Weglassen des Gruppennamens erzielt werden sollen, ist es bei Wikis, die mehrere Gruppen verwenden (so wie dieses) immer ratsam, den Gruppennamen mit anzugeben.

Achtung: Seitennamen dürfen keine Punkte oder Schrägstriche enthalten!

Wenn versehentlich eine Seite Basis.Stud.IP oder Basis/Stud.IP angelegt wird, ignoriert pmwiki den ersten Teil des Bezeichners und legt tatsächlich eine Seite IP in der Gruppe Stud an.

Neue Seiten anlegen, Seitennamen

Wie in Wikis üblich, legen Sie Seiten dadurch an, dass Sie auf sie verlinken und anschließend auf den neu entstandenen Link klicken. In dieser pmwiki-Installation sind WikiWords abgeschaltet, d.h. Sie können ausschließlich die Form mit eckigen Klammern zum Verlinken verwenden (s. Textformatierungsregeln).

Formatierungssyntax

Die Formatierungssyntax wird unter jedem Eingabefeld kurz erläutert, Links auf die pmwiki-Dokumentation führen auf vertiefende Dokumentationsseiten. Eine Button-Leiste (6) erleichtert zudem die Eingabe.

An dieser Stelle wird die pmwiki-Syntax nicht weiter erläutert, sondern nur einige Punkte herausgestellt, die sich häufiger für Anfänger als problematisch herausgestellt haben.

Bilder/Dateien einbinden

In pmwiki können Bilder und Dateien hochgeladen und auf Wiki-Seiten verlinkt bzw. angezeigt werden. Dies ist ein zweischrittiges Verfahren:

1. Verwenden des Markups Attach:dateiname.jpg und Absenden der Änderung
2. Anschließend erscheint das Attach wie ein Link auf eine nicht vorhandene Wiki-Seite, ein Klick darauf führt zu einem Upload-Dialog. Anschließend ist die Datei in pmwiki vorhanden und der Link aktiv bzw. das Bild eingebunden.

Wenn Sie nach der Bearbeitung auf Speichern (1) klicken, wird der Seiteninhalt aktualisiert. Der Knopf Speichern und Bearbeiten (2) speichert zwischen und lässt Sie direkt weitereditieren. Dies ist bei längeren Arbeiten am Text besonders empfehlenswert. Die Vorschau-Funktion (3) erlaubt es Ihnen, einen Blick auf die Formatierung der Seite zu werfen, ohne die Änderungen sofort zu speichern.

Das Feld Zusammenfassung (4) nimmt eine Kurzzusammenfassung einer Änderung auf, die dann in der Übersicht der letzten Änderungen erscheint. Auf diese Weise erleichtern Sie sich und anderen den Überblick über Veränderungen im Wiki. Typische Zusammenfassungen könnten sein: Einige Tippfehler behoben, Neuer Abschnitt zu Rechteverwaltung oder Screenshots aktualisiert. Das Feld Autor (5) sollte Ihren Namen enthalten - so sind Änderungen Personen zuordenbar.

Ein Klick auf "Bearbeiten" öffnet eine gerade angezeigte Seite im Bearbeitungsmodus. Sie sehen dann den Seiteninhalt in einer speziellen Schreibweise, die Überschriften, Links, eingebundene Bilder, Fettdruck etc. auf einfache Weise abbildet.

Wenn Sie nach der Bearbeitung auf Speichern klicken, wird der Seiteninhalt aktualisiert. Der Knopf Speichern und Bearbeiten speichert zwischen und lässt Sie direkt weitereditieren. Dies ist bei längeren Arbeiten am Text besonders empfehlenswert. Die Vorschau-Funktion erlaubt es Ihnen, einen Blick auf die Formatierung der Seite zu werfen, ohne die Änderungen sofort zu speichern.

Das Feld Zusammenfassung nimmt eine Kurzzusammenfassung einer Änderung auf, die dann in der Übersicht der letzten Änderungen erscheint. Auf diese Weise erleichtern Sie sich und anderen den Überblick über Veränderungen im Wiki. Typische Zusammenfassungen könnten sein: Einige Tippfehler behoben, Neuer Abschnitt zu Rechteverwaltung oder Screenshots aktualisiert. Das Feld Autor sollte Ihren Namen enthalten - so sind Änderungen Personen zuordenbar.

Das Stud.IP-Hilfe-Wiki verwendet pmwiki als Grundlage. Über die Standardinstallation hinaus sind einige Erweiterungen installiert bzw. in wenigen Fällen gesondert programmiert worden. Dieses Dokument informiert Sie über die wichtigsten Editierregeln für pmwiki und über die spezifischen Arbeitsabläufe für die Stud.IP-Hilfe.

Schnellstart für Hilfe-Autoren

(:toc:)

Das Stud.IP-Hilfe-Wiki verwendet pmwiki als Grundlage. Über die Standardinstallation hinaus sind einige Erweiterungen installiert bzw. in wenigen Fällen gesondert programmiert worden. Dieses Dokument informiert Sie über die wichtigsten Editierregeln für pmwiki und über die spezifischen Arbeitsabläufe für die Stud.IP-Hilfe.

Vorhandene Seiten editieren