urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ikiwiki/doc/plugins/sidebar.mdwn

27 lines
1.2 KiB
Plaintext
Raw Normal View History

Migrate doc/plugins via prefix_directives This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc | xargs --max-args 1 ./ikiwiki-transition prefix_directives
2008-07-21 13:31:57 +02:00
[[!template id=plugin name=sidebar author="Tuomo Valkonen"]]
[[!tag type/chrome]]
* Allow preprocessor directives to contain python-like triple-quoted text blocks, for easy nesting of quotes inside. * Add a template plugin. * Use the template plugin to add infoboxes to each plugin page listing basic info about the plugin.
2006-08-23 07:41:07 +02:00
* Add a tail fin^W^Wsidebar plugin by Tuomo Valkonen. * If a page links to itself, mark up the link text in a span with class="selflink" so that it can be styled. I don't have a useful style defined for that though.
2006-08-18 02:24:22 +02:00
If this plugin is enabled, then a sidebar is added to pages in the wiki.
The content of the sidebar is simply the content of a page named
clarify
2006-08-19 00:23:34 +02:00
"sidebar" (ie, create a "sidebar.mdwn").
* Add a tail fin^W^Wsidebar plugin by Tuomo Valkonen. * If a page links to itself, mark up the link text in a span with class="selflink" so that it can be styled. I don't have a useful style defined for that though.
2006-08-18 02:24:22 +02:00
Typically this will be a page in the root of the wiki, but it can also be a
MAJOR basewiki reorg Including redir pages for the moved basewiki pages. These will be removed in a future release.
2007-12-08 21:59:08 +01:00
[[ikiwiki/SubPage]]. In fact, this page,
[[plugins/sidebar|plugins/sidebar]], will be treated as a sidebar for the
[[plugins]] page, and of all of its SubPages, if the plugin is enabled.
* Add a tail fin^W^Wsidebar plugin by Tuomo Valkonen. * If a page links to itself, mark up the link text in a span with class="selflink" so that it can be styled. I don't have a useful style defined for that though.
2006-08-18 02:24:22 +02:00
sidebar: Now a sidebar directive can be used to override the sidebar shown on a page.
2010-04-15 22:40:01 +02:00
There is also a [[ikiwiki/directive/sidebar]] directive that can be used
to provide a custom sidebar content for a page.
add warnings about using map, inline, etc with the sidebar causing performance nightmares
2007-07-25 03:31:08 +02:00
sidebar: Now a sidebar directive can be used to override the sidebar shown on a page.
2010-04-15 22:40:01 +02:00
----
Warning: Any change to the sidebar page will cause a rebuild of the whole
wiki, since every page includes a copy that has to be updated. This can
especially be a problem if the sidebar includes an
[[ikiwiki/directive/inline]] directive, since any changes to pages inlined
into the sidebar will change the sidebar and cause a full wiki rebuild.
document effect of contentless dependencies on sidebar efficiency
2009-10-04 22:28:14 +02:00
Instead, if you include a [[ikiwiki/directive/map]] directive on the sidebar,
and it does not use the `show` parameter, only adding or removing pages
included in the map will cause a full rebuild. Modifying pages will not.