xref: /plugin/visualindex/README_DE.md (revision 7f5290b8d6d83542fd5b939a9c568e40224c0ec8)
1*7f5290b8SLORTET# Visualindex
2*7f5290b8SLORTET
3*7f5290b8SLORTET���� [Français](README) | ���� [English](README_EN) | **���� Deutsch** | ���� [Español](README_ES)
4*7f5290b8SLORTET
5*7f5290b8SLORTET---
6*7f5290b8SLORTET
7*7f5290b8SLORTETDas Plugin **visualindex** zeigt einen visuellen Index der Seiten (oder Mediendateien) eines DokuWiki-Namespace.
8*7f5290b8SLORTET
9*7f5290b8SLORTETEs ist kompatibel mit:
10*7f5290b8SLORTET- dem klassischen Editor;
11*7f5290b8SLORTET- ProseMirror.
12*7f5290b8SLORTET
13*7f5290b8SLORTET## Funktionsweise
14*7f5290b8SLORTET
15*7f5290b8SLORTETDas Plugin liest einen Namespace, erstellt eine Liste lesbarer Elemente und zeigt Kacheln mit:
16*7f5290b8SLORTET- einem Bild;
17*7f5290b8SLORTET- einem Titel;
18*7f5290b8SLORTET- einem Link zur Seite oder Mediendatei.
19*7f5290b8SLORTET
20*7f5290b8SLORTETWenn keine Elemente verfügbar sind, wird eine übersetzte Meldung angezeigt.
21*7f5290b8SLORTET
22*7f5290b8SLORTET## Syntax
23*7f5290b8SLORTET
24*7f5290b8SLORTETGrundsyntax:
25*7f5290b8SLORTET
26*7f5290b8SLORTET```txt
27*7f5290b8SLORTET{{visualindex>namespace}}
28*7f5290b8SLORTET```
29*7f5290b8SLORTET
30*7f5290b8SLORTETNützliche Beispiele:
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*7f5290b8SLORTETUnterstützte Optionen:
42*7f5290b8SLORTET- `filter`: einfacher Filter mit `*` (z. B. `guide*|doc*`);
43*7f5290b8SLORTET- `desc`: absteigende Reihenfolge (`1` / `true`);
44*7f5290b8SLORTET- `medias`: Medien des Namespace anzeigen (`1` / `true`).
45*7f5290b8SLORTET
46*7f5290b8SLORTETBesondere Namespace-Werte:
47*7f5290b8SLORTET- `.`: aktueller Namespace;
48*7f5290b8SLORTET- `~sub:ordner`: Namespace relativ zum aktuellen Namespace.
49*7f5290b8SLORTET
50*7f5290b8SLORTET## Konfigurationsparameter
51*7f5290b8SLORTET
52*7f5290b8SLORTETIm Konfigurationsmanager:
53*7f5290b8SLORTET
54*7f5290b8SLORTET- `icon_size`: Symbolgröße (z. B. `100px`);
55*7f5290b8SLORTET- `text_size`: Textgröße (z. B. `13px`);
56*7f5290b8SLORTET- `text_color`: Textfarbe (hex, rgb/rgba oder CSS-Farbnamen);
57*7f5290b8SLORTET- `skip_file`: regulärer Ausdruck für zu ignorierende Seiten;
58*7f5290b8SLORTET- `show_in_editor_menu`: Visualindex in den Editor-Menüs anzeigen (klassisch und ProseMirror);
59*7f5290b8SLORTET- `use_pagesicon`: den `pagesicon`-Helfer verwenden, wenn verfügbar;
60*7f5290b8SLORTET- `default_image`: Standardbild (Medien-ID, z. B. `wiki:logo.png`); wenn leer, wird das interne Plugin-Bild verwendet.
61*7f5290b8SLORTET
62*7f5290b8SLORTET## Integration mit pagesicon
63*7f5290b8SLORTET
64*7f5290b8SLORTETWenn das Plugin `pagesicon` vorhanden und über `use_pagesicon` aktiviert ist:
65*7f5290b8SLORTET- Visualindex ruft Seitensymbole über den Helfer ab;
66*7f5290b8SLORTET- Visualindex ruft auch Mediensymbole ab;
67*7f5290b8SLORTET- wenn kein Symbol gefunden wird, wird der Standard-Fallback verwendet.
68*7f5290b8SLORTET
69*7f5290b8SLORTETFallback-Reihenfolge:
70*7f5290b8SLORTET1. Symbol von `pagesicon`;
71*7f5290b8SLORTET2. Visualindex `default_image`;
72*7f5290b8SLORTET3. internes Plugin-Bild (`images/default_image.png`).
73*7f5290b8SLORTET
74*7f5290b8SLORTET## ProseMirror
75*7f5290b8SLORTET
76*7f5290b8SLORTETDas Plugin stellt eine `Visualindex`-Schaltfläche in ProseMirror bereit (wenn `show_in_editor_menu` aktiviert ist) mit einem Konfigurations-Popup.
77*7f5290b8SLORTET
78*7f5290b8SLORTETDas Popup ermöglicht die Konfiguration von:
79*7f5290b8SLORTET- Namespace;
80*7f5290b8SLORTET- Filter;
81*7f5290b8SLORTET- absteigende Reihenfolge;
82*7f5290b8SLORTET- Medienanzeige.
83