xref: /plugin/newpagefill/DOKU_ES (revision 9a36670832b754c53fa81850c7b00d5bb57a3705)
1*9a366708SLORTET====== Newpagefill Plugin ======
2*9a366708SLORTET
3*9a366708SLORTET---- plugin ----
4*9a366708SLORTETdescription: Asistente de creación de páginas con relleno automático y soporte de @TITLE@
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===== Instalación =====
23*9a366708SLORTET
24*9a366708SLORTETInstalar el plugin desde el [[plugin:extension|Gestor de extensiones]].
25*9a366708SLORTET
26*9a366708SLORTET===== Descripción =====
27*9a366708SLORTET
28*9a366708SLORTETEl plugin **newpagefill** añade un asistente ligero para crear una nueva página:
29*9a366708SLORTET  * introducir un título;
30*9a366708SLORTET  * sugerir automáticamente un identificador de página;
31*9a366708SLORTET  * introducir opcionalmente el espacio de nombres;
32*9a366708SLORTET  * elegir el modo de creación según la configuración;
33*9a366708SLORTET  * abrir el editor directamente en la página de destino.
34*9a366708SLORTET
35*9a366708SLORTETTambién complementa el sistema de plantillas nativo de DokuWiki:
36*9a366708SLORTET  * usar ''_template.txt'' o ''__template.txt'' cuando estén disponibles;
37*9a366708SLORTET  * añadir soporte para el marcador ''@TITLE@'' en el contenido inyectado;
38*9a366708SLORTET  * recurrir a una plantilla propia del plugin cuando no existe ninguna plantilla nativa.
39*9a366708SLORTET
40*9a366708SLORTET===== Configuración =====
41*9a366708SLORTET
42*9a366708SLORTET^ Nombre ^ Descripción ^ Valor predeterminado ^
43*9a366708SLORTET| template | Plantilla de reserva utilizada cuando no se encuentra ninguna plantilla de página nativa de DokuWiki. | ''===== @TITLE@ ====='' |
44*9a366708SLORTET| default_start_mode | Modo de creación predeterminado. | ''start'' |
45*9a366708SLORTET
46*9a366708SLORTETValores posibles para ''default_start_mode'':
47*9a366708SLORTET  * ''ask'': mostrar un selector en el diálogo;
48*9a366708SLORTET  * ''start'': crear una página de inicio;
49*9a366708SLORTET  * ''none'': crear una página directa;
50*9a366708SLORTET  * ''same'': crear una subpágina con el mismo nombre.
51*9a366708SLORTET
52*9a366708SLORTET===== Marcadores =====
53*9a366708SLORTET
54*9a366708SLORTETLa plantilla del plugin puede contener:
55*9a366708SLORTET  * ''@TITLE@'': título calculado por el plugin (específico de newpagefill);
56*9a366708SLORTET  * todos los marcadores nativos de DokuWiki: ''@ID@'', ''@NS@'', ''@PAGE@'', ''@USER@'', ''@DATE@'', etc. (gestionados por el núcleo de DokuWiki, no por este plugin).
57*9a366708SLORTET
58*9a366708SLORTET===== Comportamiento de @TITLE@ =====
59*9a366708SLORTET
60*9a366708SLORTETEl valor de ''@TITLE@'' se calcula de la siguiente manera:
61*9a366708SLORTET  * el valor ''title'' de la solicitud tiene prioridad;
62*9a366708SLORTET  * de lo contrario, el plugin intenta extraer un título de la URL de creación;
63*9a366708SLORTET  * si la página creada es la página de inicio del espacio de nombres, se usa el nombre del espacio de nombres padre;
64*9a366708SLORTET  * los caracteres ''_'' se reemplazan por espacios.
65*9a366708SLORTET
66*9a366708SLORTET===== Compatibilidad con plantillas =====
67*9a366708SLORTET
68*9a366708SLORTETEl plugin sigue este orden:
69*9a366708SLORTET  * plantilla ya proporcionada por DokuWiki;
70*9a366708SLORTET  * ''_template.txt'' en la carpeta de destino;
71*9a366708SLORTET  * ''__template.txt'' en el espacio de nombres actual o padre;
72*9a366708SLORTET  * plantilla de reserva configurada en el plugin.
73*9a366708SLORTET
74*9a366708SLORTET===== Función JavaScript =====
75*9a366708SLORTET
76*9a366708SLORTETEl plugin expone la función global:
77*9a366708SLORTET
78*9a366708SLORTET<code javascript>
79*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog(options)
80*9a366708SLORTET</code>
81*9a366708SLORTET
82*9a366708SLORTETEjemplo:
83*9a366708SLORTET
84*9a366708SLORTET<code javascript>
85*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog({
86*9a366708SLORTET  namespace: 'wiki:documentacion',
87*9a366708SLORTET  initialTitle: 'Nueva página'
88*9a366708SLORTET});
89*9a366708SLORTET</code>
90*9a366708SLORTET
91*9a366708SLORTETOpciones útiles:
92*9a366708SLORTET  * ''namespace'': espacio de nombres de destino en DokuWiki;
93*9a366708SLORTET  * ''initialTitle'': título prerrellenado;
94*9a366708SLORTET  * ''start'':
95*9a366708SLORTET    * ''undefined'' o ''null'': usar la configuración del plugin;
96*9a366708SLORTET    * ''@ask@'': forzar la elección del modo;
97*9a366708SLORTET    * ''true'': usar la página de inicio del wiki;
98*9a366708SLORTET    * ''false'': crear la página directamente;
99*9a366708SLORTET    * ''@same@'': crear una subpágina con el mismo nombre que el identificador;
100*9a366708SLORTET    * cualquier otra cadena: crear una subpágina con ese valor;
101*9a366708SLORTET  * ''sepchar'': separador utilizado para generar el identificador.
102*9a366708SLORTET
103*9a366708SLORTETSi ''start'' no se proporciona y ''default_start_mode = ask'', el diálogo ofrece:
104*9a366708SLORTET  * página directa;
105*9a366708SLORTET  * página de inicio;
106*9a366708SLORTET  * subpágina con el mismo nombre.
107