Operación del motor
Configuración global
La configuración general vive en CoreDocs.Engine/config.json. Controla la identidad del portal, el origen del contenido, la salida y la seguridad.
Claves principales#
| Clave | Uso |
|---|---|
project_name |
Nombre del portal |
tagline |
Texto principal de la home |
logo |
Logotipo corporativo |
base_path |
Prefijo de publicación |
content_root |
Ruta al repositorio de contenido |
output_root |
Carpeta de salida generada |
theme |
Colores corporativos |
navbar |
Navegación superior |
social |
Acciones de soporte |
ui |
Toggles visuales |
search |
Comportamiento del buscador |
footer |
Pie corporativo |
auth |
Protección local y CoreIAM |
Ejemplo realista#
{
"project_name": "CoreDocs",
"tagline": "Portal de documentación técnica de Esofitec con búsqueda contextual.",
"base_path": "/",
"content_root": "../CoreDocs.Tech/content",
"output_root": "dist"
}
content_root#
Apunta al directorio que contiene las categorías. En el modelo actual suele ser:
{
"content_root": "../CoreDocs.Tech/content"
}
Si el pipeline checkouta ambos repositorios como:
.../s/CoreDocs.Engine.../s/CoreDocs.Tech
ese valor funciona sin cambios.
output_root#
Define dónde se escribirá el build final.
Usos típicos:
dist: salida local por defecto../publish/site: staging local fuera del repo- una ruta absoluta controlada por el pipeline o el agente
Seguridad de borrado
El motor limpia por completo output_root antes de generar el sitio. No lo apuntes a carpetas con contenido que debas conservar.
base_path#
Debe reflejar cómo se servirá el portal:
/si la web cuelga del dominio raíz/documentacion/si se publica bajo un subpath
Si base_path no coincide con el hosting real, fallarán assets, rutas y callback de autenticación.
Estrategia por entornos#
Si necesitas diferencias entre desarrollo y producción, la opción más simple es mantener:
config.jsonpara local- una variante de pipeline que reemplace
base_path,output_rooto credenciales antes del build
No es recomendable subir secretos reales al repositorio.