mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
30e486a41c
This commit extracts the heading ID generation logic into a shared utility
and updates both the route generation script and the markdown pipeline to use it.
This ensures consistency between the generated routes and the rendered
documentation, and fixes an issue where custom heading IDs (`{#id}`)
were ignored during route generation.
Fixes #67200
(cherry picked from commit bedfcb5644)
29 lines
978 B
TypeScript
29 lines
978 B
TypeScript
/*!
|
|
* @license
|
|
* Copyright Google LLC All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.dev/license
|
|
*/
|
|
|
|
/**
|
|
* Extracts the ID from a heading text.
|
|
* Supports custom ID syntax: `## My Heading {#custom-id}`
|
|
*/
|
|
export function getIdFromHeading(heading: string): string {
|
|
// extract the extended markdown heading id
|
|
// ex: ## MyHeading {# myId}
|
|
// This is recommended in case we end up having duplicate Ids but we still want the same heading text.
|
|
// We don't want to make Id generation stateful/too complex to handle duplicates automatically.
|
|
const customIdRegex = /{#\s*([\w-]+)\s*}/g;
|
|
const customId = customIdRegex.exec(heading)?.[1];
|
|
|
|
if (customId) {
|
|
return customId;
|
|
}
|
|
|
|
return heading
|
|
.toLowerCase()
|
|
.replace(/\s|\//g, '-') // replace spaces and slashes with dashes
|
|
.replace(/[^\p{L}\d\-]/gu, ''); // only keep letters, digits & dashes
|
|
}
|