1# CatMenu 2 3`catmenu` zeigt ein Baummenü (Seiten + Unterordner) für einen DokuWiki-Namespace an. 4 5## Syntax 6 7```text 8{{catmenu>namespace}} 9``` 10 11Beispiele: 12 13```text 14{{catmenu>.}} 15{{catmenu>wiki}} 16{{catmenu>docs:projekt}} 17``` 18 19- `.`: verwendet den aktuellen Namespace. 20- `namespace`: verwendet den angegebenen Namespace. 21 22## Verhalten 23 24- listet alle für den aktuellen Benutzer lesbaren Seiten und Unterordner. 25- öffnet automatisch den Ast, der zur aktuellen Seite gehört. 26- verarbeitet Namespace-Startseiten (`$conf['start']`). 27- blendet Seiten ohne H1-Titel aus, wenn `skip_page_without_title` aktiviert ist. 28 29## Konfiguration 30 31Im Konfigurationsmanager: 32 33- `skip_file`: regulärer Ausdruck zum Ignorieren von Seiten-IDs. Akzeptiert auch den Sonderwert `@hidepages`, um die globale DokuWiki-Einstellung `hidepages` automatisch zu übernehmen. 34- `skip_page_without_title`: Seiten ohne H1-Titel ausblenden. 35- `show_in_editor_menu`: Einfüge-Schaltfläche im Editor anzeigen. 36- `context_menu_items`: Kontrollkästchen zur Auswahl der Aktionen im Kontextmenü (Rechtsklick). Standardmäßig alle aktiviert. 37- `footer_content`: mehrzeiliges DokuWiki-Markup, das am Ende jedes Menüs eingefügt wird (Links, Hinweise usw.). Standardmäßig leer. 38 39## Kompatibilität 40 41- Kompatibel mit dem Plugin [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror). 42- `catmenu` verwendet [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) zur Anzeige von Symbolen, wenn das Plugin verfügbar ist. Die Aktion „Symbol verwalten" im Kontextmenü erscheint nur, wenn pagesicon installiert ist. 43- Kompatibel mit dem Plugin `newpagefill` zur Seitenerstellung. Wenn vorhanden, verwendet `catmenu` dessen Erstellungsassistenten. 44 45## Kontextmenü 46 47Rechtsklick auf einen Eintrag (jede Aktion ist individuell konfigurierbar): 48 49- neue Seite erstellen (je nach Berechtigungen), 50- Cache neu laden (`purge=true`), 51- Medien-Manager öffnen, 52- Symbol-Verwaltung öffnen (`pagesicon`), wenn verfügbar, 53- URL kopieren. 54 55## Berechtigungen 56 57Die Darstellung folgt den DokuWiki-ACL-Regeln: 58 59- Leseberechtigung ist erforderlich, um einen Eintrag anzuzeigen, 60- Kontextaktionen sind je nach Berechtigung eingeschränkt (create/edit/upload). 61