Plugins
Plugins gibts ziemlich viele. Doch welche sind wirklich nützlich für uns und unseren Anwendungsfall?
Hinzukommt, das nicht jedes Plugin mit jedem anderen zusammenarbeitet.
Ich1) habe in “meinem” MitschriftenWiki einige ausprobiert und bin zur Erkenntnis gelangt, das manchmal weniger mehr ist.
Achja, die Syntax ist noch nicht auf pures Dokuwiki umgestellt. Das mache ich aber vielleicht noch.
OwnCloud-Plugin
(https://www.dokuwiki.org/plugin:owncloud)
Am 08.11.2013 probierte ich erfolgreich die Integration mit OwnCloud . Die Medien werden in Owncloud gespeichert und können im Dokuwiki verw. werden.
Es wird die Versionierung von Dokuwiki verw. (die OwnCloud eigene muss deakt. sein damit's funktioniert)
unterstützte Plugins:
→ funktionierte prima (mit Version Weatherwax; mit “Ponder Stibbons” werden keine Seiten mehr angezeigt) (Anleitung siehe
https://www.dokuwiki.org/plugin:ownclud; es muss außerdem ein entspr. Dokuwikiplugin im OwnCloud installiert sein.)
DONE: /var/www/dokuwiki/data/ (per Git) versionieren um dezentral (und offline-) verfügbar zu sein.
TODO: Herausfinden warum das OwnCloud-Auth- Pugin für DokuWiki Stress macht.
Gitbacked-Plugin
(https://www.dokuwiki.org/plugin:gitbacked)
Dokuwiki per Git versionieren (Wikiseiten, Medien, etc.)
hiermit kann man das Wiki dezentralisieren sowie mit anderen Installationen syncen; mit nem händischen `git pull` bzw. `git push ` klappts bereits!
→ funzt (Wikiedits landen automatisch im Git. Allerdings synct das Ding noch nicht selbst mit dem bare-Repo, obwohl es das tun sollte )
Git-Plugin
(https://www.dokuwiki.org/plugin:git)
Setup GIT repos (s.a. GitHowTo)
Create a new, empty master (no working files) repo.
Clone that repo to a new local repo (with working files).
Copy that repo into the root of your DokuWiki installation.
Create a .gitignore file:
conf/
bin/
inc/
lib/
data/attic/
data/cache/
data/index/
data/locks/
data/meta/
data/media_attic/
data/media_meta/
data/tmp/
*.php
.htaccess.dist
COPYING
README
VERSION
data/.htaccess
data/_dummy
data/deleted.files
data/security.png
data/security.xcf
odt2dw-Plugin (OpenOffice-Import)
(https://www.dokuwiki.org/plugin:odt2dw)
→ Import funktionierte mit Version Weatherwax; seit “Ponder Stibbons” tut sich nichts mehr
→ funzt prima (Text, Bild; im neuen Artikel verlinkte “Originaldatei” ist auch weiterhin brauchbar) getestet am 5.2.2015 mit Hrun
benötigte Bibliotheken: php xsltProcessor (ex : php-xml, php5-xsl)
enthaltene Originaldatei ist auch weiterhin brauchbar!
in der ODT-Datei enthaltene Kommentare/ Fußnoten wurden als Fußnoten übernommen
Grafiken funktionieren nun auch (gestestet 5.2.2015)
geht wirklich nur für ODT-Dateien (ODM-Globaldokumente und anderes wird nicht importiert)
ODT-Plugin (Vorlagenbasierter ODT-Export)
dw2pdf plugin (PDF-Export für einzelne Wikiseiten)
text-Plugin (einfacher Klartext-Export)
xml-Plugin (XML-Export)
OpenOffice.org-Export-Plugin (OpenOffice-Export)
s5reloaded plugin (Wikiseite als Präsentation) *
(https://www.dokuwiki.org/plugin:s5reloaded)
lt. Doku Templatefähig incl. Unterstützung des “asciimathml”-plugins (für Matheformeln)
unverträglich mit: s5-Plugin
Syntax: “~~SLIDESHOW thesis~~” im Text
Usage:
Alles zwischen der 1. H1-Überschrift und der 1. H2-Überschrift kommt auf die Welcomeslide
jede H2- Überschrift ist eine Folie
mit einer horiz. Linie beendet man die aktuelle Folie und beginnt den Handoutbereich
Fußnoten und Abkürzungen werden in der Present. unterdrückt
unterstützte Plugins:
jsmath formulas
wrap-plugin tips
→ funzt (und sieht schick aus ; Version: Adora Belle RC1); bei späteren Versionen tritt hingegen ein Fehler auf (Wikiseite statt weißer Hintergrund in der Präsentation); Fehler tritt nun auch in alter Version (vom Backup) auf
bookcreator-Plugin (Buchexport als PDF)
(https://www.dokuwiki.org/plugin:bookcreator)
etwas alt (19.04.2010), funzt aber
Wiki-Namespace “wiki:ebook” angelegt und “BOOK” fürs Frontend reingeschrieben.
→ funzt super (incl. Bilder und Links)
→ Bücher können nach “Wiki:ebooks:<Buchname>” gespeichert und auch wieder geladen werden; bearbeiten kann man sie dann natürlich auch wieder
Composer-Plugin (Verzeichnisübersicht auf einer Wikiseite)
Backlinks2-Plugin (Was zeigt hierher?)
(https://www.dokuwiki.org/plugin:backlinks2)
eigentlich schon im Wiki integriert, nun auch in Wikiseiten nutzbar
Syntax: \{\{backlinks>wiki:page}}
→ funzte (in Version Weatherwax, in “Ponder Stibbons” gibt es einen Inst.fehler), dürfte eines der TOP-PLUGINS sein (da sehr vielfältig nutzbar)
→ kein Download im Installer
Include-Plugin (Wikiseiten in andere einbetten)
(https://www.dokuwiki.org/plugin:include)
eine oder mehrere Wikiseiten ganz oder teilweise in andere einbetten
zeigt verschiedene Angaben zu den eingebundenen Seiten an deren Ende an (konfigurierbar)
Unterstützt: Discussion-Plugin, Linkback-Plugin, Tag-Plugin
Syntax:
{{page>[id]&[flags]}}
[id]&[flags]
[namespace]&[flags]
[tag]&[flags]
möglichst nicht für sensible Daten verwenden (unsicher)
→ funzt, dürfte eines der TOP-PLUGINS sein (da sehr vielfältig nutzbar)
NsToC Syntax-Plugin (Überschriftenbasierter Inhaltsverzeichnisgenerator für Namespaces)
(https://www.dokuwiki.org/plugin:nstoc)
ist etwas älter (18.02.2010)
die einzelnen Verzeichniseinträge sind mit den jeweiligen Kapiteln auf den entspr. Wikiseiten verlinkt
die Tiefe der angezeigten Verschachtelungsebenen kann festgelegt werden (s. Syntax)
ist es Filter, Sortier und Auto-Nummerierungsfähig?
Syntax: \{\{nstoc chapter3 1}} (für alle H1-Überschriften des Namespaces “chapter3”)
→ funzt
Pagelist-Plugin (konfigurierbare Wikiseitenliste)
(https://www.dokuwiki.org/plugin:pagelist)
ist etwas älter (10.05.2011)
Helferplugin für andere Plugins (z.B.: Blog, Discussion, Editor, Tag, Task and Dir )
-
kann diverse Zusatzinfos zu den jeweiligen Seiten anzeigen
Unterstützt: Discussion-Plugin, Linkback-Plugin, Tag-Plugin
Syntax:
<pagelist&[flags]>
* [[..:blog:|Blog Plugin]]
* [[..:discussion:|Discussion Plugin]]
* [[..:editor:|Editor Plugin]]
* [[..:tag:|Tag Plugin]]
* [[..:wrap|Wrap Plugin|This is shown in the description cell]]
</pagelist>
pagequery-Plugin (komplexe Seitensuche und Auflistung)
(https://www.dokuwiki.org/plugin:pagequery)
lt. eigener Angabe eine Mehrzweck- Alles-in-Einem- Lösung zur Erstellung von Indexseiten
kann (natürlich) filtern, Volltextsuchen(!), sortieren und gruppieren(!)
→ funzt (getestet in Vers. Weatherwax), ist aber ziemlich komplex
catlist Plugin (Hierarchische Wikiseiten- Auflistung)
(https://www.dokuwiki.org/plugin:catlist)
konfigurierbar (filter- und sortierbar)
Neue-Seite-erstellen- Knopf in jeder Hierarchieebene
Syntax: “<catlist (namespace:) -option1 -option2…>”
→ funzt nicht (Plugin geht vermutlich von anderer Struktur aus, was Namespace und Serverlayout betrifft; TODO: ggf. Bugreport melden)
Translation-Plugin (Übersetzung/ Mehrsprachigkeit)
S5 Presentations (Wikiseite als Präsentation)
LaTeXit-Plugin (Latex-Export)
Asciimath-Plugin (Matheformeln aus und für Text)
(https://www.dokuwiki.org/plugin:asciimath)
ist etwas älter (11.02.2009)
eigentlich auch nur ein Fallback
für Verwendung in S5-Präsentationen, muss S5 angepasst werden
→ funzt (sogar ohne Bildchen, getestet in Version Weatherwax), aber nur im Browser/ Wiki (Export funzt nicht und (S5-)Präsentation müsste angepasst werden)
(https://www.dokuwiki.org/plugin:markdownextra)
Plugin für Pandoc bzw. (erweitertes) Markdown
unterstützt Inline- Blocks mit: <markdown> … </markdown> und Dateien mit .md.txt- Endung
bietet eine gute Unterstützung für übliche Textauszeichnungen (einschließlich Fußnoten, welche wiederum formatierte Inhalte enhalten können)
→ funzt zwar (getestet in Version “Weatherwax”)(abgesehen von Dokuwiki-features und Plugins), allerdings werden die Überschriften nicht als solche erkannt (tauchen ggf. nicht in Inhaltsverzeichnissen auf) und wird vom NsToC-Plugin (Auflistung der Überschriften aus allen Wikiseiten eines Namespaces) gänzlich ignoriert
→ Siehe auch markdowku Plugin , welches eine Mischung von Markdown- und Dokuwikisyntax zulässt!
(https://www.dokuwiki.org/plugin:txt2tags)
Alternative zu Pandoc/ Markdown(extra)
unterstützt Inline- Blocks mit: <t2t> … </t2t> und Dateien mit .t2t.txt- Endung
bietet Unterstützung für einige übliche Textauszeichnungen (allerdings ohne Fußnoten)
→ funzt zwar (getestet in Version “Weatherwax”)(abgesehen von Dokuwiki-features und Plugins), allerdings werden die Überschriften nicht als solche erkannt (tauchen ggf. nicht in Inhaltsverzeichnissen auf)
Textile2- Plugin (Textile -> Multiformatkonverter)
(https://www.dokuwiki.org/plugin:textile2) Link tot
ist etwas älter (2007-02-06)
Alternative zu Pandoc/ Markdown(extra)
unterstützt lt. Doku Inline- Blocks mit: <textile> … </textile>
bietet lt. Doku Unterstützung für einige übliche Textauszeichnungen (z.B.: incl. Fußnoten)
→ kann nicht getestet werden, da der Downloadlink tot ist
(https://www.dokuwiki.org/plugin:markdowku)
ist ganz neu (2013-01-03)
die Markdownnotation kann direkt im Text verwendet werden, was eine Mischung von Markdown- und Dokuwikinotation ermöglicht
→ funzte bisher grundsätzlich ziemlich gut, wenn auch mit Einschränkungen (gelegentliche Zicken und einige Markdown-Anweisungen wie z.B. Fußnoten werden noch nicht unterstützt) dafür können Markdown- und Dokuwiki- Anweisungen miteinander gemischt werden → wieder deaktiviert, da es doch irgendwie nervte
→ Siehe auch: MarkdownExtra- Plugin, welches jedoch keine Mischung von Markdown- und Dokuwikisyntax ermöglicht
Diskussion-Plugin
Cloud-Plugin (Word-, Search & TagCloud)
(https://www.dokuwiki.org/plugin:cloud)
ist eine Alternative zur Tags-Plugin eigenen Tagauflistung
benötigt:
→ funzt und ist ziemlich praktisch
→ Ich lasse die Tags hidden und private in der Tag-Wolke ausblenden
Graphviz-plugin (auch "Dot" genannt)
(GNU)plot-Plugin *
Mindmap-Plugin *
(https://www.dokuwiki.org/plugin:mindmap)
ist etwas älter (2011)
verwendet standardmäßig GoogleCharts, falls Graphviz-Pfad nicht gesetzt!
kommt im Gegensatz zum älteren Freemind-Plugin ohne Java-/Flash-Applet aus
→ funzt nicht (kein Bild)
dokuwiki-plugin-dokutexit
(https://github.com/michitux/dokuwiki-plugin-dokutexit)
Latex-Export (mit Weiterverarbeitung zu PDF-Dateien: &do=export_latex an die Url anhängen)
Unterstützung versch. Plugins (u.a. refnotes)
Installation (von Github):
→ funzt nicht (getestet in Version Weatherwax), da die Datei fguill.sty angebl. nicht gefunden wurde, an der liegts aber nicht. Außerdem funzt der Linkanhang (s.o.) nicht
refnotes-Plugin (Lit.verw. u.ä.)
(https://www.dokuwiki.org/plugin:refnotes)
erweitert die Referencen- und Fußnotenverwaltung von Dw.
Syntax `[(Namespace:Name>Text)]` und nun einige speziellere Bsp.:
Kann auch zur Literaturverwaltung verw. werden → funzt aber nicht (bei Gelegenheit mal genauer damit beschäftigen)
→ funzt teilweise (wird nach PDF aber nicht nach Odt exportiert)
Citations for DokuWiki-Plugin
(https://www.dokuwiki.org/plugin:meta)
Experimentelles Set aus 2 Plugins in einem Pluginpaket um Metadaten gemäß Dublin-Core im Wikitext einzubetten
klingt gut, wirkt allerdings ziemlich umständlich mal sehen…
→ funzt nicht, da Verz. ziemlich leer (Verz. mussten zudem erst umbenannt werden)
Blog-Plugin
SocialMark
Captcha-Plugin
EtherpadLite Plugin
(https://www.dokuwiki.org/plugin:etherpadlite)
Für “echtes” Teamwork im Wiki - etwa zum gemeinsamen (mit-)schreiben eines Textes
→ Funzt nicht, (Download ist leer) DW hängt sich nach install auf (musste Pluginordner manuell löschen) → wieder deaktiviert, da Fehlerfenster beim Editieren (JSON Response- Problem)
Wrap Plugin
https://www.dokuwiki.org/plugin:wrap
große Container (z.B.: mehrere Absätze und Listen enthaltend): WRAP, block, div
kleine Container (im Absatz enthalten etc.): wrap, inline, span
Zusatzfunktionen:
→ Funzt und sieht spitze aus, leider werden die Boxen etc. nicht exportiert (sondern meist nur der enthaltene Text)!
Geogebra2-Plugin *
Geogebra-Plugin (Mathe- & Geometrie)
SVG-Edit plugin (Vektorgrafikeditor)
(https://www.dokuwiki.org/plugin:svgedit)
Kann SVG-Quelltext und SVG-Bilder in Wikiartikel einbetten und als Bild anzeigen
Editor? → Fehlanzeige, keine Ahnung wo der stecken soll
ggf. Mimetypes ergänzen
→ Export funzt nicht; Plugin deakt.
EBNF-Plugin (Syntaxdiagramme)
Diagram-Plugin (Diagrame und Graphen)
ckgedit-Plugin (Wysiwyg-Editor)
Ace Editor Plugin (alternativer Editor)
socialshareprivacy2 Plugin
profiles Plugin (Profilseitenkram ala SocialNetwork)
userpagecreate plugin
Video Share Plugin (Videoclips z.B. von Youtube einbetten)
(https://www.dokuwiki.org/plugin:vshare; Bundeld)
Unterstützt Youtube, Vimeo, Slideshare und viele weitere
Syntax: Some funny video
Platzhalterbild beim PDF-Export; kein Export nach OpenOffice
→ Funzt prima (ggf. Datenschutz überpr.)
html5video2 Plugin (freier Html5-Videoplayer)
(https://www.dokuwiki.org/plugin:html5video2)
Kann selbstgehostete Videodateien in versch. Formaten wiedergeben
Erfordert Anpassung der Mimetypes (Dokuwiki und ggf. auch Apache)
Syntax: “video.mp4 [widht]x[height]”
video.mp4 preview image
video alternate text
html5video Plugin (freier Html5-Videoplayer)
(https://www.dokuwiki.org/plugin:aimg)
Bildbereiche per Tooltip erklären/ verlinken
→ Funzt, Darstellungsfehler im (PDF-)Export (Anmerkung steht häßlich unter dem Bild); kein Export nach OpenOffice
Image Map plugin
Gallery-Plugin (Bildergallerie)
SwiftMail-Plugin (Emailversand über externen Mailserver)
(https://www.dokuwiki.org/plugin:swiftmail)
User/ Emailadresse und Passwort festlegen
→ funzte (natürlich per SMTP mit verschlüsselter Auth., allerding wird das Passwort unverschlüsselt in der Konfig gespeichert)
(https://www.dokuwiki.org/plugin:tools)
zusätzliche Werkzeugliste fürs Wiki (hauptsächlich für die Exportfunktionen)
unterstützt folgende Plugins/ Exportformate:
→ funzt zwar verursacht aber ein Problem mit der Anzeige der Toolbar, TODO: es müsste allerdings ein wenig angepasst werden; bis dahin bleibe ich erstmal bei meiner Eigenbau-Variante mit den Downloadlinks im Seitenfuß
doodle2 plugin *
iCal Plugin *
iCalendar Plugin *
(https://www.dokuwiki.org/plugin:icalendar)
iCal-Dateien in Wikiseiten darstellen
It was initially based on the icalevents-Plugin by Robert Rackl.
→ Inst.problem behoben, funzt aber trotzdem nicht (angebl. Downloadproblem der .ics-Kalenderateien)
noticeboard plugin *
userannotations plugin
(https://www.dokuwiki.org/plugin:userannotations)
Nutzer-Kommentare, die privat oder öffentlich sein könen
Example: Annotations for the page wiki:formatting_syntax are stored in annotations:user1:wiki:formatting_syntax for user1
→ Klingt cool, funzt aber nicht und verursachte Probleme (Toolbar und Fußzeile wurden nicht angezeigt)
Task Plugin
todo plugin
(https://www.dokuwiki.org/plugin:todo)
Checkboxbasierte einfache Aufgabenverwaltung per Todo-Liste (ohne iCal)
Unterstützt: Searchpattern Plugin zur Auflistung
Aufgaben können auf extra Wikiartikel in einstellbaren Namespace verlinken → aktuell: “.:tasks” (früher: “.:actions:”) für Subnamespace im jeweiligen Namespace
Syntax:
-
→ funzt gut
Searchpattern-Plugin
DokuWiki Plugin : AV Task Box
(https://www.dokuwiki.org/plugin:avtaskbox)
Generates nicely formatted boxes for describing project tasks or user stories.
→ funzt, sieht schick aus, hat aber leider keinen weiteren Nutzen (keine Übersichten, Downloads oder Interaktionselemente)
Authorlist-Plugin
OrphansWanted Plugin
Feed Plugin
Editor Plugin
Info Plugin
zotero plugin
Statdisplay plugin
dokubookmark plugin
Folded Plugin
Imagereference plugin
(https://www.dokuwiki.org/plugin:imagereference)
<tabcaption tablelabel| This is my other caption>
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |
</tabcaption>
<tabref tablelabel>
<tabref ns:otherpage#nicetable>
<imgref :pageinroot#bigimage>
Pagebreak
Pagebreak2
(https://www.dokuwiki.org/plugin:pagebreak2)
Fügt automatisch 'nen Seitenumbruch nach jeder H1- Überschrift ein
→ ließ sich über die Pluginsuche nicht finden, mit Url-Angabe gings aber
→ funzt nur beim Ausdrucken der Webseite, sonst bringts nichts
diffpreview plugin
TOC Tweaking assortment
inlinetoc Plugin
(https://www.dokuwiki.org/plugin:inlinetoc)
Inhaltsverzeichnis in Wikiartikel einbetten (zum Ausdrucken/ Exportieren)
Syntax: INLINETOC
Unverträglich mit: toctweak-Plugin
→ Funzt nicht richtig (unbrauchbarer Export)
TOC Plugin
Inhaltsverzeichnis in Wikiartikel einbetten (zum Ausdrucken/ Exportieren)
ist etwas älter (2009)
Unverträglich mit: toctweak-Plugin
-
→ Funzt nicht wirklich (Lediglich das Standard-Inhaltsverzeichnis kann damit verschoben werden)
subjectindex plugin
epub Plugin
(https://www.dokuwiki.org/plugin:epub)
ePub - Export mit ähnlicher Syntax wie das BookCreator-Plugin
braucht: zip-Bibliothek für PHP > 5.2 (eBooks are zip files with the '.epub' extension.)
Verzeichnis epub/<username> in pages/ und media/ anlegen und berechtigen (!)
Syntax:
<epub:Buchname>
Kapitelüberschrift
</epub>
“Start”-Knopf im Wikiartikel anklicken
→ wird anschließend im Wikiartikel verlinkt (und bei den Medien abgelegt)
→ funzt (Bilder - außer einfache - funktionieren nicht ansonsten ziemlich gut)
Tipps und Tricks
Wikipedia-Links
Signatur
Sollte auf die Nutzer-Profilseite verlinken.
Signatur : — @NAME@ @DATE@
Templates (Oberflächenvorlagen) ausprobiert
dokuwiki
- Standardtemplate (schmal, Bildschirm wird nicht voll ausgenutzt)
- einige Dateien (z.B. in /lib/tpl/dokuwiki/) angepasst (OwnCloud, Downloadlinks für versch. Formate)
default
dokubook
monobook
vector
Unterstützung für die Plugins (falls installiert): Translation, Open Office Export, dw2pdf, html2pdf → sieht wie das aktuelle Template der Wikipedia aus
Replacement patterns/ Placeholder
Sind Variablen, die beim rendern der Seite durch entsprechende Inhalte ersetzt werden.
Inside of the file, you may also use some replacement patterns to make the template a little more dynamic.
@ID@ full ID of the page
@NS@ namespace of the page
@PAGE@ page name (ID without namespace and underscores replaced by spaces)
@!PAGE@ same as above but with the first character uppercased
@!!PAGE@ same as above but with the first character of all words uppercased
@!PAGE!@ same as above but with all characters uppercased
@FILE@ page name (ID without namespace, underscores kept as is)
@!FILE@ same as above but with the first character uppercased
@!FILE!@ same as above but with all characters uppercased
@USER@ ID of user who is creating the page
@NAME@ name of user who is creating the page
@MAIL@ mail address of user who is creating the page
@DATE@ date and time when edit session started
%a %d-%m-%y etc. e.g. Thu 06-12-12. Strftime placeholders are replaced by page creation time
%% a literal % character appears in your template