/* =====================================================================
   doku.css — Codeboxen, Dokumentationsseiten, Navigation, Inhalts-
   verzeichnis

   Reihenfolge in dieser Datei ist an zwei Stellen bindend:
     1. .codebox steht VOR .doku-inhalt (eine Codebox in einem Doku-Text
        soll die Textregeln nicht überstimmen — so war es bisher).
     2. .doku-code steht NACH .doku-inhalt (dessen `pre` mit gleicher
        Spezifität überschrieben werden muss, u. a. border-radius: 0).

   Setzt basis.css voraus (Variablen).
   ===================================================================== */

/* =====================================================================
   Codebox (eigenständige Code-Anzeige mit Pfad im Kopf)
   ===================================================================== */

.codebox {
	border: 1px solid var(--bs-border-color);
	border-radius: .5rem;
	overflow: hidden;
	margin: .5rem 0 1.5rem;

	& pre {
		margin: 0;
		padding: .75rem 1rem;
		background: var(--bs-tertiary-bg);
		overflow-x: auto;
		font-size: .8125rem;
		line-height: 1.55;
		tab-size: 4;

		& code {
			padding: 0;
			background: none;
			color: inherit;
			font-size: inherit;
		}

		& .kom {
			color: var(--bs-success);
		}
	}
}

.codebox-kopf {
	display: flex;
	align-items: center;
	gap: .5rem;
	padding-block: .35rem;
	padding-inline: .75rem .5rem;
	background: var(--bs-secondary-bg);
	border-bottom: 1px solid var(--bs-border-color);
	font: .8125rem/1.4 var(--bs-font-monospace);
	color: var(--bs-secondary-color);

	& .pfad {
		font-weight: 600;
		color: var(--bs-body-color);
	}

	& .btn {
		margin-inline-start: auto;
		padding: .1rem .4rem;
		font-size: .75rem;
		line-height: 1.3;
	}
}

/* =====================================================================
   Kopfzeile einer Doku-Seite
   ===================================================================== */

.doku-kopf {
	border-bottom: 1px solid var(--bs-border-color);
	padding-bottom: .9rem;
	margin-bottom: 1.5rem;

	& h1 {
		font-size: 1.65rem;
		margin: 0;
	}

	& .doku-kurz {
		color: var(--bs-secondary-color);
		margin: .25rem 0 0;
		max-width: 60ch;
	}
}

/* =====================================================================
   Inhalt
   ===================================================================== */

.doku-inhalt {
	line-height: 1.65;

	/* Zeilenlänge begrenzen, aber nur für Fließtext. Tabellen, Codeblöcke
	   und Bilder dürfen die volle Breite nehmen — dort ist Breite
	   Information. */
	& > :is(p, ul, ol, blockquote, h1, h2, h3, h4) {
		max-width: 72ch;
	}

	& h1 {
		font-size: 1.8rem;
		margin-bottom: 1rem;
	}

	& h2 {
		font-size: 1.35rem;
		margin-top: 2.25rem;
		padding-top: .5rem;
		border-top: 1px solid var(--bs-border-color);
		scroll-margin-top: 1rem;
	}

	& h3 {
		font-size: 1.1rem;
		margin-top: 1.75rem;
		scroll-margin-top: 1rem;
	}

	& table {
		width: 100%;
		margin: 1rem 0;
		border-collapse: collapse;
		font-size: .925rem;
	}

	& :is(th, td) {
		border: 1px solid var(--bs-border-color);
		padding: .35rem .6rem;
		vertical-align: top;
	}

	& th {
		background: var(--bs-tertiary-bg);
		text-align: start;
	}

	& pre {
		background: var(--bs-tertiary-bg);
		padding: .75rem 1rem;
		border-radius: .375rem;
		overflow-x: auto;
		margin: 0;
	}

	& code {
		font-size: .875em;
	}

	& :not(pre) > code {
		background: var(--bs-tertiary-bg);
		padding: .1rem .3rem;
		border-radius: .25rem;
	}

	& blockquote {
		border-inline-start: .25rem solid var(--bs-border-color);
		padding-inline-start: 1rem;
		color: var(--bs-secondary-color);
	}

	& ul.table-of-contents {
		background: var(--bs-tertiary-bg);
		border-radius: .375rem;
		padding-block: .75rem;
		padding-inline: 2rem 1rem;
		font-size: .925rem;
	}

	& .task-list-item {
		list-style: none;
		margin-inline-start: -1.25rem;
	}

	/* Ankersymbol erst beim Überfahren — sonst steht in jeder Überschrift
	   ein Zeichen, das 99 % der Zeit niemanden interessiert. */
	& .doku-anker {
		text-decoration: none;
		color: var(--bs-secondary-color);
		opacity: 0;
		margin-inline-start: .4rem;
		font-weight: 400;

		&::after {
			content: "#";
		}
	}

	/* Muss nach der Grundfassung stehen: `.doku-anker:focus` hat dieselbe
	   Spezifität wie `.doku-anker` und gewinnt nur über die Reihenfolge. */
	& :is(h2, h3):hover .doku-anker,
	& .doku-anker:focus {
		opacity: .6;
	}
}

