tibi-docs/astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

// https://astro.build/config
export default defineConfig({
	site: 'https://docs.tibicms.de',
	vite: {
		server: {
			allowedHosts: [
				'docs.tibicms.de',
				'tibi-docs.code.testversion.online',
				'localhost',
				'127.0.0.1',
			],
		},
	},
	integrations: [
		starlight({
			title: 'Tibi Doku',
			description: 'Entwickler- und Anwender-Dokumentation für Tibi-Server und Tibi-Admin',
			defaultLocale: 'root',
			locales: {
				root: { label: 'Deutsch', lang: 'de' },
			},
			logo: {
				src: './src/assets/favicon.svg',
				replacesTitle: false,
			},
			favicon: '/favicon.svg',
			customCss: ['./src/styles/custom.css'],
			social: [
				{ icon: 'github', label: 'gitbase.de', href: 'https://gitbase.de/cms/tibi-docs' },
			],
			editLink: {
				baseUrl: 'https://gitbase.de/cms/tibi-docs/_edit/master/',
			},
			tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 3 },
			lastUpdated: true,
			sidebar: [
				{
					label: 'Einstieg',
					items: [
						{ label: 'Was ist Tibi?', slug: 'einstieg/was-ist-tibi' },
						{ label: 'Schnellstart', slug: 'einstieg/schnellstart' },
						{ label: 'Begriffe', slug: 'einstieg/begriffe' },
						{ label: 'Neues Projekt', slug: 'einstieg/neues-projekt' },
					],
				},
				{
					label: 'Server',
					items: [
						{ label: 'Übersicht', slug: 'server/uebersicht' },
						{ label: 'Konfiguration', slug: 'server/konfiguration' },
						{ label: 'Betrieb', slug: 'server/betrieb' },
						{ label: 'Sicherheit', slug: 'server/sicherheit' },
						{ label: 'Schnittstellen', slug: 'server/schnittstellen' },
					],
				},
				{
					label: 'Projekt bauen',
					items: [
						{ label: 'Sammlungen', slug: 'projekt/sammlungen-anlegen' },
						{ label: 'Felder und Widgets', slug: 'projekt/felder-widgets' },
						{ label: 'Lesen und suchen', slug: 'projekt/abfragen-lesen' },
						{ label: 'Rechte und Tokens', slug: 'projekt/rechte-tokens' },
						{ label: 'Feld-Rechte', slug: 'projekt/feld-rechte' },
						{ label: 'Hooks', slug: 'projekt/hooks-schreiben' },
						{ label: 'Dateien und Bilder', slug: 'projekt/dateien-bilder' },
						{ label: 'Navigation und Sprachen', slug: 'projekt/navigation-i18n' },
						{ label: 'Suche', slug: 'projekt/suche' },
						{ label: 'Pagebuilder-Anbindung', slug: 'projekt/pagebuilder-dev' },
						{ label: 'Website mit SSR', slug: 'projekt/ssr-website' },
						{ label: 'Jobs und Aktionen', slug: 'projekt/jobs-actions' },
						{ label: 'LLM nutzen', slug: 'projekt/llm-nutzen' },
						{ label: 'MCP nutzen', slug: 'projekt/mcp-nutzen' },
						{ label: 'Sicherung', slug: 'projekt/audit-backup' },
						{ label: 'Veröffentlichen', slug: 'projekt/deploy' },
						{ label: 'Tests und Mock', slug: 'projekt/tests' },
					],
				},
				{
					label: 'Admin',
					items: [
						{ label: 'Konzept', slug: 'admin/konzept' },
						{ label: 'Einrichten', slug: 'admin/setup' },
						{ label: 'Anpassen', slug: 'admin/customizing' },
						{ label: 'Ansichten und Listen', slug: 'admin/ansichten-listen' },
						{ label: 'Eintrags-Editor', slug: 'admin/eintrags-editor' },
						{ label: 'Medien', slug: 'admin/medien' },
						{ label: 'Exporte', slug: 'admin/exporte' },
						{ label: 'Aktionen', slug: 'admin/aktionen' },
						{ label: 'Benutzer und Rechte', slug: 'admin/benutzer-rechte' },
						{ label: 'KI-Funktionen', slug: 'admin/ki-funktionen' },
					],
				},
				{
					label: 'Anwender',
					items: [
						{ label: 'Anmelden', slug: 'anwender/anmelden' },
						{ label: 'Zurechtfinden', slug: 'anwender/orientierung' },
						{ label: 'Lesen, suchen, filtern', slug: 'anwender/lesen-suchen-filtern' },
						{ label: 'Einträge bearbeiten', slug: 'anwender/eintrag-bearbeiten' },
						{ label: 'Bilder und Dateien', slug: 'anwender/medien' },
						{ label: 'Seiten bauen', slug: 'anwender/seiten-bauen' },
						{ label: 'Verlauf und Wiederherstellen', slug: 'anwender/verlauf-wiederherstellen' },
						{ label: 'Mehrere Einträge ändern', slug: 'anwender/massenbearbeitung' },
						{ label: 'Aktionen ausführen', slug: 'anwender/aktionen' },
						{ label: 'Tastenkürzel', slug: 'anwender/tastenkombinationen' },
						{ label: 'Benutzer und Teams', slug: 'anwender/benutzer-teams' },
						{ label: 'Exportieren', slug: 'anwender/exportieren' },
						{ label: 'Sichern', slug: 'anwender/sichern' },
						{ label: 'Backup einspielen', slug: 'anwender/backup-einspielen' },
						{ label: 'Hilfe', slug: 'anwender/hilfe' },
						{ label: 'KI nutzen', slug: 'anwender/ki-nutzen' },
					],
				},
				{
					label: 'Referenz',
					items: [
						{ label: 'OpenAPI', slug: 'reference/openapi' },
						{ label: 'Schemas', slug: 'reference/schemas' },
						{ label: 'Schema-Properties', slug: 'reference/schema-properties' },
						{ label: 'System-Routen', slug: 'reference/rest-system' },
						{ label: 'Hook-Kontexte', slug: 'reference/hook-kontexte' },
						{ label: 'Hook-Referenz: Daten', slug: 'reference/hooks-daten' },
						{ label: 'Hook-Referenz: Netze und Nachrichten', slug: 'reference/hooks-netze' },
						{ label: 'Hook-Referenz: Sicherheit und Identität', slug: 'reference/hooks-sicherheit' },
						{ label: 'Hook-Referenz: Formate und Diagnose', slug: 'reference/hooks-meta' },
						{ label: 'Hook-Referenz: Templates und Medien', slug: 'reference/hooks-medien' },
						{ label: 'Token-Köpfe', slug: 'reference/token-koepfe' },
						{ label: 'Fehlerbilder', slug: 'reference/fehlercodes' },
						{ label: 'Tastatur und Schnellsuche', slug: 'reference/tastatur-kurzbefehle' },
					],
				},
				{
					label: 'ADR',
					items: [
						{ label: 'Vorlage', slug: 'adr/0000-vorlage' },
						{ label: 'Starlight', slug: 'adr/0001-starlight' },
						{ label: 'Code schlägt Doku', slug: 'adr/0002-code-schlaegt-doku' },
						{ label: 'Selbstläufer-Regel', slug: 'adr/0003-selbstlaeufer' },
					],
				},
			],
			head: [
				{
					tag: 'link',
					attrs: {
						rel: 'preconnect',
						href: 'https://fonts.googleapis.com',
					},
				},
			],
		}),
	],
});