für die Liste aller Seiten
Autoren (Grundlagen)
Die Seiten auf dieser Site sind WikiWikiWeb-Seiten. Dies bedeutet, dass Seiten einfach neu angelegt und von mehreren Autoren bearbeitet werden können. Durch Klicken auf den Edit-Link (der sich üblicherweise im Kopf- oder im Fußbereich befindet) kann eine Seite zum Bearbeiten geöffnet werden. Einige Seiten können durch Passwörter geschützt sein. Dies hängt von den Sicherheitseinstellungen des Systems ab. Viele WikiWikiWeb-Systeme erlauben jedoch das freie Bearbeiten aller Seiten.
Regeln zum Bearbeiten
PmWiki ist nicht WYSIWYG – wenn Sie eine Seite bearbeiten, sehen Sie den Markup-Text (Text mit Auszeichnungen, Wikisyntax), welcher den Inhalt der Seite beschreibt. Die grundlegenden Regeln der Syntax sind sehr einfach:
- Zwischen zwei Absätze gehört eine Leerzeile mehr.
- Um eine Liste wie diese hier zu erstellen, muss jede Zeile mit einem
#
für nummerierte (geordnete) Listen oder mit einem *
für nicht nummerierte (ungeordnete) Listen begonnen werden mehr.
- Um eine Überschrift zu erzeugen, muss eine Zeile mit einem oder mehreren Ausrufezeichen
!
begonnen werden; !!
ist eine Überschrift zweiter Ordnung und !!!
eine Überschrift dritter Ordnung.
- Um Text hervorzuheben, kann dieser in 2 oder 3 Hochkommata (Umschalttaste und #) gesetzt werden;
''text''
für kursiv und '''text'''
für fett mehr.
- Um einen Verweis zu einer anderen Seite zu setzen, wird deren Seitenname in doppelte eckige Klammern gefasst; z. B. verweist
[[basic editing]]
auf diese Seite. Verweise zu nicht existierenden Seiten werden speziell markiert, um andere zum Anlegen solcher Seite einzuladen mehr.
- Um einen Verweis auf eine andere Netzseite zu setzen, wird einfach die Adresse eingegeben, z. B. https://www.example.com/ . E-Mail-Verweise beginnen mit '
mailto:
', z. B. mailto:xyz@beispiel.de .
Zum Ausprobieren steht der Sandkasten zur Verfügung. Dort können Sie das Bearbeiten testen, ohne dass die Gefahr besteht, etwas Wichtiges zu löschen. In Talk-Seiten und bei Diskussionen gehört es zum guten Ton, dass Sie Ihren Beitrag signieren, mittels ~~~
'unterzeichnen' Sie mit dem Namen, den Sie im Feld "Autor" des Bearbeitenformulars eingetragen haben.
Beispiele
Die nachfolgende Tabelle zeigt die gebräuchlichsten Formatierungsanweisungen, um Seiten zu gestalten. Die rechte Spalte zeigt das erzielte Ergebnis, die linke Spalte welche Syntax dieses erzeugt. Weitere Formatierungsanweisungen finden sich in den Textformatierungsregeln und auf anderen Seiten der Dokumentation. Eine vollständige Liste der Standardregeln ist unter Übersicht der Auszeichnungen verfügbar.
Absätze
Ein einfacher Zeilensprung
hat im Allgemeinen keine
Auswirkung auf das Layout.
Ein Autor muss eine oder mehrere
Leerzeilen einfügen, um einen neuen
Absatz zu beginnen.
| Ein einfacher Zeilensprung
hat im Allgemeinen keine
Auswirkung auf das Layout.
Ein Autor muss eine oder mehrere
Leerzeilen einfügen, um einen neuen
Absatz zu beginnen.
|
-> Ein Pfeil (->) rückt einen
Absatz ein.
Mit Leerzeichen eingerückter
Text passt sich an den durch
Pfeile erzeugten Einzug an.
--> Längere Pfeile (-->) erzeugen
einen stärkeren Einzug.
-< Ein umgekehrter Pfeil (-<) erzeugt
einen hängenden Einzug: die erste
Zeile ist herausgezogen, die
folgenden Zeilen sind eingerückt.
--< Längere umgekehrte Pfeile bewirken einen eingerückten hängenden Einzug.
| Ein Pfeil (->) rückt einen
Absatz ein.
Mit Leerzeichen eingerückter
Text passt sich an den durch
Pfeile erzeugten Einzug an.
Längere Pfeile (-->) erzeugen
einen stärkeren Einzug.
Ein umgekehrter Pfeil (-<) erzeugt
einen hängenden Einzug: die erste
Zeile ist herausgezogen, die
folgenden Zeilen sind eingerückt.
Längere umgekehrte Pfeile bewirken einen eingerückten hängenden Einzug.
|
Zeilen, die mit einem Leerzeichen
beginnen, werden exakt so formatiert
wie eingegeben -- in einer Schriftart
mit fester Zeichenbreite.
Achtung: Sehr lange Zeilen können dabei
sehr breite Wikiseiten verursachen.
| Zeilen, die mit einem Leerzeichen
beginnen, werden exakt so formatiert
wie eingegeben -- in einer Schriftart
mit fester Zeichenbreite.
Achtung: Sehr lange Zeilen können dabei
sehr breite Wikiseiten verursachen.
|
Siehe auch Textausrichtung
- Dies gehört nicht zu den Basics ****
- Ein Hinweis auf die passende Stelle sollte genügen ****
%rfloat% Dieser Text schwebt auf der rechten Seite.
%rframe% Dieser Text schwebt mit einem Rahmen auf der rechten Seite.
Hier etwas normaler Text, damit der Effekt des Zentrierens im folgenden Beispiel deutlich wird.
%center% Dieser Text ist zentriert.
%right% Dieser Text ist rechtsbündig ausgerichtet. (Eine Einrückung -> wird benötigt, wenn der vorstehende Text nicht eingerückt ist.)
| Dieser Text schwebt auf der rechten Seite.
Dieser Text schwebt mit einem Rahmen auf der rechten Seite.
Hier etwas normaler Text, damit der Effekt des Zentrierens im folgenden Beispiel deutlich wird.
Dieser Text ist zentriert.
Dieser Text ist rechtsbündig ausgerichtet. (Eine Einrückung -> wird benötigt, wenn der vorstehende Text nicht eingerückt ist.)
|
Zeilenumbrüche
Zwei umgekehrte Schrägstriche am Zeilenende\\
erzeugen einen Zeilenumbruch.
Wikistile und andere '''%red%Formatierungen\\
werden auf%% auf der nächsten''' Zeile fortgesetzt.
Mit mehreren umgekehrten Schrägstrichen \\\
lassen sich zusätzliche Leerzeilen erzeugen.
| Zwei umgekehrte Schrägstriche am Zeilenende erzeugen einen Zeilenumbruch.
Wikistile und andere Formatierungen werden auf auf der nächsten Zeile fortgesetzt.
Mit mehreren umgekehrten Schrägstrichen
lassen sich zusätzliche Leerzeilen erzeugen.
|
Sie können die Anweisung [[<<]] nutzen,
um einen Zeilenumbruch zu erzwingen.
| Sie können die Anweisung nutzen,
um einen Zeilenumbruch zu erzwingen.
|
Ein einzelner umgekehrter Schrägstrich \
am Ende einer Zeile verbindet \
diese mit der nächsten Zeile.
| Ein einzelner umgekehrter Schrägstrich am Ende einer Zeile verbindet diese mit der nächsten Zeile.
|
Überschriften
Überschriften sind nützlich, um gut strukturierte Seiten zu erzeugen.
Sie sind aber nicht zum Hervorheben von Text geeignet.
!! Hauptüberschrift
!! [-Hauptüberschrift mit kleinerer Schrift-]
!!! Überschrift geringerer Ordnung
!!!! noch geringer
!!!!! Unterüberschrift
| Hauptüberschrift
Hauptüberschrift mit kleinerer Schrift
Überschrift geringerer Ordnung
noch geringer
Unterüberschrift
|
* Listen werden durch einen Stern @@*@@ begonnen.
** Mehrere Sterne führen zu einer tieferen Ebene.
*** Die Liste wird durch die
erste Zeile beendet, die kein Listenelement ist.
* Ein Listenelement kann auf
der nächsten Zeile fortgesetzt
werden, indem der Text mit
Leerzeichen eingerückt wird.
* Mit einem doppelten Backslash am Ende der Zeile \\
erzwingen Sie einen Zeilenumbruch in einem Element.
| - Listen werden durch einen Stern
* begonnen.
- Mehrere Sterne führen zu einer tieferen Ebene.
erste Zeile beendet, die kein Listenelement ist.
- Ein Listenelement kann auf
der nächsten Zeile fortgesetzt
werden, indem der Text mit
Leerzeichen eingerückt wird.
- Mit einem doppelten Backslash am Ende der Zeile
erzwingen Sie einen Zeilenumbruch in einem Element.
|
# Nummerierte Listen
# sind ebenfalls möglich mit einem @@#@@.
## Mehrere @@#@@-Zeichen führen zu einer tieferen Ebene.
*** Nummerierte und nicht
nummerierte Listen können
verschachtelt werden.
--> Benutzen Sie [[ListStyles]]
(besondere Wikistile) um
besondere Nummerierungen zu erhalten:
## Text zwischen Listenelementen
kann zu einem Neubeginn der
Nummerierung führen.
## %item value=3% Das kann aber auch manuell geändert werden.
| - Nummerierte Listen
- sind ebenfalls möglich mit einem
# .
- Mehrere
# -Zeichen führen zu einer tieferen Ebene.
- Nummerierte und nicht
nummerierte Listen können
verschachtelt werden.
Benutzen Sie ListStyles
(besondere Wikistile) um
besondere Nummerierungen zu erhalten:
- Text zwischen Listenelementen
kann zu einem Neubeginn der
Nummerierung führen.
- Das kann aber auch manuell geändert werden.
|
Lernen Sie mehr über Listen (einschließlichDefinitionslisten) und Wikistile für Listen.
- ein Hiweise auf Definitionslisten sollte genügen ****
: Definitionslisten : Listen mit Definitionen
: Eintrag : Definition des Eintrags
: ein anderer Eintrag: Definition des zweiten Eintrags
:: Einrückung : Mehrere Doppelpunkt am Zeilenanfang erzeugen
tiefere Listen.
| - Definitionslisten
- Listen mit Definitionen
- Eintrag
- Definition des Eintrags
- ein anderer Eintrag
- Definition des zweiten Eintrags
- Einrückung
- Mehrere Doppelpunkt am Zeilenanfang erzeugen
tiefere Listen.
|
Text in doppelten, eckigen Klammern wird zu einem Verweis auf eine andere Seite.
Übe das Bearbeiten in der [[wiki sandbox]]
| Übe das Bearbeiten in der wiki sandbox?
|
Beachten Sie: Die einzelnen Wörter im Titel werden automatisch groß begonnen. Der Verweis zielt auf WikiSandbox.Die Großschreibung eines Seitennamen sieht man nur im URL.
Ein Verweis auf eine Seite in einer anderen Wikigruppe besteht aus dem Namen der Gruppe, gefolgt von einem Trennzeichen, gefolgt vom Namen der Zielseite.
Wenn ein Punkt '.' als Trennzeichen genutzt wird, erscheint der komplette Name (Gruppenname und Seitenname).
Wenn ein Schrägstrich / als Trennzeichen genutzt wird, erscheint nur der Seitenname der Zielseite.
Übe das Bearbeiten in der [[Main/WikiSandbox]].
Welche WikiSandbox? Oh, diese hier: [[Main.WikiSandbox]].
| Übe das Bearbeiten in der WikiSandbox.
Welche WikiSandbox? Oh, diese hier: Main.WikiSandbox.
|
Text nach dem 'Pipe'-Zeichen (|) wird zum Verweistext. Stattdessen kann auch die alternative (möglicherweise einfacher zu verstehende) Pfeil-Syntax genutzt werden: Text -> Verweis.
Übe das Bearbeiten im
[[wiki sandbox|Sandkasten]].
Übe das Bearbeiten im
[[Sandkasten -> WikiSandbox]].
| Übe das Bearbeiten im
Sandkasten?.
Übe das Bearbeiten im
Sandkasten?.
|
Suffixe werden Bestandteil des Verweistextes
Klammern blenden Teile des Links aus
Übe das Bearbeiten
in den [[wiki sandbox]]en!
Übe das Bearbeiten
in der [[(wiki) sandbox]]!
| Übe das Bearbeiten
in den wiki sandboxen?!
Übe das Bearbeiten
in der sandbox?!
|
Verweise auf externe Sites
Verweise als Referenz auf externe Sites
nur der Url: https://www.pmwiki.org
Referenz: [[https://www.pmwiki.org | #]]
| nur der Url: https://www.pmwiki.org
Referenz: [1]
|
Mit Klammern können diese ausgeblendet werden.
Was ist ein [[(Wikipedia:)Wiki]]?
| Was ist ein Wiki?
|
Nur der Vollständigkeit halber:
Verweise zu Wikiseiten:
# als Referenz: [[Tables |#]]
# auf einen Seitentitel: [[Basic editing|+]]
| Verweise zu Wikiseiten:
- als Referenz: [1]
- auf einen Seitentitel: Grundlagen der Bearbeitung
|
Verweise können in einem neuen Fenster geöffnet werden:
%newwin% https://www.pmwiki.org.
| Verweise können in einem neuen Fenster geöffnet werden:
https://www.pmwiki.org.
|
Verweise auf eine nicht existierende? Seite werden besonders dargestellt, um andere Autoren einzuladen, diese Seite zu erstellen.
PmWiki unterstützt mehr Verweistypen und eine Reihe von Anzeigeoptionen, siehe Verweise für weitere Informationen.
Escape-Sequenz
Wenn Sie keine Wikiauszeichnungen dargestellt haben wollen, trotzdem aber die Zeilen umgebrochen haben möchten, benutzen Sie [= =]
. Das kann auch innerhalb einer Zeile verwendet werden.
[=
Auszeichnungen werden ''''nicht'''
dargestellt, aber
Zeilenumbrüche werden
durchgeführt.
=]
|
Auszeichnungen werden ''''nicht'''
dargestellt, aber
Zeilenumbrüche werden
durchgeführt.
|
Vorformatierter Text
Vorformatierter Text wird mit einer dicktengleichen Schrift (gleiche Zeichenabstände, Schreibmaschinenschrift) dargestellt und erzeugt keine Zeilenumbrüche außer dort, wo sie explizit im Quelltext eingefügt werden.
Beachten Sie, dass sehr lange Zeilen vorformatierten Textes dazu führen, dass die ganze Seite sehr breit wird.
Um vorformatierten Text mit Auszeichnungen (z. B. Hervorhebung) darzustellen, beginnen Sie jede Zeile mit einem Leerzeichen:
Zeilen, die mit einem Leerzeichen
beginnen, werden genau wie
eingegeben in einer '''dicktengleichen'''
Schrift dargestellt.
| Zeilen, die mit einem Leerzeichen
beginnen, werden genau wie
eingegeben in einer dicktengleichen
Schrift dargestellt.
|
Wenn Sie nicht wollen, dass Wikiauszeichnungen durchgeführt werden, können Sie [@ @] benutzen. Das kann auch innerhalb einer Zeile verwendet werden.
[@
Text, der so eingefasst ist,
zeigt sich als HTML-''Kode''-Stil
@]
|
Text, der so eingefasst ist,
zeigt sich als HTML-''Kode''-Stil
|
Sie können auch die Escape-Sequenz mit einem Leerzeichen in der ersten Zeile beginnen.
[=Die '''Escape-Sequenz''',
angeführt von einem Leerzeichen,
wird vorformatiert dargestellt.=]
| Die '''Escape-Sequenz''',
angeführt von einem Leerzeichen,
wird vorformatiert dargestellt.
|
Sie können in den jüngsten PmWiki-Versionen Syntaxhervorhebung für vorformatierten Text aktivieren.
Horizontale Linie
Vier oder mehr Bindestriche am Beginn
einer Zeile
----
erzeugen eine horizontale Linie.
| Vier oder mehr Bindestriche am Beginn
einer Zeile
erzeugen eine horizontale Linie.
|
Tabellen
Einfache Tabellen benutzen einen doppelten senkrechten Strich zum Trennen der Zellen.
|| border=1
||! Kopf 1 ||! Kopf 2 ||! Kopf 3 ||
|| Zelle 1 || Zelle 2 || Zelle 3||
| Kopf 1 | Kopf 2 | Kopf 3 |
Zelle 1 | Zelle 2 | Zelle 3 |
|
Bilder
siehe Images
Zeichenformatierung
Verwendet werden Apostrophe (einfache Anführungszeichen {'}, keine doppelten Anführungszeichen {"})
''hervorgehoben'', '''stark hervorgehoben''',
'''''sehr stark hervorgehoben'''''.
| hervorgehoben, stark hervorgehoben,
sehr stark hervorgehoben.
|
@@Dicktengleiche Schrift@@
[@Dies ist ein
vorformatierter
Textblock@]
| Dicktengleiche Schrift
Dies ist ein
vorformatierter
Textblock
|
* Text mit '^Hochstellung^'
* Text mit '_Tiefstellung_'
* {-durchgestrichener-} Text
* {+unterstrichenener+} Text
* [+großer+], [++größerer++] Text
* [-kleiner-], [--kleinerer--] Text
| - Text mit Hochstellung
- Text mit Tiefstellung
durchgestrichener Text
- unterstrichenener Text
- großer, größerer Text
- kleiner, kleinerer Text
|
Verwenden Sie keine Großbuchstaben in RGB-Farbangaben (#ff7f00, nicht #FF7F00)
[[WikiStyles|Wikistile]] erlauben %red% roten,
%blue% blauen, %green% grünen Text%% oder Text mit
%color=#ff7f00% anderen %%Farben.
| Wikistile erlauben roten,
blauen, grünen Text oder Text mit
anderen Farben.
|
Seitentitel
Die (:title:)
-Direktive setzt den Titel einer Seite unabhängig vom tatsächlichen Namen der Seite.
(:title Grundlagen der Bearbeitung:)
Der Titel dieser Seite lautet "{$Title}", ihr Name ist "{$Name}".
| Der Titel dieser Seite lautet "Grundlagen der Bearbeitung", ihr Name ist "BasicEditing".
|
Seitenbeschreibung
Die (:Description Seitenbeschreibung hier:)
-Directive setzt die Beschreibung der Seite. Die Beschreibung wird von Suchmaschinen genutzt und kann in Suchergebnissen der Suchmaschinen gezeigt werden, wird aber auch in einigen Seitenlisten genutzt.
(:Description Hier werden grundlegende Elemente der PmWiki-Syntax beschrieben:)
Die Seitenbeschreibung dieser Seite lautet "{$Description}".
| Die Seitenbeschreibung dieser Seite lautet "Hier werden grundlegende Elemente der PmWiki-Syntax beschrieben".
|
Seiten-Zusammenfassungen
Die (:Summary:Zusammenfassung hier:)
-Direktive setzt die Zusammenfassung einer Seite in eine Seiten-Text-Variable, die in einigen Seitenlistenvorlagen benutzt wird.
(:Summary: Grundlegende Syntax für PmWiki-Seiten :)
Die Zusammenfassung dieser Seite lautet ''{$:Summary}''.
| Die Zusammenfassung dieser Seite lautet Grundlegende Syntax für PmWiki-Seiten .
|
Solche Zusammenfassungen werden oft in Suchergebnissen oder in
Seitenlisten innerhalb des Wikis angezeigt. Verwechseln Sie diese Zusammenfassung nicht mit der, die in
(:description ... :)
eingefügt wird und in den Ergebnislisten von Suchmaschinen erscheinen (siehe
Seitendirektiven und
Seitenbeschreibung).
Wikistile blockweise definieren
Blöcke erlauben es, Wikistile über Zeilen- oder Absatzgrenzen hinweg zu definieren.
>>purple<<
Der gesamte Text dieses Blockes ist violett.
* violetter Eintrag 1
* violetter Eintrag 2
>>red<<
* hier ein roter Eintrag
>>center<<
* Und dieser Text ist zentriert.
>>right green<<
* Und dieser Text ist grün und rechsbündig.
>><<
* Und dies ist normal.
|
Der gesamte Text dieses Blockes ist violett.
- violetter Eintrag 1
- violetter Eintrag 2
- Und dieser Text ist zentriert.
- Und dieser Text ist grün und rechsbündig.
|
FAQ
Ich bin neu bei PmWiki, wo kann ich ein paar grundlegende Erklärungen für den Einstieg finden?
Die Seite Grundlagen der Bearbeitung ist ein guter Startpunkt. Von dort aus können Sie dann dem am Seitenende befindlichen Verweis Dokumentations-Index folgen. Dort findet sich eine strukturierte Übersicht über die wichtigsten Dokumentationsseiten.
Wie kann ich Sonderzeichen in den Text meiner Wikiseiten einfügen?
Benutzen Sie Auszeichnungen von der Seite Sonderzeichen, z. B. Copyright (©) und Trademark (® oder ™) sind Symbole, die nicht auf der Tastatur zu finden sind.
Warum werden mehrere Zeilen im Wiki-Quelltext zu einer einzigen Zeile bei der Darstellung der Seite?
PmWiki behandelt direkt untereinander stehende Zeilen mit Text als einen Absatz und fügt deshalb die Zeilen des Quelltextes zusammen und bricht sie bei der Darstellung im Browser je nach Breite des Browserfensters um. Dies wird auch bei den meisten anderen Wiki-Programmen so gemacht. Ein Autor kann aber die Direktive (:linebreaks:)
verwenden, um zu erreichen, dass getrennte Zeilen im Quelltext auch bei der Ausgabe als getrennte Zeilen behandelt werden, siehe auch Zeilenumbrüche. Ein Administrator kann aber auch die Zeile
$HTMLPNewline = '<br/>';
in die config.php-Datei einfügen, um den Erhalt von Zeilenumbrüchen zu erzwingen.
Kann ich auch einfach HTML-Kode eingeben?
Standardmäßig unterstützt PmWiki die Verwendung von HTML-Elementen im Wiki-Quelltext nicht. Hierfür gibt es eine Reihe von Gründen, die in der PmWiki-Philosophie und auf der Seite PmWiki:Audiences erläutert werden. Um es kurz zu sagen, vertritt Pm die Auffassung, dass potenzielle Autoren vom Bearbeiten von Wikiseiten abgeschreckt oder sogar ausgeschlossen werden, wenn dort HTML-Kode enthalten ist. Außerdem bringt die Verwendung von HTML-Kode eine Reihe von Darstellungs- und Sicherheits-Problemen mit sich. Ein Administrator kann allerdings das Kochbuch-Rezept Cookbook:EnableHTML nutzen, um die Nutzung von HTML-Kode in Wikiseiten zu ermöglichen.
Wo finde ich weitere Dokumentationen?
Siehe nach im Dokumentations-Index und in der Übersicht über Textauszeichnungen.
für die Liste aller Seiten