xref: /plugin/catmenu/README_ES (revision 339ba49c4f5b2a42161c07b899707ee1625d260f)
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