summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ikiwiki.setup2
-rw-r--r--doc/plugins.mdwn8
-rw-r--r--doc/plugins/contrib.mdwn4
-rw-r--r--doc/usage.mdwn6
4 files changed, 12 insertions, 8 deletions
diff --git a/doc/ikiwiki.setup b/doc/ikiwiki.setup
index a772ca60b..9d2859a86 100644
--- a/doc/ikiwiki.setup
+++ b/doc/ikiwiki.setup
@@ -109,6 +109,8 @@ use IkiWiki::Setup::Standard {
# htmltidy fortune sidebar map rst anonok}],
# If you want to disable any of the default plugins, list them here.
#disable_plugins => [qw{inline htmlscrubber passwordauth openid}],
+ # To add a directory to the perl searh path, use this.
+ #libdir => "/home/me/.ikiwiki/",
# For use with the tag plugin, make all tags be located under a
# base page.
diff --git a/doc/plugins.mdwn b/doc/plugins.mdwn
index 255f13f67..3f154f1f0 100644
--- a/doc/plugins.mdwn
+++ b/doc/plugins.mdwn
@@ -11,14 +11,6 @@ To enable plugins, use the `--plugin` switch described in
Enable the [[goodstuff]] plugin to get a nice selection of plugins that
will fit most uses of ikiwiki.
-Without administrator access, you can add some custom plugins by storing
-yourcustomplugin.pm in /home/user/.ikiwiki/IkiWiki/Plugins (or any other
-place, keeping the "IkiWiki/Plugins" part of the path) and adding this
-line at the begining of your ikiwiki.setup file:
-
- BEGIN { push @INC, "/home/user/.ikiwiki" }
-
-
## Plugin directory
[[inline pages="plugins/* and !plugins/type/* and !plugins/write and
diff --git a/doc/plugins/contrib.mdwn b/doc/plugins/contrib.mdwn
index ae234f67b..dc8b90771 100644
--- a/doc/plugins/contrib.mdwn
+++ b/doc/plugins/contrib.mdwn
@@ -13,3 +13,7 @@ IkiWiki::Plugin namespace, so they go in a IkiWiki/Plugin subdirectory
inside the perl search path. For example, if your perl looks in
`/usr/local/lib/site_perl` for modules, you can locally install ikiwiki
plugins to `/usr/local/lib/site_perl/IkiWiki/Plugin`
+
+You can use the `libdir` configuration option to add a directory to the
+search path. For example, if you set `libdir` to `/home/you/.ikiwiki/`,
+then ikiwiki will look for plugins in `/home/you/.ikiwiki/IkiWiki/Plugins`.
diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index a8bb92d68..c83f833fc 100644
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -229,6 +229,12 @@ configuration options of their own.
Disables use of a plugin. For example "--disable-plugin htmlscrubber"
to do away with HTML sanitization.
+* --libdir directory
+
+ Makes ikiwiki look in the specified directory first, before the regular perl
+ library directories. For example, if you set libdir to "/home/you/.ikiwiki/",
+ you can install plugins in "/home/you/.ikiwiki/IkiWiki/Plugins/".
+
* --discussion, --no-discussion
Enables or disables "Discussion" links from being added to the header of