Markdown-Guide

Markdown ist eine einfache Auszeichnungssprache, die in einfaches HTML umgewandelt werden kann. Hier sind einige der grundlegenden Elemente, die du verwenden kannst.

Überschriften

Verfügbar in: Clubseiten Turnierseiten

Du kannst Überschriften erstellen, indem du # vor deinen Text setzt. Die Anzahl der # bestimmt die Ebene der Überschrift.

# Überschrift 1
## Überschrift 2
### Überschrift 3

Textformatierung

Du kannst Text fett machen, indem du ihn zwischen zwei ** setzt. Um Text kursiv zu machen, setze ihn zwischen zwei _. Mit ==Text== wird Text markiert.

**Dieser Text ist fett**
_Dieser Text ist kursiv_

Listen

Du kannst ungeordnete Listen erstellen, indem du - vor deine Listenelemente setzt.

- Element 1
- Element 2
- Element 3

Geordnete Listen können erstellt werden, indem du die Nummer und einen Punkt vor die Listenelemente setzt.

1. Element 1
2. Element 2
3. Element 3

Im Forum wird eine Zeile wie 1. Element nicht von selbst zur nummerierten Liste, damit Partienotation wie 1. e4 e5 nicht zerbricht. Nummerierte Listen gibt es dort deshalb nicht.

Verfügbar in: Clubseiten Turnierseiten

Du kannst Links erstellen, indem du den Linktext in eckige Klammern [] und die URL in runde Klammern () setzt.

