1# CatMenu 2 3`catmenu` displays a tree menu (pages + subfolders) for a DokuWiki namespace. 4 5## Syntax 6 7```text 8{{catmenu>namespace}} 9``` 10 11Examples: 12 13```text 14{{catmenu>.}} 15{{catmenu>wiki}} 16{{catmenu>docs:projet}} 17``` 18 19- `.`: uses the current namespace. 20- `namespace`: uses the specified namespace. 21 22## Behavior 23 24- lists pages and subfolders readable by the current user. 25- automatically opens the branch matching the current page. 26- handles namespace start pages (`$conf['start']`). 27- hides pages without an H1 title when `skip_page_without_title` is enabled. 28 29## Configuration 30 31In the Configuration Manager: 32 33- `skip_file`: regex used to ignore matching page IDs. 34- `skip_page_without_title`: ignore pages without H1. 35- `show_in_editor_menu`: show the insert button in the editor. 36 37## Compatibility 38 39- Compatible with [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror). 40- `catmenu` uses [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) to display icons when `pagesicon` is available. 41 42## Context Menu 43 44Right-click on an item to: 45 46- create a new page (depending on permissions), 47- reload cache (`purge=true`), 48- open the media manager, 49- open icon management (`pagesicon`) when available, 50- copy the URL. 51 52## Permissions 53 54Rendering follows DokuWiki ACL rules: 55 56- read permission is required to show an item, 57- context actions are limited by permissions (create/edit/upload). 58