xref: /plugin/newpagefill/README_ES.md (revision 9a36670832b754c53fa81850c7b00d5bb57a3705)
1*9a366708SLORTET# Newpagefill
2*9a366708SLORTET
3*9a366708SLORTET[���� Français](README.md) | [���� English](README_EN.md) | [���� Deutsch](README_DE.md) | ���� Español
4*9a366708SLORTET
5*9a366708SLORTETEl plugin puede:
6*9a366708SLORTET- abrir un pequeño diálogo de creación de página con título e identificador;
7*9a366708SLORTET- sugerir automáticamente un identificador a partir del título;
8*9a366708SLORTET- rellenar la nueva página con una plantilla del plugin si no existe ninguna plantilla nativa;
9*9a366708SLORTET- extender las plantillas nativas de DokuWiki con `@TITLE@`.
10*9a366708SLORTET
11*9a366708SLORTET## Uso
12*9a366708SLORTET
13*9a366708SLORTETEl plugin añade un flujo de creación de página más sencillo:
14*9a366708SLORTET- introducir un título;
15*9a366708SLORTET- introducir opcionalmente un espacio de nombres si no se proporcionó ninguno;
16*9a366708SLORTET- el plugin sugiere un identificador;
17*9a366708SLORTET- se abre directamente el editor en la nueva página.
18*9a366708SLORTET
19*9a366708SLORTETSi existe una plantilla nativa de DokuWiki (`_template.txt` o `__template.txt`), se utiliza.
20*9a366708SLORTETDe lo contrario, el plugin aplica su propia plantilla de reserva configurada.
21*9a366708SLORTET
22*9a366708SLORTET## Configuración
23*9a366708SLORTET
24*9a366708SLORTETEn el gestor de configuración:
25*9a366708SLORTET- `template`: plantilla de reserva utilizada solo cuando no se encuentra ninguna plantilla de página nativa de DokuWiki;
26*9a366708SLORTET- `default_start_mode`: modo de creación de página predeterminado (`ask`, `start`, `none`, `same`).
27*9a366708SLORTET
28*9a366708SLORTETEsta plantilla puede contener:
29*9a366708SLORTET- `@TITLE@`: título calculado por el plugin (específico de newpagefill);
30*9a366708SLORTET- todos los marcadores nativos de DokuWiki: `@ID@`, `@NS@`, `@PAGE@`, `@USER@`, `@DATE@`, etc. (gestionados por el núcleo de DokuWiki, no por este plugin).
31*9a366708SLORTET
32*9a366708SLORTET## Comportamiento de `@TITLE@`
33*9a366708SLORTET
34*9a366708SLORTETEl plugin rellena `@TITLE@` de la siguiente manera:
35*9a366708SLORTET- primero utiliza el valor `title` si existe;
36*9a366708SLORTET- de lo contrario, intenta extraerlo de la URL de creación;
37*9a366708SLORTET- si la página creada es una página de inicio como `start`, utiliza el nombre del espacio de nombres padre;
38*9a366708SLORTET- los caracteres `_` se convierten en espacios.
39*9a366708SLORTET
40*9a366708SLORTET## Compatibilidad con plantillas DokuWiki
41*9a366708SLORTET
42*9a366708SLORTETEl plugin respeta el sistema de plantillas nativo:
43*9a366708SLORTET- `_template.txt`
44*9a366708SLORTET- `__template.txt`
45*9a366708SLORTET
46*9a366708SLORTETNo lo reemplaza.
47*9a366708SLORTETSolo añade soporte para `@TITLE@` — los marcadores nativos de DokuWiki (`@ID@`, `@NS@`, etc.) son gestionados por el núcleo después.
48*9a366708SLORTET
49*9a366708SLORTET## Función JavaScript disponible
50*9a366708SLORTET
51*9a366708SLORTETEl plugin también expone una función JavaScript global:
52*9a366708SLORTET
53*9a366708SLORTET```js
54*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog(options)
55*9a366708SLORTET```
56*9a366708SLORTET
57*9a366708SLORTETEjemplo:
58*9a366708SLORTET
59*9a366708SLORTET```js
60*9a366708SLORTETwindow.NewPageFill.openCreatePageDialog({
61*9a366708SLORTET  namespace: 'wiki:documentacion',
62*9a366708SLORTET  initialTitle: 'Nueva página'
63*9a366708SLORTET});
64*9a366708SLORTET```
65*9a366708SLORTET
66*9a366708SLORTETOpciones útiles:
67*9a366708SLORTET- `namespace`: espacio de nombres de DokuWiki donde se creará la página. Si no se proporciona, el diálogo permite introducirlo;
68*9a366708SLORTET- `initialTitle`: título prerrellenado al abrir el diálogo;
69*9a366708SLORTET- `start`:
70*9a366708SLORTET  - `undefined` o `null`: usar el modo predeterminado configurado en el plugin;
71*9a366708SLORTET  - `'@ask@'`: forzar la elección del modo aunque exista un modo predeterminado;
72*9a366708SLORTET  - `true`: usar la página de inicio del wiki, por ejemplo `start`;
73*9a366708SLORTET  - `false`: crear la página directamente;
74*9a366708SLORTET  - `'@same@'`: crear una subpágina con el mismo nombre que el identificador;
75*9a366708SLORTET  - cualquier otra cadena: crear una subpágina con ese valor;
76*9a366708SLORTET- `sepchar`: separador utilizado para generar el identificador.
77*9a366708SLORTET
78*9a366708SLORTETSi `start` no se proporciona y `default_start_mode = ask`, el diálogo muestra tres opciones:
79*9a366708SLORTET- página directa;
80*9a366708SLORTET- página de inicio;
81*9a366708SLORTET- subpágina con el mismo nombre.
82