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