====== Einführung ======
===== Allgemein ====

Das installierte [[wpde>Wiki]] System [[wiki:dokuwiki]] ist ein relativ einfach gehaltenes auf textdateien basierendes System ohne eine Datenbankanbindung. Hier nochmals die externen links zu den deutschen Seiten:
  * [[http://www.dokuwiki.org/de:dokuwiki|Dokuwiki Homepage]]
  * [[http://www.dokuwiki.org/de:syntax|Syntax]]
  * [[http://www.dokuwiki.org/de:manual|Handbuch (deutsch)]]

===== Ansicht =====

Auf der linken Seite befindet sich das [[http://www.koeag.de|Königsteiner]] Logo. Darunter befinden sich die Boxen zur [[http://www.dokuwiki.org/plugin:indexmenu|Navigation]] und zur Volltextsuche über das gesammte [[wpde>Wiki]]. Am Ende die Werkzeug Box mit verschiedensten Möglichkeiten.

Oben auf der Seite gibt es verschiedene Reiter. Für editieren oder anzeigen des Quelltextes der Seite. Daneben können alle vorhergehenden Versionen angezeigt und ggf. mit der aktuellen verglichen werden. Da nur registriert User Änderungen durchführen können ist dort auch der jeweilige Author der Änderung aufgeführt. Der Reiter **Aboverwaltung** steht nur registrierten Usern zur Verfügung. Beim klick auf den Reiter **Export: ODT** wird die aktuelle Seite im [[wpde>OpenDocument|ODF]] Format zum download angeboten. Der Reiter [[http://www.dokuwiki.org/plugin:bookcreator|ADD/Remove to selection]] dient zum selektieren einzelner Seiten aus dem [[wpde>Wiki]] um diese Seiten in einer PDF Datei zu exportieren.

====== Syntax Beispiele ======
===== Standard ====
==== Text ====

  * **fett** <code>**fett**</code>
  * //kursiv//<code>//kursiv//</code>
  * __unterstirchen__<code>__unterstrichen__</code>
  * <del>gelöscht</del><code><del>gelöscht</del></code>

Natürlich kann auch alles **__//''kombiniert''//__** werden.
<code>**__//''kombiniert''//__** werden.</code>

<code>
====== Überschrift Ebene 1 ======
===== Überschrift Ebene 2 =====
==== Überschrift Ebene 3 ====
=== Überschrift Ebene 4 ===
== Überschrift Ebene 5 ==
</code>

==== Links ====

Externe Links könnene einfach oder mit Meta-Zeichen angegeben werden:
<code>
www.schindler.ws  
[[http:\\www.schindlerw.ws|Hartmut Schindler]]
</code>

Email Adressen <hs@koeag.de> bitte so angeben
<code><hs@koeag.de></code>

Interne [[http://www.dokuwiki.org/de:namespaces|Namesnäme]] werden Interne werden in doppelten eckigen Klammern gesetzt:
<code>
[[pagename]]
[[foo:bar:]] = "Suchreihenfolge: 1=foo:bar:start 2=foo:bar:bar 3=foo:bar"
 </code>

Hier ein paar Beispiele um es besser zu verdeutlichen. Unter der **root** soll das Verzeichnis **edv** entstehen, mit mehreren unterverzeichnissen (Namensräumen). Im Namensraum edv gibt es auch ein Dokument, das **edv** heist und folgendermasen im root Dokument eingetragen wird:
<code>
  * [[edv|DV - Dokumentation]]
</code>
Im Dokument edv, das unter **root** liegt werden dann die dortigen Dokumente direkt angegeben. Ob mit //:// oder ohne //:// hat keinerlei auswirkungen. Beide verweisen auf **root**/edv.
<code>
  - [[edv:Passwoerter|Passwörter]]
  - [[:edv:Zugangsdaten|Zugangsdaten extern]]
</code>
Möchte ich relativ von meinem vorhandenen **namespace** aus positionieren muss ein **.** vorangestellt werden:
<code>
  - [[.:neu|test namensraum adressierung]]
</code>

:!:**//Ein Namensraum und ein entsprechend gleich genanntes Dokument haben nichts miteinander zu tun.
Erst durch die Angabe von Namensräumen in einem Dokument entsteht ein Namensraum, nicht durch das Dokument selbst//**




Innerhalb eines Dokumentes kann auch auf einzelne Überschirften durch die Angabe von # gesprungen werden. z.B.:
<code>
[[pagname#Abschnitt|Innerhalb eines Dokuments]]
</code>

DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. \\
Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]
<code>
DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. \\
Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]
</code>

* funktioniert nur im IE [[\\server1\koeag\edv|Server1 auf edv]] in der lokalen Zone. Besser mit rechter Maustaste "Link senden" geht email programm auf und dort dann mit STRG und klick auf file:////server1/koeag/ klicken.


=== Hier noch ein Orginalauszug von der Dokuwiki Dokumentation zwecks Namensräumen ===

Man muss Namensräume nicht separat erstellen; einfach eine Seite mit Doppelpunkt erstellen. Der Teil hinter dem letzten Doppelpunkt wird der Seitenname, alle Teile davor sind Namensräume. Alle Namensräume, die im Seitennamen verwendet werden, und noch nicht existieren, werden von DokuWiki automatisch erstellt.

In DokuWiki werden Seiten wie in jedem anderen Wiki erstellt. Dazu erstellt man einfach einen Link auf einer noch nicht existierenden Seite, folgt dem Link und klickt auf "Diese Seite erstellen". Siehe dazu auch [[de:page#neue_seite_erstellen|Neue Seite erstellen]].

^Beispiele:^^
|beispiel|zeigt auf die Seite "beispiel" im momentanen Namensraum.|
|:beispiel|zeigt auf die Seite "beispiel" im Hauptnamensraum,.|
|..beispiel\\ ..:beispiel\\ .:..:beispiel|zeigt auf die Seite "beispiel" im **parent** Namensraum|
|wiki:beispiel|zeigt auf die Seite "beispiel" im Namensraum "wiki" und "wiki" liegt **direkt im Hauptnamensraum**.|
|ns1:ns2:beispiel\\ :ns1:ns2:beispiel|zeigt auf die Seite "beispiel" im Namensraum ns2. ns2 liegt unter ns1; ns1 liegt **direkt im Hauptnamensraum**.|
|..ns1:ns2:beispiel\\ ..:ns1:ns2:beispiel|zeigt auf die Seite "beispiel" im Namensraum ns2. ns2 liegt unter ns1. ns1 liegt **neben dem akuellen** Namensraum (ns1 und der aktuelle Namensraum sind im gleichen übergeordneten Verzeichnis, wo auch immer in der Seitenhierarchie dieses übergeordnete Verzeichnis liegt.|
|.ns1:ns2:|zeigt auf die "startseite" im Namensraum ns2. ns2 liegt unter ns1; ns1 liegt unter dem aktuellen Namensraum.|

:!: Achtung: Die Syntax für relative und absolute interne Verweise ist komplexer im Vergleich zu den Konventionen für relative Verzeichnis- und Dateinamen.

Pfade sind nur dann absolut, wenn sie mit "/" beginnen.

Verweise sind absolut, wenn sie mit einem ":"-Präfix beginnen oder kein Präfix haben aber mindestens einen oder mehrere ":" dazwischen (oder als Suffix) enthalten.

Verweise, die relativ zum aktuellen Namensraum sind, können sowohl mit "." als auch mit ".:" (".." oder "..:" für den übergeordneten Namensraum) beginnen.

~~NOCACHE~~
==== Bilder ====

Bilder können über die den Medien-Manager in der Werkzeug-Leiste hochgeladen werden. Dort gibt es auch angaben zur größe und Ausrichtung der Bilder. Bilder ohne solche Angaben (?) werden irgendwie **nicht** angezeigt !!!

{{:wiki:dokuwiki-128.png?100|}}  [[http://www.schindler.ws|{{:wiki:dokuwiki-128.png?25|als Link zu www.schindler.ws}}]]

mittig anordnen {{ :wiki:dokuwiki-128.png?nolink&100 |}}
links anordnen {{:wiki:dokuwiki-128.png?nolink&100 |}}
rechts anordnen {{ :wiki:dokuwiki-128.png?80 |}}

{{:wiki:dokuwiki-128.png?200|}}

===== Erweiterungen ====

==== Alphaindex ====

Kann benutzt werden um ein Glossar zu erstellen. Das Plugin verwendet die Dateinamen der vorhandenen Dokumente eines Namensraumes. **#n** ist die Tiefe ab dem vorgegebenen namespace. **nons** sagt aus, dass der Namensraum selbst nicht im Index erscheint.

<code>
{{alphaindex>[namespace][#n][|nons]}}
</code>
==== Boxes ====


====== Template ======
===== Monobook =====

Für [[http://www.koeag.de|Königsteiner Agentur]] habe ich das template [[http://www.dokuwiki.org/template:monobook|monobook]] ausgewählt.\\
Templates könnnen mit [[wpde>PHP]] Kentnissen selbst erstellt werden. Das verwendete Template [[http://www.dokuwiki.org/template:monobook|monobook]] kann zusätzlich über Paramter im Administrator Modus konfiguriert werden. In dieser 
Installation wurde zusätzlich die Werkzeugleiste modifiziert und eine neue werkzeugleist für Administratoren mit eingefügt.

==== Template Anpassungen ====

Folgendes wurde in **boxes.php** im pfad lib/tpl/monobook/conf/boxes.php auskommentiert damit die Funktion **Index** nicht mehr für jeden User Verfügbar ist. Dafür ist die Navigation Box vorhanden.
<code>
/*
            if (actionOK("index")){ //check if action is disabled
                $_monobook_boxes["p-tb"]["xhtml"] .= "          <li id=\"tb-special\"><a href=\"".wl("", array("do" => "index"))."\" rel=\"nofollow\">".hsc($lang["monobook_toolbxdef_siteindex"])."</a></li>\n";
            }
*/
</code>   

==== Template Erweiterungen ====

In der Datei **boxes.php** im Pfad /lib/tpl/monobook/user/ wurde folgende neue Box angelegt. Diese Box erscheint nur bei angemeldeten Usern, die zur Gruppe **admin** gehören.
<code>
if ($loginname !== "") { //user is logged in?
        $_monobook_boxes["example1"]["headline"] = "Angemeldete User!";
//      if ($INFO["userinfo"]["name"] == "koeag") {
        if (in_array("admin", $INFO["userinfo"]["grps"])) {
        $_monobook_boxes["example1"]["xhtml"] = "DokuWiki with monobook... <em>rules</em>!";
        }
        if (actionOK("index")){ //check if action is disabled
                $_monobook_boxes["example1"]["xhtml"] .= "          <li id=\"tb-special\"><a href=\"".wl("", array("do" => "index"))."\" rel=\"nofollow\">".hsc($lang["monobook_toolbxdef_siteindex"])."</a></li>\n";
        }
}

</code>

=== Geht auch einfacher !!! ===

Das ganze **gedöns** mit Änderungen in den Template Dateinen, nur um die Index Funktion auszuschalten geht auch einfacher. Im config für das template den Schalter für eigenes Werkzeug anhaken und dann die Funktionen folgendermasen dort eintragen die man braucht:

<code>
  * [[this>doku.php?do=index|Inhaltsverzeichnis]]
</code>

Eine Übersicht über die möglichen Action modes gibt es [[http://www.dokuwiki.org/devel:action_modes|hier]]
Eine Übersicht über die verwendbaren Environment Variablen gibt es [[http://www.dokuwiki.org/devel:environment|hier]]

Oder gleich zur Seite für [[http://www.dokuwiki.org/devel|Entwickler]]

====== Plugin ======

Die hier aufgeführten [[http://www.dokuwiki.org/plugins|plugins]] sind aus den ca. 1000 möglichen plugins für dokuwiki entnommen. Ein ausführlicher Test vor Einsatz einer neuen Erweiterung ist zwingend erforderlich. Viele Plugins vertragen sich **nicht** mit anderen. Auch können funktionierende Plugins durch neu installierte die ursprüngliche Funktion verlieren !!!!!

=== Einige externe Seiten mit Beispielen ===

[[ http://wiki.natenom.name/ueber/verwendete_plugins]]

===== Nie zu benutzende Plugins =====

Die nachfolgenden Plugins funktionierten nicht oder im schlimmsten Fall führten sie zu Fehlern in anderen Funktionen. Beispielhaft sei hier das Plugin **bookcreator** genannt, das für sich selbst funktioniert, allerdings im gesamten Wiki keine Grafiken mehr angezeigt werden.

==== bookcreator ====

  * Erzeugen eines [[http://www.dokuwiki.org/plugin:bookcreator|PDF dokuments]] aus einzel selektiereten Seiten des wiki's
  * Ist im hier verwendeten [[http://www.dokuwiki.org/template:monobook|Template]] integriert als eigener Reiter.

===== Verwendete Plugins =====

Folgende plugins werden verwendet. Die Reihenfolge der Aufzählung entspricht Ihrem Einsatzdatum, neuere immer zuerst.

==== rdplink ====

   * Startet eine [[wpde>Remote_Desktop_Protocol]] Session auf einen anderen Rechner. wird verwendet um auf die Konsole von virtuellen Rechnern uzugreifen. 
   * [[http://www.dokuwiki.org/plugin:rdplink|RDPLink]] erzeugt eine Konfigurationsdatei und lädt diese dann auf den lokalen PC. Deshalb muß auf dem Windows Rechner die Endung .rdp mit dem Remotedesktop programm dauerhaft verknüpft werden.
   * Den [[wpde>Remote_Desktop|RDP]] Client findet man unter **//%windir%\system32\mstsc.exe//** 


==== backup ====

   * Hierbei handelt es sich um ein **Administrator** Plugin. 
   * [[http://www.dokuwiki.org/plugin:backup|Backup]] sichert die aktuelle dokuwiki installation in ein tar file.
   * Das Rücksichern muss manuell über die [[ssh://koeag@mfa1.local.koeag|Shell]] Ebene erfolgen. Zu finden ist das Backup unter **/var/www/wiki/data/media/wiki/backup**. In der Linux shell am besten den [[http://wiki.ubuntuusers.de/Midnight_Commander|mc]] starten.
   * Gesichert werden folgende Verzeicnisse:
      * conf = Aktuelle Konfigurationsdateien
      * data = Alle Inhalte
         * [[doku>de:attic]] = Enthält die verschiedenen Versionen, somit die Änderungen eines Dokumentes fest.
         * media = Alle Dokumente die in's Wiki importiert wurden
         * [[doku>metadata|meta]] = Interne Informationen zu jeder Seite.
         * pages = Die Seiten im Dokuwiki Syntax (das was wir editieren)
      * lib = plugins und templates


==== Indexmenu ====

  * Windows artige [[http://www.dokuwiki.org/plugin:indexmenu|Navigation]] mit Ordnerstrukturen. 
  * Hier eingesetzt im [[http://www.dokuwiki.org/template:monobook|monobook]] template in der Navigationsbox

<code> {{indexmenu>:#1|tsort nsort js navbar noscroll}}   </code>

==== dw2pdf ====

   * DokuWiki to [[http://www.dokuwiki.org/plugin:dw2pdf|PDF converter]]
   * Erstellt aus der angezeigten Seite ein PDF Dokument.
   * Für das eingesetzte Template [[http://www.dokuwiki.org/template:monobook|monobook]] gibt es eine Erweiterung die manuell in der Datei /users/tabs.php einzubauen ist, damit ein eigener Reiter für diese Funktion erscheint.

==== editx ====

   * DokuWiki-Seiten umbenenen oder löschen mit [[http://www.dokuwiki.org/plugin:editx|PDF editx]]
   * Im Änderungsmods einer Seite erscheint der Link für dieses Plugin im oberen Teil. Der Link leitet auf eine neue Seite in dem:
           * Die Seite gelöscht werden kann
           * Die Seite umgeleitet wird auf eine neue Seite
           * Die Seite gelöscht wird.