README.md
1# Newpagefill
2
3���� Français | [���� English](README_EN.md) | [���� Deutsch](README_DE.md) | [���� Español](README_ES.md)
4
5Le plugin peut :
6- ouvrir une petite popup de création avec un titre et un identifiant ;
7- proposer automatiquement un identifiant à partir du titre ;
8- préremplir la page avec un template du plugin si aucun template natif n'existe ;
9- enrichir les templates natifs DokuWiki avec `@TITLE@`.
10
11## Utilisation
12
13Le plugin ajoute une interface de création de page plus simple :
14- vous saisissez un titre ;
15- vous pouvez aussi saisir un namespace si aucun namespace n'est fourni au script ;
16- le plugin propose un identifiant ;
17- il ouvre ensuite directement l'éditeur de la nouvelle page.
18
19Si un template natif DokuWiki existe (`_template.txt` ou `__template.txt`), il est utilisé.
20Sinon, le plugin applique son propre template configuré.
21
22## Configuration
23
24Dans le gestionnaire de configuration :
25- `template` : template de secours utilisé seulement si aucun template natif DokuWiki n'est trouvé
26- `default_start_mode` : mode par défaut de création de la page (`ask`, `start`, `none`, `same`)
27
28Ce template peut contenir :
29- `@TITLE@` : titre calculé par le plugin (spécifique à newpagefill)
30- tous les placeholders natifs DokuWiki : `@ID@`, `@NS@`, `@PAGE@`, `@USER@`, `@DATE@`, etc. (gérés par le core, pas par ce plugin)
31
32## Comportement de `@TITLE@`
33
34Le plugin remplit `@TITLE@` ainsi :
35- il prend d'abord la valeur `title` si elle existe ;
36- sinon, il essaie de la déduire depuis l'URL de création ;
37- si la page créée est une page de démarrage comme `accueil`, il utilise le nom du namespace parent ;
38- les `_` sont transformés en espaces.
39
40## Compatibilité avec DokuWiki
41
42Le plugin respecte le système natif de templates :
43- `_template.txt`
44- `__template.txt`
45
46Il ne le remplace pas.
47Il ajoute seulement le support de `@TITLE@` — les placeholders natifs DokuWiki (`@ID@`, `@NS@`, etc.) sont gérés par le core après coup.
48
49## Fonction JavaScript disponible
50
51Le plugin expose aussi une fonction JavaScript globale :
52
53```js
54window.NewPageFill.openCreatePageDialog(options)
55```
56
57Exemple :
58
59```js
60window.NewPageFill.openCreatePageDialog({
61 namespace: 'wiki:documentation',
62 initialTitle: 'Nouvelle page'
63});
64```
65
66Options utiles :
67- `namespace` : namespace DokuWiki dans lequel créer la page. S'il n'est pas fourni, la popup permet de le saisir
68- `initialTitle` : titre proposé à l'ouverture
69- `start` :
70 - `undefined` ou `null` : utilise le mode par défaut configuré dans le plugin
71 - `'@ask@'` : demande le type de création même si un mode par défaut existe
72 - `true` : utilise la page de démarrage du wiki, par exemple `accueil`
73 - `false` : crée la page directement
74 - `'@same@'` : crée une sous-page portant le même nom que l'identifiant
75 - toute autre chaîne : crée une sous-page avec cette valeur
76- `sepchar` : séparateur utilisé pour générer l'identifiant
77
78Si `start` n'est pas fourni et que `default_start_mode = ask`, la popup affiche les trois choix :
79- page directe
80- page de démarrage
81- sous-page du même nom
82
README_DE.md
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
README_EN.md
1# Newpagefill
2
3[���� Français](README.md) | ���� English | [���� Deutsch](README_DE.md) | [���� Español](README_ES.md)
4
5The plugin can:
6- open a small page creation dialog with a title and page ID;
7- automatically suggest a page ID from the title;
8- prefill the new page with a plugin template if no native template exists;
9- extend native DokuWiki templates with `@TITLE@`.
10
11## Usage
12
13The plugin adds a simpler page creation flow:
14- enter a title;
15- optionally enter a namespace if none was provided by the caller;
16- the plugin suggests a page ID;
17- it then opens the editor for the new page directly.
18
19If a native DokuWiki template exists (`_template.txt` or `__template.txt`), it is used.
20Otherwise, the plugin applies its own configured fallback template.
21
22## Configuration
23
24In the configuration manager:
25- `template`: fallback template used only when no native DokuWiki page template is found;
26- `default_start_mode`: default page creation mode (`ask`, `start`, `none`, `same`).
27
28This template may contain:
29- `@TITLE@`: title computed by the plugin (specific to newpagefill);
30- all native DokuWiki placeholders: `@ID@`, `@NS@`, `@PAGE@`, `@USER@`, `@DATE@`, etc. (handled by DokuWiki core, not by this plugin).
31
32## `@TITLE@` behavior
33
34The plugin fills `@TITLE@` as follows:
35- it first uses the `title` value if it exists;
36- otherwise, it tries to extract it from the creation URL;
37- if the created page is a start page such as `start`, it uses the parent namespace name;
38- `_` characters are converted to spaces.
39
40## DokuWiki template compatibility
41
42The plugin respects the native template system:
43- `_template.txt`
44- `__template.txt`
45
46It does not replace it.
47It only adds support for `@TITLE@` — native DokuWiki placeholders (`@ID@`, `@NS@`, etc.) are handled by the core afterward.
48
49## Available JavaScript function
50
51The plugin also exposes a global JavaScript function:
52
53```js
54window.NewPageFill.openCreatePageDialog(options)
55```
56
57Example:
58
59```js
60window.NewPageFill.openCreatePageDialog({
61 namespace: 'wiki:documentation',
62 initialTitle: 'New page'
63});
64```
65
66Useful options:
67- `namespace`: DokuWiki namespace where the page will be created. If not provided, the dialog lets the user enter it;
68- `initialTitle`: title prefilled when opening the dialog;
69- `start`:
70 - `undefined` or `null`: use the default mode configured in the plugin;
71 - `'@ask@'`: ask for the creation type even if a default mode exists;
72 - `true`: use the wiki start page, for example `start`;
73 - `false`: create the page directly;
74 - `'@same@'`: create a subpage with the same name as the page ID;
75 - any other string: create a subpage with that value;
76- `sepchar`: separator used to generate the page ID.
77
78If `start` is not provided and `default_start_mode = ask`, the dialog shows three choices:
79- direct page;
80- start page;
81- subpage with the same name.
82
README_ES.md
1# Newpagefill
2
3[���� Français](README.md) | [���� English](README_EN.md) | [���� Deutsch](README_DE.md) | ���� Español
4
5El plugin puede:
6- abrir un pequeño diálogo de creación de página con título e identificador;
7- sugerir automáticamente un identificador a partir del título;
8- rellenar la nueva página con una plantilla del plugin si no existe ninguna plantilla nativa;
9- extender las plantillas nativas de DokuWiki con `@TITLE@`.
10
11## Uso
12
13El plugin añade un flujo de creación de página más sencillo:
14- introducir un título;
15- introducir opcionalmente un espacio de nombres si no se proporcionó ninguno;
16- el plugin sugiere un identificador;
17- se abre directamente el editor en la nueva página.
18
19Si existe una plantilla nativa de DokuWiki (`_template.txt` o `__template.txt`), se utiliza.
20De lo contrario, el plugin aplica su propia plantilla de reserva configurada.
21
22## Configuración
23
24En el gestor de configuración:
25- `template`: plantilla de reserva utilizada solo cuando no se encuentra ninguna plantilla de página nativa de DokuWiki;
26- `default_start_mode`: modo de creación de página predeterminado (`ask`, `start`, `none`, `same`).
27
28Esta plantilla puede contener:
29- `@TITLE@`: título calculado por el plugin (específico de newpagefill);
30- todos los marcadores nativos de DokuWiki: `@ID@`, `@NS@`, `@PAGE@`, `@USER@`, `@DATE@`, etc. (gestionados por el núcleo de DokuWiki, no por este plugin).
31
32## Comportamiento de `@TITLE@`
33
34El plugin rellena `@TITLE@` de la siguiente manera:
35- primero utiliza el valor `title` si existe;
36- de lo contrario, intenta extraerlo de la URL de creación;
37- si la página creada es una página de inicio como `start`, utiliza el nombre del espacio de nombres padre;
38- los caracteres `_` se convierten en espacios.
39
40## Compatibilidad con plantillas DokuWiki
41
42El plugin respeta el sistema de plantillas nativo:
43- `_template.txt`
44- `__template.txt`
45
46No lo reemplaza.
47Solo añade soporte para `@TITLE@` — los marcadores nativos de DokuWiki (`@ID@`, `@NS@`, etc.) son gestionados por el núcleo después.
48
49## Función JavaScript disponible
50
51El plugin también expone una función JavaScript global:
52
53```js
54window.NewPageFill.openCreatePageDialog(options)
55```
56
57Ejemplo:
58
59```js
60window.NewPageFill.openCreatePageDialog({
61 namespace: 'wiki:documentacion',
62 initialTitle: 'Nueva página'
63});
64```
65
66Opciones útiles:
67- `namespace`: espacio de nombres de DokuWiki donde se creará la página. Si no se proporciona, el diálogo permite introducirlo;
68- `initialTitle`: título prerrellenado al abrir el diálogo;
69- `start`:
70 - `undefined` o `null`: usar el modo predeterminado configurado en el plugin;
71 - `'@ask@'`: forzar la elección del modo aunque exista un modo predeterminado;
72 - `true`: usar la página de inicio del wiki, por ejemplo `start`;
73 - `false`: crear la página directamente;
74 - `'@same@'`: crear una subpágina con el mismo nombre que el identificador;
75 - cualquier otra cadena: crear una subpágina con ese valor;
76- `sepchar`: separador utilizado para generar el identificador.
77
78Si `start` no se proporciona y `default_start_mode = ask`, el diálogo muestra tres opciones:
79- página directa;
80- página de inicio;
81- subpágina con el mismo nombre.
82