Beim Verschieben oder Umbenennen einer Seite sind mehrere Aspekte zu beachten:

1. Welche internen Links zeigen auf diese Seite?
2. Wird die Seite in ein Verzeichnis verschoben, auf welches nicht jeder Nutzer Zugriffsrechte hat?
3. Welche anderen Elemente nutzen den Namen der Seite als Parameter?

Die erste Frage ist technisch leicht zu prüfen und wird vom Plugin move erledigt. Dieses Plugin kann auf Admin-Ebene auch ganze Namespaces umbenennen. Das klappt nur, wenn die zu ändernde Seite nicht durch die hidepages-Parameter administrativ ausgeblendet ist! Wird eine Seite in ein Verzeichnis verschoben, das durch Menüsysteme nicht erfasst wird oder sogar für bestimmte Benutzer zugriffsgeschützt ist, gehen zuvor verfügbare Zugriffmöglichkeiten verloren. Sofern mit differenzierten Benutzerrechten gearbeitet wird, könnte die administrative Einstellung sneaky index eine Rolle spielen (derzeit nicht aktiv).

Schwieriger wird es bei den anderen Elementen (also nicht den Hyperlinks), die den Namen (und Ort) der Seite als Parameter führen. Klassisches Beispiel: Nach dem Verschieben und/oder Umbenennen verweist ein Eintrag in dem Element einer Navigationsstruktur nicht automatisch auf den neuen Ort/Namen. Der Eintrag oder sogar das ganze davon abhängige Menü verschwindet. Erst nach manueller Anpassung wird es wieder sichtbar. Systembedingt sind daher vor allem gescriptete und selektive Navigationsmenüs von Umbenennungen oder Verschiebungen betroffen. Ebenso kann nach Verschieben einer Seite in einen anderen Namespace ein auf der Seite eingesetztes Steuerelement den Fokus auf sein ursprüngliches Ziel verlieren. Auch hier ist eine Anpassung an die geänderte Position oftmals manuell erforderlich. Daher ist es sinnvoll, ein Verzeichnis der Seiten zu führen, welches solche Elemente auflistet. Dies wird bei uns auf der Startseite in einem nur den Redakteuren sichtbaren Abschnitt gesuchte Seiten - broken links realisiert.

Für die Arbeit von iX-Wiki in Zusammenhang mit SVN bedeutet dies, eine bestimmte Abfolge von Schritten bei der Umbenennung beizubehalten, um die Historie des Textes in SVN zu erhalten. Beispiel: Im Trunk soll für Excel-Berichte die Seite system.txt in technical.txt umbenannt werden.

1. Aufruf der Seite über den Browserpfad
   srv-dev/xampp/DokuWiki/trunk/doku.php?id=berichtscenter:excel_berichte:system
   srv-dev\DokuWiki\Trunk\data\pages\berichtscenter\excel_berichte\system.txt (analoger Dateipfad)
2. Umbenennen in DokuWiki: → Links werden angepasst, → Datei wird umbenannt system.txt → technical.txt
3. SVN-Commit vorbereiten
   1. Dateinamensänderung auf Verzeichnisebene zurücknehmen: technical.txt → system.txt
      \\srv-dev\DokuWiki\Trunk\data\pages\berichtscenter\excel_berichte\technical.txt →
      \\srv-dev\DokuWiki\Trunk\data\pages\berichtscenter\excel_berichte\system.txt
   2. SVN-Rename über SVN-Kontextmenü im Dateiexplorer: system.txt → technical.txt
4. SVN-Commit
5. Merge abwarten (Mail mit Konflikt?), ggf. Mergekonflikt bereinigen
6. Update auf branch (Mail mit Konflikt?) ggf. Mergekonflikt bereinigen

Commit-Beispiel:

Auslöser		ix-Wiki Excel-Berichte
Inhaltliche Änderung	
Doku			
Testhinweise		
Betroffene Module	
Technische Änderung	rename system.txt -> technical.txt

