Kurzreferenz
Hyperlink |
Syntax |
Anmerkung |
interner Link |
WikiName |
Seitenname mit Binnenmajuskel |
freier interner Link |
["Seite"] oder ["freier Link"] |
konfigurierbare Funktion |
Link auf eine Unterseite |
/UnterSeite oder ["/Seite"] |
von der übergeordneten Seite aus |
externer Link |
http://example.net |
|
benamter interner Link |
[:HilfeInhalt:Inhalt der Hilfe] |
|
benamter externer Link |
[http://example.net Name] |
|
lokaler Dateianhang (Grafik) |
attachment:grafik.png |
Bilder werden direkt angezeigt |
externe Grafik |
http://example.net/image.png |
bindet Bild des Verweisziels ein |
Grenze eines internen Links |
WikiName``n |
2 Accent grave |
Vermeidung eines internen Links |
!WikiName |
konfigurierbare Funktion |
Erläuterungen und Beispiele
Beliebige Seiten-Namen
Wenn Sie eine Folge von Zeichen in eckigen Klammern und doppelten Anführungszeichen ["wie hier"] einschließen, dann wird daraus ein Seitenname. Dies kann für spezielle Anwendungen benutzt werden (z.B. für's Organisieren einer Liste von Dingen, z.B. Ihrer CD-Sammlung über deren "natürlichen" Namen) oder auch wenn Sie ein Wiki mit nicht-westlichen Zeichensätzen erzeugen wollen.
Verweise und eingebettete Bilder
Es gibt verschiedene Wege, um externe Referenzen1 in den Text einzufügen:
direktes Einfügen einer URL; wenn die URL mit einer Erweiterung für Bilddateien endet (".gif", ".jpg" or ".png"), wird die URL in ein HTML-Bildelement konvertiert.
- geklammerte URLs.
InterWiki-Verweise.
- E-Mail-Adressen.
Wenn Sie URLs in normalen Text einfügen, ist es problematisch zu erkennen, was zu der URL gehört und was nicht. Es gibt vier Wege, das Ende einer URL zu erzwingen:
- platzieren Sie ein Leerzeichen hinter die URL.
benutzen Sie die SixSingleQuotes-Methode (oder alternativ zwei inverse Hochkommata ``).
- geben Sie die URL in doppelten Anführungszeichen ein.
- benutzen Sie die Klammer-URL-Syntax.
Folgende URL-Schemata werden unterstützt: http, https, ftp, nntp, news, mailto, telnet, irc und file. Der Administrator Ihres Wikis kann die unterstützen Schemata erweitern, indem er die config.url_schemas-Variable benutzt (siehe HilfeZurKonfiguration).
Zusätzlich zu den Standard-Schemata gibt es auch noch MoinMoin-spezifische: wiki, attachment, inline und drawing. "wiki" weist einen InterWiki-Link aus, MoinMoin:FrontPage und wiki:MoinMoin:FrontPage sind also gleichbedeutend; normalerweise werden Sie die kürzere Form bevorzugen, das "wiki"-Schema wird dann wichtig, wenn Sie geklammerte Links benutzen, weil Sie dort immer ein Schema benötigen. Die anderen Schemata beziehen sich auf Dateianhänge (einschließlich Grafiken) und werden auf HilfeZuAktionen/DateiAnhänge erklärt.
Weitere Informationen über mögliche Formatierungen finden Sie unter HilfeZumEditieren.
Zu den Details, wie man auf Unterseiten verweist, siehe HilfeZumEditieren/UnterSeiten.
Um Verweisanker in eine Seite einzufügen benötigen Sie den Makro Anchor: [[Anchor(anchorname)]], wobei "anchorname" durch den korrekten Bezeichner des Ankers zu ersetzen ist. Um auf einen Anker auf der gleichen Seite zu verweisen, benutzen Sie [#anchorname] oder [#anchorname Text der Beschreibung]. Um einen Verweis auf einen Anker auf einer anderen Seite zu setzen schreiben Sie [wiki:Self:SeitenName#anchorname] oder [wiki:Self:SeitenName#anchorname Text der Beschreibung], wobei "SeitenName" der Name der anderen Seite und "anchorname" der Bezeichner des Ankers auf dieser Seite ist.
Es ist oft wünschenswert, einen Link auf eine Wikiseite im aktuellen Wiki zu erstellen, aber einen anderen, frei definierbaren Text anzuzeigen. Man kann zwar einen InterWiki-Link (mit Wikiname Self) benutzen, dies erzeugt aber ein Interwiki-Icon, was irreführend sein kann, weil wir ja das Wiki gar nicht verlassen. Benutzen Sie die Syntax [:WikiSeite:angezeigter Text], um einen Link auf eine Seite im aktuellen Wiki zu erzeugen ohne dass es ein Interwiki-Link wird.
In einigen Wikis verweist ein Link auf MoinMoin auf die gleiche Seite wie ein Link auf moinmoin. Dies gilt insbesondere für Windows- und Mac OS X-Systeme, weil Sie normalerweise nicht zwischen Groß- und Kleinschreibung bei Dateinamen unterscheiden.
Bildung von automatischen Links vermeiden
Um zu vermeiden, dass ein Wort wie MoinMoin automatisch verlinkt wird, benutzen Sie Moin``Moin.
Sie können die Verlinkung über WikiNamen unterdrücken, indem Sie ein Ausrufezeichen (engl.: bang) vor den WikiNamen schreiben, z.B. !WikiName. Dies ist über die Konfigurations-Option bang_meta = False abschaltbar.
Um zu vermeiden, dass URLs automatisch verlinkt werden, benutzen Sie entweder `http://...` oder {{{http://...}}}.
Beispiel
* http://moinmoin.wikiwikiweb.de/ * [http://moinmoin.wikiwikiweb.de/] * [http://moinmoin.wikiwikiweb.de/ MoinMoin Homepage] * http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png * [http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png] * [http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png moinmoin.png] * [http:/wiki/common/moinmoin.png http:/wiki/common//moinmoin.png] partielle URL * InterWiki * Self:InterWiki * MeatBall:InterWiki * wiki:MeatBall/InterWiki * [wiki:MeatBall/InterWiki] * [wiki:MeatBall/InterWiki InterWiki-Seite auf MeatBall] * nutzer@example.com * [:InterWiki:InterWiki-Seite in diesem Wiki] * [#anchorname Verweis auf einen Anker auf dieser Seite] * [wiki:Self:OtherPage#anchorname Verweis auf Anker auf einer anderen Wiki-Seite] * [:OtherPage#anchorname:Verweis auf Anker auf einer anderen Seite dieses Wiki]