本站使用帮助:simplenavi

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
本站使用帮助:simplenavi [2024/11/17 13:27] – 移除 - 外部编辑 (未知日期) 127.0.0.1本站使用帮助:simplenavi [2024/11/17 13:27] (当前版本) – 外部编辑 127.0.0.1
行 1: 行 1:
 +====== simplenavi Plugin ======
  
 +---- plugin ----
 +description: Create a simple navigation tree based on namespaces
 +author     : Andreas Gohr 
 +email      : dokuwiki@cosmocode.de 
 +type       : syntax
 +lastupdate : 2023-11-13
 +compatible : !Frusterick Manners, !Greebo, !Hogfather, Igor, Jack Jackrum
 +depends    : 
 +conflicts 
 +similar    : navi, indexmenu
 +tags       : navigation, menu
 +
 +downloadurl: https://github.com/cosmocode/simplenavi/zipball/master
 +bugtracker : https://github.com/cosmocode/simplenavi/issues
 +sourcerepo : https://github.com/cosmocode/simplenavi/
 +donationurl: 
 +----
 +
 +This plugin creates a tree of links based on the wiki's namespace structure and is intended to be used in the [[faq:sidebar]] of any template. It looks similar to the [[:index|Page Index]] but with [[:namespaces]] linking directly to their respective start pages. The tree is opened based on the currently opened page.
 +
 +The plugin honors [[:ACLs]] and [[config:hidepages]] settings.
 +
 +
 +
 +===== Download and Installation =====
 +
 +[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
 +
 +Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 +
 +===== Syntax and Usage =====
 +
 +Use the following code to embed the navigation in your [[faq:sidebar|sidebar]] page:
 +
 +  {{simplenavi>}}
 +
 +You can optionally give a namespace at which the navigation tree should start (e.g. useful for building different navigations for different language namespaces):
 +
 +  {{simplenavi>ns1:ns2}}
 +  
 +Example:
 +
 +  {{simplenavi>animals:insects}}
 +
 +Additional options can be given separated by spaces.
 +
 +  {{simplenavi>animals:insects filter}}
 +
 +The ''filter'' option will add a text input field which allows for filtering the top level of the tree.
 +
 +  {{simplenavi>animals:insects home}}
 +
 +The ''home'' option will wrap all found content under the start page of the given name space. Useful when composing menus from different simplenavi calls.
 +
 +===== Configuration =====
 +
 +Use the DokuWiki [[config|configuration manager]] to change the behaviour of the plugin.
 +
 +
 +  * ''natsort'' - Use natural sorting instead of simple string comparisons. There is probably no reason to disable this.
 +  * ''nsfirst'' - Sort namespaces before pages. When disabled, namespaces are sorted among pages based on their names.
 +  * ''usetitle'' - When enabled, sorting happens based on page titles instead of page IDs. When enabled, output will also use page titles in the resulting links. Note: this behavior is now independent of the [[config:useheading]] option.
 +
 +
 +===== Development =====
 +
 +A public git repository is available at [[https://github.com/cosmocode/simplenavi]]
 +
 +==== Changelog ====
 +
 +{{rss>https://github.com/cosmocode/simplenavi/commits/master.atom date}}
 +
 +==== Bugs and feature request ====
 +
 +Please report issues in the bug tracker at [[https://github.com/cosmocode/simplenavi/issues]]
 +
 +
 +----
 +
 +[[本站使用帮助:start|返回本站使用帮助]]