1====== Newpagefill Plugin ====== 2 3---- plugin ---- 4description: Asistente de creación de páginas con relleno automático y soporte de @TITLE@ 5author : Valentin LORTET 6email : contact@valentinlortet.fr 7type : Action 8lastupdate : 2026-03-13 9compatible : Librarian 10depends : 11conflicts : 12similar : 13tags : Page, Creation, Template, Namespace, JavaScript 14 15downloadurl: https://github.com/Lortet/dokuwiki-plugin-newpagefill/zipball/master 16bugtracker : https://github.com/Lortet/dokuwiki-plugin-newpagefill/issues 17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-newpagefill/ 18donationurl: 19screenshot_img : 20---- 21 22===== Instalación ===== 23 24Instalar el plugin desde el [[plugin:extension|Gestor de extensiones]]. 25 26===== Descripción ===== 27 28El plugin **newpagefill** añade un asistente ligero para crear una nueva página: 29 * introducir un título; 30 * sugerir automáticamente un identificador de página; 31 * introducir opcionalmente el espacio de nombres; 32 * elegir el modo de creación según la configuración; 33 * abrir el editor directamente en la página de destino. 34 35También complementa el sistema de plantillas nativo de DokuWiki: 36 * usar ''_template.txt'' o ''__template.txt'' cuando estén disponibles; 37 * añadir soporte para el marcador ''@TITLE@'' en el contenido inyectado; 38 * recurrir a una plantilla propia del plugin cuando no existe ninguna plantilla nativa. 39 40===== Configuración ===== 41 42^ Nombre ^ Descripción ^ Valor predeterminado ^ 43| template | Plantilla de reserva utilizada cuando no se encuentra ninguna plantilla de página nativa de DokuWiki. | ''===== @TITLE@ ====='' | 44| default_start_mode | Modo de creación predeterminado. | ''start'' | 45 46Valores posibles para ''default_start_mode'': 47 * ''ask'': mostrar un selector en el diálogo; 48 * ''start'': crear una página de inicio; 49 * ''none'': crear una página directa; 50 * ''same'': crear una subpágina con el mismo nombre. 51 52===== Marcadores ===== 53 54La plantilla del plugin puede contener: 55 * ''@TITLE@'': título calculado por el plugin (específico de newpagefill); 56 * todos los marcadores nativos de DokuWiki: ''@ID@'', ''@NS@'', ''@PAGE@'', ''@USER@'', ''@DATE@'', etc. (gestionados por el núcleo de DokuWiki, no por este plugin). 57 58===== Comportamiento de @TITLE@ ===== 59 60El valor de ''@TITLE@'' se calcula de la siguiente manera: 61 * el valor ''title'' de la solicitud tiene prioridad; 62 * de lo contrario, el plugin intenta extraer un título de la URL de creación; 63 * 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 * los caracteres ''_'' se reemplazan por espacios. 65 66===== Compatibilidad con plantillas ===== 67 68El plugin sigue este orden: 69 * plantilla ya proporcionada por DokuWiki; 70 * ''_template.txt'' en la carpeta de destino; 71 * ''__template.txt'' en el espacio de nombres actual o padre; 72 * plantilla de reserva configurada en el plugin. 73 74===== Función JavaScript ===== 75 76El plugin expone la función global: 77 78<code javascript> 79window.NewPageFill.openCreatePageDialog(options) 80</code> 81 82Ejemplo: 83 84<code javascript> 85window.NewPageFill.openCreatePageDialog({ 86 namespace: 'wiki:documentacion', 87 initialTitle: 'Nueva página' 88}); 89</code> 90 91Opciones útiles: 92 * ''namespace'': espacio de nombres de destino en DokuWiki; 93 * ''initialTitle'': título prerrellenado; 94 * ''start'': 95 * ''undefined'' o ''null'': usar la configuración del plugin; 96 * ''@ask@'': forzar la elección del modo; 97 * ''true'': usar la página de inicio del wiki; 98 * ''false'': crear la página directamente; 99 * ''@same@'': crear una subpágina con el mismo nombre que el identificador; 100 * cualquier otra cadena: crear una subpágina con ese valor; 101 * ''sepchar'': separador utilizado para generar el identificador. 102 103Si ''start'' no se proporciona y ''default_start_mode = ask'', el diálogo ofrece: 104 * página directa; 105 * página de inicio; 106 * subpágina con el mismo nombre. 107