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