aboutsummaryrefslogtreecommitdiff
path: root/doc/todo/break_up_page_template_into_subfiles.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joey@kitenet.net>2012-04-08 16:19:46 -0400
committerJoey Hess <joey@kitenet.net>2012-04-08 16:19:46 -0400
commit6429c991f6a23a0fc31b9a5281d034964f15e452 (patch)
tree6b5649f52c8111374ca863134027b81bf2fbfe05 /doc/todo/break_up_page_template_into_subfiles.mdwn
parentab1ebf1ec6fc8d90de3b8e70bd5f624c50316da8 (diff)
downloadikiwiki-6429c991f6a23a0fc31b9a5281d034964f15e452.tar
ikiwiki-6429c991f6a23a0fc31b9a5281d034964f15e452.tar.gz
response
Diffstat (limited to 'doc/todo/break_up_page_template_into_subfiles.mdwn')
-rw-r--r--doc/todo/break_up_page_template_into_subfiles.mdwn24
1 files changed, 23 insertions, 1 deletions
diff --git a/doc/todo/break_up_page_template_into_subfiles.mdwn b/doc/todo/break_up_page_template_into_subfiles.mdwn
index 1dd9e49cc..e9f2e310b 100644
--- a/doc/todo/break_up_page_template_into_subfiles.mdwn
+++ b/doc/todo/break_up_page_template_into_subfiles.mdwn
@@ -1,4 +1,9 @@
-Wishlist items such as [[Add space before slash in parent links]] would be easier to deal with if the page.tmpl template was broken up into sections and each section had a separate template file which was included in the master page.tmpl file. This would make it easier to customize parts of a page without having to fork the whole page.tmpl and then have things break when there's an update of the master page.tmpl file.
+Wishlist items such as [[Add space before slash in parent links]] would be
+easier to deal with if the page.tmpl template was broken up into sections
+and each section had a separate template file which was included in the
+master page.tmpl file. This would make it easier to customize parts of a
+page without having to fork the whole page.tmpl and then have things break
+when there's an update of the master page.tmpl file.
Suggested sections:
@@ -12,3 +17,20 @@ Suggested sections:
Would this work, or would HTML::Template have problems with this?
-- [[KathrynAndersen]]
+
+> Well, breaking it up into 6 sections would let a user modify one of them
+> with only 1/6th the chance of it being broken by a new ikiwiki.
+> Which seems like a win from the user's POV. However, I know that there
+> are ikiwiki users who modify the `page.tmpl` but are very
+> unsophisticated; needing to find the right file amoung 6 to modify
+> would be a loss for these users. And some modifications would probably
+> need to be coordinated amoung multiple files.
+>
+> For ikiwiki developers, reducing by 5/6th the number of users affected by a
+> breaking change to page.tmpl is nice, but we still have to worry about
+> the 1 in 6 that would be affected despite the splitting. Ikiwiki has
+> enough users that any change to page.tmpl has to be carefully considered
+> to avoid breaking something they may depend on, and it's been two years
+> since that last needed to be done.
+>
+> So all in all, I don't think it's worth doing. --[[Joey]]