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