Skip to content

dokuwiki-plugin: enhances editor, can build a navi-tree, mermaid editor integration, design fine tuning and some other cool stuff

License

Notifications You must be signed in to change notification settings

KalleAPunkt/Dokuwiki-DirtyLittleHelper

Repository files navigation

Dokuwiki-DirtyLittleHelper

dirtylittlehelper (dlh) is as plugin for Dokuwiki.

THANK YOU / credits

@turnermm: overlay plugin - the base I began with
@samfisch: dokubook template - here I found the tree
@lisps: linksuggest plugin - I copied it :-)
@giterlizzi bootstrap3 template - there I found the inspiration for the admin menu
@jakob1111 flowcharts plugin - the base for mermaid integration
@mermaid-js mermaid-live-editor - the mermaid live editor

why? / history

I wanted a better way for inserting wiki-internal-links in the editor. After some searching and probing I found the way that fits best for me: with "bureaucracy" and "struct" plugin you can build nice lookups for namespaces...

Then I took the "overlay" plugin and modified it for my needs. After a while I thought that it would be cool not to click on a button to have the search input and the insert button.

Some jQuery later: it works. After the editor ist opened the dlh-page is loaded in the overlay, then the elements are transferred in a new line under the toolbar in the editor. The overlay is not shown anymore - but it's still there.

Building and integrating flow-charts with mermaid: integrated. And dlh ships a mermaid live editor (the first chart in the wiki-editor is now transferred to the live editor; the rest: copy and paste).

And i needed / wanted a quick-admin-menu -> added (inspired by bootstrap3 template)

And sometimes the wiki should be wider - especially when editing and with "advanced config" plugin - done ...that means that after install of this plugin your wiki can look a bit different (thats life).

Then i thought it would be nice to have a tree on the left side like "dokubook" template -> added syntax for the tree.

The tree on the left is not always needed - added syntax for "no sidebar"...

I like comments -> syntax added

right now it works fine...

what can dlh do four you?

main feature - page-search in the editor

you need:

bureaucracy-plugin
struct-plugin

let's go

  • install the both plugins
  • create a struct-scheme
  • create at least one field in this scheme
    -- typ "page"
    -- config "usetitles" > thats better
    -- config "autocomplete" - "namespace" > put your namespace here
  • create the dokuwiki page that is configured "plugin»dirtylittlehelper»page"
~~NOCACHE~~
~~NOTOC~~
=== DLH ===
<form>
action script dummy.php
struct_field "scheme_name.field_name_1" !
struct_field "scheme_name.field_name_2" !
</form>
  • open the editor and smile

dlh tree

<dlh.tree> put it in your sidebar page and be happy
if there would be several trees -> only the first one is displayed

<dlh.notree> no tree will be rendered

<dlh.forcetree> only this tree will be rendered (overrides notree)
works only once

sidebar

<dlh.nosb> The sidebar will not be shown (css) - beware that the sidebar / tree will be generated.

<dlh.togglesb> there will be a button at the top left of the sidebar to toggle it
with

<dlh.hidesb you can hide the sidebar

mermaid

<dlh.mm>
graph LR
DOKUWIKI----DLH
</dlh.mm>

When you click the mermaid live editor you can follow the links to syntax etc.

comments

<dlh.*> this one line comment will only be seen in the editor </dlh.*>

<dlh.*>
this 
multi 
line 
comment will also only be seen in the editor 
</dlh.*>

div

<dlh.div.html[ id="" class="" style=""...]> Your html content </dlh.div.html>
will build a html div like <html><div>Your html content</div></html>

<dlh.div.wiki [ id="" class="" style=""...]> **Your** WIKI __content__ </dlh.div.wiki>
will build a div around your wiki code like <html><div></html>**Your** WIKI __content__ <html></div></html>

table

<dlh.table.html[ id="" class="" style=""...]>
  <caption>your caption</caption>
  <tr>
    <th>tablehead a</th>
    <th>tablehead b</th>
  </tr>
  <tr>
    <td> cell with text </td>
    <td> amnother cell </td>
  </tr>
<dlh.table.html>

is for pure html and like <dlh.div.wiki> you can build a table around wiki content

<dlh.table.wiki [ id="" class="" style=""...]>
  <dlh.caption.wiki> **wiki caption content** </dlh.caption.wiki>
  <dlh.tr.wiki>
    <dlh.th.wiki> table head __wiki__ syntax </dlh.th.wiki>
    <dlh.th.wiki> **another** table head __wiki__ syntax </dlh.th.wiki>
  </dlh.tr.wiki>
  <dlh.tr.wiki>
    <dlh.td.wiki> call a plugin or some other cool stuff </dlh.th.wiki>
    <dlh.td.wiki> **wiki syntax here** </dlh.th.wiki>
  </dlh.tr.wiki>
</dlh.table.wiki>

BEWARE !

This plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
This plugin is generally made for MY personal needs.

About

dokuwiki-plugin: enhances editor, can build a navi-tree, mermaid editor integration, design fine tuning and some other cool stuff

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published