xref: /plugin/newpagefill/README_DE.md (revision 9a36670832b754c53fa81850c7b00d5bb57a3705)
1*9a366708SLORTET# Newpagefill
2*9a366708SLORTET
3*9a366708SLORTET[���� Français](README.md) | [���� English](README_EN.md) | ���� Deutsch | [���� Español](README_ES.md)
4*9a366708SLORTET
5*9a366708SLORTETDas Plugin kann:
6*9a366708SLORTET- einen kleinen Dialog zur Seitenerstellung mit Titel und Bezeichner öffnen;
7*9a366708SLORTET- automatisch einen Bezeichner aus dem Titel vorschlagen;
8*9a366708SLORTET- die neue Seite mit einer Plugin-Vorlage vorfüllen, wenn keine native Vorlage vorhanden ist;
9*9a366708SLORTET- native DokuWiki-Vorlagen um `@TITLE@` erweitern.
10*9a366708SLORTET
11*9a366708SLORTET## Verwendung
12*9a366708SLORTET
13*9a366708SLORTETDas Plugin fügt einen vereinfachten Workflow zur Seitenerstellung hinzu:
14*9a366708SLORTET- einen Titel eingeben;
15*9a366708SLORTET- optional einen Namensraum eingeben, wenn keiner übergeben wurde;
16*9a366708SLORTET- das Plugin schlägt einen Bezeichner vor;
17*9a366708SLORTET- der Editor wird direkt auf der neuen Seite geöffnet.
18*9a366708SLORTET
19*9a366708SLORTETWenn eine native DokuWiki-Vorlage vorhanden ist (`_template.txt` oder `__template.txt`), wird diese verwendet.
20*9a366708SLORTETAndernfalls wendet das Plugin seine eigene konfigurierte Ersatzvorlage an.
21*9a366708SLORTET
22*9a366708SLORTET## Konfiguration
23*9a366708SLORTET
24*9a366708SLORTETIm Konfigurationsmanager:
25*9a366708SLORTET- `template`: Ersatzvorlage, die nur verwendet wird, wenn keine native DokuWiki-Seitenvorlage gefunden wird;
26*9a366708SLORTET- `default_start_mode`: Standard-Erstellungsmodus (`ask`, `start`, `none`, `same`).
27*9a366708SLORTET
28*9a366708SLORTETDiese Vorlage kann enthalten:
29*9a366708SLORTET- `@TITLE@`: vom Plugin berechneter Titel (spezifisch für newpagefill);
30*9a366708SLORTET- alle nativen DokuWiki-Platzhalter: `@ID@`, `@NS@`, `@PAGE@`, `@USER@`, `@DATE@` usw. (vom DokuWiki-Core verwaltet, nicht von diesem Plugin).
31*9a366708SLORTET
32*9a366708SLORTET## Verhalten von `@TITLE@`
33*9a366708SLORTET
34*9a366708SLORTETDas Plugin füllt `@TITLE@` wie folgt:
35*9a366708SLORTET- zuerst wird der `title`-Wert verwendet, sofern vorhanden;
36*9a366708SLORTET- andernfalls versucht es, den Titel aus der Erstellungs-URL zu extrahieren;
37*9a366708SLORTET- wenn die erstellte Seite eine Startseite ist (z. B. `start`), wird der Name des übergeordneten Namensraums verwendet;
38*9a366708SLORTET- `_`-Zeichen werden in Leerzeichen umgewandelt.
39*9a366708SLORTET
40*9a366708SLORTET## DokuWiki-Vorlagenkompatibilität
41*9a366708SLORTET
42*9a366708SLORTETDas Plugin respektiert das native Vorlagensystem:
43*9a366708SLORTET- `_template.txt`
44*9a366708SLORTET- `__template.txt`
45*9a366708SLORTET
46*9a366708SLORTETEs ersetzt es nicht.
47*9a366708SLORTETEs fügt lediglich Unterstützung für `@TITLE@` hinzu — native DokuWiki-Platzhalter (`@ID@`, `@NS@` usw.) werden danach vom Core verarbeitet.
48*9a366708SLORTET
49*9a366708SLORTET## Verfügbare JavaScript-Funktion
50*9a366708SLORTET
51*9a366708SLORTETDas Plugin stellt auch eine globale JavaScript-Funktion bereit:
52*9a366708SLORTET
53*9a366708SLORTET```js
54*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog(options)
55*9a366708SLORTET```
56*9a366708SLORTET
57*9a366708SLORTETBeispiel:
58*9a366708SLORTET
59*9a366708SLORTET```js
60*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog({
61*9a366708SLORTET  namespace: 'wiki:dokumentation',
62*9a366708SLORTET  initialTitle: 'Neue Seite'
63*9a366708SLORTET});
64*9a366708SLORTET```
65*9a366708SLORTET
66*9a366708SLORTETNützliche Optionen:
67*9a366708SLORTET- `namespace`: DokuWiki-Namensraum, in dem die Seite erstellt wird. Wenn nicht angegeben, kann er im Dialog eingegeben werden;
68*9a366708SLORTET- `initialTitle`: beim Öffnen vorausgefüllter Titel;
69*9a366708SLORTET- `start`:
70*9a366708SLORTET  - `undefined` oder `null`: den im Plugin konfigurierten Standardmodus verwenden;
71*9a366708SLORTET  - `'@ask@'`: Moduswahl erzwingen, auch wenn ein Standardmodus existiert;
72*9a366708SLORTET  - `true`: die Wiki-Startseite verwenden, z. B. `start`;
73*9a366708SLORTET  - `false`: die Seite direkt erstellen;
74*9a366708SLORTET  - `'@same@'`: eine Unterseite mit demselben Namen wie der Bezeichner erstellen;
75*9a366708SLORTET  - jede andere Zeichenkette: eine Unterseite mit diesem Wert erstellen;
76*9a366708SLORTET- `sepchar`: Trennzeichen zur Erzeugung des Bezeichners.
77*9a366708SLORTET
78*9a366708SLORTETWenn `start` nicht angegeben ist und `default_start_mode = ask`, zeigt der Dialog drei Optionen:
79*9a366708SLORTET- direkte Seite;
80*9a366708SLORTET- Startseite;
81*9a366708SLORTET- Unterseite mit gleichem Namen.
82