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

#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.

#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/api) 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.