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