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