# Crear un sitio con createsite `createsite.dkl` es una herramienta de consola de dkl-web que crea la carpeta de un sitio nuevo copiando una plantilla de `_templates/sites/`. La distribución trae la plantilla **`blank`**: un sitio vacío, con la carpeta protegida, la regla de la API FSO y un `auth.dk` que identifica al usuario. ## Uso Desde la carpeta de la instalación (las rutas son relativas a ella): ```bash cd /opt/devkron ./dkl createsite blank tienda.localhost ``` Salida real (con 2.0): ```text Iniciado 10/27/2026 17:21:20 ID de ejecución: 8add6c89e55c4501bb4bbdc7911a8d92 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 Terminado 10/27/2026 17:21:20 00:00:00.1285554 ``` | Argumento | Significado | |---|---| | primero | Nombre de la plantilla: una carpeta de `_templates/sites/` | | segundo | Nombre del host del sitio nuevo: se crea `web//` | Sin argumentos, o con una plantilla que no existe, muestra el uso: ```text - ERROR - {0} Faltan parámetros.[Ln= 58] ------------------------------------------------------------ - USO DE LA HERRAMIENTA - ./dkl createsite nombre_plantilla host_sitio_web ... ``` `createsite` copia encima de lo que exista: si la carpeta del sitio ya tiene archivos con el mismo nombre, los reemplaza. Úselo solo para sitios nuevos. Las variables `@templates_path` (`_templates/sites`) y `@sites_path` (`web`) del programa indican dónde están las plantillas y dónde se crean los sitios. Puede crear sus propias plantillas (por ejemplo, un sitio con su diseño y su `auth.dk`) como carpetas nuevas en `_templates/sites/`. ## Qué trae la plantilla blank ```text web/tienda.localhost/ ├── index.dkl página de inicio de ejemplo └── _protected/ ├── auth.dk identifica al usuario y aplica el privilegio read ├── ext.map .fso > $/fso/fso.*.dkl └── idp/ ├── default.dk proveedor de identidad: API de Induxsoft └── dbidp.dk proveedor de identidad: base de datos (ejemplo) ``` `index.dkl` es una página HTML mínima: ```dkl #set "meta-xml-declaration" "\r\n" #$ html { head{} body { h1{$"Página de inicio"} p{$"Sitio Web vacío"} } } ``` Respuesta real de 2.0: ```html

Página de inicio

Sitio Web vacío

``` ### Ajuste necesario en ext.map La regla que trae la plantilla es `.fso > $/fso/fso.*.dkl`, una ruta **absoluta** (`/fso/...` en la raíz del disco). En una instalación normal los servicios FSO están en la carpeta `fso/` de Devkron, así que cámbiela a la forma relativa a la instalación (`$` sin barra): ```text # Este es un mapa de rutas por extensión .fso > $fso/fso.*.dkl ``` Comprobado con 2.0: con la regla original, `GET /documentos/lst.fso` responde 404; con `$fso/fso.*.dkl`, responde la lista. ### auth.dk e idp/ El `auth.dk` de la plantilla se ejecuta en cada petición: carga el proveedor de identidad `_protected/idp/default.dk`, arma `@http_context/session` y, si el recurso pedido tiene un manifiesto de privilegios con `read`, exige sesión y privilegio. Mientras el sitio no tenga manifiestos (`._p_`), deja pasar todo. `default.dk` valida el token contra la API de Induxsoft (`https://api.induxsoft.net/auth/login/`), de modo que **cada petición con token hace una llamada HTTP** a esa API. Si su sitio autentica contra su propia base de datos, sustitúyalo por el ejemplo `dbidp.dk`. Todo esto se explica en [Autenticación y autorización](/es/devkron/2.0/marcos/autenticacion/). ## Publicar el sitio en nginx Agregue un `server` con el nombre del host y pase todo al servidor FastCGI: ```nginx server { listen 80; server_name tienda.localhost; client_max_body_size 50m; location / { include fastcgi_params; fastcgi_pass devkron; # el upstream del servidor FastCGI } } ``` La configuración completa de nginx (upstream, socket Unix, keepalive) está en [Instalación y configuración](/es/devkron/2.0/instalacion/). La guía [Crear un sitio nuevo con nginx](/es/devkron/2.0/guias/sitio-nuevo-nginx.md) lo recorre de principio a fin. ## Errores típicos | Síntoma | Causa y solución | |---|---| | `No existe la plantilla indicada 'x'` | No hay carpeta `_templates/sites/x/`; ejecute desde la carpeta de la instalación | | `{0} Faltan parámetros.` | Faltan el nombre de la plantilla o el host | | Los servicios `.fso` responden 404 | Cambie la regla de `ext.map` a `.fso > $fso/fso.*.dkl` | | Todas las páginas tardan cuando llevan token | `idp/default.dk` llama a la API de Induxsoft en cada petición; use un proveedor propio si no necesita esa API |