meta data for this page
  •  

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wiki:hilfe [2021/01/15 10:51] – [Syntax] gniffkewiki:hilfe [2021/12/15 20:00] (current) – external edit 127.0.0.1
Line 3: Line 3:
 ===== Dokuwiki - was ist anders, was ist zu beachten ===== ===== Dokuwiki - was ist anders, was ist zu beachten =====
 Gegenüber der bisherigen Plattform auf Wikidot.com nutzt der neue NIR die Plattform DokuWiki. Diese unterscheidet sich auch abseits der technischen Aspekte von der Insellösung Wikidot.com. Gegenüber der bisherigen Plattform auf Wikidot.com nutzt der neue NIR die Plattform DokuWiki. Diese unterscheidet sich auch abseits der technischen Aspekte von der Insellösung Wikidot.com.
 +
 +==== Login & Passwörter ====
 +Zugangsdaten sollten alle bekommen haben, wenn nicht einfach fragen. Bitte ändert das Passwort so schnell wie möglich.
 +<WRAP Tip>Das Wiki-System versendet aus Sicherheitsgründen keine E-Mails, d.h. die Funktion Passwort zurücksetzen funktioniert nicht. Bitte kontaktiert die zuständigen KollegInnen.</WRAP>
 +
 +==== Änderungen ====
 +Da das System keine Mails verschicken kann experimentiere ich gerade mit einem Plugin dass für beliebige Namespace-Ebenen und Nutzer die letzten Änderungen zeigt.
 +
 +[[iir:changes_all_nfr| Changes for all NFR-Codes (under construction)]]
  
 ==== Aussehen ==== ==== Aussehen ====
Line 14: Line 23:
 Über der Seite seht ihr neben dem kleinen Haus auch die Position der Seite in der Struktur des Wiki (dem sog. Namespace). Über der Seite seht ihr neben dem kleinen Haus auch die Position der Seite in der Struktur des Wiki (dem sog. Namespace).
  
-Rechts neben der Seite befindet sich eine Spalte mit Optionen, dort findet ihr alle Funktionen zur gesamten Seite, also bearbeiten, exportieren usw.). Wer genau hin guckt erkennt auch nach jedem durch Überschriften definierte Abschnitt einen kleinen Stift rechts, damit kann ein einzelner Abschnitt bearbeitet werden, der Rest bleibt dann unangetastet. An Tabellen seht ihr auch eine kleine Fahne unten mit der Funktion //EDIT//, damit könnt ihr Tabellen in einem separaten Editor bearbeiten.+Rechts neben der Seite befindet sich eine Spalte mit Optionen, dort findet ihr alle Funktionen zur gesamten Seite (bearbeiten, exportieren usw.). Wer genau hin guckt erkennt auch nach jedem durch Überschriften definierte Abschnitt einen kleinen Stift rechts, damit kann ein einzelner Abschnitt bearbeitet werden, der Rest bleibt dann unangetastet. An Tabellen seht ihr auch eine kleine Fahne unten mit der Funktion //EDIT//, damit könnt ihr Tabellen in einem separaten Editor bearbeiten.
  
 ==== Syntax ==== ==== Syntax ====
