Papaya Wiki Benutzerhandbuch
Aus PapayaCMS
Das papaya Wiki ist ein freies papaya-Modulpaket (GNU GPL), das ein Wiki zur Verwendung innerhalb Ihrer papaya CMS-Installation bereitstellt. Ein Großteil der Wiki-Syntax ist kompatibel zu dem weit verbreiteten System MediaWiki.
Hinweis Dies ist das Benutzerhandbuch für das papaya Wiki-Modul. Wenn Sie wissen möchten, wie Sie das Wiki in Ihrer papaya CMS-Installation einrichten können, lesen Sie bitte das Administrationshandbuch.
Inhaltsverzeichnis |
Die Wiki-Seiten verwenden
Das papaya Wiki besteht aus drei verschiedenen Seiten:
- Die Indexseite enthält eine Übersicht über alle Artikel und Kategorien
- Die Artikelseite kann verwendet werden, um Artikel zu lesen und zu bearbeiten sowie um ihre Versionen zu vergleichen
- Die Upload-Seite ermöglicht es eingeloggten Usern, Mediendateien hochzuladen, die sie in Artikeln verwenden können
Die Indexseite verwenden
Die Indexseite besteht vor allem aus Artikel- und Kategorie-Links.
Das oberste Elemente ist der Artikel-Suchdialog. Geben Sie einen Artikeltitel ein und klicken Sie auf den Absendebutton (Originalbeschriftung Go) oder drücken Sie einfach Return, um den entsprechenden Artikel zu lesen. Wenn der Artikel nicht existiert, können Sie ihn erstellen.
Unter dem Dialog sehen Sie die Hauptnavigation der Indexseite. Hier gibt es drei Arten von Links:
- Categories/Kategorien zeigt die Liste der Kategorien des Wikis an.
- Recently modified/Zuletzt geändert zeigt eine Liste von Artikeln an, die vor Kurzem erstellt oder geändert wurden, und zwar in absteigender Reihenfolge nach Änderungszeitpunkt. Die Anzahl der Artikel in dieser Liste kann von einem Wiki-Administrator eingestellt werden. Das Standardmaximum beträgt 15.
- Articles/Artikel. Hier sehen Sie entweder einen einzelnen Artikel-Link oder aber einen Link pro Anfangsbuchstabe (sowie '#' für Artikel, die mit Ziffern oder Satzzeichen beginnen), je nach Konfiguration der Seite.
Wenn Sie Kategorien oder einen der Artikel-Links (Artikel oder einen Anfangsbuchstaben) anklicken, werden eventuell Paging-Links angezeigt, falls die Anzahl der Elemente eine Grenze überschreitet, die in der Konfiguration der Seite eingestellt werden kann. Die Standardwerte sind 10 Kategorien beziehungsweise 25 Artikel pro Seite.
Hinweise: Details über das Ändern von Einstellungen für die Indexseite lesen Sie unter Die Wiki-Indexseite einrichten im Administrationshandbuch.
Die Artikelseite verwenden
Gleich unter dem Seitentitel sehen Sie den Artikel-Suchdialog, der bereits für die Indexseite beschrieben wurde.
Darunter folgt die Hauptnavigation, die folgende Links anbietet (Hinweis: In manchen Situationen sind nicht alle Links sichtbar):
- Index: Navigieren zur Indexseite
- Article/Artikel: Den aktuellen Artikel lesen und seinen Links folgen
- Edit/Bearbeiten: Den aktuellen Artikel bearbeiten
- Versions/Versionen: Versionen des aktuellen Artikels ansehen und vergleichen
- Random article/Zufälliger Artikel: Einen zufälligen Artikel lesen
Wenn Sie die Seite aufrufen, ohne einen Artikel auszuwählen, sehen Sie entweder eine Fehlermeldung oder einen Artikel-Teaser, je nach Konfiguration der Seite.
Hinweise: Für Details zum Ändern von Einstellungen für die Artikelseite lesen Sie bitte Die Wiki-Artikelseite einrichten im Wiki-Administrationshandbuch.
Artikel bearbeiten
Um einen bestehenden Artikel zu arbeiten, können Sie ihn mit Hilfe der Indexseite suchen oder seinen Titel in das Dialogfeld Artikel eingeben. Klicken Sie dann auf den Link Edit/Bearbeiten über dem Artikel. Wenn Sie diesen Link nicht sehen, ist die Bearbeitung eingeloggten Usern vorbehalten, und Sie müssen sich zuerst anmelden.
Um einen neuen Artikel zu erstellen, brauchen Sie nur seinen Titel in das Dialogfeld Article/Artikel einzugeben. Wenn der Artikel noch nicht existiert, sehen Sie automatisch den Editor, außer wenn das Bearbeiten eingeloggten Benutzern vorbehalten ist und Sie nicht angemeldet sind. de.
Führen Sie beliebige Änderungen am Wiki-Code des Artikels durch. Die vom papaya-Wiki unterstützte Syntax wird weiter unten auf diese Seite beschrieben. Wenn Sie fertig sind, können Sie optional einen Comment/Kommentar eingeben, der Ihre Änderungen zusammenfasst. Klicken Sie danach auf Save article/Artikel speichern, um Ihre Änderungen zu speichern. Sie können auch auf Preview/Vorschau klicken, um die Auswirkungen Ihrer Änderungen zu sehen, ohne sie zu speichern. beachten Sie, dass Links, Medien und Kategorien im Vorschaumodus zurzeit nicht funktionieren.
Datenschutzhinweis: Wenn Sie Artikel editieren, ohne eingeloggt zu sein, wird Ihre aktuelle IP-Adresse als Autoreninformation gespeichert.
Artikelversionen vergleichen
Um die Versionsliste des aktuellen Artikels anzuzeigen, klicken Sie auf den Link Versions/Versionen. Die Versionen werden in einer Tabelle mit folgenden Spalten angezeigt:
- Version: Zeitstempel der jeweiligen version. Wenn Sie einen dieser Links anklicken, können Sie diese Version des Artikels lesen und bearbeiten. Hinweis: Wenn Sie auf Save/Speichern klicken, basiert die neueste Version des Artikels auf der entsprechenden Version.
- (Vergleichen): Wählen Sie die Radio-Buttons von zwei verschiedenen Versionen aus, um die Änderungen zu sehen. Der Vergleich wird in einer zweispaltigen Tabelle im reinen Textmodus angezeigt. Geänderte Absätze werden durch farbige Hintergründe gekennzeichnet: Grün für hinzugefügte Absätze, rosa für entfernte Absätze und gelb für veränderte Absätze.
- Auhtor/Autor: Wenn der Autor einer Änderung eingeloggt war, erscheint hier der Username. Andernfalls wird die IP-Adresse der verwendeten Internetverbindung angezeigt.
- Comment/Kommentar: Wenn ein User beim Speichern des Artikels einen Kommentar eingegeben hat, dann wird der Kommentar in dieser Spalte angezeigt.
Die Upload-Seite verwenden
Klicken Sie auf der Artikelseite auf den Link Upload, um die Upload-Seite aufzurufen. Wenn der Link nicht angezeigt wird, sind Sie wahrscheinlich nicht eingeloggt und sollten dies nachholen. Wenn Sie diese Seite betreten, ohne eingeloggt zu sein, wird eine Fehlermeldung angezeigt.
Das Upload-Formular enthält vier felder:
- Upload file/Upload-Datei (Pflichtfeld): Suchen Sie eine Datei zum Hochladen aus, indem Sie auf Durchsuchen/Browse klicken.
- Alternate file name/Alternativer Dateiname (optional): Geben Sie einen Namen ein, unter dem Sie im Wiki auf die Datei zugreifen möchten. Wenn Sie dieses Feld leer lassen, wird der Original-Dateiname verwendet.
- Title/Titel (optional): Geben Sie einen Titel für die Datei ein. Er erscheint auf der Datei-Detailseite sowie in der Dateibox, wenn Sie bestimmte Angaben in Ihrem Wiki-Code verwenden. Der Titel dient auch als Linkbeschriftung, wenn Ihre Datei kein darstellbares Bild ist.
- Description (optional): Geben Sie eine Beschreibung für die Datei ein. Sie erscheint auf der Datei-Detailseite sowie in der Dateibox, wenn Sie bestimmte Angaben in Ihrem Wiki-Code verwenden.
Klicken Sie auf Upload, um den eigentlichen Upload durchzuführen und die Metadaten zu speichern. Sie können die Datei betrachten, indem Sie File:Dateiname (bzw, die lokalisierte Fassung, wahrscheinlich Datei:Dateiname) in das Feld Artikel eingeben.
Note: Für Details über das Einrichten der Upload-Seite lesen Sie bitte Die Wiki-Upload-Seite einrichten im Wiki-Administrationshandbuch.
Vom papaya CMS Wiki unterstützte Wiki-Syntax
Das papaya CMS Wiki unterstützt eine Teilmenge der MediaWiki-Syntax, die in den nachfolgenden Unterabschnitten beschrieben wird.
Absätze
Wenn Sie eine Zeile komplett leer lassen, wird ein neuer Absatz begonnen (ein einfacher Zeilenumbruch genügt nicht).
Beispiel:
Dies ist ein Absatz. Dies ist Teil des ersten Absatzes. Dies ist ein neuer Absatz.
Überschriften
Je nach Überschriftebene wird eine unterschiedliche Anzahl von =-Zeichen verwendet. Beispiele:
== Überschrift Ebene 2 == === Überschrift Ebene 3 ===
Wenn Sie einen Artikel lesen, wird aus der Überschriftenhierarchie automatisch ein Inhaltsverzeichnis erstellt.
Hinweis: Der Titel des Artikels selbst ist die Hauptüberschrift, so dass es keine Überschriften der Ebene 1 gibt.
Links
Es gibt zwei verschiedene Arten von Links:
- Wiki-Links (intern, verweisen auf andere Artikel)
- Externe Links auf Web-URLs
Einen Wiki-Link können Sie folgendermaßen erstellen:
[[Artikeltitel|Beschriftung]]
Die Beschriftung ist optional; wenn Sie sie weglassen, wird der Titel des verlinkten Artikels selbst als Beschriftung verwendet. Oft ist dies in Ordnung, aber aus Grammatik- oder Kontextgründen könnte auch eine andere Beschriftung angebracht sein. Hier zwei Beispiele, eines mit und eines ohne Beschriftung:
[[USA|US]]-Präsident [[Barack Obama]]
Externe Hyperlinks verwenden die folgende Syntax:
[URL caption]
Auch hier ist die Beschriftung optional. Wenn Sie sie weglassen, wird die URL selbst als Linktext verwendet. Beispiele:
Das papya Wiki-Administrationshandbuch finden Sie unter [http://de.wiki.papaya-cms.com/].
Bitte lesen Sie das [http://de.wiki.papaya-cms.com/ Administrationshandbuchl] für weitere Informationen.
Listen
Es gibt zwei Arten von Listen: Aufzählungen und einfache Listen. Eine Aufzählung wird wie folgt erstellt:
# Erstes Element # Zweites Element
Eine einfache Liste erzeugen Sie folgendermaßen:
* Erstes Element * Zweites Element
Beide Arten von Listen können verschachtelt werden, sogar miteinander vermischt. Beispiel:
* Erstes Hauptelement ** Erstes Unterelement ** Zweites Unterelement * Zweites Hauptelement ** Erstes Unterelement ** Zweites Unterelement
Definitionslisten
Definitionslisten mit nicht eingerücktem Thema und eingerückter Definition werden so erstellt:
; Thema : Definition
Einrückung
Ein Doppelpunkt am Anfang eines Absatzes rückt den Absatz um einen Schritt ein; mehr als ein Doppelpunkt erzeugt tiefere Einrückungen. Beispiel:
Normaler Absatz : Absatz mit einfacher Einrückung :: Absatz mit doppelter Einrückung
Tabellen
Tabellen können Sie mit Hilfe der folgenden Syntax erstellen:
{|
|+ Tabellenbeschriftung
|-
!Überschriftzelle
!Überschriftzelle
|-
|Normale Zelle
|Normale Zelle
|}
Der Tabellenbeginn kann Attribute für die gesamte Tabelle enthalten. Das folgende Beispiel erzeugt eine Tabelle mit zwei Pixel breitem Rand und grauem Hintergrund:
{|border=2 bgcolor=#999999
Auch für Zeilen und Zellen können Sie Attribute verwenden. Bei Zellen müssen Sie die Attribute und Inhalte durch | voneinander trennen. Die folgende Zelle erstreckt sich beispielsweise über zwei Zeilen und zwei Spalten (bitte beachten Sie, dass Sie in dem Bereich, der von dieser Zelle bedeckt wird, die entsprechenden Zellen weglassen müssen):
|rowspan=2 colspan=2|Inhalt der "vierzelligen Zelle"
Texthervorhebung
Um Text hervorzuheben, können Sie Teile davon als fett oder kursiv kennzeichnen. Dies geschieht mit Hilfe von drei beziehungsweise zwei einzelnen Anführungszeichen vor und nach dem hervorzuhebenden Bereich:
'''fett''' ''kursiv'' '''''fett und kursiv'''''
Struktur
Am Ende eines Artikels sollten Sie spezielle Struktur-Links verwenden, jeden von ihnen in einer eigenen Zeile: Kategorie-Einträge sowie Versionen des aktuellen Artikels in anderen Sprachen.
Kategorie-Einträge
Ein Kategorie-Eintrag funktioniert so:
[[Category:Name der Kategorie]]
Hinweis Der englische Begriff 'Category' funktioniert immer. Ein lokalisierter Begriff wie beispielsweise 'Kategorie' lässt sich im Backend einstellen (siehe Administrationshandbuch).
Die Kategorien, denen ein Artikel angehört, werden als Liste am Ende des Artikels angezeigt; wenn Sie "Category:Name der Kategorie" als Artikeltitel eingeben, wird eine Liste aller Artikel aus dieser Kategorie angezeigt.
Hinweis: Um auf eine Kategorie zu verlinken, setzen Sie einen weiteren Doppelpunkt vor das Schlüsselwort Category:
Die USS Enterprise NCC-1701-D ist ein [[:Category:Raumschiffe|Raumschiff]], das im 24. Jahrhundert für die Sternenflotte der Vereinten Föderation der Planeten gebaut wurde.
Sparch-Links
Sprach-Links können Sie folgendermaßen erstellen:
[[ISO-Sprachcode:Artikeltitel]]
Angenommen, Sie haben eine deutsche Seite mit dem Titel "Demokratie". Dann können Sie wie folgt Links für Englisch und Französisch hinzufügen:
[[en:Democracy]] [[fr:Démocracie]]
Wenn Sprach-Links für den aktuellen Artikel gesetzt sind, werden sie automatisch als Seiten-Übersetzungslinks verwendet. Wenn es keinen passenden Sprach-Link gibt, wird in der entsprechenden Sprache stattdessen die Wiki-Indexseite (alphabetische Liste aller Artikel) verwendet.
Weiterleitungen
Wenn Sie der Meinung sind, dass ein Schlüsselwort auf einen existierenden Artikel weiterleiten sollte, erstellen Sie den Artikel, indem Sie dieses Schlüsselwort eingeben und folgenden Wiki-Code eingeben:
#Redirect [[Titel des Artikels, auf den Sie weiterleiten möchten]]
Jeglicher nachfolgende Wiki-Code auf einer solchen Seite wird ignoriert. Angenommen, Sie haben eine Seite mit dem Titel Personal Computer, und Sie möchten einen neuen Eintrag namens PC erstellen, der auf dieser weiterleitet. Geben Sie "PC" in das Artikelfeld ein und schreiben Sie folgenden Wiki-Code:
#Redirect [[Personal Computer]]
Hinweis Das englische Schlüsselwort 'Redirect' funktioniert immer. Eine lokalisierte Variante wie beispielsweise 'Weiterleitung' kann im Backend konfiguriert werden (siehe Administrationshandbuch).
Nowiki-Bereiche
Für Codeblöcke oder zur Beschreibung von Wiki-Code können Sie nowiki-Bereiche verwenden. Dies funktioniert folgendermaßen:
<nowiki> ... beliebiger Text ... </nowiki>
Wichtig: HTML-Sonderzeichen wie < oder > müssen auch in Nowiki-Bereichen escaped werden (z.B. > für >).
Dateien
Verwenden Sie die Wiki-Upload-Seite, um Dateien hochzuladen. Sie können entweder den Original-Dateinamen beibehalten oder Ihren eigenen eingeben. Nach dem Upload können Sie eine Datei mit Hilfe der folgenden Syntax in eine Wiki-Seite einbinden:
[[File:Dateiname|Optionen]]
Es stehen folgende Optionen zur Verfügung, jeweils durch | getrennt:
- border: Einen Rahmen um den Dateibereich anzeigen. In diesem Fall werden auch der Dateititel und die Beschreibung angezeigt.
- left, right, or center: Ausrichtung des Dateibereichs auf der Seite. left oder right sorgt automatisch dafür, dass andere Inhalte den Dateibereich umfließen; Überschriften beenden das Umfließen.
- mxnpx, mpx oder xnpx setzt Breite und Höhe, nur Breite beziehungsweise nur Höhe der Datei. Funktioniert nur, wenn die Datei ein Bild ist.
- thumb[nail]: Die Datei als Thumbnail darstellen, falls sie ein Bild ist. Die Angabe der Breite und/oder der Höhe erstellt automatisch ein Thumbnail; wenn Sie thumb ohne Angabe der Größe verwenden, werden die Standard-Größenangaben aus den Seiteneinstellungen verwendet.
Referenzen
Wenn Sie Wiki-Code innerhalb einer Zeile zwischen <ref> und </ref> setzen, wird der Inhalt als Referenz dargestellt: An der Originalposition wird ein hochgestellter, nummerierter Link angezeigt. Die Liste der Referenzen wird automatisch am Fuß der Seite angezeigt. Wenn Sie einen Referenz-Link anklicken, springt der Browser nach unten zur passenden Fußnote. Referenzen sind praktisch, wenn Sie die Quellen Ihrer Artikel angeben müssen, ähnlich wie die Fußnoten-Referenzen in wissenschaftlichen Arbeiten.
Quellcode
Das papaya Wiki kann mit Hilfe des mit dem System gelieferten GeSHi Syntax Highlighter automatisch Sourcecode formatieren. Um einen Abschnitt als Sourcecode zu markieren, verwenden Sie Code wie diesen:
<source lang="Sprache"> ... beliebiger Sourcecode ... </source>
Die Liste der unterstützten Sprachen finden Sie auf der GeSHi-Website.
