Starlight 0.39: обновление навигации, стилей и i18n для документации

Starlight — официальный фреймворк Astro для создания документации. Версия 0.39 добавляет гибкость в автогенерацию навигации, улучшает стили и расширяет возможности для многоязычных сайтов.

Гибкая автогенерация ссылок в боковой панели

Раньше автогенерация всегда создавала отдельную группу в навигации для каждой директории. В версии 0.39 автоматически сгенерированные ссылки можно размещать рядом с любыми другими типами ссылок.

Если в проекте уже есть сгенерированные группы, обновите конфигурацию — оберните её в массив items:

// Было
autogenerate: { directory: 'some-dir' },

// Стало
items: [{ autogenerate: { directory: 'some-dir' } }],

Теперь можно комбинировать автогенерацию с ручными ссылками. Пример конфигурации:

[
  // Локальная страница вне директории features
  { label: 'Home', link: '/' },
  // Все страницы из директории
  { autogenerate: { directory: 'features' } },
  // Внешняя ссылка
  { label: 'Support', link: 'https://support.example.com' }
]

Улучшения CSS

Два изменения в стилях:

• Вложенные списки — исправлены отступы с помощью селектора :has(). Смотреть реализацию.
• Стабильность боковой панели — добавлено scrollbar-gutter: stable. Панель не сдвигается при раскрытии групп.

Многоязычные сайты

Три изменения для интернационализации:

• SEO для локалей — добавлены мета-ссылки x-default на страницу локали по умолчанию. Поисковики используют их как фолбэк-язык. Документация: Google Search.
• CJK-текст — свойство text-autospace автоматически добавляет пробелы между иероглифами и латиницей. Улучшает читаемость китайской и японской документации. Спецификация: MDN.
• i18next — обновлена базовая библиотека локализации с версии 23 до 26.

Как обновиться

Используйте CLI-инструмент:

npx @astrojs/upgrade

Команда обновит Starlight, Astro и установленные интеграции.

Перед обновлением проверьте CHANGELOG — там описаны миграционные шаги и breaking changes.

Команда и контрибьюторы

Разработкой Starlight занимается команда Astro.

В релизе участвовали: alomtvassam-ui, Andreas Deininger, Andriy Massimilla, Bugo, Elian, Felix Schneider, gesslar, Ian Trewella, John Goodliff, Joost de Valk, Josef Ježek, Junseong Park, Kevin Z, Linus Grolmes, Luke Hsiao, Maxime Mangel, MilesChou, Patrick Schratz, Paweł Cisło, Roman, Sakku, Shinya Fujino, Swapnil Jain, Tatsunori Uchino, vincent, Vojtěch Křižan, Woody Chang.