[Linktext](https://www.example.com)

Die meisten Links werden aber auch automatisch erkannt und in klickbare Links umgewandelt. Das gilt überall, auch im Forum.

Zitate

Du kannst Zitate erstellen, indem du dem Text ein > voranstellst.

> Dies ist ein Zitat

Horizontale Linien

Verfügbar in: Clubseiten Turnierseiten

Du kannst horizontale Linien erstellen, indem du drei oder mehr - in eine Zeile schreibst.

Damit kannst du Abschnitte voneinander trennen.

---

Verfügbar in: Clubseiten Turnierseiten

Du kannst eine neue Seite erstellen, indem du den Linktext bzw. Seitennamen in doppelte eckige Klammern [[ ]] setzt.

Die Seite wird bei Aufruf automatisch erstellt und lässt sich dann bearbeiten.

[[Zielseite]]

oder

[[Zielseite|Angezeigter Text]]

Ordner für Seiten

Verfügbar in: Clubseiten Turnierseiten

Club- und Turnierseiten lassen sich in Ordner einsortieren. Gib dazu beim Anlegen oder Umbenennen einen Pfad als Seitennamen ein, mit Schrägstrich zwischen Ordner und Seite.

Handbuch/Regeln

Der Teil vor dem letzten Schrägstrich ist der Ordner, der Rest der Seitenname. In der Seitenübersicht erscheinen die Seiten dann unter ihrem Ordner. Ordner entstehen allein aus den Namen, du musst sie nicht getrennt anlegen. Verschachtelung ist möglich, etwa Handbuch/Turniere/Regeln. Um eine Seite in einen anderen Ordner zu verschieben, benennst du sie einfach mit einem neuen Pfad um.

Relativ und absolut verlinken

Innerhalb eines Ordners lassen sich Seiten mit Wiki-Links kurz und relativ ansprechen. Es gibt drei Fälle.

  • [[Name]] ohne Schrägstrich verweist relativ auf eine Seite im selben Ordner. Auf der Seite Handbuch/Regeln führt [[Anmeldung]] also zu Handbuch/Anmeldung.
  • [[Ordner/Name]] mit Schrägstrich verweist absolut ab der obersten Ebene, unabhängig vom aktuellen Ordner. [[Turniere/Ergebnisse]] führt immer zu Turniere/Ergebnisse.
  • [[/Name]] mit führendem Schrägstrich verweist bewusst absolut auf eine Seite ganz oben. So verlinkst du aus einem Ordner heraus eine Seite auf der obersten Ebene, etwa [[/Impressum]].

Die relative und absolute Auflösung gilt genauso auf Turnierseiten.

Nutzernamen

Der Nutzername ist automatisch verlinkt und stellt bei Mouseover Informationen über den Benutzer dar.

<user name="shaack"/>

oder in Kurzform

~​shaack

Parameter

  • name: Name des Benutzers (benötigt)

id ist ein gleichwertiger Alias für name; es ist die Form, zu der die Kurzform <user id="name"/> expandiert.

Diagramme

Schachdiagramme können mit der folgenden Syntax erstellt werden.

Die FEN steht im Tag, die übrigen Angaben stehen als Parameter am öffnenden Tag.

<diagram>rnbqkbnr/ppp1pppp/8/3p4/3P4/8/PPP1PPPP/RNBQKBNR w KQkq - 0 1</diagram>
<diagram interactive="false" size="xs">rnbqkbnr/ppp1pppp/8/3p4/3P4/8/PPP1PPPP/RNBQKBNR w KQkq - 0 1</diagram>
<diagram markers="d4-success d5-danger" arrows="e2e4-warning">rnbqkbnr/ppp1pppp/8/3p4/3P4/8/PPP1PPPP/RNBQKBNR w KQkq - 0 1</diagram>

Diese Schreibweise gilt gleichermaßen auf Clubseiten, auf den Seiten manueller Turniere und im Forum.

Daneben wird weiterhin die selbstschließende Form mit der FEN als Parameter gelesen, ebenso das alte <fen>…</fen> aus dem Forum. Beide ergeben dasselbe Diagramm.

<diagram fen="rnbqkbnr/ppp1pppp/8/3p4/3P4/8/PPP1PPPP/RNBQKBNR w KQkq - 0 1"/>

Parameter

  • fen: FEN-Notation des Diagramms, wenn sie nicht im Tag steht (value ist ein Alias)
  • interactive: Erlaubt es, Figuren zu ziehen (true oder false, optional, standard: true)
  • size: Maximale Größe des Diagramms (xs, sm, md, lg, optional, standard: md)
  • orientation: Die Farbe, die unten gezeigt wird (white, black oder auto, optional, standard: auto)
  • markers: Farbige Feld-Markierungen, mit Leerzeichen getrennt als Feld-Farbe, z.B. markers="e4-danger d5-warning f3-success" (optional)
  • arrows: Farbige Pfeile, mit Leerzeichen getrennt als VonNach-Farbe, z.B. arrows="e2e4-success d7d5-danger" (optional)

Die Farben für markers und arrows sind warning (orange), danger (rot), success (grün) und info (blau).

Kommentierte Partien

Verfügbar in: Forum

Eine ganze Partie kannst du als PGN in den Beitrag stellen. Sie wird als durchspielbare Partie mit Brett angezeigt.

<pgn>
[White "shaack"]
[Black "Maiholz"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 {Spanisch} a6
</pgn>

Innerhalb von <pgn> wird nichts als Markdown gelesen, der Text kommt genau so beim Brett an, wie du ihn geschrieben hast. Zeilenumbrüche bleiben erhalten. Für eine einzelne Stellung ohne Zugfolge nimmst du ein Diagramm.

Hinweisboxen

Verfügbar in: Clubseiten Turnierseiten

Farbige Hinweisboxen mit <alert type="…">Inhalt</alert>. Typen: primary, secondary, success, danger, warning, info, light, dark. Ohne type wird info verwendet.

<alert type="warning">Anmeldeschluss ist der 1. Mai!</alert>
<alert>Nur ein Hinweis.</alert>

Im Forum bleibt der Tag als Text stehen.

Spiele

Spiele können so verlinkt werden, dass automatisch der aktuelle Status des Spiels angezeigt wird.

Zeigt bei Spielernamen und die aktuellen Halbzüge oder das Ergebnis:

<game id="hg4JpONwsqFe"/>

Zeigt den Spielstand aus der Sicht des Spielers "shaack":

<game id="hg4JpONwsqFe" view="shaack"/>

Zeigt den Spielstand aus der Sicht des weißen Spielers:

<game id="hg4JpONwsqFe" view="white" note="Notiz für die Turnierleitung"/>

Im ersten Fall wird etwas angezeigt, wie "shaack - Maiholz (1-0)".

Im zweiten Fall wird der Spielstand aus der Sicht des Spielers "shaack" angezeigt, also einfach "1". Diese Anzeige kann gut für Turniertabellen genutzt werden.

Wenn das Spiel noch läuft wird der Halbzug angezeigt, also "shaack - Maiholz [23]" oder einfach "[23]".

Parameter

  • id: ID des Spiels (benötigt)
  • view: white, black oder der Name des Spielers, dessen Sicht angezeigt werden soll (optional)
  • note: Notizfeld, kann vom Turnierleiter genutzt werden (optional)

Paarungen in manuellen Turnieren

Verfügbar in: Turnierseiten

In manuellen Turnieren wird ein Spiel nicht über die id verlinkt, sondern als geplante Paarung notiert:

<game pairing="weiss-schwarz"/>

weiss und schwarz sind die Benutzernamen der beiden Spieler, getrennt durch einen Bindestrich. Beide müssen Turnier-Teilnehmer sein. Solange keine id am Tag steht, ist es eine geplante Paarung und noch kein Spiel. Der Turnierleiter startet die Paarung auf der Turnierseite; dabei wird das Spiel angelegt und die id ergänzt (<game pairing="weiss-schwarz" id="..."/>). Mehr dazu unter Manuelle Turniere.

Zusätzlicher Parameter:

  • pairing: weiss-schwarz, Benutzernamen von Weiß und Schwarz (nur in manuellen Turnieren, anstelle von id)

Umfragen

Verfügbar in: Forum

Moderatoren eines Forums können in ihrem Beitrag eine Umfrage anlegen. Die Frage steht als Parameter am öffnenden Tag, die Antwortmöglichkeiten stehen als <option> darin.

<voting question="Wann spielen wir das Turnier?">
<option>Im Frühjahr</option>
<option>Im Herbst</option>
</voting>

Beim Veröffentlichen wird die Umfrage gespeichert und der Tag im Beitrag durch seine Kurzform ersetzt, <voting id="…" question="…"/>. Ab dann zählen die gespeicherten Antwortmöglichkeiten. Sie lassen sich über den Text nicht mehr ändern, weil die abgegebenen Stimmen daran hängen. Die Frage kannst du weiterhin im Text bearbeiten.

Eine Umfrage braucht mindestens zwei und höchstens zwanzig Antwortmöglichkeiten. Abstimmen darf jedes angemeldete Mitglied, das den Beitrag lesen kann. Jeder hat eine Stimme, und die Stimme ist endgültig.

Parameter

  • question: Die Frage über den Antwortmöglichkeiten (optional)
  • id: Schlüssel der gespeicherten Umfrage, wird beim Veröffentlichen automatisch gesetzt