Configuración

Todo lo de abajo vive bajo duxt en tu app/app.config.ts. Cómo funciona la combinación, y por qué los arrays reemplazan en lugar de añadirse, está en Configuración.

#Sitio

#Comportamiento

export default defineAppConfig({
  duxt: {
    copy: {
      models: [
        {
          label: 'Mi asistente',
          icon: 'simple-icons:openai',
          url: 'https://example.com/new?prompt='
        }
      ]
    },
    contributors: {
      avatarUrl: 'https://github.com/{username}.png?size=96'
    },
    toc: { depth: 4, scrollOffset: 112 },
    search: {
      fuzzy: { threshold: 0.3, minMatchCharLength: 3, limit: 15 },
      recentPages: 8
    },
    openapi: { exampleDepth: 6, schemaDepth: 8 },
    shortcuts: { singleCharacter: false }
  }
})

Las listas sustituyen sus valores iniciales. Una lista copy.models vacía elimina destinos externos, no las acciones de copiar y ver la fuente. search.recentPages: 0 no guarda entradas nuevas. Las opciones fuzzy solo afectan a las aproximaciones tras una búsqueda Content vacía. Sin callback de analytics no se envía nada; consentimiento, proveedor y almacenamiento pertenecen al sitio consumidor.

#logo

Definir uno es Dale identidad a tu sitio.

#organization

El nodo Organization que los buscadores y los resúmenes de IA leen para nombrar una fuente. Ausente hasta que lo definas: duxt renderiza la documentación de otros y no adivina de quién.

#Anuncios

Un aviso para todo el sitio: una versión, una migración o un mantenimiento. No se renderiza ni se reserva espacio hasta que escribas una entrada.

announcements: [
  {
    text: { 'en-GB': 'Version 2 is out.', 'es-ES': 'La versión 2 ya está disponible.' },
    link: { label: 'Leer las notas', to: '/releases/v2' }
  },
  {
    id: 'march-maintenance',
    text: 'Mantenimiento programado el domingo desde las 09:00 UTC.',
    placement: 'below-header',
    startsAt: '2026-03-01T09:00:00Z',
    endsAt: '2026-03-08T09:00:00Z'
  }
],
announcementOptions: { maxVisible: 1 }

La lista se dibuja en orden: una versión y una incidencia son dos anuncios, y el final de uno no debe retirar el otro.

#Dónde se dibujan

above-content pertenece a la columna del documento, por lo que aparece en páginas de documentación y no en una landing sin esa columna.

announcementOptions.maxVisible limita cuántos anuncios muestra a la vez cada ubicación. Un número limita cada ubicación, un objeto las limita por separado ({ 'above-header': 1 }), y null, una clave omitida o la ausencia de maxVisible significa sin límite. Al cerrar el anuncio superior, el siguiente ocupa su lugar.

#Cuándo se muestran

startsAt y endsAt se evalúan en el navegador contra el reloj del lector. El anuncio empieza y termina sin despliegue ni recarga. La ventana es semiabierta: se muestra desde startsAt y hasta endsAt.

Incluye un offset cuando importe el instante exacto (2026-03-01T09:00:00Z). Sin zona horaria se usa la hora local del lector. Una fecha inválida se trata como ausente, para que un error tipográfico no esconda el aviso silenciosamente.

#Cierre

Un anuncio cerrado sigue cerrado durante la navegación, las recargas y los cambios de idioma. Se recuerda su identidad:

• con id, exactamente esa cadena independiente del locale; cambiarla vuelve a mostrar el anuncio a todos,
• sin id, un valor derivado de todas las variantes de text y link; cambiar el texto crea un anuncio nuevo, reordenar claves de locale no.

Usa id cuando quieras corregir el texto sin volver a mostrarlo. Los cierres solo viven en localStorage; las claves de anuncios eliminados se descartan. Como el reloj y los cierres pertenecen al navegador, la franja se dibuja tras la hidratación.