.doku-roh {
	white-space: pre-wrap;
}

/* =====================================================================
   Codeblöcke innerhalb der Doku
   ===================================================================== */

.doku-code {
	border: 1px solid var(--bs-border-color);
	border-radius: .375rem;
	overflow: hidden;
	margin: 1rem 0;

	/* Der Rahmen sitzt außen, das pre darf keinen zweiten Radius haben */
	& pre {
		border-radius: 0;
	}
}

.doku-code-kopf {
	display: flex;
	align-items: center;
	gap: .5rem;
	padding-block: .25rem;
	padding-inline: .75rem .5rem;
	background: var(--bs-secondary-bg);
	border-bottom: 1px solid var(--bs-border-color);
	font-size: .75rem;
	text-transform: uppercase;
	letter-spacing: .04em;
	color: var(--bs-secondary-color);

	& .btn {
		--bs-btn-padding-y: .05rem;
		--bs-btn-padding-x: .4rem;
		--bs-btn-font-size: .7rem;

		margin-inline-start: auto;
	}
}

/* =====================================================================
   Navigation
   ===================================================================== */

.doku-nav {
	& .nav-link {
		padding: .25rem .5rem;
		font-size: .925rem;
		border-radius: .25rem;

		&.active {
			font-weight: 600;
			background: var(--bs-tertiary-bg);
		}
	}
}

.doku-buendel {
	font-family: var(--bs-font-monospace);
	font-size: .8rem;
	white-space: pre;
	min-height: 22rem;
}

.doku-gruppe {
	& > summary {
		display: flex;
		align-items: center;
		gap: .35rem;
		cursor: pointer;
		list-style: none;

		&::-webkit-details-marker {
			display: none;
		}

		& .doku-pfeil {
			font-size: .75em;
			transition: transform var(--ue-normal) ease;
		}
	}

	&[open] > summary .doku-pfeil {
		transform: rotate(90deg);
	}
}

/* Etwas Luft am Ende der Zeile, damit die Bildlaufleiste nicht auf den
   Fähnchen sitzt (bei RTL steht sie links). */
.doku-nav-liste {
	padding-inline-end: .25rem;

	/* Die letzte Gruppe braucht unten keinen Abstand — sonst sieht es aus,
	   als käme noch etwas, wenn man ganz nach unten gescrollt hat. */
	& .doku-gruppe:last-child {
		margin-bottom: 0;
	}
}

/* =====================================================================
   Inhaltsverzeichnis der Seite
   ===================================================================== */

.doku-toc {
	font-size: .875rem;
	border-inline-start: 2px solid var(--bs-border-color);

	& ul {
		list-style: none;
		padding-inline-start: 0;
		margin: 0;

		& ul {
			padding-inline-start: .85rem;
		}
	}

	& a {
		display: block;
		padding-block: .2rem;
		padding-inline: .75rem 0;
		margin-inline-start: -2px;
		border-inline-start: 2px solid transparent;
		color: var(--bs-secondary-color);
		text-decoration: none;

		&:hover {
			color: var(--bs-body-color);
		}

		&.aktiv {
			color: var(--bs-primary);
			border-inline-start-color: var(--bs-primary);
			font-weight: 600;
		}
	}
}

.doku-toc-titel {
	font-size: .7rem;
	text-transform: uppercase;
	letter-spacing: .06em;
	color: var(--bs-secondary-color);
	padding-inline-start: .75rem;
	margin-bottom: .35rem;
}

/* =====================================================================
   Mitlaufende Spalten ab lg

   Bis lg läuft die Navigation im Textfluss mit — dort gibt es nichts zu
   scrollen, und eine feste Höhe wäre nur eine zweite Bildlaufleiste.
   Die Abfragen stehen hier verschachtelt bei ihren Regeln; anders als in
   der Werkbank überschreibt hier keine Regel eine fremde Klasse, die
   Reihenfolge ist also unkritisch.
   ===================================================================== */

.doku-nav-halter {
	@media (min-width: 992px) {
		position: sticky;
		top: 1rem;
		max-height: calc(100vh - 2rem);

		/* Halterung scrollt nicht selbst, sondern verteilt: Filterfeld oben
		   fest, die Liste nimmt den Rest und läuft über. Ohne min-height:0
		   würde das Kind hier nicht schrumpfen — der Grundwert 'auto' lässt
		   ein Flexkind nie kleiner werden als seinen Inhalt, und die Liste
		   schöbe die Halterung einfach in die Länge. */
		display: flex;
		flex-direction: column;

		& .doku-nav-liste {
			flex: 1 1 auto;
			min-height: 0;
			overflow-y: auto;
		}
	}
}

.doku-toc-halter {
	@media (min-width: 992px) {
		position: sticky;
		top: 1rem;
		max-height: calc(100vh - 2rem);
		overflow-y: auto;
	}
}