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