Releases: withastro/starlight
@astrojs/[email protected]
@astrojs/[email protected]
@astrojs/[email protected]
@astrojs/[email protected]
@astrojs/[email protected]
Minor Changes
-
#1846
2de67039
Thanks @delucis! - Updates@astrojs/mdx
to v3 and enables MDX optimization by default⚠️ Potentially breaking change: MDX optimization speeds up builds (Starlight’s docs are building ~40% faster for example), but restricts some advanced MDX features. See full details in the MDX optimization documentation.Most Starlight users should be unaffected, but if you are using MDX files outside of Starlight pages with the
components
prop, you may see issues. You can disable optimization by adding MDX manually to yourintegrations
array inastro.config.mjs
:import { defineConfig } from 'astro/config'; + import mdx from '@astrojs/mdx'; import starlight from '@astrojs/starlight'; // https://astro.build/config export default defineConfig({ integrations: [ starlight({ title: 'My docs', // ... }), + mdx(), ], });
-
#1735
1a9ab50d
Thanks @HiDeoo! - Adds custom styles for<details>
and<summary>
elements in Markdown content. -
#1846
2de67039
Thanks @delucis! -⚠️ BREAKING CHANGE: The minimum supported version of Astro is now 4.8.6Please update Astro and Starlight together:
npx @astrojs/upgrade
@astrojs/[email protected]
Patch Changes
-
#1871
03bb126b
Thanks @delucis! - Adds ablueSky
icon and social link option -
#1873
13f33b81
Thanks @ekfuhrmann! - Adds 1 new icon:alpine
-
#1857
32cdfaf0
Thanks @tarikcoskun! - Updates Turkish UI translations -
#1736
cfa94a34
Thanks @julien-deramond! - Prevent list items from overflowing Markdown content
@astrojs/[email protected]
Patch Changes
-
#1838
9fe84754
Thanks @delucis! - Adds extra information to the errors thrown by the<Steps>
component to help locate misformatted code -
#1863
50be60bb
Thanks @torn4dom4n! - Update Vietnamese translation -
#1837
a33a1223
Thanks @delucis! - Adds three new icons:comment
,comment-alt
,heart
-
#1842
c7838636
Thanks @delucis! - Moves thehref
used in the site title link to Starlight’s route data object. This makes it possible for overrides to change the title link while reusing Starlight’s default component implemenation. -
#1840
cb85563c
Thanks @MiahaCybersec! - Adds 1 new icon:hackerone
@astrojs/[email protected]
@astrojs/[email protected]
@astrojs/[email protected]
Minor Changes
-
#640
7dc503ea
Thanks @HiDeoo! - Adds support for syncing multiple sets of tabs on the same page. -
#1620
ca0678ca
Thanks @emjio! - Adds support for translating the site title⚠️ Potentially breaking change: The shape of thetitle
field on Starlight’s internal config object has changed. This used to be a string, but is now an object.If you are relying on
config.title
(for example in a custom<SiteTitle>
or<Head>
component), you will need to update your code. We recommend using the newsiteTitle
prop available to component overrides:--- import type { Props } from '@astrojs/starlight/props'; // The site title for this page’s language: const { siteTitle } = Astro.props; ---
-
#1613
61493e55
Thanks @HiDeoo! - Adds newdraft
frontmatter option to exclude a page from production builds. -
#640
7dc503ea
Thanks @HiDeoo! - Updates the defaultline-height
from1.8
to1.75
. This change avoids having a line height with a fractional part which can cause scripts accessing dimensions involving the line height to get an inconsistent rounded value in various browsers.If you want to preserve the previous
line-height
, you can add the following custom CSS to your site::root { --sl-line-height: 1.8; }
-
#1720
749ddf85
Thanks @jacobdalamb! - Updatesastro-expressive-code
dependency to the latest minor release (0.35) and exposes a new@astrojs/starlight/expressive-code/hast
module for users who need to use Expressive Code’s version ofhast
.This includes a potentially breaking change if you use custom Expressive Code plugins. See the Expressive Code release notes for full details.
-
#1769
bd5f1cbd
Thanks @ncjones! - Adds support for accessing frontmatter data as a variable when using Markdoc
Patch Changes
-
#1788
681a4273
Thanks @dragomano! - Adds Russian translations for Expressive Code labels -
#1780
4db6025a
Thanks @MiahaCybersec! - Adds 1 new icon:signal
-
#1785
65009c9c
Thanks @dreyfus92! - Adds 5 new icons:node
,cloudflare
,vercel
,netlify
anddeno
-
#1786
d05d693a
Thanks @delucis! - Fixes type inference for i18n strings added by extending the default schema -
#1777
6949404b
Thanks @HiDeoo! - Fixes an issue where TypeScript could fail to serialize the frontmatter schema when configured to emit declaration files -
#1734
4493dcfa
Thanks @delucis! - Refactors<ThemeSelect>
custom element logic to improve performance -
#1731
f08b0dff
Thanks @techfg! - Fixes responding to system color scheme changes when theme isauto
-
#1793
2616f0c7
Thanks @Mrahmani71! - Updates the Farsi UI translations