====== 1. Installation ======
\\
==== Handbücher ====
|Installation| https://www.dokuwiki.org/de:install  |
|Handbuch| https://www.dokuwiki.org/de:manual|
|Template| https://www.dokuwiki.org/template:dokuwiki |
|eignens CSS| https://www.dokuwiki.org/devel:css |

==== Installation ====
Die schnellste und einfachste Art der Neuinstallation ist, auf folgender Seite das Script herunter zu laden:
https://www.dokuwiki.org/de:install:downloader\\
Auf neuen Webspace kopieren und ausführen.\\
Fertig.\\
\\
==== Konfiguration ====
folgende Einstellungen sollten geändert werden:\\
Admin -> Konfiguration

** Seitenname **\\
Name der Seite eintragen \\
Keyword: title \\
Wert: z.B. MeineSeite\\

** Sprache ändern **\\
Einloggen und oben auf ADMIN klicken\\
CONFIGURATION SETTING wählen und nach dem Keyword "lang" suchen. \\
Auf DE stellen und ganz unten auf "save".\\
\\
** erste Überschrift in einem Beitrag als Menübezeichnung nutzen **\\
Damit im Menü die Überschrift als Menubezeichnung erscheint\\
Keyword: useheading \\
Wert: immer\\

** Seiten verstecken **\\
Seiten welche nicht angezeigt werden sollen wie z.B. Sidebar\\
Keyword: hidepages  \\
Wert: (_views|sidebar)\\

** Zielfenster für Externe Links **\\
Keyword: target»extern \\
Wert: _blank\\

** Bilder Qualität **\\
Keyword: jpg_quality \\
Wert: 100\\

** "Zuletzt angesehen" ausschalten **\\
Keyword: breadcrumbs\\
Wert: Anzahl der Einträge im "Krümelpfad" = 0

** "Sie befinden sich hier" einstellen **\\
Keyword: youarehere\\
Wert: angehakt\\

** Email Adressen im Content unleserlich machen **\\
KeyWord: mailguard\\
Wert: E-Mail-Adressen schützen: immer\\


==== Sidebar (linkes Menü) anlegen ====
Im Suchfeld ":sidebar" eingeben\\
Jetzt Seite anlegen und einen Inhalt z.B. "Hauptmenü" eingeben.\\
Speichern\\

==== Logo und Favicon ändern ====
Im Medienmanger die Dateien "logo.png" und "favicon.ico" ins Root kopieren.\\
https://www.dokuwiki.org/template:dokuwiki#changing_the_logo \\

==== Standard Seitenbreite ====
Damit legt man die maximale Breite von Dokuwiki fest.\\
Admin -> Einstellungen fürs Template-Design\\
Breite der ganzen Seite (kann eine beliebige Längeneinheit sein: %, px, em, ...)\\
Wert: 1600px\\

==== Eigenes CSS ====
Im Verzeichnis conf die Datei userstyle.css anlegen und die CSS Änderungen darin vornehmen\\
  conf/userstyle.css
==== Seitenname ausblenden ====
in der CSS Datei /conf/userstyle.css folgenden Eintrag\\

<code php>
  /* Name der Seite im Menü ausschalten */
  #dw__title {
	display: none;
  }
</code>

==== Fusszeile ausblenden ====
in der CSS Datei /conf/userstyle.css folgenden Eintrag\\

<code css| donwload>
/* Fußzeile DOKUWIKI Buttons ausschalten */
#dokuwiki__footer > .pad > .buttons {
	display: none;
}
</code>

==== Farben ändern ====
Admin -> Einstellungen fürs Template-Design

