Configuración

La configuración principal de IZ-KnowledgeBase está en astro.config.mjs, src/content.config.ts, package.json y src/styles/custom.css.

El proyecto no requiere variables de entorno para operar localmente o generar el build estático.

Configuración Starlight

Configuración	Valor actual	Uso
`title`	Espacio en blanco	Evita mostrar título textual junto al logo.
`logo.src`	`./src/assets/logo-interzone.png`	Logo Interzone.
`locales.root.lang`	`es`	Interfaz en español.
`tableOfContents`	`h2` a `h3`	Muestra “En esta página”.
`customCss`	`./src/styles/custom.css`	Estilos Interzone.
`sidebar`	Autogenerado por directorio	Navegación principal.

La navegación principal se define por directorios:

Sección	Directorio
Estándares	`estandares`
Proyectos	`proyectos`
Clientes	`clientes`
Guías técnicas	`guias`
Inventario	`inventario`
Ideas y backlog	`ideas`

Para agregar una nueva guía, crear un .md o .mdx dentro del directorio correspondiente. Starlight lo mostrará automáticamente si la sección usa autogenerate.

Frontmatter estándar

Cada página debe incluir frontmatter mínimo:

---
title: Título
description: Descripción breve.
sidebar:
  order: 1
tableOfContents:
  minHeadingLevel: 2
  maxHeadingLevel: 3
---

Configuración de contenido

src/content.config.ts define la colección documental:

import { defineCollection } from 'astro:content';
import { docsLoader } from '@astrojs/starlight/loaders';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
};

Markdown y MDX

Tipo	Uso recomendado
`.md`	Documentación estándar.
`.mdx`	Páginas que usan componentes Starlight o JSX.

Variables de entorno

Variable	Estado
Build local	No requiere variables.
Publicación estática	No requiere variables.
Tokens de despliegue	Solo si se automatiza con Wrangler o CI/CD.