doc/todo/Render_multiple_destinations_from_one_source.mdwn

   1 I've set up a couple of sites where the users use ikiwiki in fairly standard mode as a CMS and I then set up another ikiwiki setup file that's got the edit options turned off, but is pointing at the same git repository in the background.  I then make the post-update hook for each be <tt>post-update-hook.ikiwiki</tt> and <tt>post-update-hook.ikiwiki-public</tt> and have the <tt>post-update</tt> hook itself be a script like:
   2
   3     #!/bin/sh
   4
   5     $0.ikiwiki "$@"
   6     $0.ikiwiki-public "$@"
   7
   8 obviously this results in duplication of most of the <tt>ikiwiki.setup</tt>, a spare working directory that (perhaps) isn't needed, and an extra post-update hook plus wrapper script that is really needless extra complication.
   9
  10 If instead there was a way of specifying additional destdir's, or perhaps more generally a way of specifying that there should be multiple passes through the build process using alternative values for some of the variables, then one could have both the private wiki view, and the public static view generated with minimal additional configuration.
  11
  12 One idea that occurs to me is an <tt>additional_configs</tt> list where one would specify files containing just the settings you want to override compared with the main setup file.
  13
  14 Alternatively, one might invent a new way of specifying alternative settings.  i.e.:
  15
  16      additionalsites:
  17        - public
  18
  19      destdir: /home/wiki/wiki-view
  20      destdir[public]: /home/wiki/public_html
  21
  22      disable_plugins: []
  23      disable_plugins[public]:
  24        - recentchanges
  25        - editpage
  26
  27      url: https://example.com/editors/
  28      url[public]: http://www.example.com/
  29
  30      ...
  31
  32 where the existance of the <tt>additionalsites</tt> list provokes additional runs through using the settings with matching extra bits to be used to override the defaults found in the rest of the file.
  33
  34 Just brainstorming a bit after [[liw]]'s comment about this being useful on IRC, and thought I'd write the idea up while I was thinking about it. -[[fil]]
  35
  36 > I don't think you can avoid ikiwiki needing to store a different
  37 > `.ikiwiki` directory with state for each site. Differences in
  38 > configuration can affect the state it stores in arbitrary ways,
  39 > ranging from which pages are even built to what plugins are enabled and
  40 > store state. This also means that it doesn't make sense to try and
  41 > share state amoung rebuilds of the same site.
  42 >
  43 > There is a hidden, and undocumented configuration setting `wikistatedir`
  44 > that can actually be pointed at a different directory than `.ikiwiki`.
  45 > Then you can rebuild multiple configurations from one working directory.
  46 >
  47 > Another handy trick is to use the old perl-format (not yaml) setup file,
  48 > and parameterize it using `$ENV{FOO}`, then you can build two different
  49 > setups from the same setup file.
  50 > --[[Joey]]