X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/479c7a1ea62d8fce3ef54f9deae89230d0b52a5d..6ebea774c85502377681165e27093a3bd3a61f30:/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn diff --git a/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn b/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn index bb3482e71..c6f1fefe1 100644 --- a/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn +++ b/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn @@ -1,6 +1,6 @@ I'd like to see some way to conditionally include wiki text based on whether the wiki enables or disables certain features. For example, -[[helponformatting]], could use `\[[if (enabled smiley) """Also, because +[[ikiwiki/formatting]], could use `\[[if (enabled smiley) """Also, because this wiki has the smiley plugin enabled, you can insert \[[smileys]] and some other useful symbols."""]]`, and a standard template for [[plugins]] pages could check for the given plugin name to print "enabled" or @@ -10,9 +10,9 @@ Some potentially useful conditionals: * `enabled pluginname` * `disabled pluginname` -* `any pagespec`: true if any of the pages in the [[PageSpec]] exist -* `all pagespec`: true if all of the pages in the [[PageSpec]] exist -* `no pagespec` or `none pagespec`: true if none of the pages in the [[PageSpec]] exist +* `any pagespec`: true if any of the pages in the [[ikiwiki/PageSpec]] exist +* `all pagespec`: true if all of the pages in the [[ikiwiki/PageSpec]] exist +* `no pagespec` or `none pagespec`: true if none of the pages in the [[ikiwiki/PageSpec]] exist * `thispage pagespec`: true if pagespec includes the page getting rendered (possibly one including the page with this content on it). * `sourcepage pagespec`: true if pagespec includes the page corresponding to the file actually containing this content, rather than a page including it. * `included`: true if included on another page, via [[plugins/inline]], [[plugins/sidebar]], [[plugins/contrib/navbar]], etc. @@ -24,8 +24,8 @@ keep the aliases for simplicity anyway). You also may or may not want to include an `else` clause; if so, you could label the text used if true as `then`. -Syntax could vary greatly here, both for the [[PreprocessorDirective]] and -for the condition itself. +Syntax could vary greatly here, both for the +[[ikiwiki/PreprocessorDirective]] and for the condition itself. > I think this is a good thing to consider, although conditionals tend to > make everything a lot more complicated, so I also want to KISS, and not @@ -56,10 +56,10 @@ for the condition itself. > > --[[Joey]] ->> [[PageSpec]] syntax seems perfect, and your proposed syntax for the `if` ->> [[PreprocessorDirective]] looks fine to me. +>> [[ikiwiki/PageSpec]] syntax seems perfect, and your proposed syntax for the `if` +>> [[ikiwiki/PreprocessorDirective]] looks fine to me. >> ->> [[PageSpec]]s don't give you `none` for free, since `!foo/*` as a boolean +>> [[ikiwiki/PageSpec]]s don't give you `none` for free, since `!foo/*` as a boolean >> would mean "does any page not matching `foo/*` exist", not "does `foo/*` >> match nothing"; however, I don't really care much about `none`, since I >> just threw it in while brainstorming, and I don't know any compelling use @@ -75,7 +75,7 @@ for the condition itself. >> pages."""]]. The help text would then only appear on the sidebar page >> itself, not the sidebar included on all pages. >> ->> * On [[blog]] entries, you could use `included` to implement a cut. +>> * On [[ikiwiki/blog]] entries, you could use `included` to implement a cut. >> (Please don't take that as an argument against. :) ) For instance, you >> could use included rather than [[plugins/toggle]] for the detailed >> changelogs of ikiwiki, or to embed an image as a link in the feed rather @@ -104,3 +104,25 @@ for the condition itself. This is now completely [[todo/done]]! See [[plugins/conditional]]. --[[Joey]] + +> You rock mightily. --[[JoshTriplett]] + +Is there a way to test features other than plugins? For example, +to add to [[ikiwiki/Markdown]] something like + + \[[if test="enabled(multimarkdown)" then="You can also use..."]] + +(I tried it like that just to see if it would work, but I wasn't that lucky.) +--ChapmanFlack + +> No, not supported. I really think that trying to conditionalise text on a +> page for multimarkdown is a path to madness or unreadability though. +> Perhaps it would be better to have .mmdwn files that can only contain +> multimarkdown? --[[Joey]] + +>> Really, there was only one (or maybe two) pages I had in mind as appropriate +>> places for conditional text based on multimarkdown—the underlay pages +>> for 'markdown' and maybe also 'formatting', because those are the pages you +>> look at when you're trying to find out how to mark stuff up for the wiki, so +>> if MM is enabled, they need to at least mention it and have a link to the +>> MM syntax guide.--ChapmanFlack