Dokumentation für Autoren

Vorwort

Bei Plugins oder Grafiken mal ein Leerzeichen oder Return mehr oder weniger - geht ja. Bei der Vorschau sieht es gut aus - passt. Sicher ist ein Wiki bis zu einem gewissen Grade fehlertolerant bzw. gibt beim Erfassen einen gewissen Spielraum. Die Probleme treten spätestens bei der Migration auf ein neues Wiki auf.

Die Migration der Daten war ein erheblicher Aufwand. Daher meine Bitte: Achtet darauf, das System nicht unnötig zu strapazieren. Im Idealfall also bitte die Syntax verwenden, die beim Klick auf die Buttons eingefügt wird. Ansonsten an die Doku auf dieser Seite halten.

Desweiteren kann man direkt HTML-Code erfassen, was jedoch nicht erwünscht ist. Die Ausnahmen sind unten aufgeführt.

Einleitung

Originaldoku der Beschreibungssprache: Grav Markdown Syntax

Zuerst muss man sich anmelden. Das geht über die Admin-Seite. Wenn das erfolgreich war, kann man dort Artikel verfassen.

Bearbeiten von Dokumenten

Zum Bearbeiten von Seiten geht man wie folgt vor:

links auf Seiten klicken
Seite wählen
- ggf. rechts bei Seiten durchsuchen die Liste filtern
- oder im Hauptbereich navigieren
Seite anklicken
Seite ändern
ggf. Seitenvorschau (Auge rechts am Rand, zwischen Text und Titel)
Seite speichern
ggf. noch Dateien hochladen
ggf. Dateien einfügen (Bilder usw.)
Seite speichern
Seite ansehen (ganz oben auf das Auge in der grünen Leiste klicken)

Allgemeines

Einfacher Zeilenumbruch durch zwei Leerzeichen am Zeilenende
Absatz durch Leerzeile
Überschriften mit # am Anfang der Zeile, gefolgt von einem Leerzeichen und dem Titel
- je nach Ebene ein oder mehr #
- Beispiele:
  - # Größte Überschrift (1. Ebene) - der Titel der Seite
  - ## Untergeordnete Überschrift (2. Ebene) - der Untertitel der Seite
  - ### Untergeordnete Überschrift (3. Ebene) - Gliederungspunkte der Seite
  - ... weitere Untergliederungen
  - ###### Letzte Ebene (6. Ebene)
Keine Links auf andere Newsbeiträge

Grafiken

Grafiken können erst hochgeladen werden, nachdem die Seite gespeichert wurde.

Das Hochladen kann mittels Drag&Drop (unterhalb des Editors existiert ein Bereich) erfolgen. Dabei bitte eine maximale Auflösung von 1920x1080 einhalten.

Generell:
- Einfügen auf dem Objekt anklicken (dies erscheint, sobald man mit der Maus über dem Objekt schwebt)
- Alternativen Text ggf. erfassen (der in []) - er
  - ist der angezeigte Text, wenn man nur den Link auf die Grafik anzeigen möchte
  - wird bei einigen Browsern angezeigt, wenn man mit der Maus über der Grafik schwebt
  - wird von Textbrowsern genutzt
Für diverse Anpassungen gibt es jetzt einen Button in der Editor Toolleiste (Schraubenschlüssel) bitte den eingefügten Text für das Bild komplett markieren, allerdings ohne den Zeilenumbruch!
- Nur als Link anzeigen (entfernt das ! am Anfang und ergänzt ?link&display=text)
- Lightbox an/aus (ermöglicht das Vergrößern und Durchblättern der Bilder durch das Anhängen von ?lightbox)
  - Normalerweise bitte nutzen - Ausnahme: Vergrößerungsmöglichkeit ist explizit nicht gewünscht
- Ausrichtung (links, rechts, mittig) durch {.left}, {.right} oder {.center}
  - Bei .center findet kein Textumlauf statt
- Bild verkleinern - durch &resize=200 (klein) oder 400 (mittel)
  - 200 ist die maximale Größe, die bei Smartphones (senkrecht) noch einen sinnvollen Textumlauf ermöglicht.
  - Ansonsten: 400 - dann erfolgt der Textumlauf nur auf dem Desktop und auf dem Smartphone nimmt das Bild bei senkrechter Ausrichtung die volle Breite ein.
