======DokuWiki-Beschreibung für GVIT====== ===Kurzreferenz von Franz=== * **Registrierung** automatisch durch den Seiten-Besucher selbst ist nicht mehr möglich, nur der Admin kann Benutzer anlegen. * **Benutzer-Berechtigungen** sind folgende eingerichtet: * Admin (darf alles), * Seiten-Bearbeiten (mit Erstellen und Dateien hochladen, ohne Löschen), * User kann nur Lesen wie jeder fremde Besucher auch. * **Sidebar**, auch** Seitenleiste** genannt, enthält die Links auf Namensräume/Themenbereiche gemäß der Bereiche die bearbeitet werden sollen, entsprechend der Kopfzeile der „Schubladen“-Tabelle der TN-Dokumentation. Der Link zeigt auf die erste Seite dieses Bereichs mit gleichem Namen wie der Namensraum selbst. Diese Seite ist quasi das Inhaltsverzeichnis des Bereichs mit den Links auf die weiterführenden Seiten. ===Neue Seite anlegen=== Die beste Methode ist es, von der vorhergehenden Seite einen Link auf die neue noch nicht vorhandene Seite zu machen und dann zu Speichern. Der neue Link erscheint rot. Diesem folgen und die neue Seite bearbeiten. * **Speichern** nach dem Bearbeiten einer Seite: unbedingt den [Speichern]-Knopf unterhalb des Eingabefensters drücken, da [Strg+S] nicht im DokuWiki speichert, sondern auf Festplatte speichern will. * Eine **Seite duplizieren** oder **speichern unter** ist mir nicht mittels Befehl gelungen, sondern nur zu Fuß: den Link zum neuen Seitennamen erstellen, den Inhalt der bisherigen Seite kopieren [Strg+C] und in neue Seite einfügen [Strg+V]. Wird der Inhalt der bisherigen Seite mit [Strg+X] entfernt, ist nach [Speichern] diese Seite gelöscht. * **Dateinamen** für neue Seiten im Wiki werden automatisch in Kleinbuchstaben umgewandelt! Umlaute werden in zwei Buchstaben umgewandelt, da Umlaute genauso wie Sonderzeichen nicht erlaubt sind! Namensbereiche (auch Namensräume genannt, Verzeichnisse, Unterordner) werden durch einen Doppelpunkt getrennt, dem Dateinamen vorangestellt. * Das **Hochladen von Dateien** in das DokuWiki ist aus dem Seiten-Bearbeitungsfenster möglich und hier beschrieben: https://www.dokuwiki.org/de:media_manager. Dabei bitte beachten, dass Fotos in den Unterordner "Bilder" des entsprechenden Namensraums zu stellen sind. Wenn es diesen noch nicht gibt, stellen Sie dann das Wort //Bilder:// mit dem Doppelpunkt getrennt vor den Dateinamen, vor dem Hochladen, nachdem Sie die Datei ausgewählt haben. Damit ein noch leerer Namensraum im Media-Manager angezeigt wird, muss der Media-Manager von diesem Namensraum aus geöffnet werden. * Es gibt folgende Arten von **Links** (Beispiele siehe [[endgeraete:zeitlos|Das Telefon]]): * Interner Link (blau) nur zu Seiten innerhalb des DokuWiki (hierzu den Namensraum im Link-Assistent (Taste mit Kettenglied) eintragen, siehe [[hutt:hutt|Hans Hutt]], * Externe Links (mit Weltkugel) zu Internetseiten, siehe [[http://GVIT.de|Externer Link zum Geschichtsverein]] und * Links zu hochgeladenen Dateien (über Taste mit Bilderrahmen) öffnet den Medien-Manager in einem anderen Fenster. Dort das Verzeichnis öffnen, die hochgeladene Datei anklicken, Linkeinstellungen auswählen und [Einfügen] drücken. Der Link wird an der Stelle des Cursors auf der zu bearbeitenden Seite eingefügt. Dort im Link mit den geschweiften Klammern hinter dem | die Bildbezeichnung eintragen, z.B. siehe diese Buchabbildung: {{ techn._grundlagen:fachbuecher:buch03:bu03_1964_s0-a00_grlg_d_tn-vt_tits.jpg?direct&100 |Fachbuch Grundlagen der TN-Vermittlungstechnik}} ===Link in Zeitliste einbauen=== Eine schöne Funktion ist es, wenn man in der Zeitliste zu einem Thema einen Link findet (blau markiert). Den Klickt man an und erhält in einem neuen Fenster die gewünschte Information. Das Einbauen eines Links funktioniert folgendermaßen:\\ - man muss im Seiten-Änderungsmode sein\\ - der Zeiger muss an die entsprechende Stelle positioniert werden\\ - im Auswahlmenü „externer Link“ anklicken\\ - dadurch wird eingesetzt: "http://example.com|Externer Link"\\ - im linken Teil muss man die Link-Adresse einsetzten\\ - im rechten Teil gibt man den Text ein, der erscheinen soll\\ ===Suchfunktion=== Es gibt in Dokuwiki die Suchfunktion, die nach Seitennamen sucht, aber auch eine Volltextsuche macht. Folgende Eingaben sind u.a. möglich:\\ - Databurg Kleyerstrasse (UND-Verknüpfung)\\ - Data*\\ - *burg\\ - atabu (das ist nur ein Teil eines Wortes)\\ - "Benutzung der Datensammlung" (exakte Schreibweise)\\ Weitere Infos zum Suchen: https://www.dokuwiki.org/de:search Das Problem bei der Volltextsuche besteht darin, dass alle Dokuwiki-Seiten in einem „Suchindex“ automatisch gelistet werden. Dabei treten aber Problem auf, dass manche Seiten nicht gelistet sind. Dann wird natürlich in diesen Seiten NICHT gesucht. Eine Abhilfe bietet das Plugin „Suchindex Manager“. Wenn man dieses Plugin aufruft, wird der Suchindex aktualisiert oder neu angelegt. Danach kann man sicher sein, dass eine Suche in allen Seiten stattfindet. In GVIT-Dokuwiki ist dieses Plugin installiert. Der Aufruf funktioniert folgendermaßen:\\ - Einloggen als Admin\\ - Aufruf: Admin/weitere Plugins\\ - Anklicken: Suchindex Manager\\ - Auswahl: Index neu aufbauen\\ Beim Dokuwiki von GVIT dauert der Vorgang ca 1 Minute === Immer wieder gesucht=== ist das Sonderzeichen Copyright (c) \\ und der Direktlink zu Wikipedia [[wpde>Tenovis]] \\ Link zu Wikipedia [[wpde> Frankfurt]]\\ Verstorben: **†** === Foto hochladen === Verzeichnisstruktur und Dateiname beim Hochladen über Medien-Manager beachten. **Bildgröße**: maximal 1024 px Breite, nicht wie hier: {{ :gvit:bilder:besuch_deutsches_telefon-museum_2017:20170629_133610.jpg?direct |Panoramabild}} **Hinweis: Ausrichtung falsch**\\ Es kann passieren, dass nach dem Hochladen von Fotos mit dem Medien-Manager die Ausrichtung von Fotos falsch ist, z.B. ein Hochkant-Foto erscheint "quer". Da hilft folgende Vorgehensweise: man muss das Foto auf dem PC Bearbeiten (z.B. Grösse oder Helligkeit änden), Abspeichern und neu Hochladen. \\ Wenn der Name bleibt, muss man beim Hochladen den Haken setzten bei: "Existierende Dateien überschreiben". ===Konvertieren von Videos=== In DokuWiki werden nur bestimmte Formate erlaubt, daher muss man ein Video nach mp4 umwandeln. Bewährt hat sich die Plattform Convertio: (https://convertio.co/de/), mit der man sehr einfach eine Video-Datei in das Format „mp4“ umwandeln kann. Das ungewandelte Video lässt sich zu Dokuwiki hochladen und es funktioniert Bild und Ton. Das funktioniert bei anderen Konvertierungstools oft nicht. === Scannen === **von Fotos** **Einstellungen**: Helligkeits- und Kontrastregler je nach Vorlage anpassen S/W-Foto bzw. Farbfoto (je nach Vorlage) --- 300 dpi **Dateityp** : JEPG File Interchange (*.jpg) **JPEG-Optionen**: Auflösung: hohe Auflösung Komprimierungsfaktor: 30 bis 40 (je nach erzielter Schärfe bei Bildern) bei erforderlicher höherer Schärfe auch >40 (höherer Speicherbedarf) **von Dokumenten** schwarz/weiss (je nach Vorlage) --- 200 dpi **Dateityp** : PDF Portable Document Format (*.pdf) Beim Scannen kann man meistens weitere Vorlagen hintereinander scannen. Ansonsten gibt es die Software PDF24, die das Bearbeiten einer Vorlage möglich macht. Beim Speichern in PDF24 muss man "Gute Qualität" auswählen. ---- === Speichern === **Dateinamen** : __TN-Nachrichten__ -> **tnna** **h**xx **s**00xx_Sys 8030 h = Heft-Nr. s = Seitenzahl - 4stellig mit führenden Nullen (die ersten Hefte wurden 4stellig durchgezählt) _Sys 8030 (Stichwort für erste Seite des Artikels) Beispiel System 8030 _Eg E2 (Endgerät Telefon E2) usw. Beispiel -> **//''tnna h41 s1808.jpg''//** <- Dateinamen für einzelne Seiten Beispiel -> **//''tnna h41 s1807-1813_ReihAnl Chef Tel.jpg''//** <- Dateinamen für fertige mehrseitige Artikel **Dateinamen**: __TN-Mitteilungen__ -> **tnmi** **h**xx **s**xx_Arbpl Kl h = Heft-Nr. s = Seitenzahl 2stellig _Arbeitsplatz Werk Kleyerstr. **Dateinamen**: __TN-Kontakte__ -> **tnko** **j**xx **a**xx **s**xx_HanMes77 j = Jahr a = Ausgabe s = Seitenzahl _Hannover Messe 1977 **Dateinamen**: __Bücher__ -> **19xx** **Titel** **s**xxx_Kapitel usw. Ausgabedatum Titel (kurz) s = Seitenzahl === Anzeigen von PDF-Dokumenten === Ein solches Dokument muss man mit dem Medien-Manager hochladen (siehe Hochladen von Dateien). * Auswahl über Link Dann kann man auf einer Seite einen Link zu dem PDF-Dokumenten eintragen. Es erscheint der Link (mit dem Hinweis „pdf“) {{:hutt:tn-seite2-81-hhutt.pdf|TN-Firmengeschichte Teil 1 bis 1960. Seite 2-81, (.pdf 3 MB)}} Beispiel: http://wiki.gvit.de/doku.php?id=tn_allgemein:tn_nachrichten ===Link über Foto=== Eine wesentlich elegantere Methode ist, zunächst von der Titelseite des .pdf ein Foto (JPG) zu machen (PDF24) und dann dieses Foto und das PDF-Dokument in den richtigen Arbeitsbereich hoch zu laden. Im Foto kann man jetzt einen externen Link auf das PDF-Dokument eintragen. Hier ist die Dokuwiki-Vorlage für diese Methode: %%[[http://wiki.gvit.de/lib/exe/fetch.php?media= “Link zum PDF-Dokument“ |{{ „Link zum JPG-Foto“?nolink&200|}}]]%% Beispiel: http://wiki.gvit.de/doku.php?id=tn_allgemein:zeitlos:firmengeschichte:literatur\\ Kopiervorlage:\\ \\ %% [[http://wiki.gvit.de/lib/exe/fetch.php?media=:tn_allgemein:zeitlos:Dateiname-Inhalt.pdf|{{:tn_allgemein:zeitlos:Dateiname-Deckblatt.jpg?nolink&200|}}]] %%\\ \\ Hinweis: **ACHTUNG** beim Verschieben von Seiten, Namensräumen und Medien unbedingt kontrollieren, ob der .jpg-Link wieder/noch stimmt? ===Rahmen um weiße Titelseite=== Wenn eine Titelseite total weiß ist, sollte man einen kleinen Rahmen anlegen. Das kann man sicher mit allen Foto-Programmen machen. Ich beschreibe, wie man mit "IrfanView" einen Rahmen anlegen kann: Foto öffnen mit "IrfanView" - Bild/Farb-Rahmen hinzufügen\\ - Methode 1, Rahmenbreite 4 Pixel auf allen Seiten\\ - ok drücken\\ - Datei/Speichern (Original-Verzeichnis), ggf. Name korrigieren\\ ---- Als Bildergalerien benutzen wir das [[https://www.dokuwiki.org/plugin:gallery|Gallery-Plugin]] ===Struktur der Seiten und Fotos=== In jedem Namensraum sollte ein Unterordner „bilder“ angelegt werden, wo zugehörige Fotos abgespeichert werden (beim Hochladen des 1. Bildes vor dem Dateinamen //bilder:Dateiname// schreiben). Wenn man Galerien verwenden will, muss man für jede Galerie einen eigenen Unterordner unter „bilder“ anlegen. Nur so wird sichergestellt, dass nur die gewünschten Fotos zu einem Thema in der Galerie dargestellt werden. Ist ein Foto größer als der Bildschirm (z.B. gößer als 1024 x 768), dann wird das Foto in der Einzeldarstellung entsprechend verkleinert. Es gibt aber dann ein Icon (rechts oben), um das Foto zu vergrössern. Ein Bild anklicken und dann manuell oder automatisch Weiterblättern: {{gallery>:datensysteme:bilder?4&80x80&crop&lightbox}} ===Struktur der Namensräume und Seiten zur Ablage von Fotos am Beispiel der Endgeräte=== Ein Ordnungsprinzip ist, dass für jedes Schwerpunktthema (z.B. Endgeräte) verschiedene Zeiträume festgelegt sind. Es wird jetzt am Beispiel des Zeitraums "1946_bis_1965" die Ablage von Fotos der darin enthaltenen Produktfamilien beschrieben. Zunächst wird immer 1 Seite angelegt: 1. „1946_bis_1965“ Hauptseite, die beim Anklicken des Zeitraums geöffnet wird Dann wird pro Produktfamilie je eine Unterseite angelegt. Wenn wir die Produktfamilien E1, E2 und E3 darstellen wollen, müssen wir folgende Unterseiten anlegen: 2. „bilder_e1“ Unterseite, die für die Aufbereitung der Galerie zu E1 benötigt wird. 3. „bilder_e2“ Unterseite, die für die Aufbereitung der Galerie zu E2 benötigt wird. 4. „bilder_e3“ Unterseite, die für die Aufbereitung der Galerie zu E3 benötigt wird. Weiterhin gibt es generell einen Namensraum "bilder" und weitere Namensräume für bestimmte Familien, z.B. e1, e2, e3, ... Allgemeine Fotos können in "bilder" abgelegt werden, Fotos zu bestimmten Familien sollen in dem zugehörigen Namensraum abgelegt werden. Dann können diese einfach als Galerie angezeigt werden. Der Ablauf soll folgendermaßen erfolgen: In der Hauptseite wird eine Produktfamilie textlich vorgestellt und es wird EIN Foto angezeigt, z.B. E1-Apparat. In dem Foto vom diesem Apparat ist ein Link auf die Seite "bilder_e1" hinterlegt. Dort ist dann zu der Produktfamilie eine Galerie programmiert, so dass ein Benutzer nach Anklicken des Fotos auf der Hauptseite die zugehörige Galerie angezeigt bekommt. Zu den andern Produktfamilien wird von der Hauptseite auf die entsprechende Unterseite verlinkt, um dann die Galerie anzuzeigen. Dann kann man weitere Fotos mit dem Medien-Manager in den entsprechenden Namensraum z.B. e1 hochladen und es werden dann alle dort vorhandenen Bilder angezeigt, ohne die Programmierung ändern zu müssen. Hier geht es zu dem Beispiel mit den Endgeräte-Familien E1, E2 und E3: [[endgeraete:1950_bis_1965:1950_bis_1965#e1}}|endgeraete:1946_bis_1965:]] Hier ist ein Übersichtsbild, das die Struktur darstellt: {{datensysteme:bilder_kurzreferenz:struktur_dokuwiki_ablage_fotos_endgeraete_gvit_v11.jpg?600|}} ===Verschieben von Seiten, Namesräumen und Medien in Dokuwiki=== Die Basis von Dokuwiki sind Namensräume (Ordner), in denen Seiten abgelegt werden. Zur Struktur kann man verschieden Namesräume anlegen, die auch Unter-Namesräume haben dürfen. Wenn man während der Bearbeitung einer Seite ein Foto downloaded und einstellt, dann wird das Foto normalerweise in den Namensraum abgelegt, wo auch diese Seite liegt. Falls man beim Download noch den Namen eines Unterordners angibt, wir der angelegt und das Foto dorthin übertragen. Mit „Übersicht“ werden alle Namensräume angezeigt, wo Seiten abgelegt sind. Im „Dateimanager“ kann man eine Übersicht der Namensräume sehen, wo Medien abgelegt sind. Das Verschieben wird mit dem „Move Plugin“ ausgeführt. Dazu benötigt man Admin-Rechte. Mit dieser Funktion werden alle Links auf die verschobene Seite angepasst. === Verschieben einer Seite === Man wählt die Seite aus, die verschoben werden soll, z.B. „test2“ Dann geht man zu „Admin“ und wählt aus: „Seite/Namensraum verschieben/umbenennen“ Die Standardeinstellung ist „Seite verschieben“ Es wird die aktuelle Seite angezeigt, z.B. „unterseite2:test2“ Jetzt muss man unter „Neuer Name“ den Namensraum und den Seitennamen angeben, wohin die Seite verschoben werden soll, z.B. „unterseite1:test2x“ In diesem Beispiel wird gleich der Name der Seite geändert (optional möglich). Mit „Start“ wir die Verschiebung vorbereitet. Mit Anklicken von „Vorschau der Änderungen, die ausgeführt werden sollen“ werden die Schritte angezeigt, die zur Verschiebung durchgeführt werden müssen. Mit „Start“ wird die Verschiebung durchgeführt. === Verschieben Namensraum === Man wählt eine Seite in dem Namensraum aus, den man verschieben will z.B. die „seite1“ im Namensraum „unterunterseite1“ Dann geht man zu „Admin“ und wählt aus: „Seite/Namensraum verschieben/umbenennen“ Jetzt wählt man aus: „Namensraum verschieben“ Es wird der zu verschiebende Namensraum angezeigt: „unterseite4:unterunterseite1“ Jetzt muss man in „Neuer Name“ das Ziel eingeben: z.B. unterseite2:unterunterseite1 In diesem Beispiel bleibt der Namensraum unverändert. Man könnte ihn auch ändern (optional möglich). Unter „Zu verschiebender Inhalt“ steht standardmässig „Seiten und Mediendateien“, damit werden auch vorhandene Bilder und Dokumente verschoben. Es werden auch alle Unter-Namensräume/Unterordner mit verschoben. Mit „Start“ wir die Verschiebung vorbereitet. Mit Anklicken von „Vorschau der Änderungen, die ausgeführt werden sollen“ werden die Schritte angezeigt, die zur Verschiebung durchgeführt werden müssen. Mit „Start“ wird die Verschiebung durchgeführt. === Verschieben von Medien (u.a. Fotos, PDF-Dokumente) === Es gibt eine baum-orientierte Oberfläche, um insbesondere Medien (aber auch Namensräume und Seiten) zu verschieben. Dazu geht man zu „Admin“ und wählt aus: „Seite/Namensraum verschieben/umbenennen“. Jetzt „baumbasierten Move-Manager“ anklicken. **Hinweis:** Man muss beim Ziel-Ordner unbedingt vorhandene Unterordner öffnen, damit der verschobene Ordner korrekt eingebunden wird. Unter „Mediendateien“ kann man den Bereich öffnen, wo Dateien sind, die man verschieben will. Man zieht jetzt die Datei zu dem Ordner, wohin sie verschoben werden soll. Sie wird dann sofort unter dem neuen Ziel angezeigt. Das kann man mit mehreren Dateien machen. Jetzt klickt man auf „Start“. Mit Anklicken von „Vorschau der Änderungen, die ausgeführt werden sollen“ werden die Schritte angezeigt, die zur Verschiebung durchgeführt werden müssen. Mit „Start“ wird die Verschiebung durchgeführt. **Hinweis** Man kann einzelne Dateien, aber auch einen Ordner durch Setzten eines Hakens auswählen. Dann werden alle ausgewählte Objekte gemeinsam verschoben.\\ Bitte Hinweis beachten bei **[[:datensysteme:kurzreferenz#link_ueber_foto|Link über Foto]]**, denn das Verschiebe-Programm hat wohl Schwierigkeiten bei solch verschachtelten Links!\\ Alle weiteren **Funktionen** des DokuWiki sind detailliert in der unten verlinkten Syntax-Beschreibung aufgelistet. Bitte unbedingt lesen! ===Links zu den Original-Beschreibungen=== **Benutzerhandbuch**: https://www.dokuwiki.org/de:manual\\ Wichtige Einzelbeschreibungen:\\ \\ Toolbar auf Bearbeitungsseite: https://www.dokuwiki.org/de:toolbar\\ **Syntax: https://www.dokuwiki.org/de:wiki:syntax **\\ Seitennamen: https://www.dokuwiki.org/de:pagename\\ Seiten: https://www.dokuwiki.org/de:page\\ Namensräume: https://www.dokuwiki.org/de:namespaces\\ Oberfläche: https://www.dokuwiki.org/template:dokuwiki\\ Suchfunktion: https://www.dokuwiki.org/de:search\\ ===Änderungen verfolgen=== Benachrichtigungen einrichten: https://www.dokuwiki.org/de:faq:notifications\\ XML Feed erstellen: https://www.dokuwiki.org/de:syndication\\ ===Mailing List für DokuWiki=== Linksammlung: https://www.freelists.org/archive/dokuwiki\\