für diese Seite:
Allgemeine Linkfarbe: 204, 132, 0   (#cc8400)

oder in der CSS Datei /conf/userstyle.css die Farben neu definieren\\



==== Besucherzähler / Seite neu anlegen ====
beides wird in der Datei inc/template.php bei Zeile 875 eingebaut



==== Sprachdatei ändern ====

Datei: Inc\Lang\De\lang.php

Suchen: Seitenleiste
Ersetzen: Menü

==== FONTS einfügen ====
/lib/conf/meta.html\\
folgendes einfügen:\\
<code php| meta.html>
<link rel="stylesheet" type="text/css" href="//fonts.googleapis.com/css?family=Open+Sans" />
</code>
\\
Jetzt noch in der CSS Datei den Font aktivieren.\\
Datei: conf/userstyle.css\\
<code css>
font: normal 16px/26px "Open Sans","Helvetica Neue",Helvetica,Arial,sans-serif;
</code>
==== PLUGIN: Neue Seite anlegen ====
Damit das Aktionsfeld für das Plugin NEUE SEITE ANLEGEN erscheint muss dieses wie folgt integriert werden.\\
{{:intern:b1.png?400|}}\\
Einbauen des Plugins: https://www.dokuwiki.org/plugin:addnewpage

/lib/tpl/dokuwiki/main.php

suchen:
<code php>
        <div class="docInfo"><?php tpl_pageinfo() ?></div>
</code>
\\
ersetzen:
<code php>
        <div class="docInfo">
		<?php echo p_render('xhtml',p_get_instructions('{{NEWPAGE}}'),$info) ?>	
		<?php tpl_pageinfo() ?>
	</div>
</code>


==== Menü ICON für Seitenmenü ====
Grafik: {{:menu.png?25}}\\
\\
ändern: /lib/tpl/dokuwiki/main.php\\
Zeile: 38\\

<code php>
   <h3 class="toggle"><?php echo $lang['sidebar'] ?></h3>
</code>
ändern in:
<code php>
   <h3 class="toggle"><img src="lib/images/menu.png" style="height:27px"> <?php echo $lang['sidebar'] ?></h3>
</code>


==== Aufklapp Menüs ====
Class in Source einfügen\\
Datei: /lib/plugins/folded/sytax/div.php
Ab Zeile 53 folgende Zeilen ergänzen um -> class="head_folder"
<code php>
                if ($this->getConf('unfold_default')) {
                    $renderer->doc .= '<p class="head_folder"><a class="folder open" href="#'.$folded_id.'">';
                } else {
                    $renderer->doc .= '<p class="head_folder"><a class="folder" href="#'.$folded_id.'">';
                }
</code>


==== Wort "Seitenleiste" ersetzen ====
Wenn das linke Menü im Handymodus ist, zeigt es standard mäßig das Wort "Seitenleiste"\\
Das ersetzen wir durch "Menü" \\
\\
Datei: \Inc\Lang\De\Lang.php
\\
Suchen: Seitenleiste\\
ersetzen: Menü\\

==== Generator verschleiern ====
Damit nicht gleich jeder erkennt, dass es sich um Dokuwiki handelt wird dieser TAG entfernt.\\
\\
Datei: inc/template.php\\
Zeile ca.: 230\\
suchen:\\
<code php>
 $head['meta'][] = array('name'=> 'generator', 'content'=> 'DokuWiki');
</code>
ersetzen:\\
<code php>
 $head['meta'][] = array('name'=> 'generator', 'content'=> '');
</code>

==== Photoimpact Dateien ====
Damit Dateien mit dem Format "*.ufo" hochgeladen werden können müssen wir folgenden Eintrag machen:\\
\\
Datei: conf/mime.conf

<code>
ufo		 text/plain
</code>

==== TITLE Attribut deaktivieren ====
Wenn man mit der Maus über bestimmte Objekte geht bekommt man eine Info angezeigt welcher durch das "title" Attribut ausgelöst wird.
Dieses kann man deaktivieren indem man folgendes in die \\
\\
Datei: /conf/userscript.js 
schreibt.\\

<code java>
jQuery(document).ready(function() { 
     jQuery( "a" ).attr('title',"");
});
</code>

==== Menü Top Bar ====
Um das Top Bar Menü wie auf der original Seite von DokuWiki hin zu bekommen folgen Sie folgender Anleitung:\\

https://www.dokuwiki.org/tips:topbar

==== htaccess ====
Die .htaccess ist standard mäßig deaktivert. Dazu die Datei \.htaccess.dist umbenennen in \.htaccess.\\
\\
Für die bessere Lesbarkeit der URL sollte folgendes ausdokumentiert werden:\\

Ergebnis:\\
<code>
## Uncomment these rules if you want to have nice URLs using
## $conf['userewrite'] = 1 - not needed for rewrite mode 2
RewriteEngine on
#
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
RewriteRule ^index.php$               doku.php
</code>
Weiterin muss in der Konfiguration der Wert "userewrite" umgestellt werden auf ".htaccess".\\
Um es noch besser zu machen haken wird noch "useslash" an, damit aus dem Doppelpunkt ein Slash wird.


Damit von http auf https weitergeleitet werden soll dann folgendes ändern:\\

<code>
## If you enable DokuWikis XML-RPC interface, you should consider to
## restrict access to it over HTTPS only! Uncomment the following two
## rules if your server setup allows HTTPS.
RewriteCond %{HTTPS} !=on
RewriteRule ^lib/exe/xmlrpc.php$      https://%{SERVER_NAME}%{REQUEST_URI} [L,R=301]
</code>

Umleiten von www auf ohne www\\
Beispiel:
<code>
RewriteCond %{HTTP_HOST} ^www\.hennweb\.de$ [NC]
RewriteRule (.*) https://hennweb.de/$1 [R=301,L]
</code>