La superficie del componente está en DuxtAnnouncements.

#Navegación y enlaces

Una entrada de sección es un enlace más un campo propio:

Útil donde las páginas no pueden llevar icono — el frontmatter de un ADR está fijado en title, description, status y date, así que el registro de decisiones se representaría sin ninguno.

La mayoría se entregan vacíos, por dos razones distintas. links, aside.links, footer.legal, title, version y el texto de la página de inicio nombran un proyecto concreto — un repositorio, una comunidad, un aviso legal, un nombre, una publicación, una frase sobre lo que hace — y pertenecen a quien gestiona el sitio. sections nombra las partes de un árbol de documentación, y el árbol es tuyo: cuatro pestañas apuntando a nombres de carpeta que la capa hubiera adivinado no llevarían a ninguna parte. Defínelo cuando tu documentación tenga secciones; hasta entonces la fila no se representa y la barra lateral muestra el árbol completo, que es la forma correcta para una documentación sin secciones.

Una fila por fuente. Una entrada pertenece a la fuente bajo cuyo prefijo de URL se encuentra, y la fila muestra las entradas de la fuente en la que está el lector — así, un sitio con la documentación en la raíz y otra cosa en /demo escribe una sola lista sections y cada área dibuja su parte de ella. Una sección generada bajo un área (/demo/openapi) pertenece a esa área en lugar de ser un área propia. Un sitio con una sola fuente tiene un área, cada entrada está dentro, y la fila es exactamente la lista tal como se escribió.

#La página de inicio

La página en / dibuja tres bandas, y cada una está ausente hasta que se define su clave.

command es una string simple, no texto: un comando de shell es igual en todos los idiomas, y uno traducido por error es uno que no se ejecuta. La capa no entrega ninguno — no sabe cómo se llama tu proyecto, por la misma razón por la que links está vacío.

No hay llamada a la acción final, deliberadamente. Los botones del bloque principal son la llamada; repetirlos bajo una rejilla de tarjetas exige a un lector recién llegado decidir dos veces.

badge se entrega vacío por la misma razón que links: una píldora sobre el titular dice algo del estado de un proyecto — «beta», «v2 ya está» — y la capa no sabe nada del estado del tuyo. Una cadena es la forma corta; el objeto añade icono, color y destino.

badge: {
  label: '{version} publicada',
  icon: 'lucide:rocket',
  variant: 'success',
  to: 'https://github.com/acme/sdk/releases/latest',
  external: true
}

preview es una ventana viva, no una imagen. Incrusta una página de este sitio en un marco de navegador que el lector puede desplazar, navegar y cuyo tema puede cambiar sin salir de la página de inicio. El marco se monta solo cuando la banda entra en el viewport, y nunca durante el renderizado en servidor — un iframe en el HTML inicial es una segunda carga completa compitiendo con la primera.

#Forma de un enlace

Todo campo marcado como texto admite un literal, una clave i18n o un registro por locale — véase Localización.

#Fuentes

Ambas claves de fuente tienen su propia página. locales es la tercera clave de compilación: cambiar cualquiera de las tres exige recompilar.

#El feed

/rss.xml está vacío hasta que feed.path nombra una sección:

feed: { path: '/changelog', title: 'mi proyecto — publicaciones' }

Desactivado por defecto a propósito. Un feed es una lista de cosas que han pasado, y una página de referencia editada no es un acontecimiento — un sitio que publica cada edición como elemento enseña a sus lectores a darse de baja. Los elementos se ordenan por el date propio de la página, recurriendo al último commit que la tocó, y solo la versión predeterminada de cada fuente contribuye, de modo que un changelog versionado no repite cada entrada una vez por versión.

La sección a la que suele apuntar es un historial de versiones, cuyas páginas llevan cada una su date.

#Generado, no escrito

Definir cualquiera de los tres a mano se sobrescribe en la siguiente compilación.