Rename 'short-title' page metadata to 'shortTitle' (#6870)

This updates the Dart docs site to align with the naming on the Flutter
docs site.

Author: parlough

site/lib/_sass/components/_breadcrumbs.scss

@@ -39,7 +39,7 @@ nav.breadcrumbs {
       }
     }
 
-    .child-icon {
+    .material-symbols {
       user-select: none;
     }
   }

site/lib/src/components/breadcrumbs.dart

@@ -6,6 +6,8 @@ import 'package:collection/collection.dart';
 import 'package:jaspr/jaspr.dart';
 import 'package:jaspr_content/jaspr_content.dart';
 
+import 'material_icon.dart';
+
 /// Breadcrumbs navigation component that
 /// follows ARIA guidelines and includes RDFa markup.
 ///
@@ -49,18 +51,15 @@ class PageBreadcrumbs extends StatelessComponent {
   /// Extract breadcrumbs from page data.
   ///
   /// Uses page metadata to generate breadcrumb titles with fallbacks:
-  /// breadcrumb >short-title > title.
+  /// `breadcrumb` > `shortTitle` > `title`.
   List<_BreadcrumbItem>? _breadcrumbsForPage(List<Page> pages, Page page) {
     final pageUrl = page.url;
 
     // Only show breadcrumbs if the URL isn't empty.
     if (pageUrl.isEmpty || pageUrl == '/') return null;
 
-    final pageData = page.data.page;
-
-    final displayTitle =
-        pageData['breadcrumb'] ?? pageData['short-title'] ?? pageData['title'];
-    if (displayTitle is! String || displayTitle.isEmpty) {
+    final pageBreadcrumb = page.breadcrumb;
+    if (pageBreadcrumb == null) {
       return null;
     }
 
@@ -85,15 +84,10 @@ class PageBreadcrumbs extends StatelessComponent {
       // Skip if no index page found.
       if (indexPage == null) continue;
 
-      final indexPageData = indexPage.data.page;
-      final indexTitle =
-          indexPageData['breadcrumb'] ??
-          indexPageData['short-title'] ??
-          indexPageData['title'];
-      if (indexTitle is String && indexTitle.isNotEmpty) {
+      if (indexPage.breadcrumb case final indexBreadcrumb?) {
         breadcrumbs.add(
           _BreadcrumbItem(
-            title: indexTitle,
+            title: indexBreadcrumb,
             url: indexPage.url,
           ),
         );
@@ -109,7 +103,7 @@ class PageBreadcrumbs extends StatelessComponent {
     // Add the current page as the final breadcrumb.
     breadcrumbs.add(
       _BreadcrumbItem(
-        title: displayTitle,
+        title: pageBreadcrumb,
         url: pageUrl,
       ),
     );
@@ -118,6 +112,19 @@ class PageBreadcrumbs extends StatelessComponent {
   }
 }
 
+extension on Page {
+  String? get breadcrumb {
+    final pageData = data.page;
+
+    final breadcrumbString =
+        pageData['breadcrumb'] ?? pageData['shortTitle'] ?? pageData['title'];
+    if (breadcrumbString is! String || breadcrumbString.isEmpty) {
+      return null;
+    }
+    return breadcrumbString;
+  }
+}
+
 final class _BreadcrumbItem {
   const _BreadcrumbItem({required this.title, required this.url});
 
@@ -157,12 +164,7 @@ final class _BreadcrumbItemComponent extends StatelessComponent {
         ],
       ),
       meta(attributes: {'property': 'position', 'content': index.toString()}),
-      if (!isLast)
-        span(
-          classes: 'material-symbols child-icon',
-          attributes: {'aria-hidden': 'true'},
-          [text('chevron_right')],
-        ),
+      if (!isLast) const MaterialIcon('chevron_right'),
     ],
   );
 }

src/content/community/index.md

@@ -1,6 +1,6 @@
 ---
 title: Community and support
-short-title: Community
+shortTitle: Community
 description: Communities, mailing lists, and bug databases for the Dart project.
 group: https://groups.google.com/a/dartlang.org
 ---

src/content/get-dart/archive/index.md

@@ -1,6 +1,6 @@
 ---
 title: Dart SDK archive
-short-title: Archive
+shortTitle: Archive
 description: >-
   Download specific stable, beta, dev, and main channel versions of
   the Dart SDK and the Dart API documentation.

src/content/get-dart/index.md

@@ -1,6 +1,6 @@
 ---
 title: Get the Dart SDK
-short-title: Get Dart
+shortTitle: Get Dart
 description: >-
   Get the libraries and command-line tools that you need to develop
   Dart web, command-line, and server apps.

src/content/get-started/add-commands.md

@@ -1,6 +1,6 @@
 ---
 title: Make your CLI program interactive
-short-title: Add commands
+shortTitle: Add commands
 description: >-
   Add simple commands to your cli application. Learn the fundamentals of Dart
   syntax including control flow, collections, variables, functions, and more.

src/content/get-started/advanced-oop.md

@@ -1,6 +1,6 @@
 ---
 title: Advanced OOP-adjacent features
-short-title: Advanced OOP Features
+shortTitle: Advanced OOP Features
 description: >-
   Enhance your Dart skills by exploring advanced features like enhanced enums
   and extensions. Improve your application's output formatting and color,

src/content/get-started/async.md

@@ -1,6 +1,6 @@
 ---
 title: Intro to async and HTTP
-short-title: Async and HTTP
+shortTitle: Async and HTTP
 description: >-
   Learn about asynchronous programming in Dart and how to make HTTP requests.
 sitemap: false

src/content/get-started/command-runner-polish.md

@@ -1,6 +1,6 @@
 ---
 title: Command_runner polish
-short-title: Command_runner polish
+shortTitle: Command_runner polish
 description: >-
   Improve the HelpCommand to provide more detailed information and add an
   onOutput argument for flexible output handling.

src/content/get-started/error-handling.md

@@ -1,6 +1,6 @@
 ---
 title: Error handling
-short-title: Error handling
+shortTitle: Error handling
 description: >-
   Improve app robustness by handling errors. Learn about exceptions, errors,
   `try/catch`, `throw`, and `rethrow`.