1# Visualindex 2 3���� [Français](README) | ���� [English](README_EN) | ���� [Deutsch](README_DE) | **���� Español** 4 5--- 6 7El plugin **visualindex** muestra un índice visual de páginas (o archivos de medios) de un namespace de DokuWiki. 8 9Es compatible con: 10- el editor clásico; 11- ProseMirror. 12 13## Funcionamiento 14 15El plugin lee un namespace, construye una lista de elementos accesibles para lectura y muestra fichas con: 16- una imagen; 17- un título; 18- un enlace a la página o al archivo de medios. 19 20Si no hay elementos disponibles, se muestra un mensaje traducido. 21 22## Sintaxis 23 24Sintaxis básica: 25 26```txt 27{{visualindex>namespace}} 28``` 29 30Ejemplos útiles: 31 32```txt 33{{visualindex>.}} 34{{visualindex>wiki}} 35{{visualindex>wiki;filter=start|syntax*}} 36{{visualindex>wiki;desc=1}} 37{{visualindex>wiki;medias=1}} 38{{visualindex>.;filter=guide*;desc=1;medias=1}} 39``` 40 41Opciones admitidas: 42- `filter`: filtro simple con `*` (ej. `guide*|doc*`); 43- `desc`: orden descendente (`1` / `true`); 44- `medias`: mostrar medios del namespace (`1` / `true`). 45 46Valores de namespace especiales: 47- `.`: namespace actual; 48- `~sub:carpeta`: namespace relativo al namespace actual. 49 50## Parámetros de configuración 51 52En el gestor de configuración: 53 54- `icon_size`: tamaño del icono (ej. `100px`); 55- `text_size`: tamaño del texto (ej. `13px`); 56- `text_color`: color del texto (hex, rgb/rgba o nombre CSS); 57- `skip_file`: expresión regular para páginas a ignorar; 58- `show_in_editor_menu`: mostrar Visualindex en los menús del editor (clásico y ProseMirror); 59- `use_pagesicon`: usar el helper `pagesicon` cuando esté disponible; 60- `default_image`: imagen predeterminada (ID de medio, ej. `wiki:logo.png`); si está vacío, se usa la imagen interna del plugin. 61 62## Integración con pagesicon 63 64Si el plugin `pagesicon` está presente y activado mediante `use_pagesicon`: 65- Visualindex obtiene los iconos de páginas a través del helper; 66- Visualindex también obtiene los iconos de medios; 67- si no se encuentra ningún icono, se usa el fallback predeterminado. 68 69Orden de fallback: 701. icono proporcionado por `pagesicon`; 712. `default_image` de Visualindex; 723. imagen interna del plugin (`images/default_image.png`). 73 74## ProseMirror 75 76El plugin expone un botón `Visualindex` en ProseMirror (cuando `show_in_editor_menu` está activado) con un popup de configuración. 77 78El popup permite configurar: 79- namespace; 80- filtro; 81- orden descendente; 82- visualización de medios. 83
