[dokuwiki] Tips needed for syntax plugin

  • From: Sebastian Menge <sebastian.menge@xxxxxxxxxxxxxxx>
  • To: dokuwiki@xxxxxxxxxxxxx
  • Date: Thu, 25 Sep 2008 13:55:28 +0200


I want to write a little plugin, that 

  - takes the input between two tags <myplug>blah</myplug>, 
  - passes "blah" to a command that produces a pdf for download,
  - and generates some thumbnails for the downloadable pdf

1) I managed to render <p>blah</p> with the color-example of
the tutorial. But I dont understand the return values of handler(). The
skeleton says 

  @return Integer The current lexer state for the match.

But all examples return a more complicated array(). Is this explained
somewhere a bit more detailed? What is the structure of "lexer state"
is it the params and result of handle() ? 

(Oh wow, I just realized that I ran into _the_ problem of untyped
languages: the types are unclear.)

2) If I get it right, I would generate the files in handle() (but on
"ENTRY" or "UNMATCHED" ?). I would move it to data/media. How would i
pass the filenames to render()? Via a private field in the plugin

3) As I said I generate a pdf via the shell and have
thumbnails for the single pages.

Where should the files go best? Would I need to generate any metadata
when I simply put it under data/media? How about versioning/caching

Thanks for any tips, Sebastian.
DokuWiki mailing list - more info at

Other related posts: