DokuWiki Anpassungen für SDMS

sdms-customisation in namespace de:qm

Allgemeiner Hinweis:

Eine strukturierte Übersicht aller DokuWiki Anpassungen, die für den Einsatz als Starke-DMS®-Dokuportal erfolgt sind.

Links zu LOG und TODO

1. Allgemeines

Ab dem 24.07.2024 erfolgte eine systematischere Erprobung und schrittweise Anpassung des DokuWiki, welches als technische Grundlage für die Entwicklung eines zentralen Dokuportal für das Starke-DMS® dienen soll:

  • Zunächst geht es darum, einen Ersatz für die Erstellung und Verwaltung (Versionierung) der bisherigen Word bzw.PDF-Dokumente im SVN zu finden und deren zentrale Bereitstellung auf elektronischem Wege zu sichern.
  • Aus dem DokuWiki-PoC (insbesondere von Boris) und den ersten, prototypischen Tests zur Übernahme/Konvertierung und zur automatischen Übersetzung (insbesondere von Christof) wurden hierfür einige Erkenntnisse und Einstellungen übernommen …

1.1 Vorteile DokuWiki

Warum wurde unser neues Starke-DMS® Dokuportal mit der vielseitigen Open-Source Wiki Software DokuWiki realisiert?

Diese von uns ausgewählte Wiki-Variante ist durch Templates und eine Vielzahl von Plugins in vielerlei Hinsicht erweiterbar. Ursprünglich insbesondere auf die Erstellung von einfachen (internen) Projekt-Dokumentationen ausgerichtet, findet es zunehmend Anwendung bei der Erstellung von komplexen Unternehmenswikis (für Zwecke des Wissensmanagements) und von regulären Webseiten.

  • Passend für diesen Einsatzzweck verfügt DokuWiki bereits über eine integrierte Zugriffskontrolle, welche die Zugriffsrechte auf einzelne Seiten oder Bereiche durch eine Kombination von Benutzern, Gruppen und Namespaces verwaltet.
  • Dadurch unterscheidet es sich beispielsweise von dem etwas bekannteren MediaWiki, welches die technische Grundlage der freien Online-Enzyklopädie Wikipedia darstellt.
    • Dort gibt es aus Prinzip einen freien Zugang auf alle gespeicherten Inhalte.
    • Und es wird eine freie, kollaborative Zusammenarbeit (mit nur relativ wenigen Regeln und Hierarchien) propagiert.
    • Daher gibt es bei MediaWiki bzw. bei Wikipedia auch nur wenige, eher technisch bedingte, Benutzerrollen (z.B. Administratoren).
    • Hier kann jeder alles lesen - und sich im Prinzip auch als Benutzer anmelden und dann als Autor von Inhalten tätig werden.
  • FIXME: 2024-10-23 ## Anpassungen für 1-Tag gültiges Login per Link (zum Aufruf der Dokumente aus den nativen Modulen) erläutern… :!:

2. Namensräume & Ordnerstruktur

2.1 Grundlegende Ordnerstruktur anlegen

2.1.1 Sprachversionen

Zunächst einen namespace für jede Sprache (initial: DE und EN) anlegen und dort eine Startdatei (start.txt) platzieren:

2.1.2 Unterordner für jeder Sprache

Darin dann jeweils die gleichen namespaces anlegen und dort eine Startdatei (start.txt) platzieren:

3. Benutzer & Rollen

Initiale Anlage von Benutzern:

USER PWD Benutzername E-Mail Gruppen / Rollen Bemerkungen
admin admin admin@example.com admin,user
dev dev@example.com dev,user
support support support@example.com support,user
partner partner partner@example.com partner,user
user user user@example.com user
dmsuser Lizenz-Nr dmsuser

3.1 Rechte und Zugangsbeschränkungen

4. Templates & grafische Anpassungen

5. Plugins

5.1 Installierte und aktivierte Plugins

5.1.1 Grundlegende Basis Plugins

Numbered Headings Plugin

https://www.dokuwiki.org/plugin:numberedheadings
⇒ Adds numbered headings to DokuWiki without changing the actual behavior of the standard headings.

nspages Plugin

https://www.dokuwiki.org/plugin:nspages
⇒ Present a table of contents of the pages of a selected namespace …

5.1.2 Export Plugins

DW2PDF Plugin

https://www.dokuwiki.org/plugin:dw2pdf
⇒ Export DokuWiki content to PDF

