User Tools

Site Tools


wiki:first-steps-de
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


wiki:first-steps-de [2019/02/09 02:31] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +====== 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|userpages]]**__
 +angelegt werden.
 +\\
 +Wenn mit Klick auf den Link __**[[:userpages|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:\\
 +|  {{:wiki:topic_does_not_exist.png?800}} |
 +
 +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** 
 +|  {{wiki:wiki_symbols_create.png?250}}  |  {{wiki:wiki_symbols_edit.png?250}}  |\\
 +Durch Klick auf die Funktion "**Create this page**" öffnet sich im Browser das Wiki-Editor-Fenster:\\
 +|  {{:wiki:page-editor.png?800}}  |
 +In diesem Editor-Fenster kann jetzt mit der Erfassung von Text, Links zu Bildern, Dokumenten und anderen Wiki-Seiten begonnen werden.\\
 +
 +  * **Hilfen zur Eingabe von Text und der Formatierung von Inhalten finden sich auf folgenden Seiten:**\\
 +    * **[[wiki:syntax|Wiki Syntax]]** 
 +    * **[[:writer-guidelines-de|Wiki Autoren-Richtlinien]]**
 +
 +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|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:\\
 +  - Die Seite mit dem __neuen__ Namen muss, ggf. auch in einem anderen Ordner, angelegt werden. Siehe __**[[#neue_seite_anlegen|Neue Seite anlegen]]**__ \\
 +  - Die __alte__ Seite wird im Editor-Modus geöffnet, der gesamte Inhalt des Editor-Fensters wird in die Zwischenablage kopiert.
 +  - Die __neue__ Seite wird im Editor-Modus geöffnet, der Inhalt der Zwischenablage wird in dieses Editor-Fenster kopiert und mit **[Save]** gespeichert.
 +  - 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.
 +  - Zuletzt wird die __alte__ Seite gelöscht. Siehe __**[[#seite_loeschen|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.\\
 +|  {{:wiki:topic_does_not_exist.png?800}} 
 +Ü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 __**[[wiki:syntax#links|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:\\
 +|  {{:wiki:upload-xyz.png?600}}  |
 +Der Media-Bereich ist wie die __**[[#seiten-topologie|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:
 +|< >|
 +|  {{:wiki:upload-unsucc.png?250}}  |
 +War das Hochladen erfolgreich, wird die betreffende Datei in blau angezeigt:
 +|< >|
 +|  {{:wiki:upload-succ.png?180}}  |
 +Durch Anklicken des Dateinamens wird ein Fenster mit dem Bild und detaillierten Datei-Informationen angezeigt (View).\\   
 +|< >|
 +|  {{:wiki:picture-view.png?350}}  |
 +===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:
 +|< >|
 +|  {{:wiki:upload-undel.png?400}}  |
 +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://
 +<code>
 +| 1. Spalte | 2. Spalte | 3. Spalte |
 +</code>
 +//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://
 +<code>
 +|< >|
 +| 1. Spalte | 2. Spalte | 3. Spalte |
 +</code>
 +//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://
 +<code>
 +^  1. Spalte  ^  2. Spalte  ^  3. Spalte  ^
 +</code>
 +\\
 +//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://
 +<code>
 +^  1. Spalte ^  2. Spalte ^  3. Spalte ^
 +</code>
 +\\
 +//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 127.0.0.1