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