5.1.3 Styling Plugins

Wrap Plugin

https://www.dokuwiki.org/plugin:wrap
⇒ Universal plugin which combines the functionality of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class …

5.1.4 Variablen

Variable Plugin

https://www.dokuwiki.org/plugin:var
⇒ Displays some dynamic info about the current page, user or date.

IfAuthEx Plugin

https://www.dokuwiki.org/plugin:ifauthex
⇒ Toggle DokuWiki page content based on users and groups with arbitrary boolean expressions

nodisp Plugin

https://www.dokuwiki.org/plugin:nodisp
⇒ Prevents selected text from being sent from server to browser based on acl; or hides display of text in browser, except from admin or manager

numberof Plugin

https://www.dokuwiki.org/plugin:numberof ⇒ Simple plugin that counts the number of pages & media files in your DokuWiki

5.1.5 Include anderer Wikiseiten bzw. Inhalte

Include Plugin

https://www.dokuwiki.org/plugin:include
⇒ Include another wiki page into the current one

filelisting Plugin

https://www.dokuwiki.org/plugin:filelisting
⇒ pluginShow a searchable and sortable list of media files in the current namespace and subnamespaces

filelist Plugin

https://www.dokuwiki.org/plugin:filelist
⇒ pluginProvides a syntax for adding linked and sorted lists of files as selected by wildcard based glob patterns to a wiki page

TemplatePageName Plugin

https://www.dokuwiki.org/plugin:templatepagename
⇒ Renames the template pages _template.txt and __template.txt (only editable as server admin) to the configurable names c_template and i_template which are normal wikipages

Page Redirect Plugin

https://www.dokuwiki.org/plugin:pageredirect ⇒ Redirect a wiki page to another wiki page

5.1.6 References and Footnotes

RefNotes Plugin

https://www.dokuwiki.org/plugin:refnotes
⇒ Extended syntax for footnotes and references.

5.1.7 Wortwolken und Tags für Seiten

Cloud Plugin

https://www.dokuwiki.org/plugin:cloud
⇒ Shows a word cloud from different sources (used words, tags, searched words)

Tag Plugin

https://www.dokuwiki.org/plugin:tag
⇒ Assign category tags to wiki pages

Tagging Plugin

https://www.dokuwiki.org/plugin:tagging
⇒ Allows users to annotate pages with tags, search for tags and show all tags one user has used
:!: CosmoCode Plugin - Needs SQLite plugin

Überlegungen zu sinnvollen Tags

5.2 Weitere interessante Plugins

5.2.1 Logging und Tracking

NEW - neues Thema um das wir uns kümmern müssen (12.11.2024)

Login/Logoff Logging Plugin

https://www.dokuwiki.org/plugin:loglog
⇒ Logs all login/logout actions and usage of admin tools with time, IP and username

  • :!: Erster Versuch wurde von Andreas schon durchgeführt… einfaches Login/Logoff der Benutzer OHNE Tracking der Seiten :!:

Evtl. die beiden folgenden Plugins zusammen ausprobieren:

Log Statistics Plugin

https://www.dokuwiki.org/plugin:logstats
⇒ This plugin provides a log file (NCSA combined i.e. like Apache) of all access to DokuWiki pages

Statdisplay Plugin

https://www.dokuwiki.org/plugin:statdisplay
⇒ Displays various statistics and bar graphs computed using a log file of all access to DokuWiki pages


Weitere Plugins die evtl. für Logging und Tracking hilfreich sein könnten:

Google Analytics for DokuWiki

https://www.dokuwiki.org/plugin:googleanalytics
⇒ This tool allows you to set a code for use with Google Analytics, which allows you to track your visitors.

Matomo Plugin

https://www.dokuwiki.org/plugin:matomo
⇒ Plugin for the new 3.x version of Matomo (formerly Piwik), the open source Google Analytics alternative.

hubspot Plugin

https://www.dokuwiki.org/plugin:hubspot
⇒ Similar to googleanalytics, matomo, piwik

https://www.dokuwiki.org/plugin:footer ⇒ Add footer text to pages as a footer template for a specific namespace

5.2.3 Tabellen Layout erweitern

Table Width Plugin

https://www.dokuwiki.org/plugin:tablewidth
⇒ Allows to specify width of table columns

  • einfacheres Plugin
  • :!: Offenbar Konflikt zwischen "Table Width" und "Tablelayout" Plugin !!!
