Glosario
Definiciones breves de los términos que encontrarás al leer estos docs. Las entradas que tienen una página de tema más profunda la nombran al final.
instance
Una copia en ejecución de Chinaski sirviendo un sitio: su propio servicio de systemd, su propio archivo de base de datos SQLite, sus propios ajustes. Varias instancias: por cliente, por etapa: pueden compartir un servidor mediante el patrón de unidad por instancia (ver Quickstart y The Database).
CMS
La aplicación de administración privada donde escribes el contenido. Guarda todo en SQLite y, en producción, se enlaza únicamente a una dirección de loopback, así que los visitantes nunca la alcanzan.
builder
El proceso separado que convierte tu base de datos de contenido en el sitio estático: lee la base de datos, renderiza tus plantillas y escribe HTML plano al disco. Los builds son explícitos: dashboard, webhook, API o línea de comandos: nunca efectos secundarios automáticos.
staging y live
Cada build se escribe en un directorio staging junto a la salida, y luego se intercambia a la salida live solo cuando el build está completo y pasa sus verificaciones de seguridad. Un build fallido deja al sitio anterior sirviendo sin tocar.
block
Un fragmento de contenido estructurado reutilizable incrustado en cualquier página o post con {{block:name}}. Los tipos simples toman campos planos; los tipos estructurados almacenan filas repetidas como JSON con un editor de filas. Ver Blocks.
stack
Una secuencia de bloques tratada como una unidad: duplicable, exportable, con historial de revisiones y diffs. Pensada para secciones grandes que se repiten entre páginas.
snippet
HTML/JavaScript/CSS crudo inyectado en el <head> o <body> de las páginas compiladas: para etiquetas de analítica, tokens de verificación, estilos personalizados. Los snippets pueden ser globales (todas las páginas) o asignarse a páginas y posts individuales. Ver Snippets.
slot
Una ubicación de menú con nombre en un theme (por ejemplo header o footer), descubierta a partir de los marcadores de workspace que declaran tus plantillas, y luego ofrecida en el Navigation del admin. Ver Navigation y la referencia de Themes.
theme
El conjunto de plantillas que renderiza tu sitio: un theme activo por instancia. Los themes proveen plantillas de página, post y listados, y exponen los tipos de bloque y los ajustes del sitio como variables de plantilla (ver el doc integrado de Themes).
media
Imágenes y archivos cargados con sus metadatos (texto alt, leyendas, dimensiones). La carpeta de medios se sincroniza en el árbol de salida de cada idioma en el momento del build.
modo air-gap
El estado de despliegue sin red saliente. Activarlo muestra un banner en la barra lateral y cambia el comportamiento donde las conexiones importan: el código de snippets externos se elimina, las restauraciones remotas de respaldos se deshabilitan, y las integraciones que llaman hacia afuera no están disponibles. La instalación sin conexión también está soportada mediante un instalador incluido.
render cache y conjunto sucio
Cómo se mantienen rápidos los builds: el contenido sin cambios se reconoce y se salta (sin re-render), mientras que los elementos editados, las transiciones programadas desde el último build y las páginas que dependen de bloques o stacks modificados se reconstruyen.
build fingerprint
Un hash de la configuración que afecta al build y de las plantillas del theme. Cuando algo global cambia: un ajuste, el theme: la huella deja de coincidir y el siguiente build cae a un rebuild completo para que no se pierda nada.
promotion guard y builds bloqueados
La verificación de "siempre en línea" entre un build terminado y la publicación: un build que haría caer una gran proporción de páginas o dispararía los enlaces rotos queda bloqueado, y el sitio anterior sigue sirviendo. Un "Promote anyway" explícito te permite saltarlo para un build (ver Build Failures).
redirect pattern
Una redirección cuyo slug antiguo termina en *, coincidiendo con cada ruta bajo ese prefijo, con $1 sustituyendo el sufijo coincidente en el destino. Las redirecciones por patrón se sirven como páginas de redirección en lugar de reglas de configuración del servidor.
secreto de instancia (CHINASKI_SECRET)
La clave aleatoria de 32+ bytes requerida al arrancar: firma las cookies de sesión y cifra las credenciales almacenadas. Se excluye de las exportaciones de ajustes, nunca saliendo de tu servidor.
cuenta placeholder y /setup
Las instalaciones frescas empiezan con una contraseña de admin placeholder. Cada solicitud de admin redirige a /setup hasta que se establece una contraseña real, después de lo cual la página de setup desaparece (404). Restablecer una contraseña de admin re-arma ese mismo flujo.
manager
El Chinaski Manager (github.com/bigjohncobb/chinaski-manager): un panel de control separado e incluido para aprovisionar y ejecutar muchas instancias del CMS en un servidor: tenants, ciclo de vida de instancias (build/deploy/rollback/start/stop), adjunción de dominios con regeneración automática del servidor web, respaldos por instancia y del plano de control, y verificaciones de salud. Sus "tenants" agrupan instancias a nivel de manager; no pone varios sitios en una sola base de datos (ver Instances).