Das Commit erzeugt mehrere E-Mails, die im Idealfall alle Status OK haben:

Merge OK  Revision 153515 (trunk) (arr)
PostCommit OK excel_berichte  Revision 153516 (branch) (arr)
Deploy OK  Revision 153516 (branch) (arr)
Done 'w:\branch\ix_dev\doku\DokuWiki\data\pages\berichtscenter\excel_berichte' (branch) (arr)

Sollten Merge-Konflikte benannt werden, müssen diese bearbeitet werden!

Nachdem alles OK ist, muss als letzter Schritt der Branch upgedated werden: SVN-Update von
\\srv-dev\DokuWiki\Trunk\data\pages\berichtscenter\excel_berichte
Die umbenannte Datei taucht hier mit der Action Deleted: Alter Dateiname und Added: Neuer Dateiname auf.

Sollten Merge-Konflikte benannt werden, müssen diese bearbeitet werden!

Für das Upgrade dringend empfohlen und auch verwendet wurde das DokuWiki Upgrade Plugin, welche natürlich zuerst installiert werden musste.

Die Kompatibilitätsfrage bzw. Info bzgl. Indexmenu-Plugin hat sich relativiert. Es ist eine Einstellung in local.php unter dokuwiki\conf möglich, die auch unter Hogfather ein operables, javascriptgesteuertes Indexmenü ermöglicht (ansonsten wären Layout geändert wie auch Zugang zu Untermenüelementen verwehrt gewesen). Eingefügt werden musste nach dem Upgrade nur die folgende Zeile:

$conf['defer_js'] = 0;

Eine Demoinstallation auf Basis der Trunkversion vom 01.10.2020 ist als Video unter i:\doku\Projekt iX-Wiki verfügbar. Die zugrundeliegende Datenbasis (Komplettsicherung) und das Ergebenis (in einer on the Stick-Variante) sind dort ebenfalls als 7z-Archiv im Unterverzeichnis DokuWiki abgelegt.

Update 20.10.2020: Beide iX-Wikis (und hierdurch auch nachfolgende Wikis) sind nun erfolgreich upgegradet! Zuvor habe ich jeweils eine Sicherungskopie als 7z-Archiv erstellt. Eine Dateiliste der Anpassungen liegt als Textfile vor (Mail an SMV).

Ablauf

• Installation des PlugIns DokuWiki Upgrade Plugin
• Datensicherung
• Update via Admin-Funktion
• Update von weiteren Plugins?
• Anpassung bei Bedarf, z. B. JavaScript-Einstellung $conf['defer_js'] = 0; in local.php-datei (s. u.)

Anpassung nach Upgrade auf Wiki-Programmversion 2020-07-29 „Hogfather“

• in …\dokuwiki\conf\local.php einfügen der Zeile $conf['defer_js'] = 0; (zumindest derzeit erforderlich, damit Javascript gesteuertes Indexmenü in der Sidebar funktioniert!
• Erstellung von Datensicherungen:
  • Version 20.20.0 wurde am 20.10.2020 durch arr upgegradet. Eine lokale Datensicherung wurde vor Upgrade erstellt. Sie liegt in Form der Datei Version.20.20.0_Stand20201019.7z vor.
  • Version 20.20.2 wurde am 20.10.2020 durch arr upgegradet. Eine lokale Datensicherung wurde vor Upgrade erstellt. Sie liegt in Form der Datei Version.20.20.2_Stand20201019.7z vor.
• Anpassung TOC Titel (s. o., Anpassung des TOC-Titels)
• Anpassung der Fußzeile über ..\dokuwiki\lib\tpl\dokuwiki\tpl_footer.php für die Links und die dazugehörigen Grafiken zu Datenschutz, Spacewell-Germany und Impressum, Bearbeitung der Grafiken für zweifarbige Darstellung.
• Anpassung der ccs-Vorgaben für H1 bis H5 (s. o., Abschnitt Styles)
• Durch das Upgrade wurden folgende Seiten neu erstellt:

/data/page/wiki/dokuwiki.txt

/data/page/wiki/syntax.txt
/data/page/wiki/welcome.txt

Diese waren zu prüfen. In syntax.txt wurden tote Links durch redaktionelle Bearbeitung entfernt.

Der Titel für das Inhaltsverzeichnis einer Wikiseite (table of content) wurde von Inhaltsverzeichnis auf Inhalt verkürzt. Die Anpassung erfolgte in der deutschen Sprachsteuerungsdatei ..\dokuwiki\inc\lang\de\lang.php an der Position Zeile 219, $lang[‘toc‘] in der Greebo-Variante bzw. in Zeile 229 der Hogfather-Variante.

Das Logo (links oben) wird über den Medien-Manager in das System kopiert. Ist das Logo unter 500 Pixel breit, wird bei den meisten Bildschirmeinstellungen der Schriftzug durch die Bindestrichkombination aufgeteilt . war ein Ansatz, das in der Demo verwendete Logo mit einem transparenten Bereich auf der rechten Seite zu versehen. Ein anderer Ansatz ist, den Namen als Bildbestandteil zu definieren. Vorteil: Form und Farbe des Schriftzuges sind vollständig redaktionell anpassbar.
Aktuell: SpaceWell-Logo

Die Datei favicon.png wird über den Medien-Manager in das System kopiert. Das quadratische iX-Logo ist derzeit in Anlehnung an die iX-Haus-Marke gestaltet. Der Schriftzug Wiki ist jedoch kaum erkennbar, aufgrund der vom Browser reduzierten Skalierung. Die Bildgröße sollte mindestens 16×16 Pixel aufweisen, besser 32×32. 64×64 ergibt keine Qualitätsverbesserung. Ggf. übernimmt SUN aus dem Marketing die Optimierung der Datei.

Die aktuellen Logos von DokuWiki mit Grafiken und Hyperlinks zu den jeweiligen OpenSource- und Lizenzinformationen waren unerwünscht. Erforderlich hingegen sind die Benennungen von Links zum Impressum und Datenschutz auf der Startseite. Diese sind nun als Links in der Startseite realisiert. Dementsprechend wurden die Dateien ..\dokuwiki\conf\license.local.php erstellt und tpl_footer.php angepasst.

Wo das Entfernen bzw. Tauschen der Hyperlinks nicht ausreicht, wird das als Link genutzte Logo umbenannt. In Datei ..\dokuwiki\lib\tpl\dokuwiki\tpl_footer.php wurde Zeile 13: <?php tpl_license(''); // license text ?> innerhalb <div id="dokuwiki__footer"><div class="pad"> vor <div class=„buttons“> entfernt, Zeilen im Block <div_class=“buttons“> wurden für Impressum, Kontakt und Datenschutz der CREM SOLUTIONS angepasst. Die verbliebene Grafik \\srv-dev\DokuWiki\Branch\lib\tpl\dokuwiki\images\button-crem.gif der Fußzeile wurde aktualisiert.

Nachtrag 05-06-2020 ARR: Anpassung mit Datenschutz, Impressum, Weblink zur Spacewell-Hauptseite und Mail-To zu einer noch zu erstellenden Doku-Mailadresse. Datenschutz auf Webseite muss bzgl. Wiki ergänzt werden (temp. Session-Cookie) – hierzu ist Philip Spitz informiert.

Im Template DokuWiki wurde via Konfigurations-Manager (ein dazugehöriges Plugin) die Hierarchische Pfadnavigation aktiviert. Hierdurch erhält ein Benutzer von einer Seite stehend Zugriff auf übergeordnete Seiten. An gleicher Stelle wird auch der Name festgelegt. Momentan lautet dieser iX-Wiki. (Ein Name ohne Trennzeichen wäre geeigneter bzgl. der automatischen Logo/Namensdarstellung Kopfbereich der Seiten.) Workaround: kein Name und Namen als Bild integrieren.

Die Einstellung bzgl. Veröffentlichung unter Lizenz wurde auf keine geändert. Zur Steuerung des internen Seiteninhalts (TOC) wird ab Überschrift 2 (h2) begonnen und es werden maximal bis zu Überschriftsebene 4 (h4) ausgeführt. Es sind mindestens drei Einträge erforderlich, damit der TOC generiert wird. Im Bereich DokuWki Aktionen unterbinden wurde probehalber die Aktion Letzte Änderungen deaktiviert. Welche weiteren Einstellungen hier für den Regelbetrieb sinnvoll sind, ist noch zu prüfen.

Bei Bedarf kann die Bearbeitungsfunktion HTML erlauben aktiviert werden, falls anderweitige Lösungen mit Plugins nicht greifen.

Das Setzen eines Anmeldecookies (Angemeldet bleiben) wurde im Konfigurationsmenü unter „Authentifizierungs-Konfiguration“ Permanente Login-Cookies erlauben (Auf diesem Computer eingeloggt bleiben) deaktiviert.

Nachfolgend sind die Anpassungen gelistet, welche nicht durch Plugins oder Templates realisiert werden.

DokuWiki sieht keine besondere Farbgebung für die Überschriften vor. Die Überschriften werden in DokuWiki via PHP und CSS mit h1- bis h5-Tags realisiert. Als Formatanweisungen werden im Wiki-Text Überschriften mit aufeinanderfolgenden Gleichheitszeichen geklammert: ======h1======, =====h2=====, ====h3====, ===h4===, ==h5==. Überschriften sind automatisch als Ziele von Sprungmarken (Hyperlinks) geeignet. Selbst können sie nicht zusätzlich als Hyperlink formatiert werden! Dagegen sprechen technische wie auch typographische Gründe.

In der Datei basicless.css im Verzeichnis dokuwiki\lib\tpl\dokuwiki\css können von Templates abhängige Formatierungen erweitert oder angepasst werden. In Anlehnung an das gültige CI sehen wir vor, die Überschriften dem Crem-Blau hervorzuheben. Die Anpassung der Header-Formate für Crem-Blau erfolgt in DokuWiki über ergänzende CSS-Angaben in der Datei basicless.css bzgl. der Farben kann in Hexadezimal: color: #003EDC; erfolgen. Auszug aus „C:\Work\w_branch\Intern\Technische Redaktion\DokuWiki\iXDokuWiki\dokuwiki\lib\tpl\dokuwiki\css\basic.less“:

h1 {
font-family: Helvetica, Arial, Geneva, sans-serif;
font-size: 2em;
margin: 0 0 0.444em;
color: #06478A;
}
h2 {
font-family: Helvetica, Arial, Geneva, sans-serif;
font-size: 1.5em;
margin: 0 0 0.666em;
color: #06478A;
}
h3 {
font-family: Helvetica, Arial, Geneva, sans-serif;
font-size: 1.25em;
margin: 0 0 0.888em;
color: #06478A;
}
h4 {
font-family: Helvetica, Arial, Geneva, sans-serif;
font-size: 1em;
margin: 0 0 1.0em;
color: #06478A;
}
h5 {
font-family: Helvetica, Arial, Geneva, sans-serif;
font-size: .875em;
margin: 0 0 1.1428em;
color: #06478A;
}

In der Datei ..\dokuwiki\conf\tpl\dokuwiki\style.ini werden Einstellungen gespeichert, welche administrativ in DokiWiki vorgenommen werden können. Wesentliche Anpassung hier ist die Einstellung der Seitenbreiten für einen links angeordneten Bereich, der meistens für Navigationszwecke genutzt wird (sidebar) und das Hauptfenster (site). In der Grundeinstellung von DokuWiki sind diesen Bereich absolute Breitenangaben in em festgelegt. Sidebar und Site reagieren dann nicht auf Größenänderung des Browserfensters! Durch die Anpassung in %-Werte reagiert DokuWiki in der Breitenberechnung dynamisch und liefert dann ein besseres Layout. Die %-Werte für Sidebar und Site müssen wir nach Fertigstellung ggf. noch anpassen. Auswahlmöglichkeiten für individuelle Farbanpassungen für den Text können mit Hilfe von Plugins eingebaut werden, vgl. color-Plugin. Einige der Einstellungen sind auch im iX-Wiki über Admin > Einstellungen fürs Template-Design einstellbar.

Textuelles Abbild von style.ini mit prozentualer Breitenangabe für site und fester Breite für sidebar (und TOC):

[replacements]
;These overwrites have been generated from the Template styling Admin interface
;Any values in this section will be overwritten by that tool again
__text__ = "#333333"
__background__ = "#ffffff"
__text_alt__ = "#999999"
__background_alt__ = "#eeeeee"
__text_neu__ = "#666666"
__background_neu__ = "#dddddd"
__border__ = "#cccccc"
__highlight__ = "#c8dcde"
__link__ = "#06478A "
__background_site__ = "#fcfcfc"
__existing__ = "#00737e"
__missing__ = "#dd3300"
__site_width__ = "95%"
__sidebar_width__ = "20em"
__tablet_width__ = "800px"
__phone_width__ = "480px"
__theme_color__ = "#008800"

Die Hyperlinkfarbe wird u. a. im TOC verwendet. Das Blau der Schrift lt. Wortbildmarke analog zur Website der Crem wird in der style.ini in der Domäne replacements der Eintrag link = „#06478A “ gesetzt oder im iX-Wiki über Admin > Einstellungen fürs Template-Design der entsprechende Eintrag für die Allgemeine Linkfarbe (#06478A). Diese Farbe wird auch für die Headerdefinition h1 bis h5 in lib\tpl\dokuwiki\css\basic.less verwendet.

In der Datei lib\plugins\wrap\style.less passen wir die Zeilen für die wrap-tags important und tip an (gelbfarbener Hintergrund) (ab iX-Wiki 20.20.0)

.wrap_important { background-color: #ffd39f; } 	mit #ffff79f;und 
.wrap_info { background-color: #d1d7df; } 		mit #ffffe0; als Hintergrundfarbe an. 

Modifikation auf einheitliche Hintergrundfarbe ab iX-Wiki 20.20.3: Auszug aus „W:\Version.20.20.3\lib\plugins\wrap\style.less“
Anpassung Hintergrundfarbe important wie bei tip ab iX-Wiki für 20.20.3 (die dark.wrap Varianten wurden nicht angepasst!)

vorher…

/*____________ important ____________*/
.wrap_important { background-color: #fff79f; }
.wrap__dark.wrap_important { background-color: #6c3b00; }
div.wrap_important { background-image: url(images/note/48/important.png); }
span.wrap_important { background-image: url(images/note/16/important.png); }

/*____________ alert ____________*/
.wrap_alert { background-color: #ffbcaf; }
.wrap__dark.wrap_alert { background-color: #ffed44; }
div.wrap_alert { background-image: url(images/note/48/alert.png); }
span.wrap_alert { background-image: url(images/note/16/alert.png); }

/*____________ tip ____________*/
.wrap_tip { background-color: #ffffe0; }
.wrap__dark.wrap_tip { background-color: #4a4400; }
div.wrap_tip { background-image: url(images/note/48/tip.png); }
span.wrap_tip { background-image: url(images/note/16/tip.png); }

nachher… (Hintergrundfarbe für Wrap Important auf #fffffe0; wie bei Tip gesetzt)

/*____________ important ____________*/
.wrap_important { background-color: #ffffe0; }
.wrap__dark.wrap_important { background-color: #6c3b00; }
div.wrap_important { background-image: url(images/note/48/important.png); }
span.wrap_important { background-image: url(images/note/16/important.png); }