0.13.0
Release Image

🍿 Minor Changes

  • #1023 a3b80f7 Thanks @kevinzunigacuellar! - Respect the trailingSlash and build.format Astro options when creating Starlight navigation links.

    ⚠️ Potentially breaking change: This change will cause small changes in link formatting for most sites. These are unlikely to break anything, but if you care about link formatting, you may want to change some Astro settings.

    If you want to preserve Starlight’s previous behavior, set trailingSlash: 'always' in your astro.config.mjs:

    import { defineConfig } from 'astro/config';
    import starlight from '@astrojs/starlight';
    

    export default defineConfig({
      trailingSlash: 'always',
      integrations: [
        starlight({
          // ...
        }),
      ],
    });

  • #742 c6a4bcb Thanks @hippotastic! - Adds Expressive Code as Starlight’s default code block renderer

    ⚠️ Potentially breaking change: This addition changes how Markdown code blocks are rendered. By default, Starlight will now use Expressive Code. If you were already customizing how code blocks are rendered and don’t want to use the features provided by Expressive Code, you can preserve the previous behavior by setting the new config option expressiveCode to false.

    If you had previously added Expressive Code manually to your Starlight project, you can now remove the manual set-up in astro.config.mjs:

    • Move your configuration to Starlight’s new expressiveCode option.
    • Remove the astro-expressive-code integration.

    For example:

    import starlight from '@astrojs/starlight';
    import { defineConfig } from 'astro/config';
     import expressiveCode from 'astro-expressive-code';
    

    export default defineConfig({
      integrations: [
       expressiveCode({
         themes: ['rose-pine'],
       }),
        starlight({
          title: 'My docs',
         expressiveCode: {
           themes: ['rose-pine'],
         },
        }),
      ],
    });

    Note that the built-in Starlight version of Expressive Code sets some opinionated defaults that are different from the astro-expressive-code defaults. You may need to set some styleOverrides if you wish to keep styles exactly the same.

  • #517 5b549cb Thanks @liruifengv! - Add i18n support for default aside labels

🐞 Patch Changes