Files
authentik/website/docusaurus-theme/hooks/title.ts
Teffen Ellis 72af009de8 website/docs: Improved Version Picker. (#14404)
* website: Flesh out version picker. Port 3.8 theme.

* website: Update Dockerfile to include compose.

* website: Flesh out branch override. Tidy list items.
2025-07-10 15:36:48 -04:00

23 lines
820 B
TypeScript

import { useDoc } from "@docusaurus/plugin-content-docs/client";
/**
* Title can be declared inside md content or declared through
* front matter and added manually. To make both cases consistent,
* the added title is added under the same div.markdown block
* See https://github.com/facebook/docusaurus/pull/4882#issuecomment-853021120
*
* We render a "synthetic title" if:
* - user doesn't ask to hide it with front matter
* - the markdown content does not already contain a top-level h1 heading
*
* @vendor docusaurus
*/
export function useSyntheticTitle(): string | null {
const { metadata, frontMatter, contentTitle } = useDoc();
const shouldRender = !frontMatter.hide_title && typeof contentTitle === "undefined";
if (!shouldRender) {
return null;
}
return metadata.title;
}