Line 24: Line 33:
   * [[http://www.dokuwiki.org/plugin:gallery|Gallery]] - damit kann man Grafiken in einer kleinen Galerie zusammenfassen statt sie direkt einzubetten   * [[http://www.dokuwiki.org/plugin:gallery|Gallery]] - damit kann man Grafiken in einer kleinen Galerie zusammenfassen statt sie direkt einzubetten
   * [[http://www.dokuwiki.org/plugin:hidden|Hidden]] - damit lassen sich einzelne Elemente ausklappbar gestalten (z.B. Legenden)   * [[http://www.dokuwiki.org/plugin:hidden|Hidden]] - damit lassen sich einzelne Elemente ausklappbar gestalten (z.B. Legenden)
 +  * [[https://www.dokuwiki.org/plugin:imagebox|ImageBox]] - einfach eckige Klammern um beliebige Medien setzen und die Bezeichnung wird unter das Objekt gesetzt und ein grauer Kasten um Medium & Text gesetzt (wie bei Wikipedia).
   * [[https://www.dokuwiki.org/plugin:wrap|Wrap]] - Wem die vorgegebenen Layout-Funktionen nicht ausreichen der findet mit Wrap einen Baukasten der Größe eines Baumarktes.   * [[https://www.dokuwiki.org/plugin:wrap|Wrap]] - Wem die vorgegebenen Layout-Funktionen nicht ausreichen der findet mit Wrap einen Baukasten der Größe eines Baumarktes.
   * [[https://www.dokuwiki.org/plugin:mathpublish|Math]] - wie der Name sagt kann man hier mathematische Gleichungen erstellen, das ist nicht unbedingt einfach aber sehr elegant.   * [[https://www.dokuwiki.org/plugin:mathpublish|Math]] - wie der Name sagt kann man hier mathematische Gleichungen erstellen, das ist nicht unbedingt einfach aber sehr elegant.
Line 37: Line 47:
 <WRAP Tip>Inhalte & Strukturen lassen sich auch nachträglich mit dem Werkzeug //Move// in der Struktur verscheiben. Bitte meldet euch falls dies notwendig wird</WRAP> <WRAP Tip>Inhalte & Strukturen lassen sich auch nachträglich mit dem Werkzeug //Move// in der Struktur verscheiben. Bitte meldet euch falls dies notwendig wird</WRAP>
    
-==== Navigation ====+
  
 ==== Komfort-Funktionen ==== ==== Komfort-Funktionen ====
 +Wie schon angesprochen bietet die Plattform DokuWiki eine etwas komfortablere Arbeitsumgebung als Wikidot.
 +Hier noch mal zusammengefasst:
 +  * Bearbeiten einzelner Abschnitte einer Seite (kleiner Stift recht nach einem durch eine Überschrift definierten Abschnitt).
 +  * Viel einfacheres Bearbeiten von Tabellen im Tabellen-Editor, inkl. Copy & Paste der Daten aus Excel-, Word- oder HTML-Tabellen. 
 +  * Komfortables Einfügen von internen Links mit Hilfe eines Auswahl-Assistenten (via Linksymbol ∞ in der Menüzeile über dem Editor-Fenster).
 +  * Die Hierarchische Struktur des Wiki erübrigt das manuelle Benennen von übergeordneten Seiten (breadcrumbs).
 +  * Anständiger Medienmanager (links in der Navigation unter Site Tools > media Manager) der alle Medien des ganzen Wiki zentral & hierarchisch aufführt. Diese sind dort dann auch einfach austauschbar.
  
  
  
 ===== Migration von Wikidot.com ===== ===== Migration von Wikidot.com =====
 +Da die Syntax der beiden Wikisysteme sehr unterschiedlich ist bringt es wenig den Quelltext der alten Wikiseite in das neue System zu kopieren.
 +daher hier ein Vorgehen wie ich es bereits erprobt habe.
 +
 +==== Texte ====
 +Einfacher ist es den Inhalt der HTML-Seite per Copy & Paste als reinen Text in die leere Seite im neuen Wiki zu kopieren und die Formatierungen (Überschriften, Aufzählungen etc.) händisch nach zu pflegen.
 +
 +==== Medien ====
 +Viele Medien werden jedes Jahr aktualisiert, für diese braucht ja keine Migration stattzufinden, es reicht die aktualisierte Datei ins neue Wiki hochzuladen.
 +Für zu migrierende Medien sind diese im alten Wiki herunterzuladen und dann bei der Bearbeitung über das Menü (Bilderrahmen - //Add images and other files//) im Medienmanager hochzuladen.
 +
 +==== Tabellen ====
 +Hier hat sich bei mir bewährt eine leere Tabelle über das Menü anzulegen, die notwendige Anzahl Zeilen & Spalten einzufügen, ggf. zusammengefasste Zellen anzulegen so dass ein Copy & Paste-Vorgang aus Excel-, Word- oder HTML-Tabellen einfach möglich ist. Das erfordert ggf. beim ersten mal etwas Übung, die Aktualisierung später ist dann aber komfortabel möglich.
 +
 +<WRAP Tip>Im Zweifel gerne nachfragen, geben gerne Hilfestellung.</WRAP>
  
 ===== Erstellung neuer Inhalte ===== ===== Erstellung neuer Inhalte =====
 +Neue Seiten, Bilder oder Tabellen lassen sich dank Komfort-Funktionen recht einfach erstellen.
 ==== Neue Seiten ==== ==== Neue Seiten ====
 +Wie auch im alten Wiki ist die Erstellung neuer Seiten am einfachsten wenn auf einer Seite (in gleicher Hierarchiestufe) ein interner Link auf die zu erstellende Seite gesetzt wird. Diesen roten Link klickt man an und kann gleich loslegen. Dabei ist es sinnvoll die neuen Seiten so zu benennen dass sie sich in die vorgegebene Struktur (siehe Ebenen im Sidebar) einpasst. 
 ==== Neue Tabellen ==== ==== Neue Tabellen ====
 +Im Editor fügt man eine neue Tabelle über das Symbol {{:wiki:insert_table.png?nolink|}} //Insert a new table// ein. Dann erscheint der Tabellen-Editor in dem ihr einige Formatierungsoptionen im Menü und eine Reihe von weiteren Funktionen wie das Einfügen oder Löschen von Zellen im Kontextmenü (per Rechtsklick auf zellen) habt.
 +Eine wichtige Funktion ist die oberste im Kontextmenü: //**H** Toggle Header State// die einstellt ob die ausgewählten Zellen Kopfzeile sind (fett und leicht grau hinterlegt). Damit markiert ihr bitte die Zeilen (bzw. Spalten) die die Datenkategorien & Einheiten enthalten.
 +
 ==== Neue Medien ==== ==== Neue Medien ====
 +Neue Medien könnt ihr im Editor-Menü mit Klick auf das entsprechende Symbol (grünes Bild mit braunem Bilderrahmen) hochladen oder auswählen.
 +Das erscheinende Fenster ist der Mediamamanger, dort könnt ihr auswählen wo die Datei stehen soll (im Zweifel nichts ändern, voreingestellt ist dies immer die Hierarchieebene der bearbeiteten Seite), Optionen zum hochladen und im Anschluss umbenennen der Datei wenn nötig.
 +
 +<WRAP Tip>Wenn ihr Medien habt die ihr an mehreren Stellen benutzt empfiehlt sich ggf. diese zusammen an einem Ort in der Hierarchie abzulegen, z.B. eine Ebene höher als die Artikel die diese einbinden.</WRAP>
 +==== Neue Quellen ====
 +Für Quellen bietet das Wiki eine ähnliche Herangehensweise wie bisher:
 +Die Erweiterung [[https://www.dokuwiki.org/plugin:refnotes|RefNotes]] bietet die Möglichkeit die Quellen einfach mit entsprechender Syntax im Text zu benennen, jeder Eintrag wird dann eine Fußnote die unter dem Text steht und auch erscheint wenn man über der Fußnote mit der Maus verweilt. Dies ist ein gutes Vorgehen wenn man wenig Quellen zitiert und diese auch nicht mehrfach zitiert werden.
 +
 +Mehr Optionen findet ihr auf der [[https://www.dokuwiki.org/plugin:refnotes:syntax|Hilfeseite zur RefNotes-Syntax]].
  
 +Eine einfache Aufwertung bieten z.B. **[[https://www.dokuwiki.org/plugin:refnotes:syntax#named_notes|Named Notes]]**, d.h. man gibt jedem Zitat einen Namen und kann die Einträge dann mehrfach zitieren.
  
 +<WRAP Tip> Weitere Optionen bei großen Literaturbeständen die ggf. auf mehreren Seiten genutzt werden sollen sind auch möglich, ebenso wie eine Kategorisierung über Namespaces. Da müsstet ihr euch aber erst mal selbst reinfuchsen. </WRAP>
 ===== Bearbeitung von Inhalten ===== ===== Bearbeitung von Inhalten =====
 +Die Bearbeitung funktioniert prinzipiell wie die Neuerstellung.
 +**Seiten** könnt ihr wie gesagt abschnittsweise bearbeiten, dies erhöht v.a. auf langen Seiten die Übersicht.
 +**Tabellen** könnt ihr aus der normalen Ansicht über das Fähnchen EDIT direkt bearbeiten.
 +**Medien** lassen sich auch komfortabel über den Medienmanager bearbeiten, diesen findet ihr wie gesagt im Sidebar unter Site Tools.
  
 +Änderungen in der **Namespace-Struktur** der angelegten Inhalte können nur Admins vornehmen, dafür gibt es ein Werkzeug welches auch die Links zwischen den Inhalten korrigiert.