X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/3e9a6a7d4fa237d488f8570b28dbe88d5277c1ae..623c7e17989f53ef049f12639950d2c50c9edd4f:/doc/plugins/linkmap.mdwn?ds=sidebyside diff --git a/doc/plugins/linkmap.mdwn b/doc/plugins/linkmap.mdwn index e0eda9289..7e51cd935 100644 --- a/doc/plugins/linkmap.mdwn +++ b/doc/plugins/linkmap.mdwn @@ -1,30 +1,14 @@ -[[template id=plugin name=linkmap included=1 author="Joey Hess"]] -[[tag type/meta]] -[[tag type/slow]] -This plugin uses [graphviz](http://www.graphviz.org/) to generate a graph showing the links between a -set of pages in the wiki. Example usage: +[[!template id=plugin name=linkmap author="[[Joey]]"]] +[[!tag type/meta]] +[[!tag type/widget]] +[[!tag type/slow]] - \[[linkmap pages="* and !blog/* and !*/Discussion"]] +This plugin provides the [[ikiwiki/directive/linkmap]] [[ikiwiki/directive]]. +It uses [graphviz](http://www.graphviz.org/) to generate a graph showing the +links between a set of pages in the wiki. -Only links between mapped pages will be shown; links pointing to or from -unmapped pages will be omitted. If the pages to include are not specified, -the links between all pages (and other files) in the wiki are mapped. For -best results, only a small set of pages should be mapped, since otherwise -the map can become very large, unweildy, and complicated. Also, the map is -rebuilt whenever one of the mapped pages is changed, which can make the -wiki a bit slow. +[[!if test="enabled(linkmap)" then=""" +Here is an example link map, of the index page and all pages it links to: -Here are descriptions of all the supported parameters to the `linkmap` -directive: - -* `pages` - A [[PageSpec]] of the pages to map. -* `height`, `width` - Limit the size of the map to a given height and width, - in inches. Both must be specified for the limiting to take effect, otherwise - the map's size is not limited. - -This plugin is included in ikiwiki, but is not enabled by default. - -If this plugin is enabled, here is a link map of the index page and all -pages it links to: - -[[linkmap pages="index or (backlink(index) and !*.png)"]] +[[!linkmap pages="index or (backlink(index) and !*.png)"]] +"""]]