User Tools

Site Tools


wiki:first-steps-de

Wiki: Erste Schritte für Autoren

Seiten-Topologie

Die Seiten im Wiki sind in einer Topologie abgelegt, die der Ordner- / Datei-Struktur von Betriebssystemen sehr ähnlich ist.
Anstelle der sonst üblichen Trenner für die Ordner-Hierarchien "/" oder "\" ist das in der Wiki-Umgebung der Doppelpunkt ":"
So ist z.B. auch in Links auf Seiten in Sub-Ordnern, die zu Seiten im Wurzel(Root)-Ordner weisen, dem Seiten-Namen der ":" voranzustellen.
Alle Links (URL) zu Seiten im Wiki beginnen immer mit dem folgenden (globalen) Teil:

https://wiki.rocrail.net/doku.php?id= 

Direkt dahinter ( kein Leerzeichen :!: ) beginnt der Seiten-Name ggf. mit vorangestelltem Ordner-Namen.
Die URL der deutschen Hauptseite des Rocrail-Projekts:

https://wiki.rocrail.net/doku.php?id=start-de

und die URL der Hauptseite der deutschen Dokumentation:

https://wiki.rocrail.net/doku.php?id=german

Links innerhalb bzw. zwischen Seiten im Wiki können um den globalen Teil der URL verkürzt werden.
Dazu wird der Seiten-Name ggf. mit vorangestelltem Ordner-Namen in "doppelte eckige Klammern" gesetzt, z.B.:

[[german]]

Wenn der Link zu einem Abschnitt/Kapitel innerhalb der Seite zeigen soll, kann der Link mit "#" + Abschnitt/Kapitel-Name erweitert werden:

[[german#rocview]]

Neue Seite anlegen

User-Seiten sollten immer in Sub-Ordnern oder Sub-Sub-Ordnern der Seite userpages angelegt werden.
Wenn mit Klick auf den Link userpages auf die Seite "User Pages" gewechselt wurde, steht im URL-Feld des Browsers die URL oder deren rechter Teil:

...wiki.rocrail.net/doku.php?id=userpages

Der Name einer Seite sollte das Thema in Kurzform bezeichnen und entsprechend der verwendeten Sprache mit "-de", "-en" usw. enden.
Um auch mehrere Seiten für einen User strukturiert ablegen zu können, sollte für diese Seiten ein Userpages-Sub-Ordner mit dem Usernamen angelegt werden.
Dieser Ordner wird gleichzeitig mit der ersten Seite angelegt, wenn wie folgt vorgegangen wird.
Im Beispiel wird der Username "xyz", der Seiten-Name "seite-1" verwendet und die Seite wird in deutsch verfasst.
Wie oben beschrieben, wird die Ordner-Struktur durch ":" festgelegt.
Ergänzt mit diesen Daten sieht die URL z.B. so aus:

...wiki.rocrail.net/doku.php?id=userpages:xyz:seite-1-de

Mit Aufruf dieser URL erscheint im Browser folgende Anzeige, weil die neue Seite noch nicht existiert und erst angelegt werden muss:

Die Funktionen zur Bearbeitung im Wiki werden mit den Symbolen am rechten Rand des Browser-Fensters aufgerufen.
Die Beschreibung wird sichtbar, wenn der Maus-Cursor darüber bewegt wird:

Seite noch nicht angelegt Seite angelegt und editierbar

Durch Klick auf die Funktion "Create this page" öffnet sich im Browser das Wiki-Editor-Fenster:

In diesem Editor-Fenster kann jetzt mit der Erfassung von Text, Links zu Bildern, Dokumenten und anderen Wiki-Seiten begonnen werden.

Mit Klick auf den [Preview]-Button kann jederzeit die Ansicht geprüft werden.
Zum Schluss oder wenn die Arbeit vorübergehend unterbrochen wird, sollte mit [Save] gespeichert werden.
Danach kann die Seite jederzeit wieder über die Funktion "Edit this page" im Editor-Modus geöffnet und bearbeitet werden.

Die neue Seite verlinken

Damit die neu angelegte Seite nicht im "Wiki-Dschungel" verloren geht, sollte sie z.B. auf der Seite userpages als Link erfasst werden.
Über die Funktion "Edit this page wird "User Pages" im Editor-Modus geöffnet.
Für einen neuen User wird ein Kapitel z.B. am Ende der Seite angelegt:

===== Username z.B. xyz =====

Darunter kann dann der Link zu der neuen Seite eingefügt werden:

[[xyz:seite-1-de]]

Die wenig aussagekräftige "seite-1-de" kann noch durch das Pipe-Zeichen "|" und einen erklärenden Text dahinter ergänzt werden:

[[xyz:seite-1-de|Dies ist meine 1. Seite]]

Anstelle des Seiten-Namens erscheint dann der Text-Zusatz als Link.

Namen von Seiten oder Ordnern ändern

Das direkte Ändern eines Seiten- oder Ordner-Namens ist nicht möglich :!:
Die erforderlichen Schritte:

  1. Die Seite mit dem neuen Namen muss, ggf. auch in einem anderen Ordner, angelegt werden. Siehe Neue Seite anlegen
  2. Die alte Seite wird im Editor-Modus geöffnet, der gesamte Inhalt des Editor-Fensters wird in die Zwischenablage kopiert.
  3. Die neue Seite wird im Editor-Modus geöffnet, der Inhalt der Zwischenablage wird in dieses Editor-Fenster kopiert und mit [Save] gespeichert.
  4. Wenn die alte Seite auf anderen Seiten verlinkt war, müssen dort die Links angepasst werden. Betroffene Seiten können mit der Funktion "Backlinks" (Fenster der alten Seite) angezeigt werden.
  5. Zuletzt wird die alte Seite gelöscht. Siehe Seite löschen

Seite löschen

Das direkte Löschen einer Seite ist nicht möglich :!:
Die zu löschende Seite wird im Editor-Modus geöffnet und der gesamte Inhalt des Editor-Fensters wird entfernt.
Dabei muss sichergestellt sein, das auch evtl. nicht direkt sichtbare Zeichen erfasst werden.
Dazu wird empfohlen, mit der Maus von der Zeichenposition oben links bei gedrückter linker Maustaste nach unten zu ziehen.
Das Editor-Fenster ist nur dann vollständig leer, wenn dabei keine Markierung entsteht und der Cursor auf der ersten Zeichenposition stehen bleibt.
Wenn bei leerem Editor-Fenster mit [Save] gespeichert wird, erhält die Seiten-Historie den Eintrag "removed".

Seite oder frühere Version wieder herstellen

Gelöschte Seite wieder herstellen

Links auf gelöschte Seiten werden in "rot" dargestellt und die Seiten sind so nicht mehr erreichbar.
Wird ein "roter" Link angeklickt, erscheint im Browser die gleiche Anzeige wie bei einer neuen Seite.

Über die Funktion "Old revisions" kann die Seite (oder eine frühere Version) wieder dargestellt werden.
Um eine ausgewählte Version der Seite wieder zu aktivieren, muss die Version mit "Edit this page" im Editor-Modus geöffnet und mit [Save] gespeichert werden.

Frühere Version einer Seite wieder herstellen

Bei einer bestehenden Seite kann über die Funktion "Old revisions" eine frühere Version der Seite dargestellt werden.
Um eine ausgewählte Version der Seite wieder zu aktivieren, muss die Version mit "Edit this page" im Editor-Modus geöffnet und mit [Save] gespeichert werden.

Bilder und Dokumente hochladen

Bilder und Dokumente können im Seiten-Text durch externe und interne Links eingefügt werden.
Interne Links verweisen auf den Media-Bereich des Wiki, in den die Bilder und Dokumente hochgeladen wurden.
Das Hochladen erfolgt über den Wiki-Mediamanager, der über folgende URL http://wiki.rocrail.net/lib/exe/mediamanager.php oder mit dem oben rechts im Browser stehenden Link "Media Manager" aufgerufen wird.

Im Browser erscheint dann der Userpages-Ordner im Media-Bereich für den User und nach Auswahl der Registerkarte "Upload" dieses Fenster im Browser:

Der Media-Bereich ist wie die Seiten-Topologie, in Sub- und Sub-Sub-Ordner strukturiert.

Über den Ordner-Baum links kann im Media-Bereich navigiert werden.
Mit dem [Select files…]-Button öffnet sich ein lokales Datei-Auswahlfenster, dass sich je nach Betriebssystem unterscheidet und deshalb hier nicht dargestellt wird.

Die gewünschte Datei wird in dem Fenster ausgewählt (Beispiel: "Bild-1.png") und mit dem [Öffnen]-Button (Windows) oder z.B. durch Doppelklick auf den Eintrag zum Hochladen festgelegt.
Die Übermittlung der Metadaten zum Browser erfordert ggf. einige Sekunden. Danach erscheint im Browser der Dateiname für das Hochladen: "Bild-1.png".
Der Dateiname kann auch geändert werden, wenn im Wiki ein vom Original abweichender Name verwendet werden soll.

Hinweis: In der aktuellen Wiki-Version können auch mehrere Dateien ausgewählt und gemeinsam hochgeladen werden.

Wenn die Datei in den Sub-Ordner des Users geladen werden soll, muss in das Upload-Feld vor dem Dateinamen "Bild-1.png" der Name des Sub-Ordners ergänzt werden: "xyz:Bild-1.png".
Soll eine bereits vorhandene Datei aktualisiert werden, muss die Option "Overwrite existing file" aktiviert werden.
Mit dem [Upload]-Button wird die Datei in die angegebene Ordner-Struktur hochgeladen.
Ist beim Hochladen ein Fehler aufgetreten, erscheint bei der betreffenden Datei (ausgegraut) eine entsprechende Information:

War das Hochladen erfolgreich, wird die betreffende Datei in blau angezeigt:

Durch Anklicken des Dateinamens wird ein Fenster mit dem Bild und detaillierten Datei-Informationen angezeigt (View).

Andere Dokumente

Andere Dokumente (XML, PDF, TXT usw.) werden auf die gleiche Art hochgeladen.
Referenz-Links können bei diesen "Nicht-Bild"-Dateien in den gewünschten Wiki-Seiten aber nicht als Inhalt, sondern nur als Links dargestellt werden.

Media-Dateien- u. -Ordner löschen

Das Löschen einer Media-Datei erfolgt mit der Schaltfläche "Delete" in der Datei-Information.
Eine Media-Datei kann aber nur gelöscht werden, wenn es in keiner Wiki-Seite einen Link zu dieser Datei gibt.
Anderenfalls erscheint eine Fehler-Information:

Das Löschen eines Ordners erfolgt automatisch, wenn der Ordner leer ist, also keine Datei und keinen Sub-Ordner enthält.
Ein gelöschter Ordner ist nicht mehr im Ordner-Baum enthalten.

Neuerungen bei der Tabellen-Formatierung

Mit der in 11/2018 aktivierten Version der Wiki-Software hat sich die Formatierung für die Tabellen-Breite und die Spaltenköpfe geändert.

Tabellen-Breite

Standardmäßig werden auch zuvor schmale Tabellen mindestens mit der halben Rahmenbreite des Browser-Fensters dargestellt:

Editiert:

| 1. Spalte | 2. Spalte | 3. Spalte |

Darstellung unformatiert:

1. Spalte 2. Spalte 3. Spalte

Um auch bei schmalen Tabellen eine angepasste Breite zu erhalten, muss der Tabelle eine Formatzeile vorangestellt werden:

Editiert mit Formatzeile:

|< >|
| 1. Spalte | 2. Spalte | 3. Spalte |

Darstellung mit Formatzeile:

1. Spalte 2. Spalte 3. Spalte
  • In der Formatzeile können auch absolute Spaltenbreiten definiert werden.
    Auf eine Beschreibung dieser im Wiki nicht benötigten Möglichkeit wird hier verzichtet.

Spaltenköpfe

Der Text in Spaltenköpfen wird nicht mehr automatisch zentriert.

  • Hinweis: Zur besseren Erläuterung der Darstellung wird in diesem Abschnitt auf die Formatzeile verzichtet.
1. Spalte 2. Spalte 3. Spalte

Zur Zentrierung müssen auch dem Text der Spaltenköpfe - wie in den Tabellenfeldern - jeweils 2 Leerzeichen vorangestellt und angefügt werden:

Editiert mit zusätzlichen Leerzeichen:

^  1. Spalte  ^  2. Spalte  ^  3. Spalte  ^


Darstellung mit zusätzlichen Leerzeichen:

1. Spalte 2. Spalte 3. Spalte


Die Ausrichtung nach rechts erfolgt noch so, wie bei der vorherigen Version der Wiki-Software.
Dem Text werden dazu 2 Leerzeichen vorangestellt, aber nur ein oder kein Leerzeichen angefügt.

Editiert für Ausrichtung nach rechts:

^  1. Spalte ^  2. Spalte ^  3. Spalte ^


Darstellung mit Ausrichtung nach rechts:

1. Spalte 2. Spalte 3. Spalte


Wird ggf. fortgesetzt …


wiki/first-steps-de.txt · Last modified: 2019/02/09 02:31 by rainerk