website/docs: Prepare for monorepo. (#14119)
* docusaurus-theme: Fix header alignment, overscroll, vertical padding. * docusaurus-theme: Lint. * website/docs: Prepare for monorepo packages. * website/docs: Clean up dependencies. Tidy table. * website/docs: Fix issue where Prettier affects example content. * website/docs: Temp fix for stale packages.
This commit is contained in:
		| @ -1,63 +1,38 @@ | ||||
| import { generateVersionDropdown } from "./src/utils.js"; | ||||
| /** | ||||
|  * @file Sidebar configuration for documentation entries. | ||||
|  * | ||||
|  * @todo Move releases into a JSON file. | ||||
|  * @todo Fix typescript import of `apiReference`. | ||||
|  */ | ||||
| import apiReference from "./docs/developer-docs/api/reference/sidebar"; | ||||
| import { generateVersionDropdown } from "./src/utils.js"; | ||||
| import releases from "./static/releases.json" with { type: "json" }; | ||||
|  | ||||
| const releases = [ | ||||
|     "releases/2025/v2025.2", | ||||
|     "releases/2024/v2024.12", | ||||
|     "releases/2024/v2024.10", | ||||
|     { | ||||
| const SUPPORTED_RELEASE_COUNT = 3; | ||||
|  | ||||
| // TODO: This logic is a placeholder for a more robust solution. | ||||
| /** | ||||
|  * @type {any[]} | ||||
|  */ | ||||
| const releaseEntries = [ | ||||
|     // Grab the latest releases and add them to the sidebar. | ||||
|     ...releases.slice(0, SUPPORTED_RELEASE_COUNT), | ||||
| ]; | ||||
|  | ||||
| if (releases.length > SUPPORTED_RELEASE_COUNT) { | ||||
|     // Then we add the rest of the releases as a category. | ||||
|     releaseEntries.push({ | ||||
|         type: "category", | ||||
|         label: "Previous versions", | ||||
|         items: [ | ||||
|             "releases/2024/v2024.8", | ||||
|             "releases/2024/v2024.6", | ||||
|             "releases/2024/v2024.4", | ||||
|             "releases/2024/v2024.2", | ||||
|             "releases/2023/v2023.10", | ||||
|             "releases/2023/v2023.8", | ||||
|             "releases/2023/v2023.6", | ||||
|             "releases/2023/v2023.5", | ||||
|             "releases/2023/v2023.4", | ||||
|             "releases/2023/v2023.3", | ||||
|             "releases/2023/v2023.2", | ||||
|             "releases/2023/v2023.1", | ||||
|             "releases/2022/v2022.12", | ||||
|             "releases/2022/v2022.11", | ||||
|             "releases/2022/v2022.10", | ||||
|             "releases/2022/v2022.9", | ||||
|             "releases/2022/v2022.8", | ||||
|             "releases/2022/v2022.7", | ||||
|             "releases/2022/v2022.6", | ||||
|             "releases/2022/v2022.5", | ||||
|             "releases/2022/v2022.4", | ||||
|             "releases/2022/v2022.2", | ||||
|             "releases/2022/v2022.1", | ||||
|             "releases/2021/v2021.12", | ||||
|             "releases/2021/v2021.10", | ||||
|             "releases/2021/v2021.9", | ||||
|             "releases/2021/v2021.8", | ||||
|             "releases/2021/v2021.7", | ||||
|             "releases/2021/v2021.6", | ||||
|             "releases/2021/v2021.5", | ||||
|             "releases/2021/v2021.4", | ||||
|             "releases/2021/v2021.3", | ||||
|             "releases/2021/v2021.2", | ||||
|             "releases/2021/v2021.1", | ||||
|             "releases/old/v0.14", | ||||
|             "releases/old/v0.13", | ||||
|             "releases/old/v0.12", | ||||
|             "releases/old/v0.11", | ||||
|             "releases/old/v0.10", | ||||
|             "releases/old/v0.9", | ||||
|         ], | ||||
|     }, | ||||
| ]; | ||||
|         items: releases.slice(SUPPORTED_RELEASE_COUNT), | ||||
|     }); | ||||
| } | ||||
|  | ||||
| export default { | ||||
|     docs: [ | ||||
|         { | ||||
|             type: "html", | ||||
|             value: generateVersionDropdown(releases), | ||||
|             value: generateVersionDropdown(releases.slice(0, SUPPORTED_RELEASE_COUNT)), | ||||
|         }, | ||||
|         { | ||||
|             type: "doc", | ||||
| @ -147,10 +122,7 @@ export default { | ||||
|                                 type: "doc", | ||||
|                                 id: "add-secure-apps/providers/property-mappings/index", | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 "add-secure-apps/providers/property-mappings/expression", | ||||
|                                 , | ||||
|                             ], | ||||
|                             items: ["add-secure-apps/providers/property-mappings/expression"], | ||||
|                         }, | ||||
|                         { | ||||
|                             type: "category", | ||||
| @ -171,9 +143,7 @@ export default { | ||||
|                                 type: "doc", | ||||
|                                 id: "add-secure-apps/providers/ldap/index", | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 "add-secure-apps/providers/ldap/generic_setup", | ||||
|                             ], | ||||
|                             items: ["add-secure-apps/providers/ldap/generic_setup"], | ||||
|                         }, | ||||
|                         { | ||||
|                             type: "category", | ||||
| @ -246,9 +216,7 @@ export default { | ||||
|                                 type: "doc", | ||||
|                                 id: "add-secure-apps/providers/ssf/index", | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 "add-secure-apps/providers/ssf/create-ssf-provider", | ||||
|                             ], | ||||
|                             items: ["add-secure-apps/providers/ssf/create-ssf-provider"], | ||||
|                         }, | ||||
|                     ], | ||||
|                 }, | ||||
| @ -326,9 +294,7 @@ export default { | ||||
|                                 type: "doc", | ||||
|                                 id: "add-secure-apps/flows-stages/bindings/index", | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 "add-secure-apps/flows-stages/bindings/work_with_bindings", | ||||
|                             ], | ||||
|                             items: ["add-secure-apps/flows-stages/bindings/work_with_bindings"], | ||||
|                         }, | ||||
|                     ], | ||||
|                 }, | ||||
| @ -470,10 +436,7 @@ export default { | ||||
|                         type: "doc", | ||||
|                         id: "users-sources/groups/index", | ||||
|                     }, | ||||
|                     items: [ | ||||
|                         "users-sources/groups/manage_groups", | ||||
|                         "users-sources/groups/group_ref", | ||||
|                     ], | ||||
|                     items: ["users-sources/groups/manage_groups", "users-sources/groups/group_ref"], | ||||
|                 }, | ||||
|                 { | ||||
|                     type: "category", | ||||
| @ -517,9 +480,7 @@ export default { | ||||
|                                         type: "doc", | ||||
|                                         id: "users-sources/sources/protocols/kerberos/index", | ||||
|                                     }, | ||||
|                                     items: [ | ||||
|                                         "users-sources/sources/protocols/kerberos/browser", | ||||
|                                     ], | ||||
|                                     items: ["users-sources/sources/protocols/kerberos/browser"], | ||||
|                                 }, | ||||
|                                 "users-sources/sources/protocols/ldap/index", | ||||
|                                 "users-sources/sources/protocols/oauth/index", | ||||
| @ -534,9 +495,7 @@ export default { | ||||
|                                 type: "doc", | ||||
|                                 id: "users-sources/sources/property-mappings/index", | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 "users-sources/sources/property-mappings/expressions", | ||||
|                             ], | ||||
|                             items: ["users-sources/sources/property-mappings/expressions"], | ||||
|                         }, | ||||
|                         { | ||||
|                             type: "category", | ||||
| @ -606,10 +565,7 @@ export default { | ||||
|                         type: "doc", | ||||
|                         id: "sys-mgmt/events/index", | ||||
|                     }, | ||||
|                     items: [ | ||||
|                         "sys-mgmt/events/notifications", | ||||
|                         "sys-mgmt/events/transports", | ||||
|                     ], | ||||
|                     items: ["sys-mgmt/events/notifications", "sys-mgmt/events/transports"], | ||||
|                 }, | ||||
|                 "sys-mgmt/certificates", | ||||
|                 "sys-mgmt/settings", | ||||
| @ -805,7 +761,7 @@ export default { | ||||
|                 slug: "releases", | ||||
|                 description: "Release Notes for recent authentik versions", | ||||
|             }, | ||||
|             items: releases, | ||||
|             items: releaseEntries, | ||||
|         }, | ||||
|     ], | ||||
| }; | ||||
|  | ||||
		Reference in New Issue
	
	Block a user
	 Teffen Ellis
					Teffen Ellis