- Beispiele
  - ![](bild.jpg?lightbox)
  - ![](bild.jpg?lightbox&resize=200){.left}
  - ![Ein interessiertes Eichhörnchen](eichhoernchen.jpg?lightbox&resize=200){.left} ->

Ich bin umlaufender Text.

Galerie aller Bilder: {{ images_collage(page.media.images).html }}

Schachtabellen, -diagramme und Rätsel

Hierzu gibt es jeweils Buttons im Editor (Zauberstab, das 'x' im Rahmen und das Fragezeichen - also die letzten drei Einträge in der Buttonleiste des Editors).

PGN Datenbanken

PGN Datenbanken können via Plugin zur Verfügung gestellt werden. Hierzu gibt es auch einen Buttom im Editor.

Man kann dazu eine PGN-Datei hochladen und den Dateinamen in der Mitte der pgn-Tags angeben.
Dies führt zur großen Darstellung (siehe Seite "Schachpartien").

Alternativ kann man stattdessen die PGN-Daten bei den Tags einfügen. Das führt zu einer kleineren Darstellung des Brettes und der Daten.

Unter "Erweitert" das "Caching" auf "Deaktiviert" stellen.

Nachrichten (Blog)

Oben + Seite hinzufügen anklicken. Im darauf erscheinenden Fester wie folgt ausfüllen:

Feld	Eingabe
Seitentitel	Den Titel für die Seite eingeben
Ordnername	Standard belassen
Übergeordnete Seite	In das Feld klicken, durch `Backspace`-Taste entfernen und `Nachrichten` eingeben
Seiten-Template	Den Typ `item` auswählen

Jetzt Weiter anklicken...

Im Reiter Optionen unter Tags

Bei Category blog auswählen.
Bei Tags die Kategorien auswählen, die zum Artikel passen. Neue Tags bitte nur nach Rücksprache.

Jetzt noch unter Inhalt den Text erfassen.

Keine Überschrift als Titel bei den Nachrichten (im Gegensatz zum alten Wiki) - der Grund: Im neuen Wiki werden die Titel der Seite automatisch beim Blog als Überschrift angezeigt. Wenn man innerhalb des Textes mit Überschriften arbeiten möchte, so nur ab Stufe 3 (Beispiel: ### Überschrift).

Mit === kann man den Anrisstext (Zeilen oberhalb) vom Rest (Zeilen unterhalb) trennen. Andernfalls werden ca. 300 Zeichen angenommen. Meine Empfehlung: Bilder nur nach dem Anrisstext erfassen. Falls man diesen nicht explizit mit === definiert, so nach dem Speichern kontrollieren, ob das Bild im Blog im Fließtext erscheint. Wenn ja, dann lieber etwas nach unten verschieben.

Erlaubte HTML Codes

Funktion	Code	Beschreibung
Bedingter Trennstrich	``	Nutzt man, um dem Browser mitzuteilen, dass er an einer bestimmten Stelle trennen darf, sofern er es aus Platzgründen für sinnvoll hält. Bei sehr breiten Tabellen ist es manchmal ganz praktisch (Smartphones haben nicht so viel Platz).
Nicht trennbares Leerzeichen	` `	Normalerweise führt der Browser einen Zeilenumbruch immer an Leerzeichen oder dem bedingten Trennstrich durch. Beim Leerzeichen kann man das verhindern, indem man statt eines Leerzeichens das ` ` verwendet. Sinnvoll ist dies z. B. bei `z. B.` :-).
Zeilenumbruch	`<br/>`	Zeilenumbruch mit zwei Leerzeichen am Zeilenende gehen schwer in Tabellen - dafür ist `<br/>` als Ersatz gedacht.

Zusätzlich sind die HTML Symbole erlaubt - hier zwei interessante Kategorien:

Man muss den Wert aus der Spalte Dec nehmen und vorne durch &# sowie hinten durch ; ergänzen - Ergebnis bei ♠: ♠
Die Darstellung der Symbole ist aber nicht immer 100%ig identisch - auf Smartphones sind die Symbole manchmal sogar farbig.
Bitte auf den gängigsten, auch etwas älteren Geräten testen - die Abdeckung ist noch nicht perfekt.