====== Newpagefill Plugin ======

---- plugin ----
description: Asistente de creación de páginas con relleno automático y soporte de @TITLE@
author     : Valentin LORTET
email      : contact@valentinlortet.fr
type       : Action
lastupdate : 2026-03-13
compatible : Librarian
depends    :
conflicts  :
similar    :
tags       : Page, Creation, Template, Namespace, JavaScript

downloadurl: https://github.com/Lortet/dokuwiki-plugin-newpagefill/zipball/master
bugtracker : https://github.com/Lortet/dokuwiki-plugin-newpagefill/issues
sourcerepo : https://github.com/Lortet/dokuwiki-plugin-newpagefill/
donationurl:
screenshot_img :
----

===== Instalación =====

Instalar el plugin desde el [[plugin:extension|Gestor de extensiones]].

===== Descripción =====

El plugin **newpagefill** añade un asistente ligero para crear una nueva página:
  * introducir un título;
  * sugerir automáticamente un identificador de página;
  * introducir opcionalmente el espacio de nombres;
  * elegir el modo de creación según la configuración;
  * abrir el editor directamente en la página de destino.

También complementa el sistema de plantillas nativo de DokuWiki:
  * usar ''_template.txt'' o ''__template.txt'' cuando estén disponibles;
  * añadir soporte para el marcador ''@TITLE@'' en el contenido inyectado;
  * recurrir a una plantilla propia del plugin cuando no existe ninguna plantilla nativa.

===== Configuración =====

^ Nombre ^ Descripción ^ Valor predeterminado ^
| template | Plantilla de reserva utilizada cuando no se encuentra ninguna plantilla de página nativa de DokuWiki. | ''===== @TITLE@ ====='' |
| default_start_mode | Modo de creación predeterminado. | ''start'' |

Valores posibles para ''default_start_mode'':
  * ''ask'': mostrar un selector en el diálogo;
  * ''start'': crear una página de inicio;
  * ''none'': crear una página directa;
  * ''same'': crear una subpágina con el mismo nombre.

===== Marcadores =====

La plantilla del plugin puede contener:
  * ''@TITLE@'': título calculado por el plugin (específico de newpagefill);
  * todos los marcadores nativos de DokuWiki: ''@ID@'', ''@NS@'', ''@PAGE@'', ''@USER@'', ''@DATE@'', etc. (gestionados por el núcleo de DokuWiki, no por este plugin).

===== Comportamiento de @TITLE@ =====

El valor de ''@TITLE@'' se calcula de la siguiente manera:
  * el valor ''title'' de la solicitud tiene prioridad;
  * de lo contrario, el plugin intenta extraer un título de la URL de creación;
  * si la página creada es la página de inicio del espacio de nombres, se usa el nombre del espacio de nombres padre;
  * los caracteres ''_'' se reemplazan por espacios.

===== Compatibilidad con plantillas =====

El plugin sigue este orden:
  * plantilla ya proporcionada por DokuWiki;
  * ''_template.txt'' en la carpeta de destino;
  * ''__template.txt'' en el espacio de nombres actual o padre;
  * plantilla de reserva configurada en el plugin.

===== Función JavaScript =====

El plugin expone la función global:

<code javascript>
window.NewPageFill.openCreatePageDialog(options)
</code>

Ejemplo:

<code javascript>
window.NewPageFill.openCreatePageDialog({
  namespace: 'wiki:documentacion',
  initialTitle: 'Nueva página'
});
</code>

Opciones útiles:
  * ''namespace'': espacio de nombres de destino en DokuWiki;
  * ''initialTitle'': título prerrellenado;
  * ''start'':
    * ''undefined'' o ''null'': usar la configuración del plugin;
    * ''@ask@'': forzar la elección del modo;
    * ''true'': usar la página de inicio del wiki;
    * ''false'': crear la página directamente;
    * ''@same@'': crear una subpágina con el mismo nombre que el identificador;
    * cualquier otra cadena: crear una subpágina con ese valor;
  * ''sepchar'': separador utilizado para generar el identificador.

Si ''start'' no se proporciona y ''default_start_mode = ask'', el diálogo ofrece:
  * página directa;
  * página de inicio;
  * subpágina con el mismo nombre.