1====== Visualindex Plugin ====== 2 3---- plugin ---- 4description: Muestra un índice visual 5author : Valentin LORTET, Gabriel CHOIMET 6email : contact@valentinlortet.fr 7type : Syntax, Action 8lastupdate : 2026-03-09 9compatible : Librarian 10depends : 11conflicts : 12similar : 13tags : Navigation, Index, Media, ProseMirror, pagesicon 14 15downloadurl: https://github.com/Lortet/dokuwiki-plugin-visualindex/zipball/master 16bugtracker : https://github.com/Lortet/dokuwiki-plugin-visualindex/issues 17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-visualindex/ 18donationurl: 19screenshot_img : 20---- 21 22[[fr:plugin:visualindex|���� Français]] | [[plugin:visualindex|���� English]] | [[de:plugin:visualindex|���� Deutsch]] | **���� Español** 23 24===== Instalación ===== 25 26Instalar el plugin desde el [[plugin:extension|Gestor de extensiones]]. 27 28===== Descripción ===== 29 30El plugin **visualindex** muestra un índice visual de las páginas (o archivos de medios) de un namespace de DokuWiki. 31 32Es compatible con: 33 * el editor clásico; 34 * [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]]. 35 36===== Sintaxis ===== 37 38Sintaxis básica: 39 * ''%%{{visualindex>namespace}}%%'' 40 41Ejemplos: 42 * ''%%{{visualindex>.}}%%'' 43 * ''%%{{visualindex>wiki}}%%'' 44 * ''%%{{visualindex>wiki;filter=start|syntax*}}%%'' 45 * ''%%{{visualindex>wiki;desc=1}}%%'' 46 * ''%%{{visualindex>wiki;medias=1}}%%'' 47 * ''%%{{visualindex>.;filter=guide*;desc=1;medias=1}}%%'' 48 49Opciones: 50 * ''filter'' : filtro simple con ''*'' (ejemplo: ''guide*|doc*''); 51 * ''desc'' : orden descendente (''1'' / ''true''); 52 * ''medias'' : listar medios del namespace (''1'' / ''true''). 53 54Namespace especial: 55 * ''.'' : namespace actual; 56 * ''~sub:carpeta'' : namespace relativo al namespace actual. 57 58===== Configuración ===== 59 60^ Nombre ^ Descripción ^ Valor predeterminado ^ 61| icon_size | Tamaño del icono (ej. ''100px''). | ''100px'' | 62| text_size | Tamaño del texto (ej. ''13px''). | ''13px'' | 63| text_color | Color del texto (hex, rgb/rgba o nombre CSS). | ''black'' | 64| skip_file | Regex de páginas a ignorar. | '''' | 65| show_in_editor_menu | Mostrar Visualindex en los menús del editor (clásico y ProseMirror). | ''true'' | 66| use_pagesicon | Usar el helper ''pagesicon'' cuando esté disponible. | ''true'' | 67| default_image | Imagen predeterminada (ID de medio), ej. ''wiki:logo.png''. | '''' | 68 69===== Integración con pagesicon ===== 70 71Si [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] está instalado y ''use_pagesicon'' activado: 72 * Visualindex resuelve los iconos de páginas; 73 * Visualindex resuelve los iconos de medios; 74 * se usa el fallback si no se encuentra ningún icono. 75 76Orden de fallback: 77 * icono proporcionado por ''pagesicon''; 78 * ''default_image'' de Visualindex; 79 * imagen interna del plugin (''images/default_image.png''). 80 81===== ProseMirror ===== 82 83El plugin expone un botón ''Visualindex'' en ProseMirror (cuando ''show_in_editor_menu'' está activado) con un popup de configuración: 84 * namespace; 85 * filtro; 86 * orden descendente; 87 * visualización de medios. 88 89===== Archivos principales ===== 90 91 * ''syntax/visualindex.php'' : análisis y renderizado XHTML; 92 * ''action/prosemirror.php'' : integración del editor; 93 * ''script/prosemirror.js'' : nodo ProseMirror; 94 * ''script/toolbar.js'' : botón y popup; 95 * ''style.css'' : estilos de visualización. 96
