1# CatMenu 2 3`catmenu` muestra un menú en árbol (páginas + subcarpetas) para un namespace de DokuWiki. 4 5## Sintaxis 6 7```text 8{{catmenu>namespace}} 9``` 10 11Ejemplos: 12 13```text 14{{catmenu>.}} 15{{catmenu>wiki}} 16{{catmenu>docs:proyecto}} 17``` 18 19- `.`: utiliza el namespace actual. 20- `namespace`: utiliza el namespace indicado. 21 22## Comportamiento 23 24- lista las páginas y subcarpetas legibles por el usuario actual. 25- abre automáticamente la rama correspondiente a la página actual. 26- gestiona las páginas de inicio de namespace (`$conf['start']`). 27- oculta las páginas sin título H1 cuando `skip_page_without_title` está activado. 28 29## Configuración 30 31En el Gestor de Configuración: 32 33- `skip_file`: expresión regular para ignorar IDs de páginas. También acepta el valor especial `@hidepages` para reutilizar automáticamente el parámetro `hidepages` de DokuWiki. 34- `skip_page_without_title`: ignorar páginas sin título H1. 35- `show_in_editor_menu`: mostrar el botón de inserción en el editor. 36- `context_menu_items`: casillas de verificación para elegir las acciones disponibles en el menú contextual (clic derecho). Todas activadas por defecto. 37- `footer_content`: marcado DokuWiki multilínea insertado al final de cada menú (enlaces, notas, etc.). Vacío por defecto. 38 39## Compatibilidad 40 41- Compatible con el plugin [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror). 42- `catmenu` usa [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) para mostrar iconos cuando está disponible. La acción "Gestionar icono" en el menú contextual solo aparece si pagesicon está instalado. 43- Compatible con el plugin `newpagefill` para la creación de páginas. Cuando está disponible, `catmenu` usa su asistente de creación. 44 45## Menú contextual 46 47Clic derecho sobre un elemento (cada acción es configurable individualmente): 48 49- crear una nueva página (según permisos), 50- recargar la caché (`purge=true`), 51- abrir el gestor de archivos multimedia, 52- abrir la gestión de iconos (`pagesicon`) si está disponible, 53- copiar la URL. 54 55## Permisos 56 57El renderizado sigue las reglas ACL de DokuWiki: 58 59- se requiere permiso de lectura para mostrar un elemento, 60- las acciones contextuales están limitadas según los permisos (create/edit/upload). 61