doc/plugins/install.mdwn

   1 [[!meta title="Installing third party plugins"]]
   2
   3 Most ikiwiki plugins are perl modules and should be installed somewhere in
   4 the perl module search path. See the @INC list at the end of the output of
   5 `perl -V` for a list of the directories in that path. All plugins are in
   6 the IkiWiki::Plugin namespace, so they go in a IkiWiki/Plugin subdirectory
   7 inside the perl search path. For example, if your perl looks in
   8 `/usr/local/lib/site_perl` for modules, you can locally install ikiwiki
   9 plugins to `/usr/local/lib/site_perl/IkiWiki/Plugin`
  10
  11 You can use the `libdir` configuration option to add directories to the
  12 search path. For example, if you set `libdir` to `/home/you/.ikiwiki/`,
  13 then ikiwiki will look for plugins in `/home/you/.ikiwiki/IkiWiki/Plugin`. This
  14 configuration option can be either a string (for backward compatibility) or a
  15 list of strings (to add several directories to the search path).
  16
  17 Ikiwiki also supports plugins that are external programs. These are
  18 typically written in some other language than perl. Ikiwiki searches for
  19 these in `/usr/lib/ikiwiki/plugins` by default. If `libdir` is set, it will
  20 also look under that directory, for example in `/home/you/.ikiwiki/plugins`.
  21 Note that this type of plugin has to be executable for ikiwiki to use it.