From e2f1277d96090132d019e443fa1b624b74d1651a Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Sun, 6 Jan 2008 10:52:11 -0500 Subject: web commit by http://madduck.myopenid.com/ --- ...place_HTML::Template_with_Template_Toolkit.mdwn | 49 ++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn (limited to 'doc/todo') diff --git a/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn b/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn new file mode 100644 index 000000000..19f138fee --- /dev/null +++ b/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn @@ -0,0 +1,49 @@ +HTML::Template is an okay templating kit, but it lacks a lot of powerful +features and thus makes it rather hard to give an ikiwiki site a consistent +look. If you browse the templates provided in the tarball, you'll notice that +more than one of them contain the `` tag, which is unnecessary. + +Maybe it's just me, I also find HTML::Template cumbersome to use, due in part +to its use of capital letters. + +Finally, the software seems unmaintained: the mailing list and searchable +archives linked from + +are broken and the author has not replied to my query in months. + +I would love to see ikiwiki use the [Template +Toolkit](http://template-toolkit.org/) as templating engine. + +One major reason for TT is its use of slots, a concept I first encountered +with Zope Page Templates and never wanted to miss it again. Let me quickly +illustrate, using the HTML::Template syntax for simplicity. Traditionally, +templating is done with includes: + + Page A Page B + + this is page A this is page B + + +This involves four pages, and if you mistype "footer" on page B, +it'll be broken in potentially subtle ways. + +Now look at the approach with slots: + + MainTemplate + This is the header + + This is the footer + + Page A Page B + + + This is page A This is page B + + + +As soon as you think about more structure pages with various slots +to fill, I am sure you can see the appeal of that approach. If not, +here is some more documentation: + +I would be glad to volunteer time to make this switch happen, such as rewrite +the templates. I'd prefer not having to touch Perl though... -- cgit v1.2.3 From c9b62ad8661095858f3eac12c9cbf003a53c8cb2 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Sun, 6 Jan 2008 10:52:58 -0500 Subject: web commit by http://madduck.myopenid.com/: make it wishlist --- doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn | 2 ++ 1 file changed, 2 insertions(+) (limited to 'doc/todo') diff --git a/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn b/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn index 19f138fee..feb31a128 100644 --- a/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn +++ b/doc/todo/replace_HTML::Template_with_Template_Toolkit.mdwn @@ -1,3 +1,5 @@ +[[tag wishlist]] + HTML::Template is an okay templating kit, but it lacks a lot of powerful features and thus makes it rather hard to give an ikiwiki site a consistent look. If you browse the templates provided in the tarball, you'll notice that -- cgit v1.2.3 From 1173b6e6a2abf39a84a211c4d60e877b9900b6b3 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 7 Jan 2008 09:16:40 -0500 Subject: web commit by http://madduck.myopenid.com/ --- doc/todo/auto-create_tag_pages_according_to_a_template.mdwn | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 doc/todo/auto-create_tag_pages_according_to_a_template.mdwn (limited to 'doc/todo') diff --git a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn new file mode 100644 index 000000000..74e5b7da3 --- /dev/null +++ b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn @@ -0,0 +1,5 @@ +It would be great if I could tell ikiwiki to automatically instantiate pages for each tag, according to a template, especially when `$tagbase` is set. + +Tags are mainly specific to the object to which they’re stuck. However, I often use them the other way around, too: as concepts. And sometimes I’d like to see all pages related to a given concept (“tagged with a given tag”). The only way to do this with ikiwiki is to instantiate a page for each tag and slap a map on it. This is quite tedious and I’d really love to see Ikiwiki do so by default for all tags. + +Also see: and -- cgit v1.2.3 From cd43ea1c990194bcddc408ac4d1ead05c6cc46eb Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 7 Jan 2008 09:17:51 -0500 Subject: web commit by http://madduck.myopenid.com/: add wishlist tag --- doc/todo/auto-create_tag_pages_according_to_a_template.mdwn | 2 ++ 1 file changed, 2 insertions(+) (limited to 'doc/todo') diff --git a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn index 74e5b7da3..7211bfe41 100644 --- a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn +++ b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn @@ -3,3 +3,5 @@ It would be great if I could tell ikiwiki to automatically instantiate pages for Tags are mainly specific to the object to which they’re stuck. However, I often use them the other way around, too: as concepts. And sometimes I’d like to see all pages related to a given concept (“tagged with a given tag”). The only way to do this with ikiwiki is to instantiate a page for each tag and slap a map on it. This is quite tedious and I’d really love to see Ikiwiki do so by default for all tags. Also see: and + +[tag wishlist] -- cgit v1.2.3 From 2f64f6d35298fccfc9c39281d95c1a4bd436cfa6 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 7 Jan 2008 09:18:19 -0500 Subject: web commit by http://madduck.myopenid.com/: idiot i am, forgot the second pair of brackets --- doc/todo/auto-create_tag_pages_according_to_a_template.mdwn | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/todo') diff --git a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn index 7211bfe41..90864d514 100644 --- a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn +++ b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn @@ -4,4 +4,4 @@ Tags are mainly specific to the object to which they’re stuck. However, I ofte Also see: and -[tag wishlist] +[[tag wishlist]] -- cgit v1.2.3 From d8326263959c2df7e5c20befa29ae1e286e4b00a Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 7 Jan 2008 10:19:04 -0500 Subject: web commit by http://madduck.myopenid.com/ --- doc/todo/allow_CGI_to_create_dynamic_pages.mdwn | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 doc/todo/allow_CGI_to_create_dynamic_pages.mdwn (limited to 'doc/todo') diff --git a/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn b/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn new file mode 100644 index 000000000..ea20231ef --- /dev/null +++ b/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn @@ -0,0 +1,3 @@ +[[tag wishlist]] + +It would be cool if the CGI could be used to render dynamic pages. For instance, I might want to create a page with a `[[map]]` according to a [[pagespec]] to be passed in the query string, instead of creating/hardcoding all possible pagespecs I might want to call. -- cgit v1.2.3 From 8831f3ca3e5a1f93afe2eaeddbb7080e75fada20 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 7 Jan 2008 10:46:49 -0500 Subject: web commit by http://madduck.myopenid.com/: fix map verbatim --- doc/todo/allow_CGI_to_create_dynamic_pages.mdwn | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/todo') diff --git a/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn b/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn index ea20231ef..6125bc413 100644 --- a/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn +++ b/doc/todo/allow_CGI_to_create_dynamic_pages.mdwn @@ -1,3 +1,3 @@ [[tag wishlist]] -It would be cool if the CGI could be used to render dynamic pages. For instance, I might want to create a page with a `[[map]]` according to a [[pagespec]] to be passed in the query string, instead of creating/hardcoding all possible pagespecs I might want to call. +It would be cool if the CGI could be used to render dynamic pages. For instance, I might want to create a page with a `\[[map]]` according to a [[pagespec]] to be passed in the query string, instead of creating/hardcoding all possible pagespecs I might want to call. -- cgit v1.2.3