Preguntas frecuentes
¿Qué plantillas puedo usar?
Kit55 soporta plantillas Jinja2/Nunjucks que están listas para usar.
¿Cuál es la diferencia entre una página y una plantilla?
Ambas son archivos HTML y ambas pueden contener comandos de Jinja2/Nunjucks. Las plantillas son fragmentos parciales o bloques de una página HTML (es decir, un pie de página, un encabezado, un banner) y Kit55 los identifica cuando se nombran con la extensión .tpl.html.
Las páginas usan la extensión .html y pueden contener (o hacer referencia a) plantillas o bloques. Kit55 solo muestra páginas en la interfaz de usuario. Las plantillas y otros archivos no son visibles en la aplicación.
Cuando seleccionas un proyecto en la GUI, Kit55 escanea todas las carpetas de tus proyectos y muestra todas las páginas que se generarán.
Kit55 incluye un proyecto de muestra muy simple que se puede usar como referencia.
¿Cómo construye Kit55 mi sitio?
Kit55 busca proyectos en Documents/kit55/projects (1), así que copia tu proyecto allí. Kit55 tomará todas tus páginas de /src y mezclará el código de las plantillas en ellas, generando nuevas páginas HTML puras que se guardarán en /dist. Esas nuevas páginas reemplazarán las referencias a plantillas con el código del propio archivo de cada plantilla.
¿Qué sucede con mis imágenes, javascript, css y otros archivos que necesito para mi sitio?
Kit55 copiará todos esos archivos (todos los archivos que no terminen en .html) bajo /dist, conservando la misma estructura en /src. De esa manera, tu sitio podrá acceder a imágenes y a otros archivos como css o js, tomando como referencia a la carpeta raíz.
¿Necesito un servidor web local para trabajar en mi sitio web?
Algunos sitios web no funcionarán correctamente si se abren como archivos locales. Esto puede deberse a una variedad de razones, la más probable es que los navegadores no ejecuten llamadas asíncronas si accedes a tu sitio en local (simplemente abriendo el archivo HTML). Para solucionar el problema de las llamadas asíncronas, debes ejecutar el sitio web a en un servidor web local.
Kit55 proporciona un pequeño servidor web incorporado.
Un servidor local también ayuda a evitar errores de origen cruzado (cross-origin) que ocurren cuando se desarrolla en local, como el infame "Cross origin requests are only supported for HTTP".
(1) tu proyecto tiene que estar ubicado bajo Documents/kit55/projects.
/src se encuentra en proyectos/<su proyecto>/src y /dist se encuentra en proyectos/<tu proyecto>/dist.