ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / forum / suppressing_output_of_pages_included_only_for_their_side_effects.mdwn
1 In particular, it's kind of annoying that using the sidebar plugin results in the creation of a free-standing sidebar.html (which in the simplest case of course includes a copy of *its own content* as a sidebar).  It would be nice if there were a way to tell Ikiwiki to treat a file like sidebar.mdwn as "inline only": allow its content to be inlined but not to render it separately nor allow linking to it.
2
3 In reading through the code and associated docs, it appears that the ideal method is for the file to be removed from the $changed array by plugin's "needsbuild" hook.  Either the sidebar plugin could define such a hook, or perhaps a more general solution is the creation of a meta variable or config file regexp that would handle it according to the user's wishes.
4
5 I'm about ready to code up such a change but want to find out if I'm thinking along the right lines.  --[[blipvert]]
6
7 > Internal pages should be able to be used for this, as they are used for
8 > comments. So you'd have
9 > `sidebar._mdwn`. However, mwdn would need to be changed to register a
10 > htmlize hook for the `_mdwn` extension for that to really work.
11
12 > But, if there's no rendered sidebar page, how can users easily edit the page
13 > in the web interface? In the specific case of the sidebar, It seems
14 > better to have the page display something different when built standalone
15 > than when built as the sidebar.
16 > --[[Joey]]