aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorsmcv <smcv@web>2016-04-12 02:00:21 -0400
committeradmin <admin@branchable.com>2016-04-12 02:00:21 -0400
commit06a67db3f9326f3d55fff77403d7fbc8146480f6 (patch)
tree86a7463afb6abe1572e3e66b8d8424826b0b9078
parent687e3f94ea34e1ffd46f3fca5940bfa1105f7ca7 (diff)
downloadikiwiki-06a67db3f9326f3d55fff77403d7fbc8146480f6.tar
ikiwiki-06a67db3f9326f3d55fff77403d7fbc8146480f6.tar.gz
explain why multiple page.tmpl is a showstopper for upstream even if not for local themes
-rw-r--r--doc/themes/discussion.mdwn14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/themes/discussion.mdwn b/doc/themes/discussion.mdwn
index d7bd8d627..d8241a8e6 100644
--- a/doc/themes/discussion.mdwn
+++ b/doc/themes/discussion.mdwn
@@ -21,6 +21,20 @@ links to the actual theme. -- [[anarcat]]
>> Would you reconsider? I've made [[this bootstrap theme|/forum/bootstrap_theme]] that works within the theme plugin without changing the `templatedir` configuration option. It seems that the `page.tmpl` I have in the subfolder `templates` takes precedence. Not sure what you meant by "two versions of page.tmpl", though. -- [[desci]]
+>>> The reason we don't want individual themes shipped with ikiwiki
+>>> to have to include their own `page.tmpl` is that when we add new
+>>> features (such as new plugins) to the ikiwiki core, if those features
+>>> require a `page.tmpl` change, we don't want to have to add them to
+>>> multiple variations of `page.tmpl`. This would either lead to
+>>> increased maintenance work (repeating ourselves), or theme-dependent
+>>> feature availability like what happens in Wordpress (for instance
+>>> imagine if `osm` only worked with Bootstrap and `sidebar` only worked
+>>> with Actiontabs - you wouldn't be able to have both).
+>>>
+>>> If you maintain your own local theme, you're welcome to maintain a
+>>> version of `page.tmpl` containing only the features you personally
+>>> need, but the `page.tmpl` in ikiwiki should be comprehensive. --[[smcv]]
+
---
I have a question.