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