diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/todo/support_for_plugins_written_in_other_languages.mdwn | 24 |
1 files changed, 19 insertions, 5 deletions
diff --git a/doc/todo/support_for_plugins_written_in_other_languages.mdwn b/doc/todo/support_for_plugins_written_in_other_languages.mdwn index 65fd84f90..33378a4fe 100644 --- a/doc/todo/support_for_plugins_written_in_other_languages.mdwn +++ b/doc/todo/support_for_plugins_written_in_other_languages.mdwn @@ -8,19 +8,22 @@ that, never again.) Instead, I'm considering using XML RPC to let ikiwiki communicate with a child process that it can spawn. The child could then be any program, -written in any language. It could talk XML RPC via stdio. +written in any language. It could talk XML RPC via stdio. (This assumes +that most languages allow easily serialising XML::RPC calls and responses +to a file descriptor. Some XML RPC implementations may be hardcoded to use +http..) Here's how it would basically look, not showing the actual XML RPC used to pass values. - -> init + -> import <- 1 <- hook type => preprocess, id => foo -> 1 <- done 1 -> 1 - -> callback type => preprocess id => foo, page => bar + -> callback type => preprocess, id => foo, page => bar <- 1 <- getconfig url -> "http://example.com", ... @@ -41,7 +44,18 @@ From the plugin's POV: * It's probably sitting in an XML::RPC loop. * Get a command from ikiwiki. -* Call the appropriate callback. -* The callback can use XML::RPC to communicate with ikiwiki to get things +* Disaptch the command to the appropriate function. The main commands seem + to be "import" and "callback"; callback can call any function that the + plugin has registered a hook for. Others commands might include + "rcs_*" for RCS plugins.. +* The function can use XML::RPC to communicate with ikiwiki to get things like config values; and to call ikiwiki functions. * When the callback returns, use XML::RPC to send a "done" command to ikiwiki. + +Simple enough, really. ikiwiki would need to add accessor functions for +all important variables, such as "getconfig" and "setconfig". It would +probably be easiest for ikiwiki to dispatch a command by just evaling +IkiWiki::$command. + +Plugin programs could be dropped into /usr/share/ikiwiki/plugins/, and +load_plugin() would just open2 the plugin program and call import. |