Tablelayout Plugin

https://www.dokuwiki.org/plugin:tablelayout
⇒ Set the width of table columns, freeze header rows, float the table, integrates with edittable plugin

  • komplexeres Plugin
  • von CosmoCode - evtl. später verwenden…

5.2.4 Redirect

Redirect Plugin

https://www.dokuwiki.org/plugin:redirect ⇒ Redirects page accesses to other pages or external sites using a central configuration file

Grafiken - Mermaid & Flowchart

Mermaid Plugin

https://www.dokuwiki.org/plugin:mermaid?s[]=mermaid
⇒ Provides support for the diagramming tool Mermaid

flowcharts Plugin

https://www.dokuwiki.org/plugin:flowcharts?s[]=mermaid
⇒ Add flowcharts and diagrams to your DokuWiki with an intuitive syntax — based on mermaids

5.2.5 Diskussion

Discussion Plugin

https://www.dokuwiki.org/plugin:discussion
⇒ Adds a comments section to Wiki pages ⇒ :!: Erstmal dieses Plugin :!:

talkpage Plugin

https://www.dokuwiki.org/plugin:talkpage
⇒ Generate a link to a talk page for each page in the wiki

5.2.6 Structured Data

struct Plugin

https://www.dokuwiki.org/plugin:struct
:!: A new structured data plugin

data Plugin

https://www.dokuwiki.org/plugin:data
⇒ Add and query structured data in your wiki
:!: You might want to consider using the spiritual successor to this plugin: struct Plugin

5.2.7 DokuWiki mit einer BLOG-Funktion versehen

Blog Plugin

https://www.dokuwiki.org/plugin:blog
⇒ Use DokuWiki as blogging tool. The Blog Plugin makes blogs in your wiki easily possible

BlogTNG Plugin

https://www.dokuwiki.org/plugin:blogtng
⇒ A next generation blog plugin for DokuWiki, integrates a powerful blogging engine into DokuWiki. It is meant as the successor of the original blog plugin


5.2.8 WYSIWYG Editor

Prosemirror Plugin

https://www.dokuwiki.org/plugin:prosemirror
⇒ A WYSIWYG editor for DokuWiki, usable but currently only in beta state
⇒ You can learn more about the approach at Why a new WYSIWYG plugin?.

5.2.9 Authentifizierung mit LDAP / AD

pureldap Plugin

https://www.dokuwiki.org/plugin:pureldap (This plugin is beta software)
⇒ A new LDAP/AD auth plugin for DokuWiki

Active Directory Authentication Plugin

https://www.dokuwiki.org/plugin:authad (bundled)
⇒ Provides authentication against a Microsoft Active Directory

LDAP Authentication Plugin

https://www.dokuwiki.org/plugin:authldap (bundled)
⇒ This plugin allows authentication against an LDAP directory using the ACL feature.

Weitere Tests und Recherche zum DokuWiki …

6.1 CosmoCode GmbH

Die CosmoCode GmbH ist eine Berliner Digitalagentur. Sie ist spezialisiert auf die Entwicklung individueller Anwendungen in den Bereichen eCommerce, Content Management Systeme (CMS) und Wissensmanagement. Enterprise DokuWiki SupportCosmoCode arbeitet seit mehr als 15 Jahren mit und für DokuWiki und hat mit über 80 wesentlichen Plugins sowie mit Forschungspartnerschaften zu Wiki Themen maßgeblich zum Erfolg von DokuWiki beigetragen.

Das von CosmoCode entwickelte ICKEwiki basiert auf dem populären Open Source Wiki DokuWiki. Der frei verfügbare Quellcode garantiert Invesitionsschutz durch Unabhängigkeit von Dienstleister und Hersteller. ICKEwiki ist kompatibel zu DokuWiki: Alle Plugins und Funktionen können angepasst und erweitert werden. ⇒ LiveDemo

  • ICKEwiki Free - mit Liste der ausgewählten Plugins - Erfahrene Nutzer können sich ICKEWiki auch komplett selbst installieren …

Liste der für ICKEwiki ausgewählten Komponenten ...

CosmoCode bietet aber auch verschiedene Pakete mit Beratung, Unterstützung und Support an:

  • ICKEwiki Basic - Support bei Installation, Update und Betrieb …
  • ICKEwiki Pro - Das umfassende Paket zur Etablierung von Wiki-Kultur in Ihrem Unternehmen …