# Crear un sitio nuevo con la plantilla y nginx En esta guía creará `tienda.localhost`: un sitio con plantilla común (encabezado, menú y pie), una página de inicio, una página de productos y un servicio JSON, publicado en nginx. Al terminar sabrá dónde va cada archivo y cómo comprobar cada pieza. Requisitos: Devkron 2.0 en `/opt/devkron` con el servidor FastCGI funcionando ([Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md)) y nginx instalado ([nginx](/es/devkron/2.0/instalacion/nginx.md)). Sin licencia, el servidor solo atiende hosts `*.localhost`. ## 1. Cree el sitio desde la plantilla ```bash cd /opt/devkron sudo ./dkl createsite blank tienda.localhost -hide-log ``` ```text web/tienda.localhost/index.dkl web/tienda.localhost/_protected/auth.dk web/tienda.localhost/_protected/ext.map web/tienda.localhost/_protected/idp/dbidp.dk web/tienda.localhost/_protected/idp/default.dk ``` Corrija la regla de la API FSO en `web/tienda.localhost/_protected/ext.map` (la plantilla la trae con ruta absoluta): ```text # Este es un mapa de rutas por extensión .fso > $fso/fso.*.dkl ``` Qué es cada archivo: [Crear un sitio con createsite](/es/devkron/2.0/marcos/sitios/crear-sitio.md). ## 2. Publíquelo en nginx `/etc/nginx/conf.d/tienda.conf` (con el `upstream devkron` que ya configuró para el servidor FastCGI): ```nginx server { listen 80; server_name tienda.localhost; client_max_body_size 50m; location / { include fastcgi_params; fastcgi_pass devkron; } } ``` ```bash sudo nginx -t && sudo systemctl reload nginx curl http://tienda.localhost/ ``` Debe responder la página de la plantilla: ```html

Página de inicio

Sitio Web vacío

``` Si responde 502, el servidor FastCGI no está arriba o nginx no puede llegar a su socket o puerto ([nginx: errores comunes](/es/devkron/2.0/instalacion/nginx.md)). Si responde 503 `Host no admitido`, use un nombre `*.localhost` o instale la licencia. ## 3. Configuración y funciones comunes `web/tienda.localhost/config.dk` (variables del sitio; [website.dkl](/es/devkron/2.0/marcos/sitios/) lo carga solo): ```dkl #include "dkli.dkh" #! module "Configuración del sitio" { @sitio_nombre = "Tienda de ejemplo" @sitio_anio = "2026" } ``` `web/tienda.localhost/lib.dk` (funciones que pueden usar todas las páginas): ```dkl #include "dkli.dkh" #! module "Funciones comunes del sitio" { // Secciones opcionales: cada página puede sustituirlas scripts:: { } menu:: { ## nav { a(href="/"){"Inicio"} $" | " a(href="/productos/"){"Productos"} } ## } } ``` ## 4. La plantilla `web/tienda.localhost/template.htt`: ```html #
#<@sitio_nombre> #
#
# ``` Y una hoja de estilos, `web/tienda.localhost/css/sitio.css`: ```css body{font-family:system-ui;margin:2rem} header{margin-bottom:1rem} ``` ## 5. La página de inicio Sustituya `web/tienda.localhost/index.dkl`: ```dkl #include "dkli.dkh" #! module "Inicio" { #include "functions.dkh" #include "serialize.dkh" #include "website.dkl" head:: { ## title{$"Inicio | #<@sitio_nombre>"} ## } body:: { ## h1{"Bienvenido"} p{$"Hoy es #."} ## } do render_page() } ``` `curl http://tienda.localhost/` responde (salida real): ```html Inicio | Tienda de ejemplo
Tienda de ejemplo

Bienvenido

Hoy es 27/10/2026.

© 2026 Tienda de ejemplo
``` ## 6. Un servicio JSON `web/tienda.localhost/api/productos.dkl`: ```dkl #include "dkli.dkh" #! program "productos" { #include "functions.dkh" #include "serialize.dkh" new r { @"success": @true } r<"data*">: from.json('[{"clave":"P-01","nombre":"Lápiz"},{"clave":"P-02","nombre":"Goma"}]') @http_context<"response/headers/content-type">: "application/json;charset=utf-8" @http_context<"response/output">: "text" @http_context<"response/text">: to.json(r) } ``` ```bash curl http://tienda.localhost/api/productos.dkl ``` ```json {"success":1,"data":[{"clave":"P-01","nombre":"Lápiz"},{"clave":"P-02","nombre":"Goma"}]} ``` En un sistema real los datos salen de la base: vea la guía [Servicio REST JSON](/es/devkron/2.0/guias/servicio-rest-json.md). ## 7. Una página que consume el servicio `web/tienda.localhost/productos/index.dkl` usa la misma plantilla (la busca en la carpeta superior) y sustituye la sección `scripts`: ```dkl #include "dkli.dkh" #! module "Productos" { #include "functions.dkh" #include "serialize.dkh" #include "website.dkl" head:: { ## title{$"Productos | #<@sitio_nombre>"} ## } body:: { ## h1{"Productos"} ul(id="lista"){$""} ## } scripts:: { ## script{$" fetch('/api/productos.dkl').then(r => r.json()).then(r => { const ul = document.getElementById('lista'); r.data.forEach(p => { const li = document.createElement('li'); li.textContent = p.nombre; ul.appendChild(li); }); }); "} ## } do render_page() } ``` Escriba `ul(id="lista"){$""}` y no `ul(id="lista"){}`: un elemento sin contenido sale como `
    `, que los navegadores no interpretan como una lista vacía. Con `$""` sale `
      `. ## 8. Compruebe | Prueba | Resultado esperado | |---|---| | `curl -I http://tienda.localhost/css/sitio.css` | `200 OK`, `Content-Type: text/css;charset=utf-8` | | `curl http://tienda.localhost/productos/` | La plantilla con `

      Productos

      ` y el `