summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/forum/Setting_up_a_development_environment.mdwn6
-rw-r--r--doc/forum/ikiwiki_development_environment_tips.mdwn24
2 files changed, 30 insertions, 0 deletions
diff --git a/doc/forum/Setting_up_a_development_environment.mdwn b/doc/forum/Setting_up_a_development_environment.mdwn
index 94f022e22..0b4e555c1 100644
--- a/doc/forum/Setting_up_a_development_environment.mdwn
+++ b/doc/forum/Setting_up_a_development_environment.mdwn
@@ -24,3 +24,9 @@ I must be missing something obvious, but the [[ikiwiki development environment t
Cheers,
[[Francois|fmarier]]
+
+> I updated the [[ikiwiki development environment tips]] page with my
+> approach to running ikiwiki from the git checkout (with changes). For
+> the templates, also make sure that you do not have custom templates in
+> your src dir as they will be used instead of those from the template
+> dir if found. --GB
diff --git a/doc/forum/ikiwiki_development_environment_tips.mdwn b/doc/forum/ikiwiki_development_environment_tips.mdwn
index 91ccc6d6e..f9c584159 100644
--- a/doc/forum/ikiwiki_development_environment_tips.mdwn
+++ b/doc/forum/ikiwiki_development_environment_tips.mdwn
@@ -42,3 +42,27 @@ Does anyone have a comfortable setup or tips they would like to share? -- [[Jon]
> needed, since it is preconfigured to use the templates and underlays
> from ikiwiki's source repository.
> --[[Joey]]
+
+> I work with Ikiwiki from the git checkout directory the following way.
+>
+> * instead of running ikiwiki, I wrote the following `mykiwiki` shell script,
+> that also allows me to use my custom lib-ifited multimarkdown:
+
+ #!/bin/sh
+
+ MMDSRC="$HOME/src/multimarkdown/lib"
+ IKIWIKISRC="$HOME/src/ikiwiki"
+ PLUGINS="$HOME/src/ikiplugins"
+
+ /usr/bin/perl -I"$MMDSRC" -I"$IKIWIKISRC/blib/lib" -I"$PLUGINS" "$IKIWIKISRC/ikiwiki.out" -libdir "$IKIWIKISRC" "$@"
+
+> * I also have an installed ikiwiki from Debian unstable, from which I only use the base wiki, so my `.setup` has the following configs:
+
+ # additional directory to search for template files
+ templatedir => '/home/oblomov/src/ikiwiki/templates',
+ # base wiki source location
+ underlaydir => '/usr/share/ikiwiki/basewiki',
+ # extra library and plugin directory
+ libdir => '/home/oblomov/src/ikiwiki',
+
+> Hope that helps --GB