# Sitios con plantillas: website.dkl `website.dkl` (parte de dkl-web) resuelve dos tareas que se repiten en todo sitio: - **Plantillas**: el marco común de las páginas (encabezado, menú, pie) se escribe una vez, en HTML o en DKL, y cada página solo aporta su contenido. - **Inclusiones automáticas**: los archivos `config.dk` y `lib.dk` de la carpeta de la página y de todas sus carpetas superiores se cargan solos, en orden, sin escribir un `#include` por cada uno. Úselo en sitios de contenido, portales y páginas de sistemas que comparten diseño. Para un servicio JSON no hace falta. ## Uso mínimo Cada página incluye `functions.dkh`, `serialize.dkh` y `website.dkl`, define funciones con el contenido y termina con `render_page()`: ```dkl #include "dkli.dkh" #! module "index.dkl" { #include "functions.dkh" #include "serialize.dkh" #include "website.dkl" head:: { ## title{$"#<@sitio_nombre>"} ## } body:: { ## h1{$"Hola desde #"} p{$"Archivos cargados: #"} ## } do render_page() } ``` `website.dkl` necesita `serialize.dkh` (usa `from.json` al cargarse); sin él falla con `Función: from.json no reconocida`. La documentación de 1.0 solo pedía `functions.dkh`. La plantilla (`template.htt`, en HTML) llama a esas funciones con `render`: ```html #
Mi sitio (plantilla HTML)
#
#
``` Con un `config.dk` que define `@sitio_nombre = "Tienda de ejemplo"` y un `lib.dk` con la función `pie`, la respuesta real es: ```html Tienda de ejemplo
Mi sitio (plantilla HTML)

Hola desde /sitio/

Archivos cargados: 2

© 2026 Tienda de ejemplo
``` ## Plantillas - Se llaman `template` con extensión **`.dkt`** (código DKL) o **`.htt`** (HTML con marcas `#<...>`). - Hay **una plantilla por carpeta** como máximo; si existen las dos, gana `.dkt`. - Se busca primero en la carpeta de la página y, si no hay, en las carpetas superiores, hasta 5 niveles (`@TEMPLATE_MAX_DEEP`). - Si no hay ninguna, `render_page` lanza el error `No hay una plantilla disponible`. La misma plantilla en DKL (`template.dkt`): ```dkl #include "dkli.dkh" #$ html(lang="es") { head { $"#" } body { div(class="seccion-2") { $"#" } } } ``` Una plantilla `.htt` es cómoda para reutilizar maquetado que ya existe (el diseñador entrega HTML); una `.dkt` da más control, porque es un programa y puede consultar datos, decidir qué menú mostrar o incluir otras piezas. La salida de una `.dkt` lleva al inicio `` (`@DKL_TEMPLATE_PREFIX`). ### render y render_page | Función | Qué hace | |---|---| | `render_page()` | Busca la plantilla, la ejecuta (`.dkt`) o la evalúa como texto con formato (`.htt`), y deja el resultado en `response/text` con `output` = `text`. Llámela al final de la página | | `render(id)` | Se usa dentro de la plantilla. Ejecuta la función `id` de la página y devuelve su salida declarativa como texto. `render('head')` llama a `head()`; para pasar argumentos escriba la llamada completa: `render('pie("2026")')` | Las funciones que llama `render` producen HTML con un bloque `## ... ##`. Si `render` pide una función que la página no define, la petición falla: defina en `lib.dk` versiones vacías de las secciones opcionales (por ejemplo, `scripts::{ }`) y que cada página las sustituya. ## Inclusiones automáticas: config.dk y lib.dk Al incluirse, `website.dkl` recorre las carpetas **desde la raíz del sitio hasta la carpeta de la página** y, en cada una, incluye `config.dk` y luego `lib.dk` si existen. Cada archivo se incluye una sola vez por petición. Suponga este sitio: ```text / ├── index.dkl ├── config.dk ├── lib.dk ├── template.htt ├── seccion-1/ │ └── index.dkl └── seccion-2/ ├── index.dkl ├── template.dkt ├── lib.dk └── sub-2-1/ └── index.dkl ``` | Página | Plantilla | Archivos que se cargan | |---|---|---| | `/index.dkl` | `/template.htt` | `/config.dk`, `/lib.dk` | | `/seccion-1/index.dkl` | `/template.htt` (de la carpeta superior) | `/config.dk`, `/lib.dk` | | `/seccion-2/index.dkl` | `/seccion-2/template.dkt` (la propia) | `/config.dk`, `/lib.dk`, `/seccion-2/lib.dk` | | `/seccion-2/sub-2-1/index.dkl` | `/seccion-2/template.dkt` (de la carpeta superior) | `/config.dk`, `/lib.dk`, `/seccion-2/lib.dk` | Comprobado con 2.0: las páginas de `/` y `/seccion-1/` cargan 2 archivos y las de `/seccion-2/` y `/seccion-2/sub-2-1/` cargan 3. Use `config.dk` para variables (nombre del sitio, conexión, rutas) y `lib.dk` para funciones comunes. Son módulos DKL; empiezan en contexto declarativo, así que el código va después de `#!`: ```dkl #include "dkli.dkh" #! module "config" { @sitio_nombre = "Tienda de ejemplo" } ``` ```dkl #include "dkli.dkh" #! module "lib raíz" { pie::anio { ## small{$"© # #<@sitio_nombre>"} ## } } ``` ## Configuración Variables de `website.dkl`. `@SITE_INCLUDES` se respeta si la define **antes** de incluir `website.dkl`; las demás puede cambiarlas después de incluirlo y antes de `render_page()`. | Variable | Valor predeterminado | Uso | |---|---|---| | `@SITE_INCLUDES` | `"config.dk,lib.dk"` | Archivos que se cargan automáticamente en cada carpeta, en ese orden | | `@TEMPLATE_FILENAME` | `"template"` | Nombre de la plantilla (sin extensión) | | `@TEMPLATE_MAX_DEEP` | `5` | Niveles de carpetas superiores donde se busca la plantilla | | `@DKL_TEMPLATE_PREFIX` | `"\r\n"` | Texto que se antepone a la salida de una plantilla `.dkt` | | `@TEMPLATE_EXTENSIONS` | `.dkt` (DKL) y `.htt` (HTML), en ese orden | Extensiones de plantilla reconocidas | Variables que deja disponibles: | Variable | Contenido | |---|---| | `@INCLUDE_LIST` | Lista de archivos que se cargaron automáticamente | | `@SITE_STRUCT` | Lista de carpetas desde la raíz hasta la de la página | | `@TEMPLATE_CURRENT` | Tras `render_page`, la plantilla usada (`filename`, `dkl`) | | `@WEB_SITE_LOADED_FILES` | Archivos ya incluidos (para no repetirlos) | ## Errores típicos | Síntoma | Causa y solución | |---|---| | `Función: from.json no reconocida` en `website.dkl` | Falta `#include "serialize.dkh"` antes de `website.dkl` | | `No hay una plantilla disponible` | No hay `template.dkt` ni `template.htt` en la carpeta ni en los 5 niveles superiores | | La página sale sin plantilla y sin contenido | Faltó `do render_page()` al final | | `Función: ... no reconocida` dentro de la plantilla | La página no define la función que pide `render`: defínala o ponga una vacía en `lib.dk` | | Una variable de `config.dk` no existe en la página | `config.dk` está en una carpeta que no es superior a la página, o se escribió el código antes de `#!` | Para empezar un sitio desde cero con la plantilla de dkl-web, vea [Crear un sitio con createsite](/es/devkron/2.0/marcos/sitios/crear-sitio.md).