xref: /plugin/newpagefill/DOKU_DE (revision 3f49ec0b89e8372432e2ec033eb734cb870eea56)
1====== Newpagefill Plugin ======
2
3---- plugin ----
4description: Seitenerstellungs-Assistent mit Vorfüllung und @TITLE@-Unterstützung
5author     : Valentin LORTET
6email      : contact@valentinlortet.fr
7type       : Action
8lastupdate : 2026-03-13
9compatible : Librarian
10depends    :
11conflicts  :
12similar    :
13tags       : Page, Creation, Template, Namespace, JavaScript
14
15downloadurl: https://github.com/Lortet/dokuwiki-plugin-newpagefill/zipball/master
16bugtracker : https://github.com/Lortet/dokuwiki-plugin-newpagefill/issues
17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-newpagefill/
18donationurl:
19screenshot_img :
20----
21
22[[fr:plugin:newpagefill|���� Français]] | [[plugin:newpagefill|���� English]] | ���� **Deutsch** | [[es:plugin:newpagefill|���� Español]]
23
24===== Installation =====
25
26Das Plugin über den [[plugin:extension|Erweiterungs-Manager]] installieren.
27
28===== Beschreibung =====
29
30Das Plugin **newpagefill** fügt einen leichtgewichtigen Assistenten zur Seitenerstellung hinzu:
31  * Titel eingeben;
32  * Bezeichner automatisch vorschlagen;
33  * optional den Namensraum eingeben;
34  * Erstellungsmodus gemäß Konfiguration wählen;
35  * Editor direkt auf der Zielseite öffnen.
36
37Es ergänzt auch das native DokuWiki-Vorlagensystem:
38  * ''_template.txt'' oder ''%%__template.txt%%'' verwenden, wenn vorhanden;
39  * Unterstützung für den Platzhalter ''@TITLE@'' im injizierten Inhalt hinzufügen;
40  * auf eine plugin-eigene Vorlage zurückfallen, wenn keine native Vorlage vorhanden ist.
41
42===== Konfiguration =====
43
44^ Name ^ Beschreibung ^ Standardwert ^
45| template | Ersatzvorlage, die verwendet wird, wenn keine native DokuWiki-Seitenvorlage gefunden wird. | ''===== @TITLE@ ====='' |
46| default_start_mode | Standard-Erstellungsmodus. | ''start'' |
47
48Mögliche Werte für ''default_start_mode'':
49  * ''ask'': Auswahl im Dialog anzeigen;
50  * ''start'': Startseite erstellen;
51  * ''none'': direkte Seite erstellen;
52  * ''same'': Unterseite mit gleichem Namen erstellen.
53
54===== Platzhalter =====
55
56Die Plugin-Vorlage kann enthalten:
57  * ''@TITLE@'': vom Plugin berechneter Titel (spezifisch für newpagefill);
58  * alle nativen DokuWiki-Platzhalter: ''@ID@'', ''@NS@'', ''@PAGE@'', ''@USER@'', ''@DATE@'' usw. (vom DokuWiki-Core verwaltet, nicht von diesem Plugin).
59
60===== Verhalten von @TITLE@ =====
61
62Der Wert von ''@TITLE@'' wird wie folgt berechnet:
63  * der ''title''-Wert der Anfrage hat Vorrang;
64  * andernfalls versucht das Plugin, einen Titel aus der Erstellungs-URL zu extrahieren;
65  * wenn die erstellte Seite die Startseite des Namensraums ist, wird der Name des übergeordneten Namensraums verwendet;
66  * ''_''-Zeichen werden durch Leerzeichen ersetzt.
67
68===== Vorlagenkompatibilität =====
69
70Das Plugin folgt dieser Reihenfolge:
71  * bereits von DokuWiki bereitgestellte Vorlage;
72  * ''_template.txt'' im Zielordner;
73  * %%__template.txt%% im aktuellen oder übergeordneten Namensraum;
74  * im Plugin konfigurierte Ersatzvorlage.
75
76===== JavaScript-Funktion =====
77
78Das Plugin stellt die globale Funktion bereit:
79
80<code javascript>
81window.NewPageFill.openCreatePageDialog(options)
82</code>
83
84Beispiel:
85
86<code javascript>
87window.NewPageFill.openCreatePageDialog({
88  namespace: 'wiki:dokumentation',
89  initialTitle: 'Neue Seite'
90});
91</code>
92
93Nützliche Optionen:
94  * ''namespace'': Ziel-Namensraum in DokuWiki;
95  * ''initialTitle'': vorausgefüllter Titel;
96  * ''start'':
97    * ''undefined'' oder ''null'': Plugin-Konfiguration verwenden;
98    * ''@ask@'': Moduswahl erzwingen;
99    * ''true'': Wiki-Startseite verwenden;
100    * ''false'': Seite direkt erstellen;
101    * ''@same@'': Unterseite mit demselben Namen wie der Bezeichner erstellen;
102    * jede andere Zeichenkette: Unterseite mit diesem Wert erstellen;
103  * ''sepchar'': Trennzeichen zur Erzeugung des Bezeichners.
104
105Wenn ''start'' nicht angegeben ist und ''default_start_mode = ask'', bietet der Dialog:
106  * direkte Seite;
107  * Startseite;
108  * Unterseite mit gleichem Namen.
109