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