diff options
| author | http://smcv.pseudorandom.co.uk/ <http://smcv.pseudorandom.co.uk/@web> | 2010-05-17 17:34:40 +0000 |
|---|---|---|
| committer | Joey Hess <joey@finch.kitenet.net> | 2010-05-17 17:34:40 +0000 |
| commit | f864b74859d8b0197f59d7dfe7d45063dc887cd1 (patch) | |
| tree | eb3543b0a66f3dbdb11a2dcfe569d5cacea26797 /doc/todo/multiple_template_directories.mdwn | |
| parent | d63553b39b4afb18a5b3ee32131095699582529c (diff) | |
| download | ikiwiki-f864b74859d8b0197f59d7dfe7d45063dc887cd1.tar ikiwiki-f864b74859d8b0197f59d7dfe7d45063dc887cd1.tar.gz | |
an example of somewhere where the old functionality is actually needed
Diffstat (limited to 'doc/todo/multiple_template_directories.mdwn')
| -rw-r--r-- | doc/todo/multiple_template_directories.mdwn | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/todo/multiple_template_directories.mdwn b/doc/todo/multiple_template_directories.mdwn index 6d1632b4c..0f8f5c880 100644 --- a/doc/todo/multiple_template_directories.mdwn +++ b/doc/todo/multiple_template_directories.mdwn @@ -13,3 +13,35 @@ ought to do the trick. > considered [[done]]. I have a use case for this, a site composed of blogs and wikis, templates divided in three categories : common, blog and wiki. The only solution I found is maintaining hard links, being able to have multiple template dirs would obviously be better. -- Changaco + +> [[plugins/underlay]] used to allow adding extra templatedirs, but Joey +> removed that functionality when he made templates search the wiki's +> own `templates` directory. +> +> You can get a 3-level hierarchy like this: +> +> * instance-specific overrides: $srcdir/templates +> * common to the entire site: a directory that is the value of all +> instances' `templatedir` parameters +> * common to every ikiwiki in the world: /usr/share/ikiwiki/templates +> (implicitly searched) +> +> (by "instance" I mean an instance of ikiwiki - a .setup file, basically.) +> +> For a more complex hierarchy you'd need the old [[plugins/underlay]] +> functionality, i.e. you'd need to (ask Joey to) revert the patch that +> removed it. For instance, if anyone has a hierarchy like this, then +> they need the old functionality back in order to split the template +> search path for the things marked `(???)`: +> +> every ikiwiki in the world (/usr/share/ikiwiki/templates) +> \--- your site (???) +> \--- your blogs (???) +> \--- travel blog ($srcdir/templates) +> \--- code blog ($srcdir/templates) +> \--- your wikis (???) +> \--- travel wiki ($srcdir/templates) +> \--- code wiki ($srcdir/templates) +> +> This looks pretty hypothetical to me, though... +> --